页面树结构

版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

...

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

请注意以下几点:

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

路径

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


请求字段

...

Field (API)Data Type

Length

MandatoryDetails
2
orderId
orderID

String80MTracking No跟踪号/Ref No客户端的订单唯一标识
3
description
description

String60O英文品名
4
nativeDescription
nativeDescription

String255O中文品名
5
weight
weight

Double O重量(>=0.000001)
6
weightUnit
weightUnit

String3O重量单位,枚举值:G, KG,LB
默认值:KG
7
length
length

Double O
8
width
width

Double O
9
height
height

Double O
10
dimensionUnit
dimensionUnit

String3O

长度单位,枚举值:M, CM
默认值:CM

11

只针对长宽高,与体积无关

invoiceValue
Double O货值(>=0.01),与sum(itemCount * unitValue)的误差不能超过0.1
12
invoiceCurrency
invoiceCurrency

String3O币种,ISO货币代码
13
recipientName
recipientName

String50O

收件人名称



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

14
recipientCompany
recipientCompany

String50O收件人公司名
15
phone
phone

String20O电话
16
email
email

String50O邮箱
17
address




addressLine1String200O地址第一行

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

addressLine2
addressLine2
String200O地址第二行
19

addressLine3
addressLine3
String80O地址第三行
20

city
city
String80O城市
21

state
state
String80O

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

postcode
postcode
String16O邮编
23

country
country
String2O国家二字代码
24
shipperName
shipperName

String50O发件人名称

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

String20O电话
26
shipperAddress
shipperAddress





addressLine1
shipperAddressLine1
String200O地址第一行
27

addressLine2
shipperAddressLine2
String200O地址第二行(如标黄字段未更新,则单独更新此字段不生效)
28

addressLine3
shipperAddressLine3
String80O地址第三行(如标黄字段未更新,则单独更新此字段不生效)
29

city
shipperCity
String80O城市
30

state
shipperState
String80O
31

postcode
shipperPostcode
String16O邮编
32

country
shipperCountry
String2O国家二字代码
33
shipperEmail
shipperEmail

String80O客户邮箱(如标黄字段未更新,则单独更新此字段不生效)
34
returnOption
returnOption

String100O退件选项(如标蓝字段未更新,则单独更新此字段不生效)
35
returnName
returnName

String50O退件接收人名称
36
returnAddress
returnAddress





addressLine1
returnAddressLine1
String200O地址第一行
37

addressLine2
returnAddressLine2
String200O地址第二行(如标蓝字段未更新,则单独更新此字段不生效)
38

addressLine3
returnAddressLine3
String80O地址第三行(如标蓝字段未更新,则单独更新此字段不生效)
39

city
returnCity
String80O城市
40

state
returnState
String80O
41

postcode
returnPostcode
String16O邮编
42

country
returnCountry
String2O国家二字代码
43
returnPhone
returnPhone

String50O退货电话
44
items
orderItems
List OItem信息
45
 skuString128OSKU
46
 descriptionString60O英文品名
如果值为空,设置成订单级别的description
1. 不能包含设置的违禁品关键词
2. 必须是英文和法文字符或数字
47
 nativeDescriptionString255O中文品名
48
 hsCodeString60OHS Code
49
 originCountryString60O国家二字代码,三字代码或名称
50
 itemCountInteger O件数,>0
51
 unitValueDouble O单价,>0
52
 weightDouble OItem重量,转换成KG



请求内容

代码块
languagejs
borderStylesolid
firstline1
titleRequest
linenumberstrue
[{
	"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": ""
}]

...

代码块
languagejava
firstline1
titleResponse
linenumberstrue
{
{    "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
        }
    ]
}