接口说明

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

请注意以下几点：

  1. 字符串类型字段只有在填写了对应的值才会更新对应字段。空值不会把该字段置空
  2. 数字类型字段在不为空和不为0时才会修改对应字段的值
  3. 更新地址信息必须全量更新，会使用报文里面的地址信息替换订单里面的地址信息
  4. 更新item信息，通过sku匹配，如果sku匹配不到或者匹配到多条都会报错
  5. 更新订单重量和币值在不更新item重量和币值信息的前提下会将订单重量或者币值按照原item所占总数的比重进行拆分。
  6. 客户使用参考号（Ref No.）或者跟踪号（Tracking No.），最多获取30条记录；

路径

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


请求内容


[
    {
      "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": "",
      "phone": "",
      "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) 请求id(orderId)；

4）客户单号(referenceNo)；

5）跟踪号(trackingNo)；



响应报文


{
    "status": "Success",
    "errors": null,
    "data": [
        {
            "status": "Success",
            "errors": null,
            "orderId": "JDQ002444601000931506",
            "referenceNo": "Marco-20200806113127",
            "trackingNo": "JDQ002444601000931506",
            "connoteId": null
        },
        {
            "status": "Success",
            "errors": null,
            "orderId": "JDQ002444701000931503",
            "referenceNo": "Marco-20200806113130",
            "trackingNo": "JDQ002444701000931503",
            "connoteId": null
        }
    ]
}

部分成功样例


{
    "status": "Partial Success",
    "errors": [
        {
            "code": 100009,
            "message": "Order JDQ00244470100093150113 not found"
        }
    ],
    "data": [
        {
            "status": "Success",
            "errors": null,
            "orderId": "JDQ002444601000931506",
            "referenceNo": "Marco-20200806113127",
            "trackingNo": "JDQ002444601000931506",
            "connoteId": null
        },
        {
            "status": "Failure",
            "errors": [
                {
                    "code": 100009,
                    "message": "Order JDQ00244470100093150113 not found"
                }
            ],
            "orderId": "JDQ00244470100093150113",
            "referenceNo": null,
            "trackingNo": null,
            "connoteId": null
        }
    ]
}

失败样例


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