接口说明
本接口用于通过参考号或者跟踪号更新部分订单信息，具体服务是否支持此接口请联系eTower了解。 请注意以下几点：
|
路径
| HTTP Verb | URL |
|---|---|
| Post | /services/shipper/update-order |
请求字段
| Field (API) | Data Type | Length | Mandatory | Details | |
| orderID | String | 80 | M | Tracking No跟踪号/Ref No客户端的订单唯一标识 | |
| description | String | 60 | O | 英文品名 | |
| nativeDescription | String | 255 | O | 中文品名 | |
| weight | Double | O | 重量(>=0.000001) | ||
| weightUnit | String | 3 | O | 重量单位，枚举值：G, KG,LB 默认值：KG | |
| length | Double | O | 长 | ||
| width | Double | O | 宽 | ||
| height | Double | O | 高 | ||
| dimensionUnit | String | 3 | O | 长度单位，枚举值：M, CM 只针对长宽高，与体积无关 | |
| invoiceValue | Double | O | 货值(>=0.01)，与sum(itemCount * unitValue)的误差不能超过0.1 | ||
| invoiceCurrency | String | 3 | O | 币种，ISO货币代码 | |
| recipientName | String | 50 | O | 收件人名称
| |
| recipientCompany | String | 50 | O | 收件人公司名 | |
| phone | String | 20 | O | 电话 | |
| String | 50 | O | 邮箱 | ||
| address | |||||
| addressLine1 | String | 200 | O | 地址第一行 限制英语/法语字符/非纯数字 自动去除特殊字符 | |
| addressLine2 | String | 200 | O | 地址第二行 | |
| addressLine3 | String | 80 | O | 地址第三行 | |
| city | String | 80 | O | 城市 | |
| state | String | 80 | O | 省 限制英语/法语字符/非纯数字 自动去除特殊字符 | |
| postcode | String | 16 | O | 邮编 | |
| country | String | 2 | O | 国家二字代码 | |
| shipperName | String | 50 | O | 发件人名称 限制英语/法语字符/非纯数字 自动去除特殊字符 | |
| shipperPhone | String | 20 | O | 电话 | |
| shipperAddress | |||||
| shipperAddressLine1 | String | 200 | O | 地址第一行 | |
| shipperAddressLine2 | String | 200 | O | 地址第二行（如标黄字段未更新，则单独更新此字段不生效） | |
| shipperAddressLine3 | String | 80 | O | 地址第三行（如标黄字段未更新，则单独更新此字段不生效） | |
| shipperCity | String | 80 | O | 城市 | |
| shipperState | String | 80 | O | 省 | |
| shipperPostcode | String | 16 | O | 邮编 | |
| shipperCountry | String | 2 | O | 国家二字代码 | |
| shipperEmail | String | 80 | O | 客户邮箱（如标黄字段未更新，则单独更新此字段不生效） | |
| returnOption | String | 100 | O | 退件选项（如标蓝字段未更新，则单独更新此字段不生效） | |
| returnName | String | 50 | O | 退件接收人名称 | |
| returnAddress | |||||
| returnAddressLine1 | String | 200 | O | 地址第一行 | |
| returnAddressLine2 | String | 200 | O | 地址第二行（如标蓝字段未更新，则单独更新此字段不生效） | |
| returnAddressLine3 | String | 80 | O | 地址第三行（如标蓝字段未更新，则单独更新此字段不生效） | |
| returnCity | String | 80 | O | 城市 | |
| returnState | String | 80 | O | 省 | |
| returnPostcode | String | 16 | O | 邮编 | |
| returnCountry | String | 2 | O | 国家二字代码 | |
| returnPhone | String | 50 | O | 退货电话 | |
| Items | List | O | Item信息 | ||
| sku | String | 128 | O | SKU | |
| description | String | 60 | O | 英文品名 如果值为空，设置成订单级别的description 1. 不能包含设置的违禁品关键词 2. 必须是英文和法文字符或数字 | |
| nativeDescription | String | 255 | O | 中文品名 | |
| hsCode | String | 60 | O | HS Code | |
| originCountry | String | 60 | O | 国家二字代码，三字代码或名称 | |
| itemCount | Integer | O | 件数，>0 | ||
| unitValue | Double | O | 单价，>0 | ||
| weight | Double | O | Item重量，转换成KG | ||
请求内容
Request
[{
"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": ""
}]
响应内容
服务端返回与请求相对应的跟踪号，包括
1）是否查询成功(status)；
2）出错代码(errors)；
3）请求id(orderId)；
4）客户单号(referenceNo)；
5）跟踪号(trackingNo)；
响应报文
Response
{
"status": "Success",
"errors": null,
"data": [
{
"status": "Success",
"errors": null,
"orderId": "JDQ002444601000931506",
"referenceNo": "Marco-20200806113127",
"trackingNo": "JDQ002444601000931506",
"connoteId": null
},
{
"status": "Success",
"errors": null,
"orderId": "JDQ002444701000931503",
"referenceNo": "Marco-20200806113130",
"trackingNo": "JDQ002444701000931503",
"connoteId": null
}
]
}
部分成功样例
Response
{
"status": "Partial Success",
"errors": [
{
"code": 100009,
"message": "Order JDQ00244470100093150113 not found"
}
],
"data": [
{
"status": "Success",
"errors": null,
"orderId": "JDQ002444601000931506",
"referenceNo": "Marco-20200806113127",
"trackingNo": "JDQ002444601000931506",
"connoteId": null
},
{
"status": "Failure",
"errors": [
{
"code": 100009,
"message": "Order JDQ00244470100093150113 not found"
}
],
"orderId": "JDQ00244470100093150113",
"referenceNo": null,
"trackingNo": null,
"connoteId": null
}
]
}
失败样例
Response
{
"status": "Failure",
"errors": [
{
"code": 100009,
"message": "Order JDQ00244470100093150113 not found"
},
{
"code": 100009,
"message": "Order JDQ00244460100093150611 not found"
}
],
"data": [
{
"status": "Failure",
"errors": [
{
"code": 100009,
"message": "Order JDQ00244460100093150611 not found"
}
],
"orderId": "JDQ00244460100093150611",
"referenceNo": null,
"trackingNo": null,
"connoteId": null
},
{
"status": "Failure",
"errors": [
{
"code": 100009,
"message": "Order JDQ00244470100093150113 not found"
}
],
"orderId": "JDQ00244470100093150113",
"referenceNo": null,
"trackingNo": null,
"connoteId": null
}
]
}