# 按生产工单生成领料单(需求 5.2③)- 前端联调方案 ## 涉及页面 - 仓储管理 → 生产领料 → 领料出库单列表(`wls/productissue/index.vue`) - 列表工具栏新增按钮「按工单生成领料单」,点击打开生成弹窗 - 生成弹窗 `wls/productissue/modules/generate.vue` ## 业务流程与数据带入 1. 弹窗内选择生产工单(工单选择器)→ 自动调用 BOM 接口取该工单的物料需求,再取该工单未取消的领料单行汇总「已领数量」。 2. 弹窗表格按物料展示:物料编码/名称/规格/单位、需求数量、已领数量、待领数量(= 需求 − 已领,负数按 0)。 3. 点击「生成领料单」→ 后端按 BOM 用量 × 工单计划数量重算应领数量并扣除已领数量,生成一张草稿领料单。 4. 生成的草稿单回到列表,后续仍走原流程:提交 → 执行拣货 → 完成(完成时才扣减库存)。 ## API | 方法 | 路径 | 说明 | |------|------|------| | POST | /mes/wm/product-issue/generate-by-work-order?workOrderId= | 按工单生成草稿领料单(权限 `mes:wm-product-issue:create`),返回领料单编号 | | GET | /mes/wm/product-issue-line/bom-item-list-by-work-order?workOrderId= | 工单 BOM 物料(含按物料汇总的需求数量),用于弹窗预览 | | GET | /mes/wm/product-issue/page | 领料单分页,弹窗内用于统计已领数量(按 workOrderId 过滤) | | GET | /mes/wm/product-issue-line/list-by-issue?issueId= | 领料单行列表,弹窗内汇总已领数量 | **generate-by-work-order 参数:** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | workOrderId | Long | 是 | 生产工单编号 | **响应:** 新建领料出库单编号(Long)。 **bom-item-list-by-work-order 响应字段:** `itemId`、`itemCode`、`itemName`、`itemSpecification`、`unitMeasureName`、`requiredQuantity`(该工单该物料的需求数量,已按物料汇总各工序投料)。 ## 字段展示规则 | 字段 | 展示位置 | 说明 | |------|----------|------| | 物料编码 / 名称 / 规格 / 单位 | 弹窗表格 | 后端已解析,直接展示 | | 需求数量 | 弹窗表格 | 工单 BOM 汇总用量 | | 已领数量 | 弹窗表格 | 由前端汇总该工单未取消领料单行的数量,仅用于预览 | | 待领数量 | 弹窗表格 | 需求 − 已领,≤0 视为 0;全部为 0 时禁用「生成领料单」 | ## 业务规则说明 | 场景 | 规则 | |------|------| | 工单状态 | 只有已确认的工单允许生成;草稿/已完成/已取消会返回针对性提示 | | BOM 为空 | 返回「生产工单[编号]的 BOM 物料清单为空,无法生成领料任务」,弹窗提示先去维护工单 BOM | | 已全部领过 | 返回「生产工单[编号]按 BOM 应领的物料已全部领过,无需重复生成领料任务」,并提示改用「补领辅料」 | | 部分已领 | 只补差额,差额为 0 的物料不生成明细行 | | 单据形态 | 生成的是**草稿**领料单(类型=普通领料),单号取编码规则 `WM_PRODUCT_ISSUE_CODE`,名称「领料-工单编号」 | | 库存 | 生成环节不动库存,只有完成拣货后才扣减 | ## 注意事项 - 弹窗里的「已领数量」只是预览口径(未取消的领料单行数量合计);最终数量以后端生成时的重算结果为准,两者不一致时以后端为准。 - 生成失败时整单回滚,不产生空单;前端展示后端返回的精确提示,不要统一替换为「生成失败」。 - 生成成功后需要刷新列表(`@success` 事件),并提示用户「已生成草稿,请提交并完成拣货后扣减库存」。 - 若用户从工单页进入(带 `workOrderId` 打开),弹窗可直接预选该工单并加载数据。