淘宝开放平台

登录
文档中心 > API类目 > 新零售供应链API

新零售供应链API

alibaba.ascp.uop.supplier.reverseorder.create (商家ERP发起创建销退单服务)

商家在收到消费者实物退货后，在ERP发起创建销退单服务

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
reverse_create_request ReverseCreateRequest 可选 逆向销退单创建请求
  • └ supplier_id
  • String
  • 必须
  • 111222
  • 供应商id
  • └ out_biz_id
  • String
  • 必须
  • xfyyy00
  • ERP业务编码
  • └ reverse_type
  • String
  • 可选
  • 1
  • 逆向类型:1=客退;2=运配异常;3=拒签退回;4=拦截退回;5=上门取退
  • └ biz_order_code
  • String
  • 必须
  • LP00001
  • 原正向发货履约主单号
  • └ tms_service_code
  • String
  • 必须
  • SF
  • 快递公司code.调用 taobao.logistics.companies.get 获取
  • └ tms_order_code
  • String
  • 必须
  • 1122333432
  • 运单号
  • receiver_info
  • Receiverinfo
  • 必须
  • a
  • 退回收件人信息（商家）
  • └ receiver_email
  • String
  • 可选
  • 11@test.com
  • 电子邮箱
  • └ receiver_phone
  • String
  • 可选
  • 0571-888888888
  • 收件人固定电话
  • └ receiver_mobile
  • String
  • 必须
  • 13800000000
  • 收件人移动电话
  • └ receiver_name
  • String
  • 必须
  • 老王
  • 收件人姓名
  • └ receiver_address
  • String
  • 可选
  • 文一西路969号
  • 详细地址
  • └ receiver_town
  • String
  • 可选
  • 五常
  • 城镇
  • └ receiver_area
  • String
  • 必须
  • 余杭
  • 区域
  • └ receiver_city
  • String
  • 必须
  • 杭州
  • 城市
  • └ receiver_province
  • String
  • 必须
  • 浙江
  • 省份
  • └ receiver_country
  • String
  • 必须
  • 中国
  • 国家
  • └ receiver_zip_code
  • String
  • 必须
  • 320000
  • 邮编
  • sender_info
  • Senderinfo
  • 必须
  • a
  • 退回寄件人信息（消费者）
  • └ sender_phone
  • String
  • 可选
  • 0571-888888888
  • 寄件人固定电话
  • └ sender_mobile
  • String
  • 可选
  • 13800000000
  • 寄件人移动电话
  • └ sender_name
  • String
  • 必须
  • 老三
  • 寄件人姓名
  • └ sender_address
  • String
  • 可选
  • 文一西路969号
  • 详细地址
  • └ sender_town
  • String
  • 可选
  • 五常
  • 城镇
  • └ sender_area
  • String
  • 必须
  • 余杭
  • 区域
  • └ sender_city
  • String
  • 必须
  • 杭州
  • 城市
  • └ sender_province
  • String
  • 必须
  • 浙江
  • 省份
  • └ sender_country
  • String
  • 必须
  • 中国
  • 国家
  • └ sender_zip_code
  • String
  • 必须
  • 320000
  • 邮编
  • order_items
  • Orderitems []
  • 可选
  • a
  • 退回订单货品信息列表
  • └ erp_order_line
  • String
  • 可选
  • werwqeq
  • erp订单明细行号
  • └ sub_order_code
  • String
  • 必须
  • 009988
  • 原正向发货履约子单号
  • └ sc_item_id
  • String
  • 必须
  • 999988
  • 货品id
  • └ plan_return_quantity
  • Number
  • 必须
  • 1
  • 货品计划退回数量
  • └ store_code
  • String
  • 必须
  • st_0001
  • 退回仓编码

响应参数

名称 类型 示例值 描述
reverse_create_response ResultWrapper a 返回值包装,result为返回具体消息内容
  • └ success
  • Boolean
  • true
  • 返回是否成功
  • └ error_code
  • String
  • a
  • 系统自动生成
  • └ error_message
  • String
  • a
  • 系统自动生成
  • data
  • DataMap
  • a
  • 业务数据
  • └ idempotent_reason
  • String
  • ERP创单外部单号重复
  • 幂等原因

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAscpUopSupplierReverseorderCreateRequest req = new AlibabaAscpUopSupplierReverseorderCreateRequest();
AlibabaAscpUopSupplierReverseorderCreateRequest.ReverseCreateRequest obj1 = new AlibabaAscpUopSupplierReverseorderCreateRequest.ReverseCreateRequest();
obj1.setSupplierId("111222");
obj1.setOutBizId("xfyyy00");
obj1.setReverseType("1");
obj1.setBizOrderCode("LP00001");
obj1.setTmsServiceCode("SF");
obj1.setTmsOrderCode("1122333432");
AlibabaAscpUopSupplierReverseorderCreateRequest.Receiverinfo obj2 = new AlibabaAscpUopSupplierReverseorderCreateRequest.Receiverinfo();
obj2.setReceiverEmail("11@test.com");
obj2.setReceiverPhone("0571-888888888");
obj2.setReceiverMobile("13800000000");
obj2.setReceiverName("老王");
obj2.setReceiverAddress("文一西路969号");
obj2.setReceiverTown("五常");
obj2.setReceiverArea("余杭");
obj2.setReceiverCity("杭州");
obj2.setReceiverProvince("浙江");
obj2.setReceiverCountry("中国");
obj2.setReceiverZipCode("320000");
obj1.setReceiverInfo(obj2);
AlibabaAscpUopSupplierReverseorderCreateRequest.Senderinfo obj3 = new AlibabaAscpUopSupplierReverseorderCreateRequest.Senderinfo();
obj3.setSenderPhone("0571-888888888");
obj3.setSenderMobile("13800000000");
obj3.setSenderName("老三");
obj3.setSenderAddress("文一西路969号");
obj3.setSenderTown("五常");
obj3.setSenderArea("余杭");
obj3.setSenderCity("杭州");
obj3.setSenderProvince("浙江");
obj3.setSenderCountry("中国");
obj3.setSenderZipCode("320000");
obj1.setSenderInfo(obj3);
List<AlibabaAscpUopSupplierReverseorderCreateRequest.Orderitems> list5 = new ArrayList<AlibabaAscpUopSupplierReverseorderCreateRequest.Orderitems>();
AlibabaAscpUopSupplierReverseorderCreateRequest.Orderitems obj6 = new AlibabaAscpUopSupplierReverseorderCreateRequest.Orderitems();
list5.add(obj6);
obj6.setErpOrderLine("werwqeq");
obj6.setSubOrderCode("009988");
obj6.setScItemId("999988");
obj6.setPlanReturnQuantity(1L);
obj1.setOrderItems(list5);
obj1.setStoreCode("st_0001");
req.setReverseCreateRequest(obj1);
AlibabaAscpUopSupplierReverseorderCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
<alibaba_ascp_uop_supplier_reverseorder_create_response>
    <reverse_create_response>
        <success>true</success>
        <error_code>a</error_code>
        <error_message>a</error_message>
        <data>
            <idempotent_reason>ERP创单外部单号重复</idempotent_reason>
        </data>
    </reverse_create_response>
</alibaba_ascp_uop_supplier_reverseorder_create_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部