# 快速更新库存
# 接口说明
可通过该接口快速更新微信小店商品的库存
# 注意事项
- 该接口仅对曾经上架成功过的商品,且商品草稿状态为非审核中(edit_status != 2 )适用。本地生活商品不受此规则约束。
- 调用后立即生效。
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/product/stock/update?access_token=ACCESS_TOKEN
# 请求参数说明
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
product_id | string(uint64) | 是 | 内部商品ID |
sku_id | string(uint64) | 是 | 内部sku_id |
diff_type | number | 是 | 修改类型。1: 增加;2:减少;3:设置。建议使用1或2,不建议使用3,因为使用3在高并发场景可能会出现预期外表现 |
num | number | 是 | 增加、减少或者设置的库存值。 |
# 请求参数示例
{
"product_id": "324545",
"sku_id": "9328425",
"diff_type": 1,
"num": 10
}
# 返回参数说明
参数 | 类型 | 描述 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
# 返回参数示例
{
"errcode": 0,
"errmsg": "ok"
}
# 错误码
错误码 | 错误描述 |
---|---|
公共错误码 | - |
10020055 | 参数有误,请开发者按照文档传参 |
10020050 | 没有商品权限,请获取权限后再试 |
10020051 | 参数错误,请开发者按照文档传参 |
10020052 | 商品不存在 |
10020054 | 更新库存失败 |
10020091 | 不支持该类型的商品 |
10020112 | 更新该sku库存频率超限 |
10020217 | 当前商品状态不允许直接更新库存 |
10020218 | 增加减少数量为0 |
10020219 | 库存不足以减扣 |
10020220 | 设置库存超过券码数量(本地生活商品) |