## 接口说明
inventory/query 查询聚水潭 ERP 的商品库存,返回 SKU 在主仓及各分仓的库存数量。与订单接口不同,库存接口支持按库存修改时间增量拉取,适合高频(分钟级)的库存同步任务,是全渠道一盘货与超卖防控的核心数据源。
### 请求要点
1. POST + application/json,公共参数参与签名(同授权文档规则)。
2. 业务参数:page_index、page_size、modified_begin/modified_end(库存修改时间窗口);也可传 sku_ids(逗号分隔多个 SKU)做精确查询,wms_co_id 指定分仓。
3. 返回 data.inventorys(或按版本为 datas)数组,常见字段:sku_id(款式/SKU 编码)、qty(主仓库存数)、available_qty(可用数)、lock_qty(锁定/占用数)、wms_co_id、wms_qty(分仓数量)。
4. 对外可售口径建议:available_qty(或 qty - lock_qty)再按店铺配额切分;直接同步 qty 会在大促占用高峰造成超卖。
### 集成建议
- 增量游标用 modified_begin 记录上次同步的最大修改时间,窗口重叠 1-2 分钟防边界遗漏。
- 轻易云库存同步方案按【聚水潭库存 → 差异计算 → 平台库存回写】编排,并对回写失败做告警与自动重试。
### 分仓口径
聚水潭企业版支持多仓(分仓 wms_co_id),主仓库存与分仓库存是两套口径:做全渠道一盘货时,先与业务确认以哪套为准;分仓模式下建议逐仓拉取并分别计算可售量,再按平台/店铺的归属仓汇总下发,避免把 A 仓的货卖到 B 仓的店铺造成无货可发。