# 批量获取库存信息
# 接口说明
通过该接口可以根据商品ID获取当前商品下所有sku的库存
# 注意事项
单次请求不能超过50个商品ID
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/product/stock/batchget?access_token=ACCESS_TOKEN
# 请求参数说明
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
product_id[] | string(uint64) array | 是 | 商品ID列表,上限为50 |
# 请求参数示例
{
"product_id": ["10000017524246"]
}
# 返回参数说明
参数 | 类型 | 描述 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
data.spu_stock_list[] | obj array | spu库存 |
data.spu_stock_list[].product_id | string | 商品ID |
data.spu_stock_list[].sku_stock[] | obj array | sku库存 |
data.spu_stock_list[].sku_stock[].sku_id | string | skuID |
data.spu_stock_list[].sku_stock[].normal_stock_num | number | 通用库存数量 |
data.spu_stock_list[].sku_stock[].limited_discount_stock_num | string | 限时抢购库存数量 |
data.spu_stock_list[].sku_stock[].warehouse_stocks[] | obj array | 区域库存 |
data.spu_stock_list[].sku_stock[].warehouse_stocks[].out_warehouse_id | string | 区域库存外部id |
data.spu_stock_list[].sku_stock[].warehouse_stocks[].num | number | 区域库存数量 |
data.spu_stock_list[].sku_stock[].warehouse_stocks[].lock_stock | number | 区域库存的锁定库存(已下单未支付的库存)数量 |
data.spu_stock_list[].sku_stock[].finder_total_num | number | 达人专属计划营销库存数量 |
data.spu_stock_list[].sku_stock[].exclusive_num | number | 直播预热/专享库存 |
data.spu_stock_list[].sku_stock[].total_stock_num | number | 库存总量:通用库存数量 + 限时抢购库存数量 + 区域库存数量 + 直播预热/专享库存 |
# 返回参数示例
{
"errcode": 0,
"errmsg": "ok",
"data": {
"spu_stock_list": [{
"product_id": "10000017524246",
"sku_stock": [{
"sku_id": "764787449",
"normal_stock_num": 990,
"limited_discount_stock_num": 0,
"warehouse_stocks": [{
"out_warehouse_id": "test4",
"num": 44,
"lock_stock": 0
}, {
"out_warehouse_id": "test2",
"num": 44,
"lock_stock": 0
}, {
"out_warehouse_id": "test3",
"num": 8,
"lock_stock": 0
}, {
"out_warehouse_id": "test1",
"num": 80,
"lock_stock": 0
}],
"finder_total_num": 300,
"exclusive_num": 10,
"total_stock_num": 1176
}]
}]
}
}
# 错误码
错误码 | 错误描述 |
---|---|
公共错误码 | - |
10020052 | 商品不存在 |
10020114 | 商品ID数量超出限制 |