组装拆卸与商品组装
「组装拆卸」是菜单分组名，点它和点它下面的「商品组装」打开的是同一个窗口，标题写作组装单。它把若干原料拼成成品：单据类型 230，主表 CombinBillHead，明细表 CombinBillSheet，生效时先做原材料出库、再做成品入库，并把原料成本结转成成品成本。
功能路径：存货管理 → 组装拆卸 / 商品组装 网页地址：/admin/Storage/combinbillhead/
一、功能概述
组装单是一张两头记账的单：表头定「组装什么、组装几个、从哪领料、入到哪个仓」，明细列「用了哪些原料、各用多少」。生效那一刻按顺序跑五步：
原材料出库（领用仓库，发出方向）
→ 按 BOM 汇总算出成品成本
→ 成品入库（完工仓库，入库方向）
→ 回写表头成本单价与金额
→ 单据状态置为已生效这五步是一个整体，中间任何一步失败，单据不会留在"半生效"状态，会直接报「记账失败」并回滚到草稿。
典型场景：现制蛋糕（几个半成品 + 奶油 + 包装盒拼成一个成品）、礼盒（若干单品拼成礼盒）、组合装销售前的预制。
二、界面布局说明
- 工具栏：新增、导出、刷新。列表上没有审核 / 反审核按钮，生效动作在单据窗口里做；
- 查询条：单据日期（默认本月）+ 领用仓库 + 完工仓库（两个都是「全部」起步）+ 高级筛选 + 方案；
- 列表列：单据号、单据日期、组装成品、领用仓库、完工仓库、组装数量、单据金额、单据状态、单据摘要；每页 20 条；
- 关键字检索：摘要 + 备注 + 单据号。
三、新建与编辑
新增窗口标题形如「组装单: No…」。每次打开新增页都会预取一个单据号，所以连着开两次会看到序号 +1，这不是留下了空单据。
按钮：返回、保存、复制、删除、试算成本。
表头五必填一选填：
| 字段 | 必填 | 说明 |
|---|---|---|
| 单据日期 | 是 | 决定记账会计期 |
| 组装成品 | 是 | 从标记为组合商品的物料里挑 |
| 领用仓库 | 是 | 原料从哪个仓出 |
| 完工仓库 | 是 | 成品入到哪个仓，不能与领用仓库相同 |
| 组装数量 | 是 | 拼几个成品，明细用量按它放大 |
| 原始单号 | 否 | 外部单号 |
金额信息（默认折叠）里两栏：入库单价（只读，生效后回填）和入库金额。
明细页签标题为原材料明细，明细工具栏是 +添加行、选择商品、删除选中、清零、清空、导出；空表中问句「暂无数据，点击上方按钮添加」。
| 列 | 能不能改 | 说明 |
|---|---|---|
| 物料编号 | 选料时填 | 冻结列 |
| 物料名称、单位 | 只读 | 带出 |
| 单位用量 | 可改 | 从 BOM 带出，一个成品用多少 |
| 实际数量 | 可改 | 真正用了多少，记账按它 |
| 单位标准用量 | 只读 | BOM 上的标准值，用来和「单位用量」比 |
| 标准用量 | 只读 | = 单位标准用量 × 组装数量 |
| 差异数量 | 只读 | = 实际数量 − 标准用量，超耗为正、省料为负 |
| 标准售价 | 只读 | 受价格字段权限控制 |
| 采购价 | 只读 | 原料档案进价 |
| 发出单价 | 只读 | 生效时按移动加权回写 |
| 发出金额 | 只读 | = 发出单价 × 实际数量 |
| 行备注 | 可改 | — |
底部合计行给发出金额合计。
差异数量这一列是给你看超耗的
「标准用量」按 BOM 算，「实际数量」按你录的算，两者之差就是这一列。长期为正说明门店实际用料比配方多，要么改 BOM、要么管操作；为负通常是省料或者少报了。这一列不参与记账，只用于复盘。
四、生效与反审核
生效前校验（原文）
| 提示原文 | 触发条件 |
|---|---|
| 请选择组装成品 | 表头成品为空 |
| 请选择领用仓库 | 领用仓库为空 |
| 请选择完工仓库 | 完工仓库为空 |
| 完工仓库与领用仓库不能相同 | 两个仓填了同一个 |
| 组装数量不能为0 | 数量空或 0 |
| 明细不能为空 | 一行原料都没有 |
| 第N行尚未输入物料 | 某行没选原料 |
| 第N行数量必须大于0 | 某行实际数量为 0 或空 |
记账失败提示（原文）
| 提示原文 | 触发条件 |
|---|---|
| 记账失败: 单据状态未更新为<期望状态>（当前<状态>），库存记账存储过程可能返回了非 0 值。 | 库存记账过程返回失败 |
| 记账失败: <业务提示> | 记账服务抛出的业务错误，常见是库存不足 |
| 生成财务凭证失败! 原因:<原因> | 库存账已动、凭证没出，需先修科目再补 |
反审核
| 提示原文 | 触发条件 |
|---|---|
| 已经确认的单据，不允许反审核 | 单据已被下游确认 |
| 该单据已被冲红，不能反审核 | 已被冲过 |
| 冲红单不能反审核 | 单据自身是红字 |
| 当前单据的会计期不是当前会计期无法反审核! | 跨期 |
| 当前单据的日期小于本期间的最小日期! … | 单据日期早于当前会计期起点 |
反审核按原数量做反向记账：成品从完工仓出、原料回领用仓，成本按原结转值退回。
五、试算成本：目前只做到界面层
工具栏那个「试算成本」按钮，前端会按顺序做六项检查，任何一项不过直接弹提示、不发请求：
| 提示原文 | 触发条件 |
|---|---|
| 单据处于只读状态，不能试算成本! | 已生效 / 已关闭的单据 |
| 请先挑选组装货品，才能试算成本! | 表头成品为空 |
| 请先挑选完工仓库，才能试算成本! | 完工仓库为空 |
| 请先挑选领用仓库，才能试算成本! | 领用仓库为空 |
| 请输入组装货品数量，才能试算成本! | 组装数量为空 |
| 明细行数为0，无法试算成本! | 明细一行都没有 |
六项全过时它会去调服务端的试算服务，而这个服务在当前版本是未实现状态（服务端代码里直接抛「组装成本试算服务待实现」）。所以：
- 上面这六条提示是真的会出现，且是有效的前置校验；
- 校验全过之后拿不到成本结果，会看到错误提示或无响应；
- 要预估成本，别看这个按钮，去货品关系设置看那张 BOM 的「成本合计」，或者按「Σ 实际数量 × 采购价」自己估。
拆卸单上的同名按钮情况完全一样，只是提示文案换成「拆卸货品」。
六、常见问题
「完工仓库和领用仓库必须不一样吗」 — 必须。这是硬校验，因为一张单同时做发出和入库，同仓会让移动加权成本算出自相矛盾的值。只有一个仓时先建个「组装间」仓。
「组装成品下拉里找不到我的商品」 — 成品判定条件是物料档案上标记为组合商品、状态正常且非某类特殊料。去物料管理把标记打开。
「明细带不出原料」 — 该成品没维护 BOM。去货品关系设置建，或者手工「+添加行」一行行填（手工填不会自动算成本结转基准）。
「成品入库成本是 0」 — 原料没有成本。检查原料做过采购入库没有、期初建账有没有成本。成本是从原料结转过来的，原料没价，成品就没价。
「能不能改组装数量」 — 受系统选项「是否允许修改组装数量」控制。关掉时这个字段是锁的。
「单据号前缀和客户端看到的不一样」 — 前缀由账套的编号规则表按单据类型配置，代码里给这套单据预留的是另一套前缀，但没配规则时一律回落到默认的「No + 日期 + 流水」。以实际账套配置为准。
「列表上没有审核按钮」 — 设计如此。组装 / 拆卸单的生效在单据窗口里做，见单据窗口通用操作。