...
| HTTP Verb | URL |
|---|---|
| Post | /services/shipper/update-order |
请求字段
| 1 | Field (API) | |||
Length | Mandatory | Details | ||
| 2 | orderID | |||
| 80 | M | Tracking No跟踪号/Ref No客户端的订单唯一标识 | ||||
| 3 | description | |||||
| 60 | O | 英文品名 | ||||
| 4 | nativeDescription | |||||
| 255 | O | 中文品名 | ||||
| 5 | weight | |||||
| O | 重量(>=0.000001) | |||||
| 6 | weightUnit | |||||
| 3 | O | 重量单位，枚举值：G, KG,LB 默认值：KG | ||||
| 7 | length | |||||
| O | 长 | |||||
| 8 | width | |||||
| O | 宽 | |||||
| 9 | height | |||||
| O | 高 | |||||
| 10 | dimensionUnit | |||||
| 3 | O | 长度单位，枚举值：M, CM 默认值：CM | ||||
| 11 | invoiceValue | |||||
| O | 货值(>=0.01)，与sum(itemCount * unitValue)的误差不能超过0.1 | |||||
| 12 | invoiceCurrency | |||||
| 3 | O | 币种，ISO货币代码 | ||
| 13 | recipientName | |||
| 50 | O | 收件人名称 限制英语/法语字符/非纯数字 自动去除特殊字符 | ||||
| 14 | recipientCompany | |||||
| 50 | O | 收件人公司名 | ||||
| 15 | phone | |||||
| 20 | O | 电话 | ||||
| 16 | ||||||
| 50 | O | 邮箱 | ||||
| 17 | address | addressLine1 | ||||
| 200 | O | 地址第一行 限制英语/法语字符/非纯数字 自动去除特殊字符 | ||
| 18 | addressLine2 | |||
| 200 | O | 地址第二行 | ||
| 19 | addressLine3 | |||
| 80 | O | 地址第三行 | ||
| 20 | city | |||
| 80 | O | 城市 | ||
| 21 | state | |||
| 80 | O | 省 限制英语/法语字符/非纯数字 自动去除特殊字符 | ||
| 22 | postcode | |||
| 16 | O | 邮编 | ||
| 23 | country | |||
| 2 | O | 国家二字代码 |
| 24 | shipperName | |
| shipperName | 50 | O | 发件人名称 限制英语/法语字符/非纯数字 自动去除特殊字符 | |
| 25 | shipperPhone | |||
| shipperPhone | 20 | O | 电话 | |
| 26 | shipperAddress | shipperAddressLine1 | ||
| 200 | O | 地址第一行 | ||
| 27 | shipperAddressLine2 | |||
| 200 | O | 地址第二行（如标黄字段未更新，则单独更新此字段不生效） | ||
| 28 | shipperAddressLine3 | |||
| 80 | O | 地址第三行（如标黄字段未更新，则单独更新此字段不生效） | ||
| 29 | shipperCity | |||
| 80 | O | 城市 | ||
| 30 | shipperState | |||
| 80 | O | 省 | ||
| 31 | shipperPostcode | |||
| 16 | O | 邮编 | ||
| 32 | shipperCountry | |||
| 2 | O | 国家二字代码 |
| 33 | shipperEmail | |
| shipperEmail | 80 | O | 客户邮箱（如标黄字段未更新，则单独更新此字段不生效） | |
| 34 | returnOption | |||
| returnOption | 100 | O | 退件选项（如标蓝字段未更新，则单独更新此字段不生效） | |
| 35 | returnName | |||
| returnName | 50 | O | 退件接收人名称 | |
| 36 | returnAddress | returnAddressLine1 | ||
| 200 | O | 地址第一行 | ||
| 37 | returnAddressLine2 | |||
| 200 | O | 地址第二行（如标蓝字段未更新，则单独更新此字段不生效） | ||
| 38 | returnAddressLine3 | |||
| 80 | O | 地址第三行（如标蓝字段未更新，则单独更新此字段不生效） | ||
| 39 | returnCity | |||
| 80 | O | 城市 | ||
| 40 | returnState | |||
| 80 | O | 省 | ||
| 41 | returnPostcode | |||
| 16 | O | 邮编 | ||
| 42 | returnCountry | |||
| 2 | O | 国家二字代码 |
| 43 | returnPhone | |
| returnPhone | 50 | O | 退货电话 | ||||
| 44 | orderItems | List | O | Item信息 | |||
| 45 | sku | String | 128 | O | SKU | ||
| 46 | description | String | 60 | O | 英文品名 如果值为空，设置成订单级别的description 1. 不能包含设置的违禁品关键词 2. 必须是英文和法文字符或数字 | ||
| 47 | nativeDescription | String | 255 | O | 中文品名 | ||
| 48 | hsCode | String | 60 | O | HS Code | ||
| 49 | originCountry | String | 60 | O | 国家二字代码，三字代码或名称 | ||
| 50 | itemCount | Integer | O | 件数，>0 | |||
| 51 | unitValue | Double | O | 单价，>0 | |||
| 52 | weight | Double | O | Item重量，转换成KG | |||
请求内容
| 代码块 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
[{
"address": {
"country": "CA",
"city": "Belle River",
"postcode": "N0R 1A0",
"addressLine1": "address line 1",
"addressLine2": "",
"addressLine3": "",
"state": "ON"
},
"nativeDescription": "",
"orderId": "Test001",
"dimensionUnit": "",
"length": 0,
"description": "",
"weight": 0,
"invoiceValue": 0,
"invoiceCurrency": "",
"recipientCompany": "",
"returnAddress": {
"addressLine1": "",
"addressLine2": "",
"addressLine3": "",
"city": "",
"country": "",
"postcode": "",
"state": ""
},
"returnName": "",
"returnOption": "",
"returnPhone": "",
"shipperAddress": {
"addressLine1": "",
"addressLine2": "",
"addressLine3": "",
"city": "",
"country": "",
"postcode": "",
"state": ""
},
"shipperEmail": "",
"shipperName": "",
"shipperPhone": "",
"phone": "",
"width": 0,
"recipientName": "",
"items": [{
"hsCode": "",
"nativeDescription": "",
"originCountry": "",
"description": "",
"weight": 0,
"sku": "sku",
"itemCount": 0,
"unitValue": 0
}],
"email": "",
"height": 0,
"weightUnit": ""
}] |
...