## 接口说明
stock_query.php 查询旺店通企业版 ERP 的货品库存,按【仓库 + 货品(SKU)】维度返回库存量、可用量、锁定量等数据。它是电商一盘货场景的关键出数口:以旺店通为库存主账,把可售库存按店铺/平台配额回写到各销售渠道。
### 请求要点
1. 公共参数按签名规则构造;业务参数 form 提交。
2. 分页:pageno + pagesize;建议按仓库(warehouse_no)循环拉取,避免单仓全量超时。
3. 可选 spec_no(商家编码/SKU)精确查询单个货品库存,适合库存校准任务。
4. 响应 status=0 时,data.stocks 数组含 warehouse_no、spec_no、goods_no、stock_num(库存量)、available_num(可用量)、lock_num(锁定量)等字段。
### 口径与坑
- 对外可售口径应为 available_num,而非 stock_num;同步到平台前建议再减去在途未付款订单的占用缓冲。
- 库存为快照,增量同步需依赖快照 diff 或旺店通库存变更类接口配合;轻易云采用"定时快照 + 差异下发"策略,把对销售端的写请求量降低一个数量级以上。
- 多仓场景注意仓间调拨在途,防止两边重复计数。
### 与库存同步接口的关系
stock_query 是“读”库存;若做自有商城闭环,还需配合查询库存同步接口(api_goods_stock_change_query.php)与库存同步回写接口,完成“ERP 库存变化 → 平台可售”的链路。两类接口的口径差异(ERP 账面库存 vs 平台可售库存)要在方案设计阶段定义清楚,否则上线后必然出现账实不符的投诉。