同步库存
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是商品总库存数,可售库存+独立库存+保留库存,接口逻辑会用这个数 - 独立库存 - 保留库存,去设置可售库存;增减库存时:操作可售库存的增减
示例
{
"itemId": "603c****0b0a",
"qty": 100
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
skuId
string
商品编号
itemStock
object
商品库存
available
integer
可售库存
standalone
integer
必需
独立库存,也叫预留库存,是用于特定渠道进行销售的库存
reserved
integer
必需
保留库存,也叫锁定库存,这部分库存被锁定,不可售
total
integer
总库存
示例
{
"skuId": "603c****0b0a",
"skuStock": {
"available": 100,
"standalone": 100,
"reserved": 100,
"total": 300
}
}
最后修改时间: 1 年前