库存管理-维护与查询参考¶
适用基线：测试环境 /
dev分支 / 2026-07-15。 用途：配合库存管理使用。本页用于快速定位预计入、库存事务和库存余额；不替代采购收货、发料、盘点等来源业务的操作说明。
快速定位¶
| 你的目的 | 建议对象 | 首要定位条件 | 下一步 |
|---|---|---|---|
| 任务还在等、想看待完成预期 | 预计入库/出库 | 任务号、物料、库存状态、库位 | 联查任务状态；勿当已入账 |
| 解释一次已发生变动 | 库存事务 | 业务记录号或事务号；辅以物料、时间窗 | 跳业务记录 → 再核余额 |
| 查现在还有多少、在哪、能否用 | 库存余额 | 物料 + 库位 + 库存状态 + 批次/托盘/包装 | 异常则反查最近事务 |
| 收货/上架完了但账不对 | 先业务记录，再事务，再余额 | 记录号 → 事务号 → 完整业务键 | 同时排除仍待上架/检验 |
| 理解粒度、可用量与动作边界 | 下文「字段业务语义」 | — | 叶页摘要见三层叶页 |
字段业务语义¶
写法约定见页面数据字典规范；粒度通例见库存管理精度与唯一粒度。
本页以查询/追溯为主：无单据维护向的级联回填、来源单带入、收发数量换算专表；策略与默认值回源业务页。数量变更回到收货、发料、盘点等来源业务，不在本页改账。
字段业务语义总表¶
| 字段/对象（中文业务名） | 行为模式 | 业务作用 | 谁在何时维护/选择 | 业务约束摘要 | 影响哪些功能 | 变更或错选风险 |
|---|---|---|---|---|---|---|
| 任务号（预计入/出） | P2 | 挂接来源任务 | 查询筛选；原则上由任务写入 | 预期随任务创建/释放 | 判断待完成工作 | 手工删预期破坏追溯（GAP-019） |
| 预计入库 / 预计出库 | P9 | 待完成预期 | 由源业务任务创建；非人工主维护 | 批量物理删除入口存在风险（GAP-019） |
可用预期、看板 | 误当已入账或误删 |
| 业务记录号（事务） | P2 | 反查实际业务结果 | 查询/联查 | 事务应由记录生成 | 收货/发料/调整等追溯 | 脱离记录无法解释变动 |
| 库存事务 / 事务类型 | P1/P9 | 一次已发生变动事实 | 由业务记录生成；勿当手工改账入口 | 人工创建视为非培训主路径 | 余额更新、追溯 | 旁路写入导致账实难追（GAP-012） |
| 库存余额 | P3/P8 | 当前数量结果 | 查询；按业务键定位 | 业务键=物料+批次+托盘+包装+库存状态+库位 | 发料/出库选库存、盘点 | 条件不全会查错或混粒度（GAP-005/GAP-022） |
| 可用量口径 | P3 | 能否被下游选用 | 查询时理解 | 是否扣减预留/预计出 ❓ | 出库选余额 | 超发或选不到 |
| 冻结 / 库存状态 | P1/P3 | 是否可用于下游 | 系统或受控业务 | 影响发料/出库/转移可选范围（细节 ❓） | 下游选择器 | 「有数不能用」 |
| 审计字段 | P14 | 追溯 | 系统写入 | 勿导入维护 | — | — |
选择器范围表 / 查询过滤（P2 / P3 / P13）¶
| 场景 | 选择/过滤对象 | 可选或检索范围 | 范围依赖 | 选中或查到后看什么 | 选不到/查不到时通常原因 |
|---|---|---|---|---|---|
| 本页列表筛选：预计 | 预计入/出 | 按任务号、业务类型、物料、库位、状态 | 源任务是否已生成/已清理 | 待完成数量与维度 | 任务未建、已完成已清理、筛错类型 |
| 本页列表筛选：事务 | 库存事务 | 按记录号、事务号、业务类型、时间、物料 | 源记录是否已形成 | 变动量与维度 | 业务未形成记录、时间窗不对 |
| 本页列表筛选：余额 | 库存余额 | 须按完整业务键理解行 | 权限是否裁剪 ❓（GAP-014） |
结存量与最近事务 | 漏维、仍在预期未入账 |
| 发料/出库等业务中选余额 | 余额行 | 物料+库位/状态/批次/包装/托盘过滤，且可用量足够（口径 ❓） | 单据物料、仓库、状态要求；权限 ❓ | 锁定粒度维度与可扣上限 | 无余额、状态不符、粒度未采、可用量不足、权限外 |
本库存查询页以列表筛选为主；若出现新增/编辑按钮被注释，培训仍按「查询为主」。
精度与采集表（P8）——余额业务键¶
| 精度/维度 | 何时必须采集 | 采集入口（Web/PDA） | 缺失时能否完成 | 对库存唯一粒度的影响 |
|---|---|---|---|---|
| 物料 + 库位 + 库存状态 + 批次 + 托盘 + 包装 | 形成/查询余额时按业务键理解 | 由收货/发料/上架等源业务采集 | 源业务缺维通常不能正确入账/扣减 | 任一项不同即不同余额行（GAP-005） |
状态与动作边界（P9）¶
| 对象 | 允许动作 | 前置检查 | 下游影响 | 风险 |
|---|---|---|---|---|
| 预计入 | 查询；禁止把批量删除当清账 | 来源任务是否仍需要该预期 | 删除后任务与预期脱节 | GAP-019/GAP-020 |
| 事务 | 查询/导出 | 权限与过滤条件 | — | 后端鉴权证据不足（GAP-021，挂 GAP-014） |
| 余额 | 查询/导出；详情联查事务 | 应用完整业务键过滤 | — | 详情事务过滤不完整（GAP-022）；勿直接改余额消差异 |
预计入库：查询待完成预期¶
预计入库表达由任务带来的待完成入库预期，不等同于已入账库存。采购收货任务创建时会形成预计入；其它业务是否形成预计结果需按各自业务验证。
| 建议查看 | 用途 |
|---|---|
| 任务号、业务类型 | 找到预计来自哪项待执行工作 |
| 物料、数量、单位 | 核对待完成的对象和数量 |
| 库位、仓库、库存状态 | 判断预计会落入何处、以何种状态进入库存 |
| 批次、托盘、包装 | 对需要追溯的物料核对库存维度 |
📷 截图占位
预计入库列表。标出任务号、物料、数量、库存状态、库位和来源查询条件。
库存事务：追溯一次变化¶
库存事务记录实际业务形成的一次库存变动。查询时优先从业务记录号或事务号定位；若只知道物料，应同时带上地点、状态和批次/包装缩小范围。
| 建议查看 | 用途 |
|---|---|
| 事务号、事务类型、业务类型 | 判断这是哪类变化 |
| 业务记录号 | 反查实际收货、发料、盘点或其它业务结果 |
| 物料、数量、单位 | 核对变化对象和变化量 |
| 库存状态、库位、批次/包装 | 判断变化发生在什么库存维度 |
| 发生时间、处理人 | 辅助追溯处理时点和责任线索 |
当前实现存在批量创建库存事务的服务入口，但正常业务人员是否可直接人工创建、可修改哪些内容，应以页面权限和测试环境为准；培训中应优先通过来源业务形成事务。
📷 截图占位
库存事务列表、详情与「来源业务记录」跳转入口。
库存余额：查看当前结果¶
余额查询应把物料、库位、库存状态、批次、托盘和包装作为一个整体理解。即使物料相同，只要其中一项不同，也可能是不同的库存结果和不同的可用范围。
| 推荐顺序 | 查询字段 | 为什么先看它 |
|---|---|---|
| 1 | 物料、库位、库存状态 | 确认要找的物料在哪个地点、是否处于可用状态 |
| 2 | 批次、托盘、包装 | 排除同物料不同追溯单元混在一起的情况 |
| 3 | 数量、单位 | 判断当前结果是否满足需求 |
| 4 | 仓库、库区、库位组、货主 | 在多仓、多归属场景中进一步定位 |
| 5 | 最近事务号和时间 | 继续追溯最近一次变化 |
📝 示例数据占位
同一物料在两个库位、两种库存状态、两个批次下形成四条余额的示例。
详情与联查建议¶
| 详情分组 | 业务内容 | 快速跳转 |
|---|---|---|
| 库存识别与数量 | 物料、数量、单位、货主 | 物料基本信息 |
| 地点与状态 | 仓库、库区、库位、库存状态、冻结信息 | 仓库/库位资料 |
| 批次与包装 | 批次、托盘、包装及有效期信息 | 批次或包装追溯（后续补充） |
| 来源与最近变化 | 最近事务、业务记录、来源任务 | 库存事务、对应业务记录 |
| 系统信息 | 创建、更新时间和操作线索 | 操作或接口日志（后续补充） |
查询前快速核对¶
| 场景 | 最少先核对什么 |
|---|---|
| 查「是否已入库」 | 业务记录是否已生成，是否已有库存事务，再查余额 |
| 查「为什么数量不同」 | 物料、单位、库位、库存状态、批次/包装是否一致 |
| 查「为什么不能使用」 | 库存状态、冻结、地点和所在业务的选择条件 |
| 查「任务是否还在等待」 | 任务状态与预计入是否仍存在 |
仍待业务确认¶
- 三类库存页面的真实详情 Tab、默认列表列和快速跳转过滤条件；
- 人工维护预计入、库存事务或库存余额的页面入口、权限和审计要求（
GAP-012、GAP-019～GAP-021）； - 余额唯一粒度与详情反查事务过滤条件的技术改进（
GAP-005、GAP-022）； - 冻结、质量状态、上架和盘点差异对可用库存的具体影响。