文档
测试

1.创建退货入库单

websocket测试
POST
https://api.jd.com/routerjson

接口描述

可通过此接口创建B2B退货入库单据

jos官网说明：

https://jos.jd.com/apilist?apiGroupId=138&apiId=14261&apiName=jingdong.eclp.rtw.addRtwOrder

退货入库场景定义及场景:

`退货定义:` --- 1.退货是指仓库按订单将货物发出后，由于某种原因，客户将商品退回仓库。业务产生的场景有客户拒收返仓、客户售后退货、客户售后换货等。 `退货场景:` --- 1.京东快递-客户拒收:中小件投递时如果投递不成功，快递员会进行多次投递，或者客户在第一次时就告知快递员拒收。最终拒收后，会将商品返回分拣中心，分拣中心逆向发货，生成退货入库单 2.京东大件-大件拒收：大件投递时客户拒收，快递员通过终端操作拒收,生成退货入库单。 3.订单取消(wms已复核,未交接发货)：当销售出库单已复核（已减少库存，未交付配送）时，客户取消订单，且订单取消成功，则通过发起退货入库对商品进行入库。 4.WMS退货：当商家使用第三方配送（只使用了京东的仓库服务），出库后，客户拒收后，第三方配送将商品送返原仓库，仓库人员通过WMS发起退货入库。 5.门店退货（EDI\JOS\ECLP管理端\ECLP商家端）：针对B2B业务，门店可能会将一段时间内的商品进行退货，一般通过下发B2B退货单方式退货入库。 6.商家下发（EDI\JOS\ECLP管理端\ECLP商家端）：商家指定商品进行退货。

退货入库单交互图

![退货入库单交互图 1.png](https://cos.easydoc.net/48578360/files/kpqpcq1u.png)

数据格式及编码

```language Content_type：application/x-www-form-urlencoded Accept：application/json Charset：utf-8 ```

调用注意事项

```language ◆ B2C退货入库单，必须传入正向销售出库单号 ◆ B2B退货入库单,无要求 ```

Params公共参数

参数名
类型
描述
必填
method
string
接口方法名。请填写"jingdong.eclp.rtw.addRtwOrder"
必填
app_key
string
开发者应用app_key
必填
access_token
string
京东账户授权访问令牌码
必填
timestamp
string
请求时间, 京东网关允许误差为10分钟。 示例：2020-09-23 12:23:45
必填
format
string
数据格式。固定值"json"
必填
v
string
接口版本号，固定值“2.0”
必填
sign_method
string
签名方式,可支持"md5"（默认）,"hmacmd5","hmacsha256"
可选
sign
string
签名值
必填

Request Body应用级参数

参数名
类型
描述
必填
360buy_param_json
string
业务系统参数
必填
ownerNo
string(50)
eclp事业部编码
可选
eclpRtwNo
string
eclp--退货入库单号
可选
isvRtwNum
string(100)
isv/商家--退货入库单号
可选
warehouseNo
string(50)
eclp--退货入库库房编号
可选
orderInType
string(1)
eclp--退货入库单类型(1为B2C退货单,默认项，2为B2B退货单）
可选
eclpSoNo
string(50)
eclp--正向销售出库单号{B2C时必填,B2B忽略}
可选
isvSoNo
string(50)
Isv/商家--正向销售出库单号{B2C时必填,B2B忽略}
可选
orderMark
string(50)
eclp--退货入库单标记位。orderMark第1位-是否可缺量入库（0表示不允许；1表示允许）；orderMark第8位-0按单，1按板回传；
可选
orderType
string(1)
isv/商家--退货类型{1：售后退货；3：拒收退货,默认项}
可选
sellerRtwTypeName
string(50)
isv/商家--单据类型名称（wms人员可在退货预检查看）
可选
sellerRtwType
string(10)
isv/商家--单据类型
可选
receiveLevel
string(1)
eclp--单据商品收货等级{1:按单据等级入库；2:按实物等级入库}
可选
receivePriority
string
eclp--单据收货优先级（商家自定义1-9的数字，代表优先级)
可选
customerName
string(50)
退货入库来源
可选
salesPlatformName
string(50)
销售平台名称
可选
shopName
string(50)
退货单所属店铺名称
可选
spSoNo
string(50)
退单单所属销售平台单号
可选
sellerRemark
string(100)
备注
可选
reson
string(400)
备注
可选
shipperName
string(100)
【需京东研发配置后生效】物流信息--承运商名称
可选
packageNo
string
【需京东研发配置后生效】物流信息--退货包裹物流单号
可选
senderName
string(50)
【需京东研发配置后生效】物流信息--寄件人姓名（wms人员可在退货预检-单据确认界面作为筛选条件）
可选
senderTelPhone
string(50)
【需京东研发配置后生效】物流信息--寄件人电话（wms人员可在预检界面作为筛选条件）
可选
senderMobilePhone
string(50)
【需京东研发配置后生效】物流信息--寄件人手机号（wms人员可在预检界面作为筛选条件）
可选
deptGoodsNo
string[]
退货入库明细--京东商品编码
可选
isvGoodsNo
string[]
退货入库明细--商家商品编码
可选
orderLine
string[]
退货入库明细--商家侧行序号
可选
goodsLevel
string[]
退货入库明细--申请入库商品等级编码（100-良品,默认;200-残品;400-脏品)
可选
planQty
number[]
退货入库明细--申请入库数量
可选
productionDate
string[]
退货入库明细--生产日期批次属性(格式：”yyyy-MM-dd“）
可选
packageBatchNo
string[]
退货入库明细--包装批号批次属性
可选
batAttrListJson
string[]
退货入库明细--商品其他批属性字段Json串(生产日期productionDate;到期日期expirationDate;生产批号lot;供应商supplier;收货日期receiveDate;采购单号poNo;包装批号packageBatchNo;制造商manufacturer;)（联合利华专用）
可选
planRtwReasonDesc
string[]
安踏专用--商家退货原因描述
可选
planRtwReasonNo
string[]
安踏专用--商家退货原因编码
可选

Response响应参数

参数名
类型
描述
必填
jingdong_eclp_rtw_addRtwOrder_responce
object
数据字典
必填
code
string
网关状态码
必填
transportrtw_result
object
业务系统数据字典
可选
resultCode
string
业务操作状态码
可选
msg
string
业务操作状态描述；示例：下发成功
可选
eclpRtwNo
string
eclp系统-退货入库单号
可选
reason
string
示例：
可选

请求示例

`url示例:` --- > https://api.jd.com/routerjson?method=jingdong.eclp.rtw.addRtwOrder&app_key=**++{{app_key值}}++**&access_token=**++{{access_token值}}++**& timestamp=**++{{请求时间}}++**&format=json&v=2.0&sign_method=**md5**&sign=**++{{签名值}}++** `Request Body示例:` --- ```json 360buy_param_json={ "orderInType":"2", "isvRtwNum":"12345678isvRtwNumoo4", "salesPlatformName":"测试平台名称", "spSoNo":"spSoNo1", "ownerNo":"EBU4418046670139", "orderType":"1", "orderMark":"00000000000000000000000000000000000000000000000000", "warehouseNo":"110000180", "receiveLevel":"2", "receivePriority":"1", "reson":"测试原因reson", "sellerRemark":"测试selleReamrk", "customerName":"ceshi_customerName", "sellerRtwType":"seRtwTyp1", "sellerRtwTypeName":"sellerRtwTypeName1", "shopName":"shopName1", "planRtwReasonDesc":"planRtwReasonDesc1,planRtwReasonDesc2", "planRtwReasonNo":"1planRtwReasonNo,2planRtwReasonNo", "workOrderNo":"workOrderNo1,workOrderNo2", "shipperName":"京东快递", "packageNo":"JDV12345678", "deptGoodsNo":"EMG4418126614172,EMG4418124253043", "planQty":"10,20", "goodsLevel":"100,100", "orderLine":"2,3" } ```

响应示例

`成功示例:` --- ```json { "jingdong_eclp_rtw_addRtwOrder_responce": { "code": "0", "transportrtw_result": { "reason": "", "resultCode": "1", "msg": "下发成功", "eclpRtwNo": "EBR4418072103893" } } } ``` `异常示例:` --- ```json { "error_response": { "code": "67", "zh_desc": "java.lang.RuntimeException: com.jd.bk.saf.exception.SafJosException: 退货入库服务 请检查数据错误 : 明细中的goodsNo(商品编码)/isvGoodsNo(isv商品编码)和planQty(计划入库数量)不能为空是否已经创建过退货入库单，或者网络超时！（解决方案参考：http://open.jd.com/home/home#/doc/common?listId=533）", "en_desc": "platform connecting service process unknown exception information(Solution reference:http://open.jd.com/home/home#/doc/common?listId=533)" } } ```
上一篇 4.采购单关单指令(分批次到货场景)
nextDoc 2.取消退货入库单
本文档使用易文档编写, 更新时间: 2022-08-17 10:45