文档中心 > API类目 > 淘天物流API

taobao.logistics.mail.return.service (服务商撤销单回传)

服务商撤销单回传

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
logistics_order_sync_request LogisticsOrderSyncRequestDTO 必须 参数信息
  • └ subscriber_supplier_id
  • String
  • 可选
  • 123
  • 商家订阅id
  • └ provider_supplier_id
  • String
  • 必须
  • 10200311582310593
  • 淘天物流服务商ID
  • └ cp_code
  • String
  • 必须
  • SF
  • 服务商配资源唯一编码
  • └ mail_no
  • String
  • 必须
  • SF3235525235
  • 运单号
  • └ action_type
  • String
  • 必须
  • Reversal
  • 业务类型:冲销,"Reversal"
  • └ action_time
  • String
  • 必须
  • 2025-05-13 19:34:15
  • 业务发生时间
  • └ action_sub_type
  • String
  • 必须
  • 1
  • 业务子类型,"1",商家取消 "2",小哥取消 "3",装车前揽收网点原地址退回

响应参数

名称 类型 示例值 描述
is_retry Boolean true 是否需要重试
biz_code String SF3235525235_2025-05-13 19:34:15 唯一标识单号(运单号+时间)
suc Boolean true 系统成功失败 true|false
biz_error_code String 1000 错误码
biz_error_message String 单据不存在 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LogisticsMailReturnServiceRequest req = new LogisticsMailReturnServiceRequest();
LogisticsMailReturnServiceRequest.LogisticsOrderSyncRequestDTO obj1 = new LogisticsMailReturnServiceRequest.LogisticsOrderSyncRequestDTO();
obj1.setSubscriberSupplierId("123");
obj1.setProviderSupplierId("10200311582310593");
obj1.setCpCode("SF");
obj1.setMailNo("SF3235525235");
obj1.setActionType("Reversal");
obj1.setActionTime("2025-05-13 19:34:15");
obj1.setActionSubType("1");
req.setLogisticsOrderSyncRequest(obj1);
LogisticsMailReturnServiceResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<logistics_mail_return_service_response>
    <is_retry>true</is_retry>
    <biz_code>SF3235525235_2025-05-13 19:34:15</biz_code>
    <suc>true</suc>
    <biz_error_code>1000</biz_error_code>
    <biz_error_message>单据不存在</biz_error_message>
</logistics_mail_return_service_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

返回
顶部