页面树结构
转至元数据结尾
转至元数据起始

正在查看旧版本。 查看 当前版本.

与当前比较 查看页面历史

« 前一个 版本 15 下一个 »

Table of Contents ×

Description

一个订单对应一个包裹和它的商品描述、重量、派送地址等信息。

Path

HTTP Verb URL
Post/services/shipper/orders

Paremters

#Field (API)Field (Excel Template)Data TypeLengthMandatoryDetails

1referenceNoRef No.String80M客户端的订单唯一标识
2referenceNo1referenceNo1String80O客户端订单号
3trackingNoTracking No.String40O跟踪号
4serviceCodeN/AString64M服务代码,物流商提供
5incotermIncotermString3ODDU/DDP
6descriptionGoods DescriptionString60M英文品名
7nativeDescriptionNative DescriptionString255O中文品名
8weightTotal weightDouble M重量(>=0.000001)
9weightUnitTotal Weight UnitString3O重量单位,枚举值:G, KG,LB
默认值:KG
10lengthLengthDouble O
11widthWidthDouble O
12heightHeightDouble O
13volumeVolumeDouble O体积(>=0.01)
14dimensionUnitDimension UnitString3O长度单位,枚举值:M, CM
默认值:CM
15invoiceValueInvoice ValueDouble M货值(>=0.01),与sum(itemCount * unitValue)的误差不能超过0.1
16invoiceCurrencyInvoice CurrencyString3M币种,ISO货币代码
17 Pick UpBoolean1O枚举值:Y/N
默认值:N
18authorityToLeaveATLBoolean   
19lockerServiceLocker ServiceBoolean   
20batteryTypeBattery TypeString64O电池类型,枚举值:
No Battery
Lithium Ion
Polymer
Lithium Ion Alloy
默认值:No Battery
21batteryPackingBattery PackingString64O电池包装,枚举值:
No Battery
Inside Equipment
Packaged with Equipment
Battery Only
Other
默认值:No Battery
22dangerousGoodsDangerours GoodsBoolean O默认值:false
23skuPacking ListString128O捡货清单,一般面单上会显示出来
24serviceOptionService OptionString60O 
25instructionShipping InstructionsString255O派送指令
26facilityShipper Facility/OriginString20O发件网点,物流商提供
27platformE-Commerce PlatformString20O平台代码
28recipientNameRecipient NameString50M收件人名称

限制英语/法语字符/非纯数字
自动去除特殊字符
29recipientTaxIdRecipient Tax IDString100O收件人税号
30recipientCompanyRecipient CompanyString50O收件人公司名
31phonePhoneString20O电话
32emailEmailString50O邮箱
33addressLine1Address line 1String200M地址第一行

限制英语/法语字符/非纯数字
自动去除特殊字符
34addressLine2Address line 2String200O地址第二行
35addressLine3Address line 3String80O地址第三行
36cityCity/SuburbString80M城市
37stateStateString80M

限制英语/法语字符/非纯数字
自动去除特殊字符
38postcodePostcodeString16O邮编
39countryCountryString2M国家二字代码
40shipperNameShipper NameString50M发件人名称

限制英语/法语字符/非纯数字
自动去除特殊字符
41shipperPhoneShipper PhoneString20O电话
42shipperAddressLine1Shipper Address Line1String200O地址第一行
43shipperAddressLine2Shipper Address Line2String200O地址第二行
44shipperAddressLine3Shipper Address Line3String80O地址第三行
45shipperCityShipper Address CityString80O城市
46shipperStateShipper Address StateString80O
47shipperPostcodeShipper Address PostcodeString16O邮编
48shipperCountryShipper Address CountryString2O国家二字代码
49returnOptionReturn OptionString100O退件选项
50returnNameReturn NameString50M退件接收人名称
51returnAddressLine1Return Address Line1String200M地址第一行
52returnAddressLine2Return Address Line2String200O地址第二行
53returnAddressLine3Return Address Line3String80O地址第三行
54returnCityReturn Address CityString80M城市
55returnStateReturn Address StateString80M
56returnPostcodeReturn Address PostcodeString16O邮编
57returnCountryReturn Address CountryString2M国家二字代码
58itemsN/AList OItem信息
59 itemNoItem NoString128MItem编号
60 skuItem SKUString128MSKU
61 descriptionItem DescString60M英文品名
如果值为空,设置成订单级别的description
1. 不能包含设置的违禁品关键词
2. 必须是英文和法文字符或数字
62 nativeDescriptionItem Native DescString255O中文品名
63 hsCodeItem HSCodeString60OHS Code
64 originCountryItem OriginString60M国家二字代码,三字代码或名称
65 itemCountItem CountInteger M件数,>0
66 unitValueItem Unit ValueDouble M单价,>0
67 warehouseNoWarehouse No 50O截取前50个字符
68 productURLItem Product URLString512O产品链接
69 itemWeightItem WeightDouble OItem重量,转换成KG
70extendData N/AList O扩展字段
71 vendoridvendoridString12O税号
72 gstexemptionCodegstexemptionCodeSting4OGST免税码,如果vendorid正确,该字段值自动设置为“PAID”
73 senderTaxIdsenderTaxIdString255O发货人税号
74 InjectPortInjectPortString256O订单配送港口,针对加拿大服务






Request

Request
[
  {
    "referenceNo": "reedzhang1231211",
    "country": "AU",
    "serviceCode": "UBI.AU2AU.AUPOST.1",
    "serviceOption": "Expedited",
    "facility": "can",
    "state": "VICTORIA",
    "city": "Berwick",
    "postcode": "3806",
    "addressLine1": "3 Lakeside Drivie",
    "addressLine2": "",
    "recipientName": "Corrie McKee",
    "phone": "0403536112",
    "email": "corrie.mckee@monash.edu",
    "sku": "sw2111202146745684",
    "invoiceCurrency": "USD",
    "invoiceValue": 6.23,
    "weightUnit": "g",
    "weight": 264,
    "description": "sw2111202146745684",
    "nativeDescription": "连衣裙",
    "shipperName": "Jiang Yuanfei",
    "shipperPhone": "+86 02586707811",
    "shipperAddressLine1": "Prologis (Anbo) Logistics Center Datang Town,Sanshui Industrial Park",
    "vendorid": "111",
    "abnnumber": "",
    "gstexemptioncode": "PAID",
    "extendData": {
      "injectPort": null
    },
    "orderItems": [
      {
        "itemCount": 1,
        "originCountry": "CN",
        "description": "sw2111202146745684",
        "nativeDescription": "连衣裙",
        "unitValue": 3.87,
        "itemNo": "8247107",
        "sku": "sw2111202146745684"
      },
      {
        "itemCount": 1,
        "originCountry": "CN",
        "description": "sw2201125303640755",
        "nativeDescription": "背心",
        "unitValue": 2.36,
        "itemNo": "9743766",
        "sku": "sw2201125303640755"
      }
    ],
    "shipperCity": "FO SHAN",
    "volume": 0.1
  }
]

Response

Response
 {
  "status": "Success",
  "errors": null,
  "data": [
    {
      "status": "Success",
      "errors": null,
      "warnings": null,
      "orderId": "z1Mkp-bpgIHPRFCcNg0cbw",
      "referenceNo": "Sammy2022318022939",
      "trackingNo": "9274890260113400044444",
      "connoteId": null,
      "piecesResult": null,
      "extraProperty": {
        "injectPort": "EWR",
        "customsClearanceType": "T"
      }
    }
  ],
  "warnings": null
}

  • 无标签