71 库存列表
用于获取SKU(包括有品发货SKU)库存数
1. 接口
/mtop/aftersale/openapi/inventory/list
2. 接口参数
公共参数
请求参数
| 字段 | 类型 | 是否必填 | 备注 |
|---|---|---|---|
| skuIdList | List<Long> | 否 | sku列表,用于限定查询范围,size <= 100 |
| pageSize | Integer | 否 | 页大小,默认20,pageSize <= 100 |
| pageNum | Integer | 否 | 当前页号, 默认1, 从1开始 |
3.请求实例
data: {
"skuIdList": [], // or [3012345,3112346]
"pageNum": 1,
"pageSize": 20
}
4. 返回结果
| 字段 | 类型 | 备注 |
|---|---|---|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页数据条数 |
| total | Integer | 数据总条数 |
| skuInventoryList | List<SkuInventory> |
库存列表 |
SkuInventory 信息:
| 字段 | 类型 | 备注 |
|---|---|---|
| skuId | Long | skuId |
| inventory | Long | 库存 |
| detail | SkuInventoryDetail |
库存明细 |
SkuInventoryDetail 信息:
| 字段 | 类型 | 备注 |
|---|---|---|
| youpinOnSaleInventory | Long | 有品仓在售库存 |
| youpinNoSaleInventory | Long | 有品仓不可售库存(该SKU在自发货渠道有实物库存) |
| merchantFreeInventory | Long | 商家仓可支配库存(可以不经过审批直接扣减) |
| merchantBindInventory | Long | 商家仓不可支配库存(扣减库存需要在商家工作台提交申请,由供应链进行审批) |
| merchantOrderCountOnYoupin | Long | 商家仓有品渠道订单占用 |
| merchantOrderCountOnVmi | Long | 商家仓非有品渠道订单占用 |
商家可以直接扣减数量 = 商家仓可支配库存(merchantFreeInventory) - 商家仓有品渠道订单占用(merchantOrderCountOnYoupin)
5. 返回示例
{
"code": 0,
"message": "ok",
"data": {
"total": 2000,
"pageSize": 10,
"pageNum": 1,
"skuInventoryList": [{
"skuId": 3001869,
"inventory": 1000,
"detail": {
"youpinOnSaleInventory": 100,
"youpinNoSaleInventory": 200,
"merchantFreeInventory": 300,
"merchantBindInventory": 400,
"merchantOrderCountOnYoupin": 3,
"merchantOrderCountOnVmi": 0
}
}]
}
}