文档中心 > API类目 > 天猫供应链

taobao.logistics.provider.work.order.sync (物流服务商工单同步淘天接口)

物流服务商工单同步淘天接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
work_order_sync_request WorkOrderSyncDTO 必须 服务商同步工单对象
  • └ provider_order_create_time
  • Date
  • 必须
  • 2024-11-22 00:00:00
  • 服务商内部单据创建时间
  • └ provider_order_code
  • String
  • 必须
  • 123456
  • 服务商内部单据号
  • └ tt_logistics_order_type
  • Number
  • 可选
  • 1
  • 关联的淘天单据类型
  • └ provider_order_expire_time
  • Date
  • 可选
  • 2024-11-22 00:00:00
  • 服务商内部单据到期时间
  • └ provider_order_update_time
  • Date
  • 必须
  • 2024-11-22 00:00:00
  • 服务商内部单据更新时间
  • └ provider_order_customer_type
  • Number
  • 可选
  • 1
  • 服务商内部单据发起方
  • structural_reply
  • StructuralReply
  • 可选
  • 结构化回复内容
  • reply_supplements
  • ReplySupplement []
  • 可选
  • 补充回复
  • 补充回复
  • └ field_name
  • String
  • 可选
  • pickupDate
  • 补充回复字段名
  • └ field_value
  • String
  • 可选
  • YYYY-MM-DD HH:MM:SS
  • 补充回复字段值
  • └ reply_value
  • Number
  • 可选
  • 1
  • 一级结构化回复
  • └ service_code
  • String
  • 必须
  • 催派送
  • 服务类型编码
  • └ tt_logistics_order_code
  • String
  • 可选
  • LW123456
  • 关联的淘天单据号
  • └ provider_order_type
  • Number
  • 必须
  • 1
  • 服务商内部单据类型
  • └ biz_order_code
  • String
  • 必须
  • 123456
  • 业务单号
  • └ biz_order_type
  • Number
  • 必须
  • 1
  • 业务单据类型
  • └ idempotent_id
  • String
  • 必须
  • 12345
  • 幂等键
  • └ extension
  • String
  • 可选
  • {key:value}
  • 扩展信息,实际为Map

响应参数

名称 类型 示例值 描述
work_order_sync_response DataResult 处理结果
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ error_code
  • String
  • "PARAM_ERROR"
  • 参数错误编码
  • └ error_msg
  • String
  • "业务参数错误"
  • 参数错误

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LogisticsProviderWorkOrderSyncRequest req = new LogisticsProviderWorkOrderSyncRequest();
LogisticsProviderWorkOrderSyncRequest.WorkOrderSyncDTO obj1 = new LogisticsProviderWorkOrderSyncRequest.WorkOrderSyncDTO();
obj1.setProviderOrderCreateTime(StringUtils.parseDateTime("2024-11-22 00:00:00"));
obj1.setProviderOrderCode("123456");
obj1.setTtLogisticsOrderType(1L);
obj1.setProviderOrderExpireTime(StringUtils.parseDateTime("2024-11-22 00:00:00"));
obj1.setProviderOrderUpdateTime(StringUtils.parseDateTime("2024-11-22 00:00:00"));
obj1.setProviderOrderCustomerType(1L);
LogisticsProviderWorkOrderSyncRequest.StructuralReply obj2 = new LogisticsProviderWorkOrderSyncRequest.StructuralReply();
List<LogisticsProviderWorkOrderSyncRequest.ReplySupplement> list4 = new ArrayList<LogisticsProviderWorkOrderSyncRequest.ReplySupplement>();
LogisticsProviderWorkOrderSyncRequest.ReplySupplement obj5 = new LogisticsProviderWorkOrderSyncRequest.ReplySupplement();
list4.add(obj5);
obj5.setFieldName("pickupDate");
obj5.setFieldValue("YYYY-MM-DD HH:MM:SS");
obj2.setReplySupplements(list4);
obj2.setReplyValue(1L);
obj1.setStructuralReply(obj2);
obj1.setServiceCode("催派送");
obj1.setTtLogisticsOrderCode("LW123456");
obj1.setProviderOrderType(1L);
obj1.setBizOrderCode("123456");
obj1.setBizOrderType(1L);
obj1.setIdempotentId("12345");
obj1.setExtension("{key:value}");
req.setWorkOrderSyncRequest(obj1);
LogisticsProviderWorkOrderSyncResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<logistics_provider_work_order_sync_response>
    <work_order_sync_response>
        <success>true</success>
        <error_code>&quot;PARAM_ERROR&quot;</error_code>
        <error_msg>&quot;业务参数错误&quot;</error_msg>
    </work_order_sync_response>
</logistics_provider_work_order_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

返回
顶部