文档
测试

3.查询单据状态及详情

POST
https://api.jd.com/routerjson

接口描述

开发者根据退货入库单号查询单据详情(支持B2B/B2C退货单)

jos官网说明:

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

退货入库单状态流转图

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

数据格式及编码

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

Params请求参数

参数名
类型
描述
必填
method
string
接口方法名。请填写"jingdong.eclp.rtw.queryRtw"
必填
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
签名值。签名算法请参考https://easydoc.xyz/doc/85914950/QULSrw7u/EnnJTVOz
必填

Request Body应用级参数

application/x-www-form-urlencoded
参数名
类型
描述
必填
360buy_param_json
string
业务系统参数
必填
eclpRtwNo
string
ECLP-京东退货入库单号
必填
isvRtwNum
string
ISV/商家-退货入库单号
可选
orderInType
string
退货入库单类型,1:b2c退货;2:b2b退货
必填
eclpSoNo
string
eclp-销售出库单号(b2c必填)
可选
warehouseNo
string
eclp-退货入库库房编号
可选
reson
string
退货入库原因
可选
queryBatAttrFlag
boolean
是否查询批次信息,true:查询批次信息;false:不查询批次信息;默认不查询
可选

Response响应参数

application/json
参数名
类型
描述
必填
jingdong_eclp_rtw_queryRtw_responce
object
数据字典
必填
code
string
示例:0
必填
queryrtw_result
array
数据列表
必填
deptNo
string
eclp系统-事业部编码
必填
status
string
eclp系统-退货入库单当前状态,0:新建;100:初始;200:已完成;400:取消成功;500:超期拒收;600:整单拒收;700:已反馈商家
必填
eclpRtwNo
string
eclp系统--退货入库单号
必填
isvRtwNum
string
isv/商家--退货入库单号
必填
eclpSoNo
string
eclp系统--正向销售出库单号
可选
reason
string
退货入库原因
必填
warehouseNo
string
入库库房编号
必填
receiveBoxNum
int
收货箱数
必填
rtwDetailsModelList
array
退货入库商品信息
必填
goodsNo
string[]
eclp事业部商品编码; 示例:EMG4418124253043
必填
isvGoodsNo
string[]
isv/商家商品编码
必填
planQty
int[]
计划入库数量
必填
realQty
int[]
实际入库数量
必填
goodsLevelNo
string[]
入库商品等级
必填
detailIsvSoNo
string[]
商家销售单号
必填
detailEclpSoNo
string[]
eclp销售单号
必填
detailOrderLine
string[]
商家行号
可选
newWayBill
string
逆向物流运单号
必填
logicParam
string
逻辑因子
必填
source
string
退货入库单创建渠道,1:ECLP商家端;2:ECLP管理端;3:JOS;4:青龙;5:系统触发; 8:WMS;9:EDI;
必填
createUser
string
eclp退货入库单创建人
必填
createTime
date
eclp退货入库单创建时间; 示例:2020-10-10 16:15:40
必填
updateTime
string
eclp退货入库单最后更新时间; 示例:2020-10-10 16:15:40
必填
productsName
string
仓产品的产品编码
可选
billingMode
string
计费方式
必填
salesPlatformName
string
销售平台名称
必填
spSoNo
string
销售平台单号
必填
shipperName
承运商名称
必填

请求示例

`url示例:` --- > https://api.jd.com/routerjson?method=jingdong.eclp.rtw.queryRtw&app_key=**++{{app_key值}}++**&access_token=**++{{access_token值}}++**& timestamp=**++{{请求时间}}++**&format=json&v=2.0&sign_method=**md5**&sign=**++{{签名值}}++** `Request Body示例:` --- ```json 360buy_param_json={ "eclpRtwNo":"EBR4418070655667675", "orderInType":"2" } ```

响应示例

`成功示例:` --- ```json { "jingdong_eclp_rtw_queryRtw_responce": { "code": "0", "queryrtw_result": [ { "createTime": "2020-10-10 16:15:39", "reason": "测试原因reson", "deptNo": "EBU4418046670139", "logicParam": "", "status": "100", "updateTime": "2020-10-10 16:15:40", "eclpSoNo": "", "receiveBoxNum": 0, "isvRtwNum": "12345678isvRtwNumoo4", "eclpRtwNo": "EBR4418070655718", "createUser": "ISV", "source": "3", "newWayBill": "JDV12345678", "rtwDetailsModelList": [ { "realQty": 0, "goodsLevelNo": "100", "detailIsvSoNo": "", "planQty": 20, "detailEclpSoNo": "", "goodsNo": "EMG4418124253043", "isvGoodsNo": "roly-商家商品编码", "detailOrderLine": "3" }, { "realQty": 0, "goodsLevelNo": "100", "detailIsvSoNo": "", "planQty": 10, "detailEclpSoNo": "", "goodsNo": "EMG4418126614172", "isvGoodsNo": "roly-商家商品编码2", "detailOrderLine": "2" } ], "warehouseNo": "110000180" } ] } } ``` `异常示例:` --- ```json { "jingdong_eclp_rtw_queryRtw_responce": { "code": "0", "queryrtw_result": [] } } ```