文档
测试

3.仓库保质期商品库存查询

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.queryShelfLifeGoodsList"
必填
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系统--事业部编码
必填
warehouseNo
string
eclp系统--库房编码
必填
goodsNo
string
eclp系统--事业部商品编码
可选
isvGoodsNo
string
isv/商家系统--商品编码
可选
status
string
库存状态,1.良品;2.残品;3.样品
可选
goodsLevel
string
京东商品等级;100-199 良品;200-299残品;6 待鉴定
可选
currentPage
string
当前页;默认第一页
可选
pageSize
string
每页条数;每页条数据最大1000
可选

Response响应参数

application/json
参数名
类型
描述
必填
jingdong_eclp_stock_queryShelfLifeGoodsList_responce
object
数据字典
必填
code
string
网关状态码
必填
pageableResult
object
业务系统数据字典
必填
recordCount
int
业务系统状态码
必填
shelfLifeGoodsResultList
array
业务系统数据列表
必填
deptNo
string
eclp系统--事业部商品编码
可选
deptName
string
eclp系统--事业部商品名称
可选
warehouseNo
string
eclp系统--库房编号
可选
warehouseName
string
eclp系统--库房名称
可选
goodsNo
string
eclp系统--事业部商品编码
可选
isvGoodsNo
string
isv/商家系统--商品编码
可选
eclpGoodsName
string
eclp系统--商品名称
可选
goodsLevel
string
eclp系统--商品等级
可选
stockNum
int
现货库存
可选
usableNum
int
可用库存
可选
shelfLifeDays
string
保质期天数
可选
productionDate
string
生产日期
可选
expirationDate
string
到期日期
可选
locDate
string
锁定日期
可选
remainDays
string
剩余天数
可选
remainDaysRate
string
剩余天数占比
可选
status
string
状态(1正常 ,2预警,3临期,4过期)
可选
createTime
date
记录日期
可选

请求示例

`url示例:` --- > https://api.jd.com/routerjson?method=jingdong.eclp.stock.queryShelfLifeGoodsList&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":"110017380", "goodsNo":"EMG4418126614172", "currentPage":1, "pageSize":50 } ```

响应示例

`成功示例:` --- ```json { "jingdong_eclp_stock_queryShelfLifeGoodsList_responce":{ "code":"0", "pageableResult":{ "recordCount":0, "shelfLifeGoodsResultList":[ { "deptName":"某事业部", "createTime":"2018-12-10 12:59:59", "expirationDate":"2018-12-31", "status":"1", "stockNum":"10", "eclpGoodsName":"测试商品", "productionDate":"2018-12-01", "goodsNo":"EMG00xxx", "usableNum":"10", "deptNo":"EBU4418046670139", "warehouseName":"110017380", "remainDaysRate":"0.33", "remainDays":"10", "locDate":"2018-12-15", "goodsLevel":"100", "warehouseNo":"11000000X", "isvGoodsNo":"testGoods", "shelfLifeDays":"30" } ] } } } ``` `失败示例:` --- ```json { "jingdong_eclp_stock_queryShelfLifeGoodsList_responce": { "code": "0", "pageableResult": { "recordCount": 0, "shelfLifeGoodsResultList": [] } } } ``` `异常示例:` --- ```json { "error_response": { "code": "67", "zh_desc": "java.lang.RuntimeException: com.jd.bk.saf.exception.SafJosException: 库存系统 5,399(解决方案参考: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)" } } ```