## 接口说明
taobao.qimen.stock.query 是奇门仓储标准接口中的库存查询接口(多条件),用于 ERP 侧主动查询 WMS/云仓内商品的库存量,完成对账式库存校准。聚水潭作为奇门对接方实现该接口时,调用方同样通过 target_app_key + customer_id 路由到商家数据。
### 请求要点
1. 奇门网关统一调用,公共参数与签名规则同前;format 可选 json/xml。
2. 业务查询条件(放在业务报文/extend 参数中):ownerCode(货主编码)、warehouseCode(仓库编码)、itemCode(商品编码)、itemId、pageIndex/pageSize 分页等;支持按商品列表批量条件查询。
3. 响应 items 数组通常含 itemCode、quantity(良品数量)、lockQuantity(锁定数)、inventoryType(库存类型:ZP 正品、CC 残次等)等字段;正品口径才是可售库存来源。
4. 奇门标准接口字段名采用驼峰式,与聚水潭自有开放接口(snake_case)不同,字段映射时要逐一对齐。
### 使用场景
- 定时任务:ERP 每小时拉一次云仓良品库存,与本地账面对账,差异超阈值告警;
- 大促前库存盘点校准:按 itemCode 清单批量查询,修正分仓可售数;
- 残次品(CC)库存单独归集,避免混入可售量。
### 与聚水潭自有接口的选型
同一商家既可用聚水潭新版开放接口(inventory/query),也可用奇门标准接口查库存:前者签名体系与聚水潭统一、字段更贴合 ERP;后者是行业标准,便于一套代码对接多个 WMS。轻易云默认优先新版开放接口,奇门作为淘系专属数据与多 WMS 适配场景的补充通道。