库存管理¶

适用基线：测试环境 / dev 分支 / 2026-07-15。 阅读对象：测试、实施、运维（主）；仓库主管、库存查询、收发料执行人员（顺带）。

业务目的与适用范围¶

库存查询常混成一件事，其实要分三层看：预计入库/出库回答「已经安排、尚未完成」；库存事务回答「某一次业务造成了什么变动」；库存余额回答「现在某处还剩多少」。读完本页，应能按问题选对入口——例如「任务还在等收货」先查预期，「收货完了为什么账变了」先查事务，「现在能不能发」先查余额——再沿「余额 → 事务 → 业务记录」或「任务 → 预期 → 记录 → 事务 → 余额」联查，而不是把三张表当同一份结果反复对。

本页讲清三类对象如何衔接、何时查哪一层、怎样从结果追溯回业务来源。具体查询字段、库存粒度、列表/详情规划和验证细节见库存管理-维护与查询参考。

如何使用本组文档¶

不确定时：先用本页「想解决什么 → 优先入口」表选层；字段与联查细节再下沉维护参考。

关键业务对象与关系¶

采购收货已确认采用「收货任务形成预计入 → 收货记录形成库存事务 → 事务更新余额」。其它业务应按自身来源、任务和记录规则分别确认，不能仅因为都涉及库存就直接套用采购收货的状态或动作。

三类对象分别解决什么问题¶

日常业务如何影响库存¶

1. 业务来源先形成申请、任务或其他待执行工作；是否生成预计入/预计出取决于具体业务。
2. 现场执行产生实际业务记录；记录应保留来源、物料、数量、批次、包装、库存状态和库位等关键信息。
3. 实际记录形成库存事务——解释「为什么变了」的主要入口。
4. 库存余额反映事务处理后的当前结果；异常时应「余额 → 事务 → 业务记录/任务」，不要直接改余额消差。

三类对象以查询与追溯为主（GAP-012），不是日常手工改账入口。修正库存应走盘点、退货、调拨、报废等对应业务，而不是在库存查询页改数。

建议验证点¶

• 走通一笔采购收货：任务生成后能查到预计入；收货完成后预计入清理/消失，事务与余额按实收更新。
• 同一物料在不同库位或库存状态下拆成多条余额；查询或发料时漏维会误判可用量（GAP-005 / GAP-022）。
• 「只见预计不见余额」：确认任务是否已执行并产生记录与事务，勿把预计当已入账。
• 余额详情反查事务时，人工带齐物料/库位/状态/批次/托盘/包装，核对过滤是否漏维（GAP-022）。
• 预计入若出现批量删除入口，确认培训口径禁止当清账工具（GAP-019）；接口参数/鉴权见 GAP-020、GAP-021。
• 现场反馈「有数不能用」：先查余额状态与冻结，再查下游选择条件，再查最近事务是否状态变更未完成。

库存数量与位置的关键判断¶

库存余额不是只按「物料」汇总。当前业务口径至少同时关注批次、托盘、包装、物料、库存状态和库位；同一物料在不同库位、批次或状态下应视为不同可用结果。

因此，在查询「库存不足」「账实不一致」或「为何不能发料」前，应先确认条件是否覆盖正确的物料、库位、批次/包装和库存状态，不能只看物料总数。

关键字段业务角色（查询页）¶

完整语义见维护与查询参考；粒度通例见库存管理精度与唯一粒度。

同一物料在业务上可拆成多条余额。业务键为：物料 + 批次 + 托盘 + 包装 + 库存状态 + 库位（见库存管理精度与唯一粒度）。数据库是否有等价唯一约束仍属 GAP-005，图中不把它画成已实现约束。

过账与对象挂接见库存数据挂接模型。本分组没有独立策略页；可选范围与过账行为主要受上游业务类型、源业务记录与库存状态约束。变更前请在测试环境走通「源业务 → 事务 → 余额」并留回退路径。

查询、详情与快速跳转¶

详情分组与快速跳转¶

常见问题与处理¶

当前限制与待确认事项¶

• GAP-012：预计入、库存事务、库存余额以查询与追溯为主，不应作为日常手工改库存的入口。
• GAP-019：预计入列表仍可能暴露「批量删除」类入口；培训上预计入应由任务创建/释放，禁止把它当清账工具。
• GAP-020：预计入删除相关接口参数定义存在错位风险；单条删除入口多已隐藏，恢复或外部调用前须先核接口契约。
• GAP-021：导出等动作前端可有权限码，后端强制鉴权证据不足；授权结论须结合实测（并挂 GAP-014）。
• GAP-005 / GAP-022：余额业务粒度已确认，但 DDL 唯一约束与余额详情反查事务的过滤条件可能未带齐托盘/库存状态/库位等维度；查询与判断须人工带齐完整维度，勿只看物料总数。
• 各类来源业务生成预计入/预计出的时点不能一概而论，当前仅确认采购收货任务会形成预计入；
• 库存状态、冻结、质量处理和上架对可用量的最终影响，需在 WMS/QMS 跨模块测试中补充。

待补充的图示与示例¶