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

文档中心 > API类目 > 阿里健康API

alibaba.alihealth.wms.returnorder.confirm (销退入库上架回告)

销退逆向的包裹退回到仓库后,仓库做上架回传。注意:不支持分批次部分上架。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
returnorder_confirm_request ReturnorderConfirmRequest 可选 退货入库单确认请求
  • order_lines
  • OrderLine []
  • 可选
  • []
  • 订单信息
  • └ actual_price
  • String
  • 可选
  • 100.00
  • 实际价格
  • └ actual_qty
  • String
  • 必须
  • 12
  • 实收商品数量
  • └ amount
  • String
  • 可选
  • 200.00
  • 金额
  • └ batch_code
  • String
  • 可选
  • P123
  • 批次编码
  • batchs
  • Batch []
  • 可选
  • []
  • 批次信息
  • └ actual_qty
  • Number
  • 可选
  • 12
  • 实收数量(要求batchs节点下所有的实收数量之和等于orderline中的实收数量)
  • └ batch_code
  • String
  • 可选
  • P1234
  • 批次编号
  • └ expire_date
  • String
  • 可选
  • 2016-09-09
  • 过期日期(YYYY-MM-DD)
  • └ inventory_type
  • String
  • 可选
  • ZP
  • 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP)
  • └ produce_code
  • String
  • 可选
  • P1234
  • 生产批号
  • └ product_date
  • String
  • 可选
  • 2016-09-09
  • 生产日期(YYYY-MM-DD)
  • └ quantity
  • String
  • 可选
  • 10
  • 数量
  • └ remark
  • String
  • 可选
  • 备注
  • 备注
  • └ color
  • String
  • 可选
  • 红色
  • 颜色
  • └ delivery_order_id
  • String
  • 可选
  • D123456
  • 发货单ID
  • └ discount
  • String
  • 可选
  • 0.9
  • 折扣
  • └ discount_amount
  • String
  • 可选
  • 10.00
  • 折扣金额
  • └ discount_price
  • String
  • 可选
  • 90.00
  • 折后价格
  • └ exception_qty
  • String
  • 可选
  • 0
  • 异常数量
  • └ expire_date
  • String
  • 可选
  • 2016-09-09
  • 过期日期(YYYY-MM-DD)
  • └ ext_code
  • String
  • 可选
  • EXT123
  • 扩展编码
  • └ inventory_type
  • String
  • 可选
  • ZP
  • 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP)
  • └ item_code
  • String
  • 必须
  • I1234
  • 商品编码
  • └ item_id
  • String
  • 可选
  • CK1234
  • 仓储系统商品编码(条件为提供后端(仓储系统)商品编码的仓储系统)
  • └ item_name
  • String
  • 可选
  • iPhone15
  • 商品名称
  • └ location_code
  • String
  • 可选
  • L123
  • 库位编码
  • └ move_in_location
  • String
  • 可选
  • L456
  • 入库库位
  • └ move_out_location
  • String
  • 可选
  • L789
  • 出库库位
  • └ order_line_no
  • String
  • 可选
  • D1234
  • 单据行号
  • └ order_source_code
  • String
  • 可选
  • OS123
  • 订单来源编码
  • └ out_biz_code
  • String
  • 可选
  • xxxxx
  • outBizCode
  • └ owner_code
  • String
  • 必须
  • HZ1234
  • 货主编码
  • └ pay_no
  • String
  • 可选
  • PAY123456
  • 支付单号
  • └ plan_qty
  • Number
  • 必须
  • 12
  • 应收商品数量
  • └ produce_code
  • String
  • 可选
  • P1234
  • 生产批号
  • └ product_code
  • String
  • 可选
  • PC123
  • 商品编码
  • └ product_date
  • String
  • 可选
  • 2016-09-09
  • 生产日期(YYYY-MM-DD)
  • └ purchase_price
  • String
  • 可选
  • 80.00
  • 采购价格
  • └ qr_code
  • String
  • 可选
  • 1;1;1
  • 商品的二维码(类似电子产品的SN码;用来进行商品的溯源;多个二维码之间用分号;隔开)
  • └ quantity
  • String
  • 可选
  • 5
  • 数量
  • └ reference_price
  • String
  • 可选
  • 120.00
  • 参考价格
  • └ remark
  • String
  • 可选
  • 备注
  • 备注
  • └ retail_price
  • String
  • 可选
  • 150.00
  • 零售价格
  • └ settlement_amount
  • String
  • 可选
  • 140.00
  • 结算金额
  • └ size
  • String
  • 可选
  • M
  • 尺寸
  • └ sku_property
  • String
  • 可选
  • 颜色:红;尺寸:M
  • SKU属性
  • sn_list
  • SnList
  • 可选
  • sn列表
  • └ sn
  • String []
  • 可选
  • Top,Pub
  • sn编码
  • └ source_order_code
  • String
  • 可选
  • PO123456
  • 交易平台订单编码
  • └ standard_amount
  • String
  • 可选
  • 130.00
  • 标准金额
  • └ standard_price
  • String
  • 可选
  • 130.00
  • 标准价格
  • └ status
  • String
  • 可选
  • CONFIRMED
  • 状态
  • └ stock_in_qty
  • String
  • 可选
  • 12
  • 入库数量
  • └ stock_out_qty
  • String
  • 可选
  • 0
  • 出库数量
  • └ sub_delivery_order_id
  • String
  • 可选
  • SD123456
  • 子发货单ID
  • └ sub_source_code
  • String
  • 可选
  • SS123
  • 子订单来源编码
  • └ sub_source_order_code
  • String
  • 可选
  • PL1234
  • 交易平台子订单编码
  • └ taobao_item_code
  • String
  • 可选
  • T123456
  • 淘宝商品编码
  • └ warehouse_code
  • String
  • 可选
  • xxxxx
  • warehouseCode
  • return_order
  • ReturnOrder
  • 可选
  • 退货单信息
  • └ action_type
  • String
  • 可选
  • RETURN
  • 操作类型
  • └ buyer_nick
  • String
  • 可选
  • tb123456
  • 买家昵称
  • └ earliest_arrival_time
  • String
  • 可选
  • 2024-01-01 10:00:00
  • 最早到货时间
  • └ express_code
  • String
  • 可选
  • YD1234
  • 运单号
  • └ logistics_code
  • String
  • 必须
  • SF
  • 物流公司编码(SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通、ZTO=中通(ZTO)、HTKY=百世汇通、 UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、 AMAZON=亚马逊物流、OTHER=其他;只传英文编码)
  • └ logistics_name
  • String
  • 可选
  • 顺丰
  • 物流公司名称
  • └ order_confirm_time
  • String
  • 可选
  • 2016-09-09 12:00:00
  • 确认入库时间(YYYY-MM-DD HH:MM:SS)
  • └ order_flag
  • String
  • 可选
  • FLAG123
  • 订单标记
  • └ order_type
  • String
  • 可选
  • THRK
  • 单据类型(THRK=退货入库;HHRK=换货入库;只传英文编码)
  • └ out_biz_code
  • String
  • 可选
  • OZ1234
  • 外部业务编码(消息ID;用于去重;ISV对于同一请求;分配一个唯一性的编码。用来保证因为网络等原因导致重复传输;请求不会 被重复处理)
  • └ owner_code
  • String
  • 可选
  • HZ1234
  • 货主编码
  • └ plan_arrival_time
  • String
  • 可选
  • 2024-01-02 10:00:00
  • 计划到货时间
  • └ pre_delivery_order_code
  • String
  • 可选
  • PD123456
  • 原发货单编码
  • └ pre_delivery_order_id
  • String
  • 可选
  • PID123456
  • 原发货单ID
  • └ ref_order_code
  • String
  • 可选
  • RO123456
  • 关联订单编码
  • └ remark
  • String
  • 可选
  • 备注信息
  • 备注
  • └ return_order_code
  • String
  • 必须
  • R1234
  • ERP的退货入库单编码
  • └ return_order_id
  • String
  • 可选
  • R1234
  • 仓库系统订单编码
  • └ return_order_status
  • String
  • 可选
  • CONFIRMED
  • 退货单状态
  • └ return_reason
  • String
  • 可选
  • 破损退货
  • 退货原因
  • sender_info
  • SenderInfo
  • 可选
  • 发件人信息
  • └ area
  • String
  • 可选
  • 余杭
  • 区域
  • └ birth_date
  • String
  • 可选
  • 1990-01-01
  • 出生日期
  • └ car_no
  • String
  • 可选
  • 浙A12345
  • 车牌号
  • └ career
  • String
  • 可选
  • 工程师
  • 职业
  • └ city
  • String
  • 必须
  • 杭州
  • 城市
  • └ company
  • String
  • 可选
  • 淘宝
  • 公司名称
  • └ country_code
  • String
  • 可选
  • CN
  • 国家代码
  • └ country_code_ciq
  • String
  • 可选
  • CN
  • CIQ国家代码
  • └ country_code_cus
  • String
  • 可选
  • CN
  • 海关国家代码
  • └ detail_address
  • String
  • 必须
  • 杭州市余杭区989号
  • 详细地址
  • └ email
  • String
  • 可选
  • 345@gmail.com
  • 电子邮箱
  • └ fax
  • String
  • 可选
  • 0571-88888888
  • 传真
  • └ gender
  • String
  • 可选
  • 性别
  • └ id
  • String
  • 可选
  • S123456
  • 编号
  • └ id_number
  • String
  • 可选
  • 110101199001011234
  • 证件号码
  • └ id_type
  • String
  • 可选
  • ID_CARD
  • 证件类型
  • └ mobile
  • String
  • 必须
  • 13214567869
  • 移动电话
  • └ name
  • String
  • 必须
  • 老王
  • 姓名
  • └ nick
  • String
  • 可选
  • user123
  • 昵称
  • └ province
  • String
  • 必须
  • 浙江省
  • 省份
  • └ remark
  • String
  • 可选
  • 备注
  • 备注
  • └ tel
  • String
  • 可选
  • 81020340
  • 固定电话
  • └ town
  • String
  • 可选
  • 横加桥
  • 村镇
  • └ zip_code
  • String
  • 可选
  • 043300
  • 邮编
  • └ source_order_code
  • String
  • 可选
  • SO123456
  • 来源订单编码
  • └ supplier_code
  • String
  • 可选
  • SUP123
  • 供应商编码
  • └ supplier_name
  • String
  • 可选
  • 供应商A
  • 供应商名称
  • └ warehouse_code
  • String
  • 必须
  • W1234
  • 仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER)
  • └ extend_props
  • String
  • 可选
  • {}
  • 扩展属性

响应参数

名称 类型 示例值 描述
result ReturnorderConfirmResponse 退货入库单确认响应
  • └ flag
  • String
  • success
  • 响应结果:success|failure
  • └ code
  • String
  • 0
  • 响应码
  • └ message
  • String
  • invalid appkey
  • 响应信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlihealthWmsReturnorderConfirmRequest req = new AlibabaAlihealthWmsReturnorderConfirmRequest();
AlibabaAlihealthWmsReturnorderConfirmRequest.ReturnorderConfirmRequest obj1 = new AlibabaAlihealthWmsReturnorderConfirmRequest.ReturnorderConfirmRequest();
List<AlibabaAlihealthWmsReturnorderConfirmRequest.OrderLine> list3 = new ArrayList<AlibabaAlihealthWmsReturnorderConfirmRequest.OrderLine>();
AlibabaAlihealthWmsReturnorderConfirmRequest.OrderLine obj4 = new AlibabaAlihealthWmsReturnorderConfirmRequest.OrderLine();
list3.add(obj4);
obj4.setActualPrice("100.00");
obj4.setActualQty("12");
obj4.setAmount("200.00");
obj4.setBatchCode("P123");
List<AlibabaAlihealthWmsReturnorderConfirmRequest.Batch> list7 = new ArrayList<AlibabaAlihealthWmsReturnorderConfirmRequest.Batch>();
AlibabaAlihealthWmsReturnorderConfirmRequest.Batch obj8 = new AlibabaAlihealthWmsReturnorderConfirmRequest.Batch();
list7.add(obj8);
obj8.setActualQty(12L);
obj8.setBatchCode("P1234");
obj8.setExpireDate("2016-09-09");
obj8.setInventoryType("ZP");
obj8.setProduceCode("P1234");
obj8.setProductDate("2016-09-09");
obj8.setQuantity("10");
obj8.setRemark("备注");
list5.setBatchs(list7);
obj4.setColor("红色");
obj4.setDeliveryOrderId("D123456");
obj4.setDiscount("0.9");
obj4.setDiscountAmount("10.00");
obj4.setDiscountPrice("90.00");
obj4.setExceptionQty("0");
obj4.setExpireDate("2016-09-09");
obj4.setExtCode("EXT123");
obj4.setInventoryType("ZP");
obj4.setItemCode("I1234");
obj4.setItemId("CK1234");
obj4.setItemName("iPhone15");
obj4.setLocationCode("L123");
obj4.setMoveInLocation("L456");
obj4.setMoveOutLocation("L789");
obj4.setOrderLineNo("D1234");
obj4.setOrderSourceCode("OS123");
obj4.setOutBizCode("xxxxx");
obj4.setOwnerCode("HZ1234");
obj4.setPayNo("PAY123456");
obj4.setPlanQty(12L);
obj4.setProduceCode("P1234");
obj4.setProductCode("PC123");
obj4.setProductDate("2016-09-09");
obj4.setPurchasePrice("80.00");
obj4.setQrCode("1;1;1");
obj4.setQuantity("5");
obj4.setReferencePrice("120.00");
obj4.setRemark("备注");
obj4.setRetailPrice("150.00");
obj4.setSettlementAmount("140.00");
obj4.setSize("M");
obj4.setSkuProperty("颜色:红;尺寸:M");
AlibabaAlihealthWmsReturnorderConfirmRequest.SnList obj10 = new AlibabaAlihealthWmsReturnorderConfirmRequest.SnList();
obj10.setSn("Top,Pub");
list9.setSnList(obj10);
obj4.setSourceOrderCode("PO123456");
obj4.setStandardAmount("130.00");
obj4.setStandardPrice("130.00");
obj4.setStatus("CONFIRMED");
obj4.setStockInQty("12");
obj4.setStockOutQty("0");
obj4.setSubDeliveryOrderId("SD123456");
obj4.setSubSourceCode("SS123");
obj4.setSubSourceOrderCode("PL1234");
obj4.setTaobaoItemCode("T123456");
obj4.setWarehouseCode("xxxxx");
obj1.setOrderLines(list3);
AlibabaAlihealthWmsReturnorderConfirmRequest.ReturnOrder obj11 = new AlibabaAlihealthWmsReturnorderConfirmRequest.ReturnOrder();
obj11.setActionType("RETURN");
obj11.setBuyerNick("tb123456");
obj11.setEarliestArrivalTime("2024-01-01 10:00:00");
obj11.setExpressCode("YD1234");
obj11.setLogisticsCode("SF");
obj11.setLogisticsName("顺丰");
obj11.setOrderConfirmTime("2016-09-09 12:00:00");
obj11.setOrderFlag("FLAG123");
obj11.setOrderType("THRK");
obj11.setOutBizCode("OZ1234");
obj11.setOwnerCode("HZ1234");
obj11.setPlanArrivalTime("2024-01-02 10:00:00");
obj11.setPreDeliveryOrderCode("PD123456");
obj11.setPreDeliveryOrderId("PID123456");
obj11.setRefOrderCode("RO123456");
obj11.setRemark("备注信息");
obj11.setReturnOrderCode("R1234");
obj11.setReturnOrderId("R1234");
obj11.setReturnOrderStatus("CONFIRMED");
obj11.setReturnReason("破损退货");
AlibabaAlihealthWmsReturnorderConfirmRequest.SenderInfo obj12 = new AlibabaAlihealthWmsReturnorderConfirmRequest.SenderInfo();
obj12.setArea("余杭");
obj12.setBirthDate("1990-01-01");
obj12.setCarNo("浙A12345");
obj12.setCareer("工程师");
obj12.setCity("杭州");
obj12.setCompany("淘宝");
obj12.setCountryCode("CN");
obj12.setCountryCodeCiq("CN");
obj12.setCountryCodeCus("CN");
obj12.setDetailAddress("杭州市余杭区989号");
obj12.setEmail("345@gmail.com");
obj12.setFax("0571-88888888");
obj12.setGender("男");
obj12.setId("S123456");
obj12.setIdNumber("110101199001011234");
obj12.setIdType("ID_CARD");
obj12.setMobile("13214567869");
obj12.setName("老王");
obj12.setNick("user123");
obj12.setProvince("浙江省");
obj12.setRemark("备注");
obj12.setTel("81020340");
obj12.setTown("横加桥");
obj12.setZipCode("043300");
obj11.setSenderInfo(obj12);
obj11.setSourceOrderCode("SO123456");
obj11.setSupplierCode("SUP123");
obj11.setSupplierName("供应商A");
obj11.setWarehouseCode("W1234");
obj1.setReturnOrder(obj11);
obj1.setExtendProps("{}");
req.setReturnorderConfirmRequest(obj1);
AlibabaAlihealthWmsReturnorderConfirmResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alihealth_wms_returnorder_confirm_response>
    <result>
        <flag>success</flag>
        <code>0</code>
        <message>invalid appkey</message>
    </result>
</alibaba_alihealth_wms_returnorder_confirm_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

返回
顶部