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

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

taobao.logistics.reverseorder.erp.search (ERP销退单查询接口)

ERP销退单查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_erp_search_reverse_orders_request ErpSearchReverseOrdersRequest 必须 搜索请求
  • └ end_modified_time
  • Date
  • 可选
  • 2024-03-28 10:05:00
  • 销退单最后修改时间查询条件的结束时间
  • └ extend_fields
  • String
  • 可选
  • {"key":"value"}
  • 扩展字段
  • └ page_no
  • Number
  • 可选
  • 1
  • 分页信息
  • └ page_size
  • Number
  • 可选
  • 20
  • 分页大小
  • └ start_modified_time
  • Date
  • 可选
  • 2024-03-28 10:00:00
  • 销退单最后修改时间查询条件的开始时间
  • └ trade_ids
  • String []
  • 可选
  • 3858105060593440211
  • 交易订单ID
  • └ wlb_order_code_list
  • String []
  • 可选
  • msc8594362
  • 逆向仓储单号
  • └ lg_order_code_list
  • String []
  • 可选
  • LP00641742134783
  • 逆向物流单号
param_erp_search_reverse_orders_option ErpSearchReverseOrdersOption 必须 搜索查询选项
  • └ filter_discard_status
  • Boolean
  • 可选
  • true
  • 是否过滤废弃单据
  • └ query_order_item
  • Boolean
  • 可选
  • false
  • 是否查询对应的明细
  • └ query_order_return_item
  • Boolean
  • 可选
  • false
  • 是否查询对应的二级明细

响应参数

名称 类型 示例值 描述
result PaginationResult 结果
  • └ error_desc
  • String
  • 错误描述
  • 错误描述
  • └ total_page
  • Number
  • 1
  • 总页数
  • └ start
  • Number
  • 0
  • 记录偏移量
  • └ error_code
  • String
  • 错误码
  • 错误码
  • └ total_count
  • Number
  • 1o
  • 总数
  • data_list
  • ErpFullReverseOrderViewDTO []
  • 数据列表
  • reverse_order
  • ErpReverseOrderViewDTO
  • 销退单主单
  • └ order_code
  • String
  • RBMS500245575525
  • 销退单单号
  • └ order_status
  • Number
  • 900
  • 系统状态->100 待下发状态 200 下发履行成功状态 300 配作业状态 400 仓作业状态 500 二次入区状态 900 完结状态
  • └ biz_order_status
  • Number
  • 900120
  • 业务状态->创建 100101L 问题订单 100115L 待人工审核 100155L 待合单决策 100161L 待合单 100165L 待下发 100181L 下发履行成功状态 下发履行成功 200105L 配作业状态 配接单 300105L 已预约 300125L 预约异常 300130L 取件成功 300165L 城市中转仓入库 300205L 退供审核 300215L 待中转仓出库 300225L 城市中转仓出库成功 300235L 仓作业状态 仓接单(等待退货到仓) 400105L 退货已到仓 400125L 质检完成/收货 400145L 区外仓调拨上架 400165L 二次入区状态 区外仓调拨出库 500105L 清关成功 500125L 清关失败 500130L 调拨入区内仓-仓配交接 500135L 完结状态 退货完成 900110L 取消 900120L 仓拒收 900130L 取件失败 900140L 调拨入区外仓 900150L 保税仓调拨入库 900160L
  • └ mail_no
  • String
  • SF1625376886261
  • 运单号
  • └ wlb_order_code
  • String
  • MSC1234
  • 逆向仓储单号
  • └ tms_code
  • String
  • ZTO
  • 配送公司编码
  • └ prev_scp_ordercode
  • String
  • SCP517763310739
  • 正向履约单号
  • └ return_type
  • Number
  • 1
  • 销退类型->(1, "客退") (2, "运配异常") (3, "拒签退回") (4, "拦截退回") (5, "上门取退") (6, "清关退运")
  • └ source_biz
  • Number
  • 1
  • 业务来源->(1 "手工创建") (2 "退款自动创建") (3 "拒签自动创建") (4 "拦截自动创建") (5 "无指令登记自动创建") (6 "配送异常退回自动创建") (7 "外部系统创建") (8 "下游拉单创建") (9 "ERP推单创建") (10 "正向清关失败退回") (-1 "历史迁移数据") (-2 "历史多段退数据") (11 "跨租户协同调用创建") (12 "渠道推单创建")
  • └ gmt_modified
  • Date
  • 2024-03-28 10:05:00
  • 修改时间
  • └ owner_id
  • Number
  • 271188
  • 货主
  • └ seller_id
  • Number
  • 27118808
  • 卖家
  • └ store_code
  • String
  • HKG026
  • 退货仓code
  • └ trade_id
  • String
  • 3859463125749204704
  • 交易单号
  • └ fulfil_time_info
  • String
  • {"key":"value"}
  • 履行时间-> key(含义) WMS_ACCEPT(仓接单) WMS_ARRIVE(到仓) CUSTOMS_REFUND_AUDIT_SUCCESS(逆向海关通过) WMS_ON_SHELF(仓上架) EXTERNAL_WMS_OUT(区外仓出库) BONDED_RETURN_IN(保税仓入库) SEND_FULFIL(下发履行) -> value 为时间戳
  • └ feature_map
  • String
  • {"key":"value"}
  • g_logistics:物流模式 tc_order_id:2C交易订单 distributorId:分销商ID distributorNick:分销商名称 distributeMode:银河 fxBizCode:淘分销 scpMergeFlag:合单 preLgOrderCode:正向发货LP cancelReason:取消原因 signRejectReason:拒收原因 receiveFailReason:收货失败原因 closeOrderReason:关单原因 picUrls:仓库回传验货图片 manualRemark:备注
  • └ lg_order_code
  • String
  • LP00645973971612
  • 逆向物流订单号
  • └ gmt_create
  • Date
  • 2024-03-28 10:05:00
  • 创建时间
  • └ biz_error_code
  • String
  • RPC_REVERSE_ERROR
  • 业务错误码
  • └ biz_error_message
  • String
  • 下发履行异常
  • 系统错误信息
  • reverse_order_item_list
  • ErpReverseOrderItemViewDTO []
  • 销退单明细
  • └ sub_trade_id
  • String
  • 3858105060593440211
  • 子交易单id
  • └ sc_item_id
  • Number
  • 4066234693
  • 货品id
  • └ sc_item_code
  • String
  • xc2434
  • 货品code
  • └ sc_item_name
  • String
  • 晕船药咀嚼片
  • 后端货品名称
  • └ bar_code
  • String
  • 754hg2374h7
  • 条形码
  • └ plan_quantity
  • Number
  • 1
  • 计划数量
  • └ real_quantity
  • Number
  • 1
  • 实际上架数量
  • └ damage_quantity
  • Number
  • 1
  • 残品数量
  • reverse_order_return_item_list
  • ErpReverseOrderReturnItemViewDTO []
  • 1
  • 销退二级明细
  • └ inventory_type
  • Number
  • 1
  • 库存类型
  • └ quantity
  • Number
  • 1
  • 数量
  • └ feature_map
  • String
  • {"key":"value"}
  • 扩展字段
  • └ feature_map
  • String
  • {"key":"value"}
  • tc_order_id:2C交易订单 tc_suborder_id:2C交易子订单 refundReason:退货原因 refundReasonId:退货原因ID
  • └ trade_id
  • String
  • 3849545271534806707
  • 交易单号
  • └ id
  • Number
  • 500282613538
  • 明细主键id
  • └ combine_item_id
  • Number
  • 746347738
  • 组合货品主品Id
  • └ combine_item_name
  • String
  • 小样
  • 组合货品主品名称
  • └ combine_qty
  • Number
  • 1
  • 组合货品交易下单数量
  • └ item_id
  • Number
  • 32785
  • 前端商品Id
  • └ item_code
  • String
  • sn2342
  • 前端商品Code
  • └ item_name
  • String
  • 洗面奶
  • 前端商品名称
  • └ sku_id
  • Number
  • 1234
  • skuId
  • └ request_success
  • Boolean
  • true
  • 调用是否成功
  • └ limit
  • Number
  • 1
  • 本次分页查询的数量限制

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LogisticsReverseorderErpSearchRequest req = new LogisticsReverseorderErpSearchRequest();
LogisticsReverseorderErpSearchRequest.ErpSearchReverseOrdersRequest obj1 = new LogisticsReverseorderErpSearchRequest.ErpSearchReverseOrdersRequest();
obj1.setEndModifiedTime(StringUtils.parseDateTime("2024-03-28 10:05:00"));
obj1.setExtendFields("{\"key\":\"value\"}");
obj1.setPageNo(1L);
obj1.setPageSize(20L);
obj1.setStartModifiedTime(StringUtils.parseDateTime("2024-03-28 10:00:00"));
obj1.setTradeIds("3858105060593440211");
obj1.setWlbOrderCodeList("msc8594362");
obj1.setLgOrderCodeList("LP00641742134783");
req.setParamErpSearchReverseOrdersRequest(obj1);
LogisticsReverseorderErpSearchRequest.ErpSearchReverseOrdersOption obj2 = new LogisticsReverseorderErpSearchRequest.ErpSearchReverseOrdersOption();
obj2.setFilterDiscardStatus(true);
obj2.setQueryOrderItem(false);
obj2.setQueryOrderReturnItem(false);
req.setParamErpSearchReverseOrdersOption(obj2);
LogisticsReverseorderErpSearchResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<logistics_reverseorder_erp_search_response>
    <result>
        <error_desc>错误描述</error_desc>
        <total_page>1</total_page>
        <start>0</start>
        <error_code>错误码</error_code>
        <total_count>1o</total_count>
        <data_list>
            <erp_full_reverse_order_view_d_t_o>
                <reverse_order>
                    <order_code>RBMS500245575525</order_code>
                    <order_status>900</order_status>
                    <biz_order_status>900120</biz_order_status>
                    <mail_no>SF1625376886261</mail_no>
                    <wlb_order_code>MSC1234</wlb_order_code>
                    <tms_code>ZTO</tms_code>
                    <prev_scp_ordercode>SCP517763310739</prev_scp_ordercode>
                    <return_type>1</return_type>
                    <source_biz>1</source_biz>
                    <gmt_modified>2024-03-28 10:05:00</gmt_modified>
                    <owner_id>271188</owner_id>
                    <seller_id>27118808</seller_id>
                    <store_code>HKG026</store_code>
                    <trade_id>3859463125749204704</trade_id>
                    <fulfil_time_info>{&quot;key&quot;:&quot;value&quot;}</fulfil_time_info>
                    <feature_map>{&quot;key&quot;:&quot;value&quot;}</feature_map>
                    <lg_order_code>LP00645973971612</lg_order_code>
                    <gmt_create>2024-03-28 10:05:00</gmt_create>
                    <biz_error_code>RPC_REVERSE_ERROR</biz_error_code>
                    <biz_error_message>下发履行异常</biz_error_message>
                </reverse_order>
                <reverse_order_item_list>
                    <erp_reverse_order_item_view_d_t_o>
                        <sub_trade_id>3858105060593440211</sub_trade_id>
                        <sc_item_id>4066234693</sc_item_id>
                        <sc_item_code>xc2434</sc_item_code>
                        <sc_item_name>晕船药咀嚼片</sc_item_name>
                        <bar_code>754hg2374h7</bar_code>
                        <plan_quantity>1</plan_quantity>
                        <real_quantity>1</real_quantity>
                        <damage_quantity>1</damage_quantity>
                        <reverse_order_return_item_list>
                            <erp_reverse_order_return_item_view_d_t_o>
                                <inventory_type>1</inventory_type>
                                <quantity>1</quantity>
                                <feature_map>{&quot;key&quot;:&quot;value&quot;}</feature_map>
                            </erp_reverse_order_return_item_view_d_t_o>
                        </reverse_order_return_item_list>
                        <feature_map>{&quot;key&quot;:&quot;value&quot;}</feature_map>
                        <trade_id>3849545271534806707</trade_id>
                        <id>500282613538</id>
                        <combine_item_id>746347738</combine_item_id>
                        <combine_item_name>小样</combine_item_name>
                        <combine_qty>1</combine_qty>
                        <item_id>32785</item_id>
                        <item_code>sn2342</item_code>
                        <item_name>洗面奶</item_name>
                        <sku_id>1234</sku_id>
                    </erp_reverse_order_item_view_d_t_o>
                </reverse_order_item_list>
            </erp_full_reverse_order_view_d_t_o>
        </data_list>
        <request_success>true</request_success>
        <limit>1</limit>
    </result>
</logistics_reverseorder_erp_search_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

返回
顶部