# 库存查询接口

## 库存列表（按 SKU 查）

```
POST https://openapi.77ircloud.com/invoicing-aggregation/inventories-sku/search
```

**Header:** `access_token: {token}` + `Content-Type: application/json`

**Body 参数：**
```json
{
  "currentPage": 1,
  "pageSize": 10,
  "warehouseId": 2116753909958624,
  "skuIds": [2116792188293408, 2287816343303072]
}
```

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `warehouseId` | int | **必填** | 仓库ID，从仓库列表接口获取 |
| `skuIds` | array | 可选 | 商品SKU ID数组，不传则返回该仓库全部库存 |
| `currentPage` | int | 可选 | 页码，默认1 |
| `pageSize` | int | 可选 | 每页数量，默认10 |

**返回：**
```json
{
  "code": 200,
  "data": {
    "totalCount": 80,
    "currentPage": 1,
    "pageSize": 10,
    "items": [
      {
        "skuId": 2116792188293408,
        "spuId": 2116792188162336,
        "name": "霜火菓子（柿子+花生）",
        "code": "101-030-0008",
        "amount": 3,
        "availableAmount": 7,
        "preOrderCount": 83,
        "unitName": "件",
        "unitId": 2116753910024416,
        "status": 23
      }
    ]
  }
}
```

**关键字段说明：**

| 字段 | 类型 | 说明 |
|------|------|------|
| `availableAmount` | number | **可用库存**（扣减预占后的真实可用），用于判断是否充足 |
| `amount` | number | 总库存（含预占） |
| `preOrderCount` | number | 预占数量（被其他订单占用） |
| `skuId` | number | 商品SKU ID，与订单中商品对应 |

**注意：**
- ⚠️ **只有产生过出入库数据的商品才会出现在结果中**（无业务数据的SKU不返回）
- `warehouseId` 必填，必须先从仓库列表获取
- 库存判断用 `availableAmount > 3` 作为是否充足的条件