库存查询接口

库存列表（按 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 作为是否充足的条件

1.8 KiB Raw Blame History Unescape Escape

库存查询接口

库存列表（按 SKU 查）

1.8 KiB

Raw Blame History