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

taobao.logistics.express.bill.reversal (账单红冲)

账单红冲

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tms_bill_reversal_request TmsBillReversalRequest 可选 请求参数
  • └ service_type
  • String
  • 必须
  • 15
  • 服务类型
  • └ mail_no
  • String
  • 必须
  • SF2344
  • 运单号
  • └ reversal_reason
  • String
  • 必须
  • 顺丰已经收费的运单号
  • 红冲原因
  • └ feature
  • String
  • 必须
  • {"collect_time":"2026-12-23 00:00:00"}
  • 扩展属性
  • └ biz_code
  • String
  • 必须
  • MFU23434
  • 业务单号
  • └ tms_cp_code
  • String
  • 必须
  • SF
  • 资源编码
  • related_mail_details
  • MailDetailDTO []
  • 可选
  • 子母件
  • └ mail_no
  • String
  • 可选
  • SF342434
  • 运单号
  • └ mail_type
  • String
  • 可选
  • parent
  • 子母件类型,母件:parent,子件:child

响应参数

名称 类型 示例值 描述
result ResultDTO 返回值
  • └ biz_error_msg
  • String
  • 系统错误
  • 错误原因描述
  • └ success
  • Boolean
  • true
  • 系统成功是失败
  • └ retry
  • Boolean
  • false
  • 是否需要重试
  • └ biz_error_code
  • String
  • SYSTEM_ERROR
  • 错误原因编码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LogisticsExpressBillReversalRequest req = new LogisticsExpressBillReversalRequest();
LogisticsExpressBillReversalRequest.TmsBillReversalRequest obj1 = new LogisticsExpressBillReversalRequest.TmsBillReversalRequest();
obj1.setServiceType("15");
obj1.setMailNo("SF2344");
obj1.setReversalReason("顺丰已经收费的运单号");
obj1.setFeature("{\"collect_time\":\"2026-12-23 00:00:00\"}");
obj1.setBizCode("MFU23434");
obj1.setTmsCpCode("SF");
List<LogisticsExpressBillReversalRequest.MailDetailDTO> list3 = new ArrayList<LogisticsExpressBillReversalRequest.MailDetailDTO>();
LogisticsExpressBillReversalRequest.MailDetailDTO obj4 = new LogisticsExpressBillReversalRequest.MailDetailDTO();
list3.add(obj4);
obj4.setMailNo("SF342434");
obj4.setMailType("parent");
obj1.setRelatedMailDetails(list3);
req.setTmsBillReversalRequest(obj1);
LogisticsExpressBillReversalResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<logistics_express_bill_reversal_response>
    <result>
        <biz_error_msg>系统错误</biz_error_msg>
        <success>true</success>
        <retry>false</retry>
        <biz_error_code>SYSTEM_ERROR</biz_error_code>
    </result>
</logistics_express_bill_reversal_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

返回
顶部