ircloud-assistant/skills/irun-yidianhuo/inventory.md

库存查询接口

库存列表（按 SKU 查）

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

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

Body 参数：

{
  "currentPage": 1,
  "pageSize": 10,
  "warehouseId": 2116753909958624,
  "skuIds": [2116792188293408, 2287816343303072]
}

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

返回：

{
  "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 作为是否充足的条件