注意:以下文档只适用于TOP接口,请谨慎使用!

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

taobao.uop.logistics.order.report (ERP订单状态回告接口)

ERP订单状态回告接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
erp_synergy_callback_req_dto ErpMerchantCallbackReqDTO 必须 ERP订单状态回告入参
  • order_details
  • SubOrderDTO []
  • 可选
  • ERP子订单状态回告入参
  • ERP子订单状态回告入参
  • └ item_id
  • Number
  • 可选
  • 121211
  • 商品id
  • └ estimated_delivery_time
  • String
  • 可选
  • 2026-05-13 20:00:00
  • 预计送达时间
  • └ exception_reason
  • String
  • 可选
  • 商品缺货
  • 异常原因
  • └ sub_trade_order_status
  • String
  • 可选
  • WAIT_BUYER_CONFIRM_GOODS
  • 子交易单状态
  • └ sub_trade_order_code
  • String
  • 可选
  • T20260513123456789
  • 子交易单号
  • └ status_update_time
  • String
  • 可选
  • 2026-05-13 20:00:00
  • 状态更新时间(格式:yyyy-MM-dd HH:mm:ss)
  • └ order_status
  • String
  • 必须
  • WAIT_SELLER_SEND_GOODS
  • 主交易单状态
  • └ exception_reason
  • String
  • 可选
  • 物流延迟
  • 异常原因
  • └ trade_order_code
  • String
  • 必须
  • T20260513987654321
  • 主交易单号
  • └ tracking_number
  • String
  • 可选
  • SF123456789CN
  • 运单号
  • └ status_update_time
  • String
  • 必须
  • 2026-05-13 20:00:00
  • 状态更新时间(格式:yyyy-MM-dd HH:mm:ss)
  • └ extend_fields
  • String
  • 可选
  • 扩展属性

响应参数

名称 类型 示例值 描述
result SingleResultDTO 商家ERP系统向平台回告订单作业进度状态,平台返回结果
  • └ is_retry
  • Boolean
  • false
  • 是否需要重试
  • └ error_desc
  • String
  • UOP履约服务单更新失败
  • 异常枚举描述
  • └ success
  • Boolean
  • true
  • 执行结果
  • └ is_idempotent
  • Boolean
  • false
  • 当前请求是否被幂等
  • └ error_code
  • String
  • UOP_UPDATE_UOP_SVC_ORDER_ERROR
  • 异常枚举Code

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UopLogisticsOrderReportRequest req = new UopLogisticsOrderReportRequest();
UopLogisticsOrderReportRequest.ErpMerchantCallbackReqDTO obj1 = new UopLogisticsOrderReportRequest.ErpMerchantCallbackReqDTO();
List<UopLogisticsOrderReportRequest.SubOrderDTO> list3 = new ArrayList<UopLogisticsOrderReportRequest.SubOrderDTO>();
UopLogisticsOrderReportRequest.SubOrderDTO obj4 = new UopLogisticsOrderReportRequest.SubOrderDTO();
list3.add(obj4);
obj4.setItemId(121211L);
obj4.setEstimatedDeliveryTime("2026-05-13 20:00:00");
obj4.setExceptionReason("商品缺货");
obj4.setSubTradeOrderStatus("WAIT_BUYER_CONFIRM_GOODS");
obj4.setSubTradeOrderCode("T20260513123456789");
obj4.setStatusUpdateTime("2026-05-13 20:00:00");
obj1.setOrderDetails(list3);
obj1.setOrderStatus("WAIT_SELLER_SEND_GOODS");
obj1.setExceptionReason("物流延迟");
obj1.setTradeOrderCode("T20260513987654321");
obj1.setTrackingNumber("SF123456789CN");
obj1.setStatusUpdateTime("2026-05-13 20:00:00");
obj1.setExtendFields("");
req.setErpSynergyCallbackReqDto(obj1);
UopLogisticsOrderReportResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<uop_logistics_order_report_response>
    <result>
        <is_retry>false</is_retry>
        <error_desc>UOP履约服务单更新失败</error_desc>
        <success>true</success>
        <is_idempotent>false</is_idempotent>
        <error_code>UOP_UPDATE_UOP_SVC_ORDER_ERROR</error_code>
    </result>
</uop_logistics_order_report_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

返回
顶部