页面历史

...

通过参考号或者跟踪号更新订单信息。

请注意以下几点：

字符串类型字段只有在填写了对应的值才会更新对应字段。空值不会把该字段置空
数字类型字段在不为空和不为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

请求字段

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

请求内容

代码块

language	js
borderStyle	solid
firstline	1
title	Request
linenumbers	true

[
    {
      	"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": "",
		"phoneaddressLine3": "",
		"city": "",
		"country":    "width"",
		"postcode": 0"",
		"state": ""
	},
	"returnName": "",
 	"recipientNamereturnOption": "",
	"returnPhone":      "items"",
	"shipperAddress": [{
		"addressLine1": "",
		"addressLine2": "",
		"addressLine3": "",
		"city": "",
		"country": "",
		"hsCodepostcode": "",
		"state": ""
	},
	"shipperEmail": "",
	"shipperName": "",
	"shipperPhone": "",
 	"nativeDescriptionphone": "",
	"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) 请求id3）请求id(orderId)；

4）客户单号(referenceNo)；

...

页面树结构

版本比较

旧版本 6

新版本 7

标识

请求字段

请求内容

响应内容