文档
测试

1.创建退供单

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

接口描述

开发者可调用此接口下发退供应商出库指令给京东库房

jos平台接口说明:

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

数据格式及编码

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

Params公共请求参数

参数名
类型
描述
必填
method
string
接口方法名。请填写"jingdong.eclp.rts.isvRtsTransfer"
必填
app_key
string
开发者应用app_key
必填
access_token
string
京东账户授权访问令牌码
必填
timestamp
string
请求时间, 京东网关允许误差为10分钟。 示例:2020-09-23 12:23:45
必填
format
string
请求时间, 京东网关允许误差为10分钟。 示例:2020-09-23 12:23:45
必填
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
业务系统参数
必填
deptNo
string
事业部编码
可选
eclpRtsNo
string
京东退供单单号
可选
isvRtsNum
string
isv/商家退供单单号
必填
rtsType
string
退供单据类型(1-良品非临期),(2-残品非临期),(4-临期品)、(5-过期品)、(6-待检品)
可选
warehouseNo
string
退库库房编号
必填
supplierNo
string
供应商编号
可选
packFlag
string
是否按款/sku装箱 (0-否),(1-是)
可选
allowLack
string
是否允许缺量(是否允许实际出库数量小于计划出库数量);枚举值:0(否)、1(是)
可选
logicParam
string
逻辑库位(公司,仓别,个别商家需要指定库位出库时使用)
可选
orderLine
string[]
退供单商品明细-退供商品行序号
可选
deptGoodsNo
string[]
退供单商品明细-京东商品编码
可选
isvGoodsNo
string[]
退供单商品明细-isv/商家商品编码
可选
goodsName
string[]
退供单商品明细-商品名称
可选
quantity
string[]
退供单商品明细-计划退货数量
必填
realQuantity
string[]
退供单商品明细-实际退货数量
可选
goodsLevel
string[]
退供单商品明细-退货商品等级
可选
goodsPrice
number[]
退供单商品明细-退供商品单价
可选
totalAmount
number[]
退供单商品明细-退供商品总金额
可选
lotProductionBatchNo
string[]
退供单商品明细-生产批号批属性
可选
lotSupplier
string[]
退供单商品明细-生产日期批属性
可选
batAttrListJson
string[]
批属性字符串
可选
deliveryMode
string
提货方式;枚举值:1(商家自提)、2(京东配送)
必填
receiver
string
京东配送-收货人姓名
可选
receiverPhone
string
京东配送-收货人电话
可选
email
string
京东配送-收货人电子邮件
可选
province
string
京东配送-收货地址(省)
可选
city
string
京东配送-收货地址(市)
可选
county
string
京东配送-收货地址(区/县)
可选
town
string
京东配送-收货地址(街道/乡镇)
可选
address
string
京东配送-收货地址(详细地址)
可选
createUser
string
单据创建人
可选
remark
string
备注
可选
purchaser
string
采购员
可选
customField
string
商家个性化属性json串
可选

Response响应参数

application/json
参数名
类型
描述
必填
jingdong_eclp_rts_isvRtsTransfer_responce
object
数据字典
必填
code
string
网关状态码
必填
rtsResult
object
业务系统数据字典
必填
resultCode
string
业务系统执行状态码
必填
failMsg
string
业务系统执行状态中文描述
必填
eclpRtsNo
string
eclp系统-退供单号; 示例:EBS4418047441624
必填

请求示例

`url示例:` --- > https://api.jd.com/routerjson?method=jingdong.eclp.rts.isvRtsTransfer&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", //事业部编码 "isvRtsNum":"isvRtsNum11111", //isv/商家退供单号 "rtsType":"1", //退供单据类型(1-良品非临期),(2-残品非临期),(4-临期品)、(5-过期品)、(6-待检品) "deliveryMode":"2", //提货方式:1(商家自提)、2(京东配送) "warehouseNo":"110000180", //退库库房编号 "allowLack":"0", //是否允许缺量(是否允许实际出库数量小于计划出库数量);枚举值:0(否)、1(是) "remark":"测试remark备注", //备注 "receiver":"roly", //京东配送-收货人姓名 "receiverPhone":"18825162021", //京东配送-收货人电话 "email":"2335529706@qq.com", //京东配送-收货人电子邮件 "address":"广东省广州市增城区新塘镇海伦堡花园78栋", //京东配送-收货地址(详细地址) "province":"广东省", //京东配送-收货地址(省) "city":"广州市", //京东配送-收货地址(市) "county":"增城区", //京东配送-收货地址(区/县) "town":"新塘镇", //京东配送-收货地址(街道/乡镇) "deptGoodsNo":"EMG4418126614172,EMG4418124253043", //退供单商品明细-京东商品编码 "quantity":"10,20", //退供单商品明细-计划退货数量 "goodsLevel":"100,100", //退供单商品明细-退货商品等级 "goodsPrice":"1.3,1.5", //退供单商品明细-退供商品单价 "totalAmount":"130,145", //退供单商品明细-退供商品总金额 "createUser":"uuu" //单据创建人 } ```

响应示例

`成功示例:` --- ```json { "jingdong_eclp_rts_isvRtsTransfer_responce": { "code": "0", "rtsResult": { "eclpRtsNo": "EBS4418047441624", "resultCode": "1", "failMsg": "响应成功" } } } ``` `失败示例:` --- ```json { "error_response": { "code": "RTS 3,399", "zh_desc": "退供应商服务 商家退供出库单号为空(解决方案参考:http://open.jd.com/home/home#/doc/common?listId=533)", "en_desc": "RTS 3,399(Solution reference:http://open.jd.com/home/home#/doc/common?listId=533)" } } ```