# 获取库存
- 查询库存接口已做限流处理, 1小时内允许访问1次,建议使用客户端的【推送库存接口】更新库存
接口地址 /api/order/inventory
请求方式 POST
consumes ["application/json"]
produces ["*/*"]
接口描述 ``
请求示例
{
"warehouseId": null,
"sku": null
}
1
2
3
4
2
3
4
请求参数
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| form | form | body | true | QueryInventoryApiRequest | QueryInventoryApiRequest |
| token | token | header | true | string |
schema属性说明
QueryInventoryApiRequest
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| sku | sku | body | false | string | |
| warehouseId | 仓库ID | body | false | string |
响应状态
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | GenericResult |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| data | InventoryDto | ||
| message | string | ||
| success | boolean |
schema属性说明
InventoryDto
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| warehouseId | 仓库ID | string | |
| sku | sku | string | |
| qty | 总库存数量 | integer | |
| qtyLocked | 锁定库存数量 | integer | |
| qtyUsable | 可用库存数数量(总库存数 - 锁定库存数) | integer | |
| skuUnit | sku单位 (PCS / CARTON) | string |
响应示例
{
"success": true,
"message": "",
"data": [
{
"warehouseId": "491400208890597376",
"sku": "WZXY01",
"qty": 48,
"qtyLocked": 10,
"qtyUsable": 38,
"skuUnit": "PCS"
},
{
"warehouseId": "491400208890597376",
"sku": "kuzi-003-aiqi",
"qty": 37,
"qtyLocked": 25,
"qtyUsable": 12,
"skuUnit": "CARTON"
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22