71 库存修改
用于增减SKU库存数
1. 接口
/mtop/aftersale/openapi/inventory/update
2. 接口参数
公共参数
请求参数
字段 | 类型 | 是否必填 | 备注 |
---|---|---|---|
itemList | List<UpdateSkuInventoryItem> | 是 | 修改列表,size<=100 |
type | Integer | 否 | 库存更新方式,可选。0为增量更新,1为全量更新。如果不填,默认为增量更新 |
UpdateSkuInventoryItem
信息:
字段 | 类型 | 备注 |
---|---|---|
skuId | Long | skuId |
changeCount | Long | 库存修改值,必填。type=0或不传表示增量更新,正数补库存,负数扣减库存(只能扣减商家仓可支配库存);type=1表示全量库存覆盖(覆盖数量不能少于商家仓不可支配库存) |
注:库存数上限为999999999
3. 请求实例
data: {
"itemList": [
{
"skuId": 3001681,
"changeCount": -1 // 表示操作skuId 3001681 库存数减1
}
],
"type": 0 // 表示增量更新
}
4. 返回结果
字段 | 类型 | 备注 |
---|---|---|
updatedSkuInventoryList | List<SkuInventory> |
修改后的库存列表 |
SkuInventory
信息:
字段 | 类型 | 备注 |
---|---|---|
skuId | Long | skuId |
inventory | Long | 库存 |
detail | SkuInventoryDetail |
库存明细 |
SkuInventoryDetail
信息:
字段 | 类型 | 备注 |
---|---|---|
youpinOnSaleInventory | Long | 有品仓在售库存 |
youpinNoSaleInventory | Long | 有品仓不可售库存(该SKU在自发货渠道有实物库存) |
merchantFreeInventory | Long | 商家仓可支配库存(可以不经过审批直接扣减) |
merchantBindInventory | Long | 商家仓不可支配库存(扣减库存需要在商家工作台提交申请,由供应链进行审批) |
merchantOrderCountOnYoupin | Long | 商家仓有品渠道订单占用 |
merchantOrderCountOnVmi | Long | 商家仓非有品渠道订单占用 |
5. 返回结果
{
"code": 0,
"message": "ok",
"data": {
"updatedSkuInventoryList": [
{
"skuId": 3001869,
"inventory": 9999,
"detail": {
"youpinOnSaleInventory": 100,
"youpinNoSaleInventory": 200,
"merchantFreeInventory": 299,
"merchantBindInventory": 400,
"merchantOrderCountOnYoupin": 3,
"merchantOrderCountOnVmi": 0
}
}
]
}
}