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
}
}]
}
}