文档
测试

2.取消退供单

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

接口描述

开发者可调用此接口下发取消退供单(异步返回)

jos官网说明:

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

数据格式及编码

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

调用注意事项:

> 取消结果为异步返回;建议稍后再次调用此接口获取取消结果; 如果商家有要求同步返回,需京东研发进行配置

Params公共请求参数

参数名
类型
描述
必填
method
string
接口方法名。请填写"jingdong.eclp.rts.isvRtsCancel"
必填
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应用级参数

application/x-www-form-urlencoded
参数名
类型
描述
必填
360buy_param_json
string
业务系统参数
必填
deptNo
string
eclp系统--事业部编码
必填
eclpRtsNo
eclp系统--退供应商单号
必填
isvRtsNum
isv/商家系统--退供应商单号
可选
deliveryMode
string
退供单据类型;枚举值:1(良品非临期),2(残品非临期),6(待检品)
可选
warehouseNo
string
eclp系统--退库库房编号
可选
supplierNo
string
eclp系统--供应商编码
可选
receiver
string
收货人姓名(提货方式为商家自提时,非必填)
可选
receiverPhone
string
收货人电话(提货方式为商家自提时,非必填)
可选
email
string
收货人电子邮件(提货方式为商家自提时,非必填)
可选
address
string(200)
收货地址(提货方式为商家自提时,非必填)
可选
province
string(50)
收货地址所属省(提货方式为商家自提时,非必填)
可选
city
string(50)
收货地址所属市(提货方式为商家自提时,非必填)
可选
county
string(50)
收货地址所属区/县(提货方式为商家自提时,非必填)
可选
town
string(50)
收货地址所属街道/乡镇(提货方式为商家自提时,非必填)
可选
logicParam
string(50)
逻辑库位(公司,仓别,个别商家需要指定库位出库时使用)
可选
deptGoodsNo
string[]
eclp系统--事业部商品编号(isvGoodsNo与deptGoodsNo 二选一必填)
可选
goodsName
string[]
eclp系统--事业部商品名称
可选
quantity
string[]
申请退货数量
可选
goodstatus
string[]
商品等级(100-良品,200-残品,其他枚举视商家商品等级个性化配置决定)
可选

Response响应参数

参数名
类型
描述
必填
jingdong_eclp_rts_isvRtsCancel_responce
object
数据字典
必填
code
string
网关状态码
必填
rtsResult
object
业务系统数据字典
必填
resultCode
string
业务系统执行状态码
必填
msg
string
业务系统执行状态描述; 示例:取消成功
必填

请求示例

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

响应示例

`取消中示例:` --- ```json { "jingdong_eclp_rts_isvRtsCancel_responce": { "code": "0", "rtsResult": { "resultCode": "3", "msg": "取消操作已接收,正在取消中" } } } ``` `取消成功示例:` --- ```json { "jingdong_eclp_rts_isvRtsCancel_responce": { "code": "0", "rtsResult": { "resultCode": "1", "msg": "取消成功" } } } ``` `异常示例:` --- ```json { "error_response": { "code": "61", "zh_desc": "eclpRtsNo-参数不能为空,请填写参数值!(解决方案参考:http://open.jd.com/home/home#/doc/common?listId=533)", "en_desc": "parameter null value is not valid ,please refer to the help document and confirm(Solution reference:http://open.jd.com/home/home#/doc/common?listId=533)" } } ```