接口说明
- ERP调用的虎符API名称:jingdong.hufu.returnorder.create
- 虎符调用WMS的API名称:returnorder.create
- 注:该接口和入库单的区别就是该接口是从入库单接口中单独剥离出来的,专门处理退货引起的入库操作。
入参规范
<?xml version="1.0" encoding="utf-8"?>
<request>
<returnOrder>
<returnOrderCode>ERP的退货入库单编码, string (50) , 必填</returnOrderCode>
<warehouseCode>仓库编码, string (50),必填 ,统仓统配等无需ERP指定仓储编码的情况填OTHER</warehouseCode>
<orderType>单据类型, string (50),THRK=退货入库,HHRK=换货入库 (只传英文编码)</orderType>
<orderFlag>用字符串格式来表示订单标记列表:比如VISIT^ SELLER_AFFORD^SYNC_RETURN_BILL 等, 中间用“^”来隔开 订单标记list (所有字母全部大写) : VISIT=上门;SELLER_AFFORD=是否卖家承担运费 (默认是) ;SYNC_RETURN_BILL=同时退回发票;</orderFlag>
<preDeliveryOrderCode>原出库单号(ERP分配), string(50) ,必填</preDeliveryOrderCode>
<preDeliveryOrderId>原出库单号(WMS分配), string (50),条件必填</preDeliveryOrderId>
<logisticsCode>物流公司编码, string (50) , SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通 、ZTO=中通 (ZTO) 、HTKY=百世汇通、UC=优速、STO=申通、TTKDEX=天天快递 、QFKD=全峰、FAST=快捷、POSTB=邮政小包 、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、AMAZON=亚马逊物流、OTHER=其他,必填, (只传英文编码) </logisticsCode>
<logisticsName>物流公司名称, string (200) </logisticsName>
<expressCode>运单号, string (50) </expressCode>
<returnReason>退货原因, string (200) </returnReason>
<buyerNick>买家昵称, string (50) </buyerNick>
<senderInfo> <!--发件人信息-->
<company>公司名称, string (200) </company>
<name>姓名, string (50) , 必填</name>
<zipCode>邮编, string (50) </zipCode>
<tel>固定电话, string (50) </tel>
<mobile>移动电话, string (50) , 必填</mobile>
<email>电子邮箱, string (50) </email>
<countryCode>国家二字码,string(50)</countryCode>
<province>省份, string (50) , 必填</province>
<city>城市, string (50) , 必填</city>
<area>区域, string (50) </area>
<town>村镇, string (50) </town>
<detailAddress>详细地址, string (200) , 必填</detailAddress>
</senderInfo>
<remark>备注, string (500) </remark>
</returnOrder>
<orderLines>
<orderLine>
<orderLineNo>单据行号,string(50)</orderLineNo>
<sourceOrderCode>交易平台订单, string (50) </sourceOrderCode>
<subSourceOrderCode>交易平台子订单编码, string (50) </subSourceOrderCode>
<ownerCode>货主编码, string (50) , 必填</ownerCode>
<itemCode>商品编码, string (50) , 必填</itemCode>
<itemId>仓储系统商品编码, string (50) , 条件必填,条件为提供后端(仓储系统)商品编码的仓储系统</itemId>
<inventoryType>库存类型, string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, 默认为ZP, </inventoryType>
<planQty>应收商品数量, int, 必填</planQty>
<batchCode>批次编码, string (50) </batchCode>
<productDate>生产日期, string (10) , YYYY-MM-DD</productDate>
<expireDate>过期日期, string (10) , YYYY-MM-DD</expireDate>
<produceCode>生产批号, string (50) </produceCode>
</orderLine>
</orderLines>
</request>
出参规范
<?xml version="1.0" encoding="utf-8"?>
<response>
<flag>success|failure</flag>
<code>响应码</code>
<message>响应信息</message>
<returnOrderId>仓储系统退货单编码, string (50) </returnOrderId>
</response>