页面树结构

版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

...

一个订单对应一个包裹和它的商品描述、重量、派送地址等信息。

路径

HTTP Verb URL
Post/services/shipper/orders

请求字段

#Field (API)Data Type

Length

MandatoryDetails

1referenceNoString80M客户端的订单唯一标识
2referenceNo1String80O客户端订单号
3trackingNoString40O跟踪号
4serviceCodeString64M服务代码,物流商提供
5incotermString3ODDU/DDP
6descriptionString60M英文品名
7nativeDescriptionString255O中文品名
8weightDouble M重量(>=0.000001)
9weightUnitString3O重量单位,枚举值:G, KG,LB
默认值:KG
10lengthDouble O
11widthDouble O
12heightDouble O
13volumeDouble O体积(>=0.01)
14dimensionUnitString3O长度单位,枚举值:M, CM
默认值:CM
15invoiceValueDouble M货值(>=0.01),与sum(itemCount * unitValue)的误差不能超过0.1
16invoiceCurrencyString3M币种,ISO货币代码
17 Boolean1O枚举值:Y/N
默认值:N
18authorityToLeaveBoolean   
19lockerServiceBoolean   
20batteryTypeString64O电池类型,枚举值:
No Battery
Lithium Ion
Polymer
Lithium Ion Alloy
默认值:No Battery
21batteryPackingString64O电池包装,枚举值:
No Battery
Inside Equipment
Packaged with Equipment
Battery Only
Other
默认值:No Battery
22dangerousGoodsBoolean O默认值:false
23skuString128O捡货清单,一般面单上会显示出来
24serviceOptionString60O 
25instructionString255O派送指令
26facilityString20O发件网点,物流商提供
27platformString20O平台代码
28recipientNameString50M收件人名称

限制英语/法语字符/非纯数字
自动去除特殊字符
29recipientTaxIdString100O收件人税号
30recipientCompanyString50O收件人公司名
31phoneString20O电话
32emailString50O邮箱
33addressLine1String200M地址第一行

限制英语/法语字符/非纯数字
自动去除特殊字符
34addressLine2String200O地址第二行
35addressLine3String80O地址第三行
36cityString80M城市
37stateString80M

限制英语/法语字符/非纯数字
自动去除特殊字符
38postcodeString16O邮编
39countryString2M国家二字代码
40shipperNameString50M发件人名称

限制英语/法语字符/非纯数字
自动去除特殊字符
41shipperPhoneString20O电话
42shipperAddressLine1String200O地址第一行
43shipperAddressLine2String200O地址第二行
44shipperAddressLine3String80O地址第三行
45shipperCityString80O城市
46shipperStateString80O
47shipperPostcodeString16O邮编
48shipperCountryString2O国家二字代码
49returnOptionString100O退件选项
50returnNameString50M退件接收人名称
51returnAddressLine1String200M地址第一行
52returnAddressLine2String200O地址第二行
53returnAddressLine3String80O地址第三行
54returnCityString80M城市
55returnStateString80M
56returnPostcodeString16O邮编
57returnCountryString2M国家二字代码
58itemsList OItem信息
59 itemNoString128MItem编号
60 skuString128MSKU
61 descriptionString60M英文品名
如果值为空,设置成订单级别的description
1. 不能包含设置的违禁品关键词
2. 必须是英文和法文字符或数字
62 nativeDescriptionString255O中文品名
63 hsCodeString60OHS Code
64 originCountryString60M国家二字代码,三字代码或名称
65 itemCountInteger M件数,>0
66 unitValueDouble M单价,>0
67 warehouseNo 50O截取前50个字符
68 productURLString512O产品链接
69 itemWeightDouble OItem重量,转换成KG
70extendData List O扩展字段
71 vendoridString12O税号
72 gstexemptionCodeSting4OGST免税码,如果vendorid正确,该字段值自动设置为“PAID”
73 senderTaxIdString255O发货人税号
74 InjectPortString256O订单配送港口,针对加拿大服务

...