文档

测试

3.查询退供单详情

websocket测试

POST

https://api.jd.com/routerjson

接口描述

开发者可调用此接口查询退供单据详情

jos官网说明:

https://jos.jd.com/apilist?apiGroupId=138&apiId=13178&apiName=jingdong.eclp.rts.isvRtsQuery

数据格式及编码

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

Params公共请求参数

参数名

类型

描述

必填

method

string

接口方法名。请填写"jingdong.eclp.rts.isvRtsQuery"

必填

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

签名值

必填

请求参数

application/x-www-form-urlencoded

参数名

类型

描述

必填

360buy_param_json

string

业务系统参数

必填

eclpRtsNo

string

京东退供单单号

必填

isvRtsNum

string

isv/商家退供单单号

可选

deptNo

string

事业部编码

可选

deliveryMode

string

退供单据类型（1-良品非临期），（2-残品非临期），（6-待检品）

可选

warehouseNo

string

退库库房编码

可选

supplierNo

string

供应商编码

可选

receiver

string

京东配送-收货人姓名

可选

receiverPhone

string

京东配送-收货人电话

可选

email

string

京东配送-收货人电子邮箱

可选

province

string

京东配送-收货人地址（省）

可选

city

string

京东配送-收货人地址（市）

可选

county

string

京东配送-收货人地址（区/县）

可选

town

string

京东配送-收货人地址（乡镇/街道）

可选

address

string

京东配送-收货人地址（详细地址）

可选

deptGoodsNo

string

退库商品明细-京东商品编码

可选

goodsName

string

退库商品明细-商品名称

可选

quantity

string

退库商品明细-计划出库数量

可选

realQuantity

string

退库商品明细-实际出库数量

可选

goodsStatus

string

退库商品明细-商品状态(1-良品）、（2-残品)；

可选

Response响应参数

application/json

参数名

类型

描述

必填

jingdong_eclp_rts_isvRtsQuery_responce

object

数据字典

可选

code

string

网关状态码

可选

rtsResultList

array

业务系统数据列表

可选

resultCode

string

查询结果(1为成功，其它均为失败)

可选

msg

string

查询结果描述信息

可选

deptNo

string

事业部编号

必填

eclpRtsNo

string

京东退供单单号（EBS开头）

可选

isvRtsNum

string

isv/商家退供单单号

可选

supplierNo

string

供应商编号

可选

warehouseNo

string

退库库房

可选

logicParam

string

逻辑库位

可选

rtsOrderStatus

string

退供单当前状态（0-新建）、（100-初始化）、（150-复核完成）、（200-已完成）、（250-取消失败）、（300-取消中）、400（400-已取消)

必填

operatorTime

string

退供单操作时间；格式：yyyy-MM-dd HH:mm:ss

可选

operatorUser

string

操作人

可选

rtsDetailList

list

退供单商品明细列表

可选

orderLine

string

退供单商品明细-行序号

可选

deptGoodsNo

string

退供单商品明细-京东商品编号

可选

goodsName

string

退供单商品明细-商品名称

可选

goodsStatus

string

退供单商品明细-商品状态(良品；残品；样品)

可选

goodsLevel

string

退供单商品明细-商品等级

可选

quantity

string

退供单商品明细-申请出库数量

可选

realQuantity

string

退供单商品明细-实际出库数量

可选

rtsBatchList

list

退供单批属性列表

可选

orderLine

退供单批属性-行序号

可选

deptGoodsNo

string

退供单批属性-京东商品编号

可选

goodsLevel

string

退供单批属性-商品等级

可选

quantity

string

退供单批属性-申请出库数量

可选

realQuantity

string

退供单批属性-实际出库数量

可选

batchNo

string

退供单批属性-批号

可选

batAttrList

list

退供单批属性-商品批属性list

可选

batAttrList

string

批属性键

可选

batchValue

string

批属性值

可选

deliveryMode

string

提货方式（1-商家自提）,（2-京东配送)

可选

receiver

string

京东配送-收件人

可选

receiverPhone

string

京东配送-收件人电话

可选

email

string

京东配送-收件人电子邮箱

可选

province

string

京东配送-收货地址(省)

可选

city

string

京东配送-收货地址(市)

可选

county

string

京东配送-收货地址(区/县)

可选

town

string

京东配送-收货地址(乡镇/街道)

可选

source

string

单据创建方式（8-ISV)

可选

remark

string

备注

可选

请求示例

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

响应示例

`成功示例:` --- ```json { "jingdong_eclp_rts_isvRtsQuery_responce": { "code": "0", "rtsResultList": [ { "eclpRtsNo": "EBS4418047441756", "receiver": "roly", "remark": "测试remark备注", "supplierNo": "EMS4418047652673", "rtsDetailList": [ { "deptGoodsNo": "EMG4418126614172", "goodsStatus": "0", "quantity": "10", "goodsLevel": "100", "goodsName": "测试商品名称2" }, { "deptGoodsNo": "EMG4418124253043", "goodsStatus": "0", "quantity": "20", "goodsLevel": "100", "goodsName": "roly测试-商品名称" } ], "city": "广州市", "deptNo": "EBU4418046670139", "operatorUser": "uuu", "logicParam": "", "province": "广东省", "resultCode": "1", "receiverPhone": "18825162021", "isvRtsNum": "isvRtsNum11111", "deliveryMode": "2", "msg": "查询成功", "rtsOrderStatus": "100", "source": "8", "county": "增城区", "email": "2335529706@qq.com", "town": "新塘镇", "operatorTime": "2020-10-11 21:37:25", "warehouseNo": "110000180" } ] } } ``` `失败示例:` --- ```json { "jingdong_eclp_rts_isvRtsQuery_responce": { "code": "0", "rtsResultList": [] } } ``` `异常示例:` --- ```json { "error_response": { "code": "67", "zh_desc": "java.lang.RuntimeException: com.jd.eclp.common.exception.EclpSystemException: com.jd.bk.saf.exception.SafJosException: 退供应商服务传入参数不能为空！（解决方案参考：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)" } } ```

上一篇 2.取消退供单

nextDoc 1.创建仓间调拨单