增减库存
POST/ark/open_api/v3/common_controller| 错误码 | 错误码描述 | |
|---|---|---|
| -5009604 | 接口报错 | |
| -5009501 | 不是有效的ObjectId | |
| -5009025 | 未找到ITEMID,请重新尝试 | |
| -5009015 | 商品不属于本商家 | |
| -5009001 | 找不到商家 请重新尝试 | |
| -5009202 | 库存总数不能小于0 | |
| -5009030 | 暂时无法通过开放平台更新组合商品库存数，请使用新版编辑页进行更改 | |
| -5009026 | 该商品不允许修改库存 |
请求参数
Body 参数application/json
skuId
string
商品编号
qty
integer
必需
同步库存数/增减库存数，同步库存时：qty是商品总库存数，可售库存+独立库存+保留库存，接口逻辑会用这个数 - 独立库存 - 保留库存，去设置可售库存；增减库存时：操作可售库存的增减
示例
{
"skuId": "string",
"qty": 0
}示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
skuId
string
商品编号
skuStock
object
商品库存
available
integer
可售库存
standalone
integer
必需
独立库存，也叫预留库存，是用于特定渠道进行销售的库存
reserved
integer
必需
保留库存，也叫锁定库存，这部分库存被锁定，不可售
total
integer
总库存
示例
{
"skuId": "603c****0b0a",
"skuStock": {
"available": 100,
"standalone": 100,
"reserved": 100,
"total": 300
}
}
【小红书】API开发者 微信交流群
扫码加入交流群最后修改时间： 1 年前