即时库存查询(STK_Inventory)

## 接口说明 金蝶云星空的库存快照保存在即时库存表单(FormId:STK_Inventory)中,同样通过 ExecuteBillQuery 通用查询接口读取。它按【库存组织 + 物料 + 仓库 + 仓位 + 批号】维度返回库存量(FQty)、可用量(FAVBQty)、锁库量(FLockQty)等字段,是库存同步、全渠道一盘货、智能补货场景的基础数据源。 ### 请求要点 1. FormId 固定为 STK_Inventory;常用 FieldKeys:FMaterialId.FNumber(物料编码)、FStockId.FNumber(仓库编码)、FStockOrgId.FNumber(库存组织)、FQty、FAVBQty、FStockStatusId.FName。 2. 即时库存是快照而非流水,没有修改时间字段,不能按时间增量过滤;建议全量分页拉取后在轻易云侧做前后快照比对,计算差异后再下发,避免全量冲刷下游。 3. 过滤零库存行可加 FilterString:FQty <> 0,显著减少数据量。 4. 多组织集团客户要按 FStockOrgId 分别过滤,防止跨组织串库存。 ### 与补货模型的衔接 轻易云智能补货方案通常以该接口的 FAVBQty 作为可用库存输入,结合在途采购单(PO 未入库数量)与安全库存阈值生成补货建议,再回写采购申请单。 ### 性能注意 即时库存行数与“物料 × 仓库 × 批号”组合数成正比,商贸企业常见规模在几十万行;按单页 2000 行全量拉取一次需要数十次请求,建议在业务低峰执行,并把快照落到中间库,下游比对与消费都读中间库,避免反复扫描源系统影响 ERP 在线业务。