页面树结构

版本比较

标识

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

...

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


请求字段

...

orderID345678101112131416172021222324252627shipperAddressLine1shipperAddressLine230shipperCityshipperState33343738returnAddressLine1returnAddressLine2returnAddressLine3returnCityreturnStatereturnPostcodereturnCountry4647484952535455
Field (API)Data Type

Length

MandatoryDetails2
orderId
String80MTracking No跟踪号/Ref No客户端的订单唯一标识
description
String60O英文品名
nativeDescription
String255O中文品名
weight
Double O重量(>=0.000001)
weightUnit
String3O重量单位,枚举值:G, KG,LB
默认值:KG
length
Double O
width
Double O
9height
Double O
dimensionUnit
String3O

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

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

invoiceValue
Double O货值(>=0.01),与sum(itemCount * unitValue)的误差不能超过0.1
invoiceCurrency
String3O币种,ISO货币代码
recipientName
String50O

收件人名称



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

recipientCompany
String50O收件人公司名
15phone
String20O电话
email
String50O邮箱
address




18addressLine1String200O地址第一行

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

19addressLine2String200O地址第二行

addressLine3String80O地址第三行

cityString80O城市

stateString80O

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

postcodeString16O邮编

countryString2O国家二字代码
shipperName
String50O发件人名称

限制英语/法语字符/非纯数字
自动去除特殊字符
shipperPhone
String20O电话
shipperAddress




28addressLine1String200O地址第一行29

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

addressLine3shipperAddressLine3String80O地址第三行(如标黄字段未更新,则单独更新此字段不生效)31

cityString80O城市32

stateString80O

postcodeshipperPostcodeString16O邮编

countryshipperCountryString2O国家二字代码
35shipperEmail
String80O客户邮箱(如标黄字段未更新,则单独更新此字段不生效)
36returnOption
String100O退件选项(如标蓝字段未更新,则单独更新此字段不生效)
returnName
String50O退件接收人名称
returnAddress




39addressLine1String200O地址第一行40

addressLine2String200O地址第二行(如标蓝字段未更新,则单独更新此字段不生效)41

addressLine3String80O地址第三行(如标蓝字段未更新,则单独更新此字段不生效)42

cityString80O城市43

stateString80O44

postcodeString16O邮编45

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

itemExportInvoice ValueString255O物品出口申报金额

itemExportInvoice CurrencyString255O物品出口申报币种
extendData Object O扩展字段,仅展示部分,具体字段根据服务要求有所不同
 vendoridString12O发件人税号
 gstexemptionCodeSting4OGST免税码,如果vendorid正确,该字段值自动设置为“PAID”
 senderTaxIdString255O发货人税号

injectPortString255O订单配送港口
 originPortString255O订单起始港口

postageDecimal (12, 2)255O运费

icmsDecimal (12, 2)255O巴西icms 费用

vatDecimal (12, 2)255O税号

agentIDString10OparcelShopID

coverAmountDouble
O保费金额,针对于特定服务的额外投保业务

shipperCompanyNameString255O发件人公司名

shipperOrganizationCodeString255O发件人企业统一社会信用代码

exportInvoiceValueString255O出口申报金额

exportInvoiceCurrencyString255O出口申报币种



请求内容

代码块
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
        }
    ]
}