页面历史

Float_table_content
Hidable false
Maxlvl 6

接口说明

通过参考号或者跟踪号更新订单信息。本接口用于通过参考号或者跟踪号更新部分订单信息，具体服务是否支持此接口请联系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

请求字段

1

Field (API)

Data Type

Length

Mandatory

Details

2

orderId

orderID3

String

80

M

客户端的订单唯一标识

Tracking No跟踪号/Ref No客户端的订单唯一标识
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

address
	addressLine1	String	200	O	地址第一行限制英语/法语字符/非纯数字自动去除特殊字符

18

addressLine2

String

200

O

地址第二行

19

addressLine3

String

80

O

地址第三行

20


	city	String	80

M

O

城市

21

state

String

80

M

O	省限制英语/法语字符/非纯数字自动去除特殊字符

22


	postcode	String	16	O	邮编

23


	country	String	2

M

O

国家二字代码

24

shipperName

String

50

M

O	发件人名称限制英语/法语字符/非纯数字自动去除特殊字符

25


shipperPhone		String	20	O	电话

26

shipperAddress

shipperAddressLine1


	addressLine1	String	200	O	地址第一行

27

addressLine2

shipperAddressLine2

String

200

O

地址第二行（如标黄字段未更新，则单独更新此字段不生效）

28

addressLine3

shipperAddressLine3

String

80

O

地址第三行（如标黄字段未更新，则单独更新此字段不生效）

29

city

shipperCity

String

80

O

城市

30

state

shipperState

String

80

O

省

31

postcode

shipperPostcode

String

16

O

邮编

32shipperCountry

country

String

2

O

国家二字代码

33


shipperEmail		String	80	O	客户邮箱（如标黄字段未更新，则单独更新此字段不生效）

34

returnOption

String

100

O

退件选项（如标蓝字段未更新，则单独更新此字段不生效）

35

returnName

String

50

M

O

退件接收人名称

36

returnAddress

returnAddressLine1


	addressLine1	String	200

M

O

地址第一行

37returnAddressLine2

addressLine2

String

200

O

地址第二行（如标蓝字段未更新，则单独更新此字段不生效）

38

addressLine3

returnAddressLine3

String

80

O

地址第三行（如标蓝字段未更新，则单独更新此字段不生效）

39returnCity

city

String

80

M

O

城市

40

state

returnState

String

80

M

O

省

41returnPostcode

postcode

String

16

O

邮编

42

country

returnCountry

String

2

M

O

国家二字代码

43


returnPhone		String	50	O	退货电话

44orderItems

items

List

O

Item信息

45


	sku	String	128

M

O

SKU

46

description

String

60

M

O	英文品名如果值为空，设置成订单级别的description 1. 不能包含设置的违禁品关键词 2. 必须是英文和法文字符或数字

47

nativeDescription

String

255

O

中文品名

48

hsCode

String

60

O

HS Code

49


	originCountry	String	60

M

O	国家二字代码，三字代码或名称

50

itemCount

Integer

M

O

件数，>0

51


	unitValue	Double

M

O

单价，>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": "",
		"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": ""
}]

...

代码块

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

页面树结构

版本比较

旧版本 7

新版本当前版本

标识

Float_table_content
Hidable false
Maxlvl 6

接口说明

路径

请求字段

请求内容

页面树结构

页面历史

版本比较

旧版本 7

新版本 当前版本

标识

Float_table_contentHidablefalseMaxlvl6

接口说明

路径

请求字段

请求内容

新版本当前版本

Float_table_content
Hidable false
Maxlvl 6