产品完工入库单
产品完工入库单记的是做好的成品进仓这一笔账。单据类型 211，主表 SPP_ManufactureLairageHead，明细表 SPP_ManufactureLairageSheet，编号以 YNo 开头。它是四张生产单里唯一带质检闸门和次品自动分流的一张。
功能路径：生产调度 → 生产单据 → 产品完工入库单 网页地址：/admin/SimpProduce/sppmanufacturelairagehead/
一、功能概述
这张单和另外三张有一个结构性差别：菜单打开的不是标准单据窗口，而是一个"完工入库工作台"。 工作台负责批量看、批量生效；单张单的录入与修改走另一个编辑窗口。两者共用同一张主表，但注册在两个地址上：
| 用途 | 地址 | 界面 |
|---|---|---|
| 日常浏览与批量生效 | sppmanufacturelairagehead/ | 上下双栏工作台，含三个质检位列 |
| 新增 / 编辑单张单 | sppmanufacturelairagebill/ | 标准单据窗口（表头 + 入库明细页签） |
列表里的单据编号是一个链接，点了才进编辑窗口，标题形如「产品完工入库单 - <单号>」；工具栏的「新增」也是直接跳去那个地址的开单页。
二、界面布局说明（工作台）
- 工具栏：新增、生效、反审核。「生效」和「反审核」都支持多选批量执行；
- 查询条：单据日期（默认本月）+ 单据状态（草稿 / 申请 / 生效 / 关闭）+ 关键字，关键字框的提示语写明搜的是单据编号 / 备注 / 计划单号；
- 每页 50 条，默认按单据日期倒序——这一点和另外三张（每页 20）不同；
- 列表列共 15 列，前三列冻结：单据编号、单据日期、状态，随后是三个质检位、单据金额、仓库、来源计划单、生产日期、生产组、生产部门、制单人、复核人、备注。
三个质检位是什么
| 列 | 含义 | 显示 |
|---|---|---|
| 生产部质检 | 车间工序做完的检验有没有过 | 勾选框 |
| 成品部质检 | 成品质检有没有过 | 勾选框 |
| 完工入库 | 入库动作有没有登记 | 勾选框 |
这三列是只读状态位，来自单据的自定义状态字段，由质检环节和 MES 交接回写。工作台里没有手动打勾的按钮——想点亮它得去对应的质检或交接操作。
「生产组」这一列取的是来源计划单上的生产组，不是入库单自己的字段。手工新增、没有关联计划单的入库单，这一列是空的。
下栏入库明细
选中上栏任意一行，下栏立刻显示这张单的明细，12 列：行号、物料编号、物料名称、规格、单位、计划数量、本次入库、合格数量、生产次品、包装次品、基础单价、行备注。上下栏高度比约 55:45。
三、新建与编辑
编辑窗口是标准单据窗口，表头不分组、四列平铺：
| 字段 | 必填 | 说明 |
|---|---|---|
| 单据日期 | 是 | 决定记账会计期 |
| 原始单号 | 否 | 外部单号 |
| 来源计划单号 | — | 只读，由生成链带入 |
| 入库仓库 | 是 | 成品进哪个仓 |
| 生产部门 | 否 | — |
| 生产日期 | 否 | 可与单据日期不同 |
| 摘要 / 备注 | 否 | 两个文本域并排 |
明细页签标题为入库明细，工具栏是 +添加行、选择商品、删除选中、清零、清空、导出。列分四组：
| 分组 | 列 | 能不能改 | 说明 |
|---|---|---|---|
| 物料 | 物料编号、物料名称、物料规格、基础单位、配方版本 | 只读（编号列通过选择商品填） | 配方版本 ≥100000 显示 V<版本ID>，否则显示 工厂<ID> |
| 数量 | 单位 | 可改 | 从物料单位列表选 |
| 数量 | 计划数量 | 只读 | 来源计划单给的目标量 |
| 数量 | 本次入库 | 必填可改 | 实际入仓数，记账按它 |
| 数量 | 合格数量 | 可改 | 质检通过数 |
| 数量 | 生产次品 | 可改 | 车间环节的不良品 |
| 数量 | 包装次品 | 可改 | 包装环节的不良品 |
| 价格 | 基础单价 | 只读 | 受成本字段权限控制 |
| 备注 | 行备注 | 可改 | — |
| — | 批号 | 可改 | 批号管理商品才有；未开通批次功能不显示 |
底部两个合计：合计本次入库、合计合格数量。表头金额是 单据金额 = Σ(本次入库 × 基础单价)——明细里没有单独的金额列，这个数是按公式汇总出来的；如果某行的基础单价取不到，金额保留原值而不是清零。
四、生效：四张单里最复杂的一步
在工作台勾选一行或多行，点「生效」，先弹确认：
确定生效选中的完工入库单吗？将执行库存记账、计划单核销与次品出库。
生效时系统按顺序做四件事
- 质检闸门——见下节，不通过直接失败；
- 成品入库记账，并把来源计划单对应行核销（计划数量按已入库数累加）；
- 单据状态置为已生效，写复核人、复核时间、会计期；
- 次品分流——记账成功之后才做，且各自独立：
- 开了「生产部质检」→ 按「生产次品」数量生成一张次品出库单；
- 开了「成品部质检」→ 按「包装次品」数量生成一张次品出库单；
- 去向由生产系统特点里的「生产次品处理模式」「产品次品处理模式」决定：按报废模式生成其他减少单（摘要
自动生成其他减少单(次品处理)），按调拨模式走移库。
生效成功的回显会把次品单号一起带出来，形如 已生效 1 张完工入库单（YNo…（次品单 A、B））。
质检闸门
生产系统特点里开了「完工入库单生效前强制进行质检」后，单据的质检位没达到要求组合就拦下：
系统已启用完工入库单生效前强制进行质检特点,单据没有完全通过质检,单据生效失败!
要求哪几位，取决于「生产部质检」「成品部质检」两个开关的组合。两个开关只开一个时，要求比两个都开或都不开时更松——这是 Delphi 老逻辑原样保留的，不是配置错了。判断办法：看列表的质检位列，缺哪一格就去补哪一步。
编辑窗口的生效前校验（原文）
| 提示原文 | 触发条件 |
|---|---|
| 请录入明细 | 明细为空 |
| 请选择入库仓库 | 表头仓库为空 |
| 第N行还未选择物料 | 某行没选商品 |
| 第N行还未录入本次入库数量 | 某行本次入库为 0 或空 |
| 只有草稿状态可以审核(当前状态=N) | 单据已生效或已关闭 |
批量执行的结果文案
| 文案 | 含义 |
|---|---|
| 未选择分店 | 会话还没选定机构 |
| 请先勾选完工入库单 | 一行都没勾 |
| 没有可生效的完工入库单 | 勾了但全部不满足条件 |
| 生效失败：\n<单号>：<原因> | 全部失败，逐条列原因 |
| 已生效 N 张（单号…）；失败 M 张：\n… | 部分成功，成功的已经落库，不会回滚 |
五、反审核
确认文案：
确定反审核选中的完工入库单吗？反审核将冲回库存记账。
反审核做三件事：冲回入库记账、撤销计划单核销、为这张单关联的已生效原材料消耗单生成一张负数消耗单（摘要 冲红自动生成反向消耗单）。也就是说，反审核完工入库单不会直接把原料退回仓库，而是靠一张反向消耗单把领用冲掉——账上是平的，但消耗单列表里会多出负数记录。
闸门（原文）：
| 提示原文 | 触发条件 |
|---|---|
| 只有已审核状态可以反审核(当前状态=N) | 单据不是已生效态；已关闭的也不能反审核 |
| 产品完工入库单不存在（fBillID=N） | 单据已删除或跨账套 |
| 非生效状态的入库单不能反审核! | 服务侧兜底 |
次品出库单不会因为反审核而自动删除，需要单独处理。
六、常见问题
「生效报质检失败，但三个质检位看着都是勾的」 — 检查是不是只开了两个质检开关中的一个。这种组合下要求的位置组合和直觉不同，见上文质检闸门一节。
「入库数比计划数少，还能不能生效」 — 能。计划数量只读、只做参考，记账按本次入库。要控制必须足量入库，靠的是生产系统特点里的相关开关，不是这张单本身。
「生效成功但库存没增加」 — 看是不是只保存没生效。草稿不入账。另外确认入库仓库是不是当前账号有权限的仓。
「多出来一张负数消耗单」 — 那是反审核完工入库单留下的冲回单，属正常。它不带来源计划单，摘要写着 冲红自动生成反向消耗单。
「次品出库单没生成」 — 三种可能：对应的质检开关没开；次品数量为 0；处理模式设成了按调拨模式（走移库而不是其他减少单）。
「点单据编号进编辑窗口，页面返回 500 服务器内部错误」 — 本测试账套实测：工作台列表、批量生效、批量反审核、明细下栏都正常，但进入编辑窗口（新增和修改都是）会返回 500。这不是权限问题。遇到时反馈技术支持；批量动作不受影响。
「生产组那一列是空的」 — 这张单没有关联生产计划单（手工新增的老数据常见）。生产组是从计划单带出来的。