# 质检单关联生产报工/销售出库 - 前端联调方案 ## 涉及页面 - 质量管理 → 过程检验(IPQC)列表、详情 - 质量管理 → 出货检验(OQC)列表、详情 - 生产管理 → 生产报工(只读参考:报工单号、状态、盘号) - 仓储管理 → 销售出库单(只读参考:出库单号、明细盘号、质量状态) ## 业务流程与数据带入 ### 过程检验(IPQC)关联生产报工 1. 质检工序报工审批通过后,报工单转为「待检验(3)」,同时生成质量状态为「待检验(0)」的产出行,产出行盘号来自生产工单。 2. 质检员独立新建或导入 IPQC 单,填写检测数量、合格数量、不合格数量并上传检验附件,完成后由后端按数量自动判定:不合格数量为 0 → 校验通过(1),否则校验不通过(2)。 3. 在已完成且未关联来源的 IPQC 详情页点击「关联生产报工」,前端调用候选接口。后端自动使用本单的「物料 + 盘号」筛选,只返回物料、盘号、数量与当前质检单完全一致,且仍处于待检验状态的报工产出行。 4. 用户选中一条候选后提交关联。后端校验通过后回写:报工单状态 → 已完成(4)、按合格/不合格数量拆分产出行并完成产出入库、回写任务质量数量、检查工单是否完工。 5. 关联成功后,质检单详情应显示来源单据类型、来源单据编号、来源行 ID,并隐藏「关联生产报工」按钮。 ### 出货检验(OQC)关联销售出库 1. 销售出库单提交时,勾选「需要出货检验」的明细质量状态置为「待检验(0)」,出库单状态进入「待检测(1)」。提交动作不再自动创建 OQC 单。 2. 质检员独立新建或导入 OQC 单,填写检测数量、合格数量、不合格数量并上传检验附件,完成后同样按数量自动判定 1/2。 3. 在已完成且未关联来源的 OQC 详情页点击「关联销售出库」,前端调用候选接口。后端自动使用本单的「物料 + 盘号」筛选,只返回出库单状态为「待检测」、明细勾选了出货检验、尚未关联质检单,且物料、盘号、数量与当前质检单完全一致的明细。 4. 用户选中一条候选后提交关联。后端回写出库明细的质检单 ID 与质量状态(合格 → PASS,不合格 → FAIL)。 5. 当该出库单所有需检验明细都变为合格后,出库单自动从「待检测(1)」流转到「待拣货(2)」。存在不合格明细时保持「待检测」,等待后续处置,不会自动取消整张出库单。 ## API | 方法 | 路径 | 说明 | |------|------|------| | GET | /mes/qc/source-link/feedback-candidates | 查询 IPQC 可关联的生产报工产出行候选 | | POST | /mes/qc/source-link/feedback | 将 IPQC 关联到指定报工产出行 | | GET | /mes/qc/source-link/sales-candidates | 查询 OQC 可关联的销售出库明细候选 | | POST | /mes/qc/source-link/sales | 将 OQC 关联到指定销售出库明细 | 权限码: | 接口 | 权限码 | |------|--------| | feedback-candidates、feedback | mes:qc-ipqc:update | | sales-candidates、sales | mes:qc-oqc:update | **请求参数(候选查询):** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | qcId | Long | 是 | 当前质检单 ID(IPQC 或 OQC) | **请求参数(提交关联):** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | qcId | Long | 是 | 当前质检单 ID | | lineId | Long | 是 | 候选接口返回的 lineId(报工产出行 ID 或销售出库明细 ID) | **候选响应字段:** | 字段 | 类型 | 说明 | |------|------|------| | lineId | Long | 待检明细 ID,提交关联时回传 | | documentId | Long | 来源单据 ID:报工单 ID 或销售出库单 ID | | documentCode | String | 来源单据编号:报工单号或出库单号 | | reelNo | String | 盘号 | | quantity | BigDecimal | 待检数量 | **候选响应示例:** ```json { "code": 0, "data": [ { "lineId": 123, "documentId": 456, "documentCode": "BG20261104001", "reelNo": "PAN-001", "quantity": 200 } ] } ``` **关联成功响应:** `{ "code": 0, "data": true }` ## 字段展示规则 | 字段 | 展示位置 | 说明 | |------|----------|------| | sourceDocCode | 质检单详情 | 已关联时展示来源单据编号,未关联时显示空 | | sourceDocType | 质检单详情 | 后端返回 304=生产报工,119=销售出库 | | sourceLineId | 质检单详情 | 已关联时非空,用于判断是否隐藏关联按钮 | | reelNo | 质检单列表、详情 | 已完成质检单必须非空才能发起关联 | | documentCode | 候选弹窗 | 报工单号或销售出库单号 | | reelNo | 候选弹窗 | 盘号,用于人工复核 | | quantity | 候选弹窗 | 待检数量,应与质检单检测数量一致 | ## 业务规则 | 场景 | 规则 | |------|------| | IPQC 关联前置条件 | 质检单状态必须为已完成(4),且 sourceDocType、sourceDocId、sourceLineId 均为空,盘号非空 | | IPQC 候选条件 | 产出行质量状态为待检验(0)、关联报工单状态为待检验(3)、物料一致、生产工单一致;质检单指定了生产任务时任务也必须一致;盘号一致;报工产出行数量等于质检单检测数量 | | IPQC 关联写回 | 报工单转已完成(4),按合格/不合格数量拆分产出行并完成产出入库,回写任务质量数量与工单进度 | | OQC 关联前置条件 | 质检单状态必须为已完成(4),且 sourceDocType、sourceDocId、sourceLineId 均为空,盘号非空 | | OQC 候选条件 | 出库单状态为待检测(1)、明细勾选需要出货检验、明细尚未关联质检单、物料一致、客户一致(质检单填写客户时)、盘号一致、明细数量等于质检单检测数量 | | OQC 关联写回 | 出库明细写入质检单 ID 与质量状态;全部需检明细合格后出库单转待拣货(2) | | 一对一约束 | 一条待检明细只能被一张质检单关联;一张质检单只能关联一条来源明细 | | 盘号来源 | IPQC 取生产工单盘号;OQC 取销售订单明细盘号;两处均不做模糊匹配,仅去除首尾空格后比较 | | 数量约束 | 质检单检测数量必须大于 0 且与待检明细数量完全相等 | ## 注意事项 - 关联操作不可重复:质检单已关联来源后,详情页应隐藏关联入口;重复提交会被后端拒绝并提示已关联来源单据编号。 - 候选列表为空不代表接口异常:多为盘号、数量或单据状态不满足;前端应提示用户核对盘号与检测数量,并刷新重试。 - 后端错误提示会按「单据状态 / 物料 / 工单 / 任务 / 盘号 / 数量 / 已关联」给出具体维度与双方实际值,前端应直接展示后端 message,不要替换为统一的“操作失败”。 - 完成质检单时后端会校验:合格数量与不合格数量之和必须大于 0 且等于检测数量,并且必须已上传至少一份检验附件;未满足时不允许完成。 - 质检结论由数量自动计算,前端完成弹窗无需再让用户选择判定结果;提交的判定值会被后端覆盖。 - 新建质检单不再依赖质检方案:后端会忽略 templateId,也不会自动生成检验指标行;前端表单无需再强校验质检方案。 - 销售出库单提交后不再自动创建 OQC,原“提交即生成检验单”的提示文案和后续跳转需同步调整。 - 关联成功后需刷新质检单详情与来源单据列表,避免继续展示旧的状态与关联信息。