文档中心 > API类目 > 海南离岛免税api

alibaba.dutyfree.logistics.package.sync (订单物流单号推送通用)

订单物流单号推送:支持一个订单多个包裹场景

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_logistics_package_sync_request OrderLogisticsPackageSyncRequest 必须 请求
  • package_info_request_list
  • OrderLogisticsPackageInfo []
  • 必须
  • 包裹信息列表
  • └ tms_code
  • String
  • 必须
  • ZTO
  • 物流公司code
  • └ tms_order_code
  • String
  • 必须
  • 77113671272624
  • 物流公司运单号
  • item_request_list
  • OrderLogisticsPackageItemInfo []
  • 可选
  • 包裹中商品信息
  • └ quantity
  • Number
  • 可选
  • 1
  • 数量
  • └ outer_item_id
  • String
  • 可选
  • esd0001
  • 商品外部id
  • └ sub_order_code
  • String
  • 可选
  • DF2405945988099116940
  • 子订单号
  • └ order_code
  • String
  • 可选
  • DF2405945988099116940
  • 主订单号
  • └ item_id
  • String
  • 可选
  • 649278169972
  • 商品id
  • └ seller_id
  • Number
  • 必须
  • 2001010101
  • 卖家id
  • └ external_msg
  • String
  • 可选
  • {"k":"v"}
  • 扩展信息
  • └ order_code
  • String
  • 必须
  • DF2405945988099116940
  • 主订单号
  • └ order_confirm_time
  • Number
  • 必须
  • 1641889290000
  • 订单确认时间
  • └ lg_order_code
  • String
  • 可选
  • LP00491829777067
  • 履约单号
  • └ outer_order_code
  • String
  • 可选
  • xxxxx
  • 外部系统订单id

响应参数

名称 类型 示例值 描述
code_value Number 0 错误码
message String success 错误信息
result Boolean true 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDutyfreeLogisticsPackageSyncRequest req = new AlibabaDutyfreeLogisticsPackageSyncRequest();
AlibabaDutyfreeLogisticsPackageSyncRequest.OrderLogisticsPackageSyncRequest obj1 = new AlibabaDutyfreeLogisticsPackageSyncRequest.OrderLogisticsPackageSyncRequest();
List<AlibabaDutyfreeLogisticsPackageSyncRequest.OrderLogisticsPackageInfo> list3 = new ArrayList<AlibabaDutyfreeLogisticsPackageSyncRequest.OrderLogisticsPackageInfo>();
AlibabaDutyfreeLogisticsPackageSyncRequest.OrderLogisticsPackageInfo obj4 = new AlibabaDutyfreeLogisticsPackageSyncRequest.OrderLogisticsPackageInfo();
list3.add(obj4);
obj4.setTmsCode("ZTO");
obj4.setTmsOrderCode("77113671272624");
List<AlibabaDutyfreeLogisticsPackageSyncRequest.OrderLogisticsPackageItemInfo> list7 = new ArrayList<AlibabaDutyfreeLogisticsPackageSyncRequest.OrderLogisticsPackageItemInfo>();
AlibabaDutyfreeLogisticsPackageSyncRequest.OrderLogisticsPackageItemInfo obj8 = new AlibabaDutyfreeLogisticsPackageSyncRequest.OrderLogisticsPackageItemInfo();
list7.add(obj8);
obj8.setQuantity(1L);
obj8.setOuterItemId("esd0001");
obj8.setSubOrderCode("DF2405945988099116940");
obj8.setOrderCode("DF2405945988099116940");
obj8.setItemId("649278169972");
list5.setItemRequestList(list7);
obj1.setPackageInfoRequestList(list3);
obj1.setSellerId(2001010101L);
obj1.setExternalMsg("{\"k\":\"v\"}");
obj1.setOrderCode("DF2405945988099116940");
obj1.setOrderConfirmTime(1641889290000L);
obj1.setLgOrderCode("LP00491829777067");
obj1.setOuterOrderCode("xxxxx");
req.setOrderLogisticsPackageSyncRequest(obj1);
AlibabaDutyfreeLogisticsPackageSyncResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_dutyfree_logistics_package_sync_response>
    <code_value>0</code_value>
    <message>success</message>
    <result>true</result>
</alibaba_dutyfree_logistics_package_sync_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部