文档
测试

2.仓库实物库存查询

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

接口描述

开发者可调用此接口查询仓库实物商品库存

数据格式及编码

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

Params公共请求参数

参数名
类型
描述
必填
method
string
接口方法名。请填写"jingdong.eclp.stock.queryStock"
必填
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
object
业务系统参数
必填
deptNo
string
eclp系统--事业部编码
必填
warehouseNo
string
eclp系统--库房编码
必填
goodsNo
string
eclp系统--事业部商品编码
可选
isvSku
string
isv/商家系统--商品编码
可选
sellerGoodsSign
string
eclp系统--商家商品标识
可选
stockStatus
string
库存状态,1.良品;2.残品;3.样品
可选
goodsLevel
string
京东商品等级;100-199 良品;200-299残品;6 待鉴定
可选
stockType
string
库存可用类型, 1.正常 2.待退品3.商家预留4.仓库锁定5.临期锁定6.盘点锁定
可选
returnZeroStock
string
是否返回0库存数据,1表示不返回库存为0的数据,2表示返回库存为0的数据;默认1(云集除外)
可选
returnIsvLotattrs
string
是否返回isv串 ,不传时不返回,为原查询方式,填1时代表返回isv串,将影响查询方式和返回数据的维度(物流云专用)
可选
currentPage
string
当前页;默认第一页
可选
pageSize
string
每页条数;每页条数据最大1000
可选

Response响应参数

application/json
参数名
类型
描述
必填
jingdong_eclp_stock_queryStock_responce
object
数据字典
必填
code
string
网关状态码
必填
querystock_result
array
仓库库存数据列表
必填
recordCount
int
记录数
必填
deptNo
string
事业部编码
必填
deptName
string
事业部名称
必填
goodsNo
string
eclp事业部商品编码
必填
isvSku
string
isv/商家商品编码
必填
sellerGoodsSign
string
商家商品标识
必填
warehouseNo
string
库房编码
必填
warehouseName
string
库房名称
必填
stockStatus
string
库存状态(1,良品;2 残品;3,样品;4临时品;13,脏品;14,待鉴定品)
必填
stockType
string
库存类型(1.正常 2.待退品3.商家预留4.仓库锁定5.临期锁定6.盘点锁定7.隔离库存)
必填
totalNum
int
商品总库存
必填
usableNum
int
商品可用库存
必填
goodsLevel
string
商品等级编码(100-199 良品;200-299残品,6 待鉴定)
必填
goodsName
string
商品等级名称
必填

请求示例

`url示例:` --- > https://api.jd.com/routerjson?method=jingdong.eclp.stock.queryStock&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", "warehouseNo":"110000180" } ```

响应示例

`成功示例:` --- ```json { "jingdong_eclp_stock_queryStock_responce": { "code": "0", "querystock_result": [ { "recordCount": 6, "isvSku": "roly-商家商品编码", "deptName": "roly测试事业部", "sellerGoodsSign": "luorui1", "goodsNo": "EMG4418124253043", "usableNum": 20, "deptNo": "EBU4418046670139", "warehouseName": "北京系统测试仓2号库", "totalNum": 20, "stockType": "7", "stockStatus": "1", "goodsLevel": "100", "warehouseNo": "110000180", "goodsName": "roly测试-商品名称" }, { "recordCount": 6, "isvSku": "roly-商家商品编码2", "deptName": "roly测试事业部", "sellerGoodsSign": "luorui2", "goodsNo": "EMG4418126614172", "usableNum": 1, "deptNo": "EBU4418046670139", "warehouseName": "北京系统测试仓2号库", "totalNum": 1, "stockType": "1", "stockStatus": "14", "goodsLevel": "6", "warehouseNo": "110000180", "goodsName": "测试商品名称2" }, { "recordCount": 6, "isvSku": "roly-商家商品编码2", "deptName": "roly测试事业部", "sellerGoodsSign": "luorui2", "goodsNo": "EMG4418126614172", "usableNum": 10, "deptNo": "EBU4418046670139", "warehouseName": "北京系统测试仓2号库", "totalNum": 10, "stockType": "7", "stockStatus": "1", "goodsLevel": "100", "warehouseNo": "110000180", "goodsName": "测试商品名称2" }, { "recordCount": 6, "isvSku": "roly-商家商品编码2", "deptName": "roly测试事业部", "sellerGoodsSign": "luorui2", "goodsNo": "EMG4418126614172", "usableNum": 39, "deptNo": "EBU4418046670139", "warehouseName": "北京系统测试仓2号库", "totalNum": 39, "stockType": "1", "stockStatus": "2", "goodsLevel": "200", "warehouseNo": "110000180", "goodsName": "测试商品名称2" }, { "recordCount": 6, "isvSku": "roly-商家商品编码", "deptName": "roly测试事业部", "sellerGoodsSign": "luorui1", "goodsNo": "EMG4418124253043", "usableNum": 131, "deptNo": "EBU4418046670139", "warehouseName": "北京系统测试仓2号库", "totalNum": 168, "stockType": "1", "stockStatus": "1", "goodsLevel": "100", "warehouseNo": "110000180", "goodsName": "roly测试-商品名称" }, { "recordCount": 6, "isvSku": "roly-商家商品编码2", "deptName": "roly测试事业部", "sellerGoodsSign": "luorui2", "goodsNo": "EMG4418126614172", "usableNum": 9, "deptNo": "EBU4418046670139", "warehouseName": "北京系统测试仓2号库", "totalNum": 40, "stockType": "1", "stockStatus": "1", "goodsLevel": "100", "warehouseNo": "110000180", "goodsName": "测试商品名称2" } ] } } ``` `失败示例:` --- ```json { "jingdong_eclp_stock_queryStock_responce": { "code": "0", "querystock_result": [] } } ``` `异常示例:` --- ```json { "error_response": { "code": "STOCK 3,399", "zh_desc": "库存系统 查询仓库实物库存失败,失败原因,主数据系统 调用:根据授权码:422432a000_m与事业部编号EBU441804667017tg获取事业部接口,获取数据时出现异常(解决方案参考:http://open.jd.com/home/home#/doc/common?listId=533)", "en_desc": "STOCK 3,399(Solution reference:http://open.jd.com/home/home#/doc/common?listId=533)" } } ```