...
一个订单对应一个包裹和它的商品描述、重量、派送地址等信息。 |
路径
HTTP Verb | URL |
---|---|
Post | /services/shipper/orders |
请求字段
# | Field (API) | Data Type | Length | Mandatory | Details | |
1 | referenceNo | String | 80 | M | 客户端的订单唯一标识 | |
2 | referenceNo1 | String | 80 | O | 客户端订单号 | |
3 | trackingNo | String | 40 | O | 跟踪号 | |
4 | serviceCode | String | 64 | M | 服务代码,物流商提供 | |
5 | incoterm | String | 3 | O | DDU/DDP | |
6 | description | String | 60 | M | 英文品名 | |
7 | nativeDescription | String | 255 | O | 中文品名 | |
8 | weight | Double | M | 重量(>=0.000001) | ||
9 | weightUnit | String | 3 | O | 重量单位,枚举值:G, KG,LB 默认值:KG | |
10 | length | Double | O | 长 | ||
11 | width | Double | O | 宽 | ||
12 | height | Double | O | 高 | ||
13 | volume | Double | O | 体积(>=0.01) | ||
14 | dimensionUnit | String | 3 | O | 长度单位,枚举值:M, CM 默认值:CM | |
15 | invoiceValue | Double | M | 货值(>=0.01),与sum(itemCount * unitValue)的误差不能超过0.1 | ||
16 | invoiceCurrency | String | 3 | M | 币种,ISO货币代码 | |
17 | Boolean | 1 | O | 枚举值:Y/N 默认值:N | ||
18 | authorityToLeave | Boolean | ||||
19 | lockerService | Boolean | ||||
20 | batteryType | String | 64 | O | 电池类型,枚举值: No Battery Lithium Ion Polymer Lithium Ion Alloy 默认值:No Battery | |
21 | batteryPacking | String | 64 | O | 电池包装,枚举值: No Battery Inside Equipment Packaged with Equipment Battery Only Other 默认值:No Battery | |
22 | dangerousGoods | Boolean | O | 默认值:false | ||
23 | sku | String | 128 | O | 捡货清单,一般面单上会显示出来 | |
24 | serviceOption | String | 60 | O | ||
25 | instruction | String | 255 | O | 派送指令 | |
26 | facility | String | 20 | O | 发件网点,物流商提供 | |
27 | platform | String | 20 | O | 平台代码 | |
28 | recipientName | String | 50 | M | 收件人名称 限制英语/法语字符/非纯数字 自动去除特殊字符 | |
29 | recipientTaxId | String | 100 | O | 收件人税号 | |
30 | recipientCompany | String | 50 | O | 收件人公司名 | |
31 | phone | String | 20 | O | 电话 | |
32 | String | 50 | O | 邮箱 | ||
33 | addressLine1 | String | 200 | M | 地址第一行 限制英语/法语字符/非纯数字 自动去除特殊字符 | |
34 | addressLine2 | String | 200 | O | 地址第二行 | |
35 | addressLine3 | String | 80 | O | 地址第三行 | |
36 | city | String | 80 | M | 城市 | |
37 | state | String | 80 | M | 省 限制英语/法语字符/非纯数字 自动去除特殊字符 | |
38 | postcode | String | 16 | O | 邮编 | |
39 | country | String | 2 | M | 国家二字代码 | |
40 | shipperName | String | 50 | M | 发件人名称 限制英语/法语字符/非纯数字 自动去除特殊字符 | |
41 | shipperPhone | String | 20 | O | 电话 | |
42 | shipperAddressLine1 | String | 200 | O | 地址第一行 | |
43 | shipperAddressLine2 | String | 200 | O | 地址第二行 | |
44 | shipperAddressLine3 | String | 80 | O | 地址第三行 | |
45 | shipperCity | String | 80 | O | 城市 | |
46 | shipperState | String | 80 | O | 省 | |
47 | shipperPostcode | String | 16 | O | 邮编 | |
48 | shipperCountry | String | 2 | O | 国家二字代码 | |
49 | returnOption | String | 100 | O | 退件选项 | |
50 | returnName | String | 50 | M | 退件接收人名称 | |
51 | returnAddressLine1 | String | 200 | M | 地址第一行 | |
52 | returnAddressLine2 | String | 200 | O | 地址第二行 | |
53 | returnAddressLine3 | String | 80 | O | 地址第三行 | |
54 | returnCity | String | 80 | M | 城市 | |
55 | returnState | String | 80 | M | 省 | |
56 | returnPostcode | String | 16 | O | 邮编 | |
57 | returnCountry | String | 2 | M | 国家二字代码 | |
58 | items | List | O | Item信息 | ||
59 | itemNo | String | 128 | M | Item编号 | |
60 | sku | String | 128 | M | SKU | |
61 | description | String | 60 | M | 英文品名 如果值为空,设置成订单级别的description 1. 不能包含设置的违禁品关键词 2. 必须是英文和法文字符或数字 | |
62 | nativeDescription | String | 255 | O | 中文品名 | |
63 | hsCode | String | 60 | O | HS Code | |
64 | originCountry | String | 60 | M | 国家二字代码,三字代码或名称 | |
65 | itemCount | Integer | M | 件数,>0 | ||
66 | unitValue | Double | M | 单价,>0 | ||
67 | warehouseNo | 50 | O | 截取前50个字符 | ||
68 | productURL | String | 512 | O | 产品链接 | |
69 | itemWeight | Double | O | Item重量,转换成KG | ||
70 | extendData | List | O | 扩展字段 | ||
71 | vendorid | String | 12 | O | 税号 | |
72 | gstexemptionCode | Sting | 4 | O | GST免税码,如果vendorid正确,该字段值自动设置为“PAID” | |
73 | senderTaxId | String | 255 | O | 发货人税号 | |
74 | InjectPort | String | 256 | O | 订单配送港口,针对加拿大服务 |
...