页面历史

...

本接口用于通过参考号或者跟踪号更新部分订单信息，具体服务是否支持此接口请联系eTower了解。

请注意以下几点：

字符串类型字段只有在填写了对应的值才会更新对应字段。空值不会把该字段置空
数字类型字段在不为空和不为0时才会修改对应字段的值
如果更新Receipt相关信息，则以下标绿字段字段需要全量更新，不支持单独更新其中某一个，eTower会使用此接口报文里面的地址信息替换原订单里面的地址信息。
如果更新Shipper相关信息，则以下标黄字段字段需要全量更新，不支持单独更新其中某一个，eTower会使用此接口报文里面的地址信息替换原订单里面的地址信息。
如果更新Return相关信息，则以下标蓝字段字段需要全量更新，不支持单独更新其中某一个，eTower会使用此接口报文里面的地址信息替换原订单里面的地址信息。
更新item信息，通过sku匹配，如果sku匹配不到或者匹配到多条都会报错
更新订单重量和币值在不更新item重量和币值信息的前提下会将订单重量或者币值按照原item所占总数的比重进行拆分。
客户使用参考号（Ref No.）或者跟踪号（Tracking No.），最多获取30条记录；
发送获取清单/ 大包交接之后，订单信息无法更改

路径

HTTP Verb	URL
Post	/services/shipper/update-order

请求字段

orderID510111213141518192327shipperAddressLine23031333438returnAddressLine2414549505155

1	Field (API)		Data Type	Length	Mandatory	Details	2
orderId		String	80	M	Tracking No跟踪号/Ref No客户端的订单唯一标识
3	description		String	60	O	英文品名
4	nativeDescription		String	255	O	中文品名
weight		Double		O	重量(>=0.000001)
6	weightUnit		String	3	O	重量单位，枚举值：G, KG,LB 默认值：KG
7	length		Double		O	长
8	width		Double		O	宽
9	height		Double		O	高
dimensionUnit		String	3	O	长度单位，枚举值：M, CM 默认值：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	电话
16	email		String	50	O	邮箱
17	address
	addressLine1	String	200	O	地址第一行限制英语/法语字符/非纯数字自动去除特殊字符
	addressLine2	String	200	O	地址第二行
	20	addressLine3	String	80	O	地址第三行
	21	city	String	80	O	城市
	22	state	String	80	O	省限制英语/法语字符/非纯数字自动去除特殊字符
	postcode	String	16	O	邮编
	24	country	String	2	O	国家二字代码
25	shipperName		String	50	O	发件人名称限制英语/法语字符/非纯数字自动去除特殊字符
26	shipperPhone		String	20	O	电话
shipperAddress
	28	shipperAddressLine1addressLine1	String	200	O	地址第一行	29
	addressLine2	String	200	O	地址第二行（如标黄字段未更新，则单独更新此字段不生效）
	addressLine3	shipperAddressLine3	String	80	O	地址第三行（如标黄字段未更新，则单独更新此字段不生效）
	city	shipperCity	String	80	O	城市
	32	shipperStatestate	String	80	O	省
	postcode	shipperPostcode	String	16	O	邮编
	country	shipperCountry	String	2	O	国家二字代码
35	shipperEmail		String	80	O	客户邮箱（如标黄字段未更新，则单独更新此字段不生效）
36	returnOption		String	100	O	退件选项（如标蓝字段未更新，则单独更新此字段不生效）
37	returnName		String	50	O	退件接收人名称
returnAddress
	39	returnAddressLine1addressLine1	String	200	O	地址第一行	40
	addressLine2	String	200	O	地址第二行（如标蓝字段未更新，则单独更新此字段不生效）
	addressLine3	returnAddressLine3	String	80	O	地址第三行（如标蓝字段未更新，则单独更新此字段不生效）
	42	returnCitycity	String	80	O	城市
	43	returnStatestate	String	80	O	省
	44	returnPostcodepostcode	String	16	O	邮编
	country	returnCountry	String	2	O	国家二字代码
46	returnPhone		String	50	O	退货电话
47	orderItemsitems		List		O	Item信息
48		sku	String	128	O	SKU
	description	String	60	O	英文品名如果值为空，设置成订单级别的description 1. 不能包含设置的违禁品关键词 2. 必须是英文和法文字符或数字
	nativeDescription	String	255	O	中文品名
	hsCode	String	60	O	HS Code
52		originCountry	String	60	O	国家二字代码，三字代码或名称
53		itemCount	Integer		O	件数，>0
54		unitValue	Double		O	单价，>0
	weight	Double		O	Item重量，转换成KG

...

代码块

language	java
firstline	1
title	Response
linenumbers	true

{
 {   "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
        }
    ]
}

页面树结构

版本比较

旧版本 14

新版本当前版本

标识

路径

请求字段

页面树结构

页面历史

版本比较

旧版本 14

新版本 当前版本

标识

路径

请求字段

新版本当前版本