主题
物料管理
页面定位
物料管理不是单纯的“物料档案表”，而是仓库管理里的总控页。
你可以把它理解成三层能力放在同一页里：
- 基础档案维护：维护物料名称、规格、类别、供应商、单位、安全库存等信息
- 库存执行入口：直接发起入库、出库、盘库
- 库存判断中心：查看当前库存、在途、缺料、待领、价格历史、库存变化记录
也就是说，很多与仓库有关的问题，第一反应都应该先来这里看：
- 这个物料有没有建档
- 现在库存还剩多少
- 为什么会缺料
- 有没有采购在路上
- 有没有领料还没领走
- 最近价格有没有变过
菜单路径
仓库管理 → 基础数据 → 物料信息
谁会用到这个页面
- 仓库管理员：维护物料、做入库出库和盘库
- 采购人员：看缺料、做智能采购、追踪在途
- 拆单 / 生产相关人员：确认待领、核对物料是否可用
- 管理人员：复盘库存变化、价格变化和异常波动
建议你先看哪里
这张图想帮你先建立阅读顺序：物料管理最难的不是记按钮，而是先分清这页到底是在“建档”、还是在“执行库存动作”、还是在“判断库存状态”。
页面整体分工
这张图想帮你看懂：这个页面不是只有一张列表，而是把“筛选、判断、执行、追溯”四件事都集中到了一个入口里。
搜索与筛选怎么用
根据当前前端实现，这页的搜索不是传统表单检索，而是更偏向“快速定位 + 交叉筛选”：
- 顶部输入框：输入你能想到的物料相关信息
- 类别按钮组：按物料类别筛选
- 供应商按钮组：按供应商筛选
- 显示已停用开关：决定是否把已停用物料也显示出来
其中关键词搜索会同时匹配多类信息，包括：
- 名称
- 规格
- 类别名称
- 单位
- 供应商名称
- 位置
- 别名
- 备注
而且它支持按空格拆分关键词组合检索，不只是单一模糊搜索。
列表默认排序与自定义排序
为了提升一线的找件和核对体验，物料列表支持双重排序规则：
- 默认拼音排序：启用状态与可见物料列表在初始化加载时，默认以 “物料类别 → 物料名称 → 物料规格 → 供应商” 的中文拼音首字母升序进行多级字典排序，保证相似规格和品类的物料集中展示。
- 列头数值排序：列表上所有的库存和数量字段列（包括：库存、在途、预计库存、待领、待受理、未下单、安全库存 等）均支持点击列头，执行快速的数值大小升序或降序排列，方便采购与仓管快速筛查库存最高或最紧缺的物料。
列表关键指标怎么理解
列表里最容易让新手混淆的，不是名称和规格，而是中间那几个库存和状态相关的数量列。
| 列 | 作用与含义 |
|---|---|
| 类别 | 这个物料归属于哪类物料 |
| 名称 | 物料主名称；如果已停用，会额外看到“已停用”标记 |
| 规格 | 同名物料进一步区分的关键条件 |
| 供应商 | 这个物料当前可选择的供应商列表 |
| 单价 | 当前生效价格；点击可以看价格变更历史 |
| 价格策略 | 当前单价是手动、加权平均还是最近采购价 |
| 库存 | 现在仓库里实际还剩多少；点击可以看库存变化记录 |
| 预计库存 | 动态计算的未来可用量，带有红/黄/绿状态图标 |
| 在途 | 已经采购但还没真正入库的数量；点击可看采购明细 |
| 待受理 | 领料单审批中或等待仓库处理的待领料明细数量；点击可弹窗查看待受理明细 |
| 未下单 | 已在智能采购计划中生成，但尚未正式向供应商下单的物料数量；点击可弹窗查看未下单采购计划明细 |
| 待领 | 已经有人申请且仓库已配货、但还没真正领走的数量；点击可看待领明细 |
| 缺料 | 当前建议采购数量，计算提示为“安全库存 + 待领 + 待受理 - 库存 - 在途” |
| 安全库存 | 低于这个值时，就说明应该开始考虑补货 |
| 单位 | 计量单位 |
| 别名 | 领料匹配时常用的辅助名称 |
| 位置 | 物料在仓库里的常放位置 |
| 备注 | 补充说明 |
缺料、在途、待领之间是什么关系
这张图想帮你理解几个数字不是彼此独立的：真正决定要不要采购的，不只是“库存少不少”，而是库存、待领、在途、安全库存一起算出来的结果。
顶部操作区都在做什么
根据当前页面实现，顶部主要操作包括：
- 智能采购：把当前缺料物料整理成采购计划
- 入库：对一批物料做手工入库
- 出库：对一批物料做手工出库
- 盘库：录入盘点结果，修正库存
- 新增：新建物料档案
- 批量删除：删除选中的物料
- 导出：导出当前筛选后的物料档案
- 导出出入库明细：根据时间范围导出物料的详细库存变动流水记录
- 导入：通过通用导入弹窗批量导入物料
- 刷新 / 列设置：刷新数据、调整显示列
另外，这些按钮并不是所有人都一定能看到，页面会按权限控制显示。
新增 / 编辑物料时实际要填什么
根据当前抽屉实现，新增或编辑时主要维护这些内容：
| 信息项 | 说明 | 必填 |
|---|---|---|
| 名称 | 物料名称 | 是 |
| 规格 | 规格信息 | 否 |
| 类别 | 所属物料类别 | 是 |
| 单位 | 计量单位 | 是 |
| 供应商 | 可用供应商，可多选 | 是 |
| 价格 | 当前价格 | 否 |
| 价格策略 | 加权平均 / 最新采购价 / 手动设置 | 是 |
| 库存数量 | 仅新增时可录入初始库存 | 新增时是 |
| 位置 | 仓库存放位置 | 否 |
| 安全库存 | 最低警戒值，0 表示不限制 | 是 |
| 编码 | 物料编码 | 否 |
| 别名 | 领料匹配时可用的辅助名称 | 否 |
| 备注 | 补充说明 | 否 |
| 创建时间 | 物料档案首次建立的时间（仅详情页/编辑页可见只读） | - |
其中有几个很关键的真实规则：
- 新增时才录初始库存，编辑已有物料时不能直接在这里改库存。
- 价格策略不是展示字段，而是实际生效规则。
- 如果编辑时选择的是手动设置价格策略，会要求填写“价格变更原因”。
- 系统会在新增时检查“名称 + 规格”是否和已有物料冲突；如果发现冲突，不是直接报死错，而是提示你加载已有物料继续编辑。
新增和编辑为什么要分开理解
这张图想帮你避免一个典型误区：物料抽屉不是万能修改器，库存变动应走入库、出库、盘库，而不是回到编辑里直接改数。
三类库存操作怎么区分
1. 入库
入库用于把物料数量真正加到当前库存里。
当前实现支持：
- 从已勾选物料带入
- 通过搜索快速添加物料
- 通过“选择物料”抽屉补充物料
- 为每种物料录入入库数量
- 统一填写本次操作备注
2. 出库
出库用于手工扣减库存。
和入库类似，但有一个重要限制：
- 出库数量不能大于当前库存数量，否则系统直接阻止提交
3. 盘库
盘库不是简单加减，而是把“系统库存”改成“你盘点出来的实际库存”。
盘库时你会同时看到：
- 当前库存
- 盘点数量
- 盘点结果：多了 / 少了 / 正常
这张图想帮你分清三种动作的边界：入库和出库是执行动作，盘库是校正动作，三者不能混着用。
库存、价格、在途、待领都能点进去看什么
这页一个很重要的特点是：很多数字都不是死数字，而是可下钻追溯的入口。
点“库存”会看到什么
点击库存数字，会打开库存变化记录，可看到：
- 时间
- 类型（入库、出库、盘盈、盘亏、正常、导入）
- 变化前后数量
- 来源说明
- 操作人
而且来源说明会尽量带出业务来源，例如：
- 采购单入库
- 订单领料
- 补料出库
- 退料入库
- 自由操作
导出出入库明细（新）
在物料列表操作区，点击“导出出入库明细”按钮，可以根据时间范围批量导出物料的库存变动记录。
- 操作时间范围：支持选择最近 6 个月内的日期范围。
- 快捷选项：支持“本月”、“上月”快速选择。
- 导出内容：包含操作时间、物料名称、规格、操作类型、变动前数量、变动数量、变动后数量、来源说明及操作人等。
点“单价”会看到什么
点击单价，会打开价格变更历史，可看到：
- 变更时间
- 变更前 / 后价格
- 价格策略
- 变更原因
点“在途”会看到什么
点击在途数量，会打开在途明细，展示该物料所有未完成入库的采购明细，包括：
- 采购单号
- 采购数量
- 已入库数量
- 待入库数量
- 当前进度（待入库 / 部分入库 / 已入库）
点“待领”会看到什么
点击待领数量，会打开待领明细，展示该物料所有还没领完的领料明细，包括：
- 订单编号
- 申请数量
- 已领数量
- 待领数量
- 申请人
如果当前用户有订单查看权限，还能直接从这里跳转到订单详情。
点“待受理”会看到什么（新）
点击待受理数量，会弹出物料待受理数量详情面板，展示所有处于审核中或仓库配货待受理阶段的领料明细：
- 领料单号；
- 订单编号 / 关联客户订单名称；
- 申请领用数量；
- 申请人与申请时间。
点“未下单”会看到什么（新）
点击未下单数量，会弹出物料未下单采购计划详情面板，展示已由智能采购生成但在系统中尚未下发给供应商的采购计划：
- 采购计划单号；
- 关联订单号 / 客户单号；
- 计划采购数量；
- 计划创建时间与操作人。
智能采购怎么理解
智能采购不是“看到想买就买”，而是把当前缺料数量大于 0 的启用中物料整理出来，帮你快速生成采购计划。
当前逻辑里：
- 只有启用中的物料会进入智能采购候选；
- 只有缺料大于 0 的物料可参与；
- 系统会默认带出建议采购数量（安全库存 + 待领 - 库存 - 在途）；
- 系统会默认选中该物料的第一个合作供应商；
- 你仍然可以在弹窗里直接修改采购数量、切换不同的供应商；
- 计划行一键删除：如果某项物料暂时不需要采购，采购员可以直接点击右侧操作列的 【删除】 按钮，将该行物料从本次采购计划中快速移出；
- 最后确认无误后，系统会按供应商自动分组，合并生成对应的采购计划单。
这张图想帮你理解：智能采购的本质不是自动下单，而是把“缺什么、买多少、向谁买”先整理成一批待审核计划。
停用物料要怎么理解
页面默认会隐藏已停用物料，只有打开“显示已停用”开关才会看到。
而且停用不是单纯做个标记。根据当前页面提示：
- 停用后，该物料将无法被采购、领料、补料等流程选用
所以停用更像是“冻结该物料继续参与业务”，不是普通备注状态。
物料历史快照机制与物理删除
为了保障历史单据（如：采购单、出入库流水、领退料单等）及财务账目的可追溯性与数据完整性，系统引入了物料数据历史快照机制与物理删除前置校验拦截。
1. 历史快照保护
- 历史数据隔离：当管理员在后台修改当前物料档案的名称、规格、分类或计量单位，或者对物料进行停用时，已经生成的历史单据中保存的物料数据完全不受影响。它们会永久封存该单据生成时刻的物料快照状态，防止由于档案变更导致过往账目及交易记录发生历史性错乱。
- 可信对账：财务和仓管人员在回查几个月前的历史单据时，依然能够看到当时真实的物料信息，保障审计无误。
2. 物理删除前置强校验
为了防止误删除导致正在执行的订单流转受阻，系统对物理删除设置了严格的拦截逻辑：
- 活跃单据检测：只有当物料档案没有关联任何活跃单据（如：等待入库的采购单、审批中或待领用的领料/补料申请、待收货的退料单等未完结业务）时，系统才允许执行物理删除。
- 强拦截阻断：若物料仍在活跃业务中使用，系统会抛出明确异常并阻断删除操作，要求业务人员先处理完结或作废相关单据。
3. 静态快照冗余兜底机制
- 若物料已通过前置强校验并执行了物理删除，其历史关联流水和已归档单据不会被损坏。
- 系统通过静态快照冗余数据兜底机制，依然会在历史报表上显示该物料原有的属性（如名称、规格、供应商），并在名称旁自动附加红色高亮
（已删除）标识，既方便追查，又确保页面不显示空白或报空值错误。
📥 数据导出二次确认
在列表操作区点击 【导出】 按钮时，系统会基于当前用户设置的交叉筛选条件进行数据提取，并在执行下载前弹出二次确认提示。这不仅能让您核对是否导出正确的物料范围，同时能有效防范因连续误点击导出大体量数据而导致的服务器瞬时性能负载波动。
常见场景
场景一：新物料第一次建档
- 点击新增
- 填名称、规格、类别、单位、供应商
- 补安全库存、位置、别名等信息
- 如有现货，可直接录入初始库存
- 保存后开始进入后续采购、领料、库存管理流程
场景二：仓库收到一批新板材
- 进入物料管理
- 直接点“入库”
- 添加对应物料
- 填入库数量
- 补备注
- 提交后库存立即增加
场景三：为什么明明库存不低，系统还是提示缺料
- 先看该物料的待领数量是否很高
- 再看是否有安全库存要求
- 再看在途数量是否还没到货
- 最后综合判断缺料值为什么大于 0
场景四：想查某个物料库存为什么突然变少了
- 先点击库存数字
- 打开库存变化记录
- 看是自由出库、订单领料、补料还是盘亏
- 再根据来源单据继续往下追
常见问题
1. 什么是“预计库存”，为什么它会有不同颜色的图标？
“预计库存”是系统帮你算的一笔账：当前库存 - 待领数量 + 在途数量。 它反映了：如果所有该领的都领走，所有采购的都到货，仓库还能剩多少。
- 绿色（充足）：预计库存大于安全库存，无需担心。
- 黄色（预警）：预计库存大于 0，但已经跌破安全库存，建议关注。
- 红色（不足）：预计库存小于或等于 0，意味着未来会产生欠料。
2. 为什么编辑物料时不能直接改库存？
因为当前设计里，库存变动要走专门的入库、出库、盘库流程，这样系统才能保留库存变化记录。编辑抽屉主要负责维护档案信息。
2. 为什么我新增物料时，系统提示已经有相同物料？
因为系统会按“名称 + 规格”检查冲突。遇到这种情况，通常不是让你重复建档，而是提示你直接加载已有物料继续编辑。
3. 为什么智能采购按钮有时点不了？
因为当前实现里，只有启用中的物料里存在“缺料数量大于 0”的记录时，智能采购才会开放。
4. 为什么停用后在其他流程里选不到这个物料？
因为停用后的物料会被视为不再参与采购、领料、补料等业务流程，这不是显示问题，而是业务限制。
使用建议与最佳实践
- 先把基础档案维护准，再做库存动作：类别、单位、供应商、别名会直接影响后面使用体验。
- 不要把编辑当作调库存工具：任何库存数量变化都优先走入库、出库、盘库。
- 发现缺料先别急着采购：先一起看库存、待领、在途、安全库存，再决定要不要买。
- 价格策略尽量保持一致口径：不要今天手动、明天最新采购、后天再改回来，否则后续复盘会混乱。
- 停用前先确认后续是否还会用到：停用会直接影响采购、领料、补料等业务入口。