原材料消耗单
原材料消耗单记的是车间从配料间领走原料这一笔账。单据类型 210，主表 SPP_MaterialDomainHead，明细表 SPP_MaterialDomainSheet，编号以 Md 开头。它绝大多数时候不是人敲出来的，而是配料管理点「生成领用单」时自动落下的——所以这张单的第一用途是核对与追溯，不是录入。
功能路径：生产调度 → 生产单据 → 原材料消耗单 网页地址：/admin/SimpProduce/sppmaterialdomainhead/
一、功能概述
一张消耗单对应一次领料动作：从哪个仓库领、哪个部门领、哪个生产组领、领了哪些物料各多少。生效后系统按明细数量做原料出库记账，并把来源生产计划单标记成「已被领用」。
它有三个入口，重要性从高到低：
| 入口 | 怎么产生 | 单据摘要长什么样 |
|---|---|---|
| 配料管理 → 生成领用单 | 系统按计划单 + 配料汇总自动建单并直接生效 | 自动生成原材料领用单-<计划单号> |
| 完工入库单反审核 / 冲红 | 系统生成一张负数消耗单冲回原领用 | 冲红自动生成反向消耗单 |
| 本窗口「新增」 | 人工补录 | 自己填 |
「需求数量」和「输入数量」不是一回事。 需求数量是上游配料计算给出的应领量，只读；输入数量是实际领了多少，可编辑。车间超领或少领，改的是输入数量，记账按输入数量走。
二、界面布局说明
列表页是标准单据窗口：
- 工具栏：新增、导出、刷新；
- 查询条：单据日期（今天 / 昨天 / 本周 / 上周 / 本月 / 上月 / 自定义）+ 领料仓库下拉 + 高级筛选 + 方案；默认区间是本月，可查范围上限 365 天；
- 列表列：单据号、单据日期、仓库、单据金额、单据状态、单据摘要；每页 20 条，可切 20 / 30 / 50 / 100 / 200；
- 关键字检索：「包含 / 等于 / 开头为 / 结尾为 / 不等于 / 不包含 / 介于」七种匹配，检索范围是摘要 + 自动摘要 + 单据号三个字段拼起来的串，所以按摘要里的计划单号搜是搜得到的。
高级筛选面板里共八个条件：单据号、单据状态、制单日期、记账日期、制单人、记账人、原单据号、备注。文本类条件（单据号、原单据号、备注）都带「包含 / 等于 / 开头为 / 结尾为 / 不等于 / 不包含 / 介于」七种匹配方式；日期类默认「未设置」；制单人与记账人是人员下拉。这套面板四张生产单据完全一样。
列表只显示领用主单。 两类记录被过滤掉：已删除（状态 -1）和子类型不为 0 的记录。子类型 1 是「原料耗用退回」红字单，由配料管理的「耗用退回」动作生成，它不会出现在这个列表里。要查退回记录，得从配料管理那张配料单的详情里看，或者按单据号直接搜。
三、新建与编辑
新增窗口分三段：基本信息、三个页签（单据内容 / 金额信息 / 单据摘要）。
表头
| 字段 | 必填 | 说明 |
|---|---|---|
| 单据日期 | 是 | 决定记账落在哪个会计期 |
| 领料仓库 | 是 | 从哪个仓出库，通常是配料间 |
| 生产部门 | 否 | 领料归属部门 |
| 生产计划单号 | — | 只读，见下方说明 |
| 生产日期 | 否 | 实际生产日，可与单据日期不同 |
| 原始单号 | 否 | 手填的外部单号 |
| 生产组 | 否 | 关联生产组 |
「生产计划单号」是计算出来的显示值，不落库：它由 No + 计划单日期串 + 类型号 213 + 计划单 ID 拼成。手工新增的单没有来源计划单，这一栏就是空的——这是正常的，不代表关联丢了。
单据内容（明细）
明细工具栏：+添加行、选择商品、删除选中、清零、清空、导出。列按分组标题排：
| 分组 | 列 | 能不能改 | 怎么算 |
|---|---|---|---|
| 物料 | 物料编码 | 选择商品时填 | 支持编号 / 名称 / 拼音码模糊搜，一次最多返回 20 条 |
| 物料 | 条码、物料名称、物料规格、基础单位 | 只读 | 随物料带出 |
| 物料 | 配方版本 | 只读 | 数值 ≥ 100000 显示 V<版本ID>，否则显示 工厂<ID> |
| — | 需求数量 | 只读 | 上游配料计算给的应领量 |
| — | 输入单位 | 可改 | 从该物料的单位列表里选 |
| — | 输入数量 | 可改 | 实际领用量，记账按它 |
| 进价金额 | 单位进价、标准进价、进价金额 | 只读 | 进价金额 = 输入数量 × 单位进价 |
| 成本金额 | 单位成本价、成本金额、标准成本价 | 只读 | 成本金额 = 输入数量 × 单位成本价 |
| 售价金额 | 标准售价、单位售价、售价金额 | 只读 | 售价金额 = 输入数量 × 单位售价 |
| — | 行备注 | 可改 | — |
| — | 批号 | 可改 | 批号管理商品才有值；未开通批次功能的账号看不到这一列 |
换输入单位会同时改两个基础数量。 选完单位后，系统按换算率把输入数量折成基础单位数量，同时写入「基础数量」和「业务基础数量」两列（两值相同）。所以输入数量填 5 公斤、基础单位是克，落库的基础数量是 5000，不是 5。
三组金额列受字段权限控制。 进价金额组与售价金额组归「价格」权限，成本金额组归「成本」权限。没授权时整组列不显示，底部合计也会少对应那一项——这是权限设计，不是数据缺失。
底部合计
明细区底部一行是合计输入数量和合计进价金额；再下面一栏是单据金额与估算成本金额：
- 单据金额 = 所有明细行的进价金额之和；
- 估算成本金额 = 所有明细行的成本金额之和。
这两个数在草稿阶段是前端算的临时值，生效后由记账服务回写成本，之后看到的成本金额才是财务口径。
四、生效与反审核
工具栏的「生效」在草稿状态下可点，「反审核」在已生效状态下可点。
生效前校验（原文）
按顺序卡，第一条不过就弹提示：
| 提示原文 | 触发条件 |
|---|---|
| 单据号为空 | 极端情况：编号没预分配上 |
| 请录入明细 | 明细一行都没有 |
| 请选择领料仓库 | 表头仓库为空 |
| 第N行还未选择物料 | 某行没选商品 |
| 第N行还未录入数量 | 某行输入数量为 0 或空 |
| 第N行基础单位数量为零 | 输入数量折成基础单位后为 0（常见于换算率没维护） |
| 只有草稿状态可以审核(当前状态=N) | 单据已经是生效或关闭态 |
生效时系统做了什么
- 按明细数量做原料出库记账（方向为领用出库）；
- 单据状态置为已生效，写入复核人、复核时间、会计期；
- 如果这张单带了来源计划单，把计划单标记为「已被领用」——这一步是防止同一张计划单被重复领用；
- 生效成功后回显单号。
反审核闸门（原文）
| 提示原文 | 触发条件 |
|---|---|
| 只有已审核状态可以反审核(当前状态=N) | 单据不是已生效态。已关闭（2）的单也不能反审核，尽管后台服务本身认这个状态 |
| 原材料消耗单不存在（fBillID=N） | 单据已被删除或跨账套 |
| 非生效状态的单据不能反审核! | 同上，服务侧兜底 |
| 仅领用主单（子类型0）可在此反审核 | 这是一张退回红字单 |
| 该单据已被冲红，不能反审核 | 单据已被别的动作冲过 |
| 红字单不能反审核 | 单据自身就是红字 |
失败时提示统一带前缀，形如 反审核失败: 该单据已被冲红，不能反审核。
五、状态
| 状态 | 含义 | 能做什么 |
|---|---|---|
| 草稿 | 已保存未生效 | 编辑、删除、生效 |
| 已生效 | 已记账 | 反审核（未跨期、未被冲红时） |
| 已关闭 | 业务上终结 | 只能查，不能反审核 |
| 删除 | 逻辑删除 | 列表不显示 |
六、常见问题
「列表里少了一张负数单」 — 大概率是原料耗用退回单（子类型 1）。主列表按设计过滤掉了它，从配料管理的「耗用退回」入口看。
「输入数量填了，生效报第N行基础单位数量为零」 — 该物料的换算率没配或配成 0。去物料管理的单位页签补换算率，或把输入单位改成基础单位再试。
「需求数量是 0 但输入数量有值」 — 正常。手工新增的单没有配料计算，需求数量本来就没值；记账只看输入数量。
「成本金额和进价金额不一样」 — 不一样才对。进价是采购口径，成本是记账后的实际成本；草稿阶段成本那一列常常是空的，生效后才有数。
「点单据编号进编辑页，页面返回 500 服务器内部错误」 — 本测试账套实测：列表页、新增窗口、导出都正常，但进入已有单据的编辑页会返回 500。这不是权限问题（权限不足是不显示菜单或按钮）。遇到时先用「新增」重建一张同内容的单，或反馈技术支持；查询、导出、生效、反审核都不受影响。
「同一张计划单被领了两次」 — 生效时会给来源计划单打「已被领用」标记，正常路径下第二次会被拦：该单引入的生产计划单有被其它[原料领用单]领用！。如果确实出现两张，检查是不是有人手工新增绕过了计划单关联。
「导出的金额和页面差几分」 — 页面金额列保留 4 位小数，导出走的是明细原始值，四舍五入口径不同。以生效后的记账数为准。