批量获取库存信息 | 微信开放文档

# 批量获取库存信息

# 接口说明

通过该接口可以根据商品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[].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,
                "total_stock_num": 1166
            }]
        }]
    }
}

# 错误码

错误码	错误描述
公共错误码	-
10020052	商品不存在
10020114	商品ID数量超出限制