页面历史

Float_table_content

Description

一个订单对应一个包裹和它的商品描述、重量、派送地址等信息。产生和打印标签，按照请求顺序返回结果。

Path

HTTP Verb	URL
Post	/services/shipper/orderslabels

Paremters

Ref No.referenceNo1收件人名称
限制英语/法语字符/非纯数字
自动去除特殊字符地址第一行
限制英语/法语字符/非纯数字
自动去除特殊字符省
限制英语/法语字符/非纯数字
自动去除特殊字符发件人名称
限制英语/法语字符/非纯数字
自动去除特殊字符

#	Field (API)		Field (Excel Template)	Data Type	Length	Mandatory	Details
#	Field (API)		Field (Excel Template)	Data Type	Length	Mandatory
1	referenceNo		orderIds		String	80	M	客户端的订单唯一标识O
2	referenceNo1		labelType		String	80	O	客户端订单号
3	trackingNo		Tracking No.	String	40	O	跟踪号
4	serviceCode		N/A	String	64	M	服务代码，物流商提供
5	incoterm		Incoterm	String	3	O	DDU/DDP
6	description		Goods Description	String	60	M	英文品名
7	nativeDescription		Native Description	String	255	O	中文品名
8	weight		Total weight	Double		M	重量(>=0.000001)
9	weightUnit		Total Weight Unit	String	3	O	重量单位，枚举值：G, KG,LB 默认值：KG
10	length		Length	Double		O	长
11	width		Width	Double		O	宽
12	height		Height	Double		O	高
13	volume		Volume	Double		O	体积(>=0.01)
14	dimensionUnit		Dimension Unit	String	3	O	长度单位，枚举值：M, CM 默认值：CM
15	invoiceValue		Invoice Value	Double		M	货值(>=0.01)，与sum(itemCount * unitValue)的误差不能超过0.1
16	invoiceCurrency		Invoice Currency	String	3	M	币种，ISO货币代码
17			Pick Up	Boolean	1	O	枚举值：Y/N 默认值：N
18	authorityToLeave		ATL	Boolean
19	lockerService		Locker Service	Boolean
20	batteryType		Battery Type	String	64	O	电池类型，枚举值： No Battery Lithium Ion Polymer Lithium Ion Alloy 默认值：No Battery
21	batteryPacking		Battery Packing	String	64	O	电池包装，枚举值： No Battery Inside Equipment Packaged with Equipment Battery Only Other 默认值：No Battery
22	dangerousGoods		Dangerours Goods	Boolean		O	默认值：false
23	sku		Packing List	String	128	O	捡货清单，一般面单上会显示出来
24	serviceOption		Service Option	String	60	O
25	instruction		Shipping Instructions	String	255	O	派送指令
26	facility		Shipper Facility/Origin	String	20	O	发件网点，物流商提供
27	platform		E-Commerce Platform	String	20	O	平台代码
28	recipientName		Recipient Name	String	50	M
29	recipientTaxId		Recipient Tax ID	String	100	O	收件人税号
30	recipientCompany		Recipient Company	String	50	O	收件人公司名
31	phone		Phone	String	20	O	电话
32	email		Email	String	50	O	邮箱
33	addressLine1		Address line 1	String	200	M
34	addressLine2		Address line 2	String	200	O	地址第二行
35	addressLine3		Address line 3	String	80	O	地址第三行
36	city		City/Suburb	String	80	M	城市
37	state		State	String	80	M
38	postcode		Postcode	String	16	O	邮编
39	country		Country	String	2	M	国家二字代码
40	shipperName		Shipper Name	String	50	M
41	shipperPhone		Shipper Phone	String	20	O	电话
42	shipperAddressLine1		Shipper Address Line1	String	200	O	地址第一行
43	shipperAddressLine2		Shipper Address Line2	String	200	O	地址第二行
44	shipperAddressLine3		Shipper Address Line3	String	80	O	地址第三行
45	shipperCity		Shipper Address City	String	80	O	城市
46	shipperState		Shipper Address State	String	80	O	省
47	shipperPostcode		Shipper Address Postcode	String	16	O	邮编
48	shipperCountry		Shipper Address Country	String	2	O	国家二字代码
49	returnOption		Return Option	String	100	O	退件选项
50	returnName		Return Name	String	50	M	退件接收人名称
51	returnAddressLine1		Return Address Line1	String	200	M	地址第一行
52	returnAddressLine2		Return Address Line2	String	200	O	地址第二行
53	returnAddressLine3		Return Address Line3	String	80	O	地址第三行
54	returnCity		Return Address City	String	80	M	城市
55	returnState		Return Address State	String	80	M	省
56	returnPostcode		Return Address Postcode	String	16	O	邮编
57	returnCountry		Return Address Country	String	2	M	国家二字代码
58	items		N/A	List		O	Item信息
59		itemNo	Item No	String	128	M	Item编号
60		sku	Item SKU	String	128	M	SKU
61		description	Item Desc	String	60	M	英文品名如果值为空，设置成订单级别的description 1. 不能包含设置的违禁品关键词 2. 必须是英文和法文字符或数字
62		nativeDescription	Item Native Desc	String	255	O	中文品名
63		hsCode	Item HSCode	String	60	O	HS Code
64		originCountry	Item Origin	String	60	M	国家二字代码，三字代码或名称
65		itemCount	Item Count	Integer		M	件数，>0
66		unitValue	Item Unit Value	Double		M	单价，>0
67		warehouseNo	Warehouse No		50	O	截取前50个字符
68		productURL	Item Product URL	String	512	O	产品链接
69		itemWeight	Item Weight	Double		O	Item重量，转换成KG
70	extendData		N/A	List		O	扩展字段
71		vendorid	vendorid	String	12	O	税号
72		gstexemptionCode	gstexemptionCode	Sting	4	O	GST免税码，如果vendorid正确，该字段值自动设置为“PAID”
73		senderTaxId	senderTaxId	String	255	O	发货人税号
74		InjectPort	InjectPort	String	256	O	订单配送港口，针对加拿大服务
abelType: 0表示默认值10cm * 15cm， 1表示10cm * 15cm， 2表示A4， 4表示10cm * 10cm，目前API只支持这三种格式；
3	packinglist		String	40	O	是否打印拣货清单
4	merged		String	64	M	Boolean类型，指定是否需要合并为一个PDF文件；若选择合并，则只会合并打印出成功的订单，并且按照请求参数中订单的顺序进行合并。
5	labelFormat		String	3	O	标签格式，可选JPG格式，不填默认为PDF格式。JPG格式面单不支持合并，当同时选择打印packinglist时，会返回多个文件。

Request

代码块

language	js
borderStyle	solid
firstline	1
title	Request
linenumbers	true

[
 
{
 


"referenceNoorderIds": ["reedzhang1231211ABC123456789001001002"],
 


"country": "AU",
    "serviceCode": "UBI.AU2AU.AUPOST.1"labelType":1,


  "serviceOptionpackinglist": "Expedited",
 false,


"facilitymerged": "can",
 false,


"statelabelFormat": "VICTORIA",
    "city": "Berwick",
    "postcode": "3806",
    "addressLine1": "3 Lakeside Drivie",
    "addressLine2": "",
    "recipientName": "Corrie McKee",
    "phone": "0403536112",
    "email": "corrie.mckee@monash.edu",
    "sku": "sw2111202146745684",
    "invoiceCurrency": "USD",
    "invoiceValue": 6.23,
    "weightUnit": "g",
    "weight": 264,
    "description": "sw2111202146745684",
    "nativeDescription": "连衣裙",
    "shipperName": "Jiang Yuanfei",
    "shipperPhone": "+86 02586707811",
    "shipperAddressLine1": "Prologis (Anbo) Logistics Center Datang Town,Sanshui Industrial Park",
    "vendorid": "111",
    "abnnumber": "",
    "gstexemptioncode": "PAID",
    "extendData": {
      "injectPort": null
    },
    "orderItems": [
      "JPG"


}

Response

代码块

language	java
firstline	1
title	Response
linenumbers	true

 

{


      "itemCountstatus": 1,
        "originCountry": "CN",
 "Success",


    "descriptionerrors": "sw2111202146745684"null,
 


    "nativeDescriptiondata": "连衣裙",
        "unitValue": 3.87,
  [


   "itemNo": "8247107",         "sku": "sw2111202146745684"
      },
      {
   


  "itemCount": 1,         "originCountrystatus":
"CN",
        "description": "sw2201125303640755",
        "nativeDescription": "背心",
        "unitValue": 2.36,
        "itemNo": "9743766",
        "sku": "sw2201125303640755"
      }
    ]Success",


  "shipperCity": "FO SHAN",
    "volume": 0.1
  }
]

Response

代码块

language	java
firstline	1
title	Response
linenumbers	true

 {   "status": "Success",   "errors": null,


"data":
[     {       "statuslabelContent": "Success",
      "errors": null,Base64
String"


    "warnings": null,       "orderId":
"z1Mkp-bpgIHPRFCcNg0cbwJDQ002445001000931503",


    "referenceNo": "Sammy2022318022939",       "trackingNo":
"9274890260113400044444JDQ002445001000931503",


    "connoteId": null,       "piecesResultlabelContents": null,


    "extraProperty": {   }


   "injectPort": "EWR",
        "customsClearanceType": "T"
      }
    }
  ],
  "warnings": null
} ]


}

页面树结构

版本比较

旧版本 1

新版本 2

标识

Float_table_content

Description

Path

Paremters

Request

Response

Response