宁夏三级mom后端
编辑 | blame | 历史 | 原始文档

不合格品处理 - 前端联调方案

涉及页面

  • 质量管理 > 不合格品处理（新增页面 mes/qc/ncr/index）
  • 来料检验详情页（增加"生成NCR"按钮）
  • 过程检验详情页（增加"生成NCR"按钮）
  • 出货检验详情页（增加"生成NCR"按钮）
  • 退料检验详情页（增加"生成NCR"按钮）

业务流程与数据带入

  1. 检验判定不合格 → NCR 创建：在各检验单详情页，当检验结果为"不合格退货"或"不合格报废"时，可点击"生成NCR"按钮，自动带入检验类型、检验单ID/编号、物料信息、不合格数量、不合格描述，跳转到 NCR 新建页面。
  2. NCR 待评审 → 评审：填写处置方式（退货/报废/返工/让步接收/降级使用）、责任部门、缺陷等级、评审意见。
  3. NCR 已评审 → 处置：填写处理人、处理结果说明。
  4. NCR 已处置 → 关闭：填写关闭意见。

API

方法 路径 说明
POST /mes/qc/ncr/create 创建不合格品处理单
PUT /mes/qc/ncr/update 更新不合格品处理单（仅待评审状态）
PUT /mes/qc/ncr/review 评审不合格品处理单
PUT /mes/qc/ncr/dispose 执行不合格品处置
PUT /mes/qc/ncr/close 关闭不合格品处理单
DELETE /mes/qc/ncr/delete 删除不合格品处理单（仅待评审状态）
GET /mes/qc/ncr/get 获得不合格品处理单详情
GET /mes/qc/ncr/page 获得不合格品处理单分页列表
GET /mes/qc/ncr/export-excel 导出不合格品处理单 Excel

创建 NCR

POST /mes/qc/ncr/create

请求参数：

参数 类型 必填 说明
code String 是 NCR单号
name String 是 NCR名称
qcType Integer 否 检验类型（1=IQC/2=IPQC/3=OQC/4=RQC）
qcId Long 否 来源检验单ID
itemId Long 是 不合格物料ID
defectLevel Integer 否 缺陷等级（1=致命/2=严重/3=轻微）
unqualifiedQuantity BigDecimal 否 不合格数量
defectDescription String 否 不合格描述
rootCause String 否 根本原因
correctiveAction String 否 纠正措施
preventiveAction String 否 预防措施
remark String 否 备注

更新 NCR

PUT /mes/qc/ncr/update

请求参数：同创建，增加 id 字段（必填）。

评审 NCR

PUT /mes/qc/ncr/review

请求参数：

参数 类型 必填 说明
id Long 是 NCR编号
disposition Integer 是 处置方式（1=退货/2=报废/3=返工/4=让步接收/5=降级使用）
responsibleDeptId Long 否 责任部门ID
defectLevel Integer 否 缺陷等级
reviewOpinion String 否 评审意见

处置 NCR

PUT /mes/qc/ncr/dispose

请求参数：

参数 类型 必填 说明
id Long 是 NCR编号
handlerUserId Long 否 处理人ID
handleResult String 否 处理结果说明

关闭 NCR

PUT /mes/qc/ncr/close

请求参数：

参数 类型 必填 说明
id Long 是 NCR编号
closeOpinion String 否 关闭意见

分页查询

GET /mes/qc/ncr/page

请求参数：

参数 类型 必填 说明
code String 否 NCR单号（模糊）
qcType Integer 否 检验类型
itemId Long 否 不合格物料ID
defectLevel Integer 否 缺陷等级
disposition Integer 否 处置方式
status Integer 否 状态
responsibleDeptId Long 否 责任部门ID
reviewDate LocalDateTime[] 否 评审日期范围
createTime LocalDateTime[] 否 创建时间范围
pageNo Integer 否 页码
pageSize Integer 否 每页条数

响应字段

字段 类型 说明
id Long 编号
code String NCR单号
name String NCR名称
qcType Integer 检验类型
qcId Long 来源检验单ID
qcCode String 来源检验单编号
itemId Long 物料ID
itemCode String 物料编码
itemName String 物料名称
itemSpecification String 规格型号
defectLevel Integer 缺陷等级
unqualifiedQuantity BigDecimal 不合格数量
defectDescription String 不合格描述
disposition Integer 处置方式
responsibleDeptId Long 责任部门ID
responsibleDeptName String 责任部门名称
reviewerUserId Long 评审人ID
reviewerNickname String 评审人昵称
reviewDate LocalDateTime 评审日期
reviewOpinion String 评审意见
handlerUserId Long 处理人ID
handlerNickname String 处理人昵称
handleDate LocalDateTime 处理日期
handleResult String 处理结果说明
rootCause String 根本原因
correctiveAction String 纠正措施
preventiveAction String 预防措施
closeUserId Long 关闭人ID
closeUserNickname String 关闭人昵称
closeDate LocalDateTime 关闭日期
closeOpinion String 关闭意见
status Integer 状态
remark String 备注
createTime LocalDateTime 创建时间

业务规则说明

状态流转

待评审(0) ──评审──▶ 已评审(1) ──处置──▶ 已处置(2) ──关闭──▶ 已关闭(3)

操作权限约束

操作 允许状态 说明
创建 — 无状态限制
更新 待评审 仅待评审状态可编辑
删除 待评审 仅待评审状态可删除
评审 待评审 状态变为"已评审"，自动填入当前登录人为评审人
处置 已评审 状态变为"已处置"
关闭 已处置 状态变为"已关闭"，自动填入当前登录人为关闭人

处置方式枚举

值 名称 说明
1 退货 退回供应商
2 报废 内部报废处理
3 返工 重新加工
4 让步接收 特采接收
5 降级使用 降级后使用

缺陷等级枚举

值 名称
1 致命
2 严重
3 轻微

注意事项

  • NCR 创建时编号规则建议：NCR + 年月日时分秒（如 NCR20250101120000），前端可用时间戳生成
  • 从检验单生成 NCR 时，建议将 qcType、qcId、itemId、unqualifiedQuantity 自动带入
  • NCR 的 qcCode 字段存储来源检验单编号，用于列表展示关联关系
  • 列表页推荐展示：NCR单号、来源检验单编号、物料名称、缺陷等级、不合格数量、处置方式、状态、创建时间
  • 不同状态下展示不同的操作按钮：
  • 待评审：编辑、删除、评审
  • 已评审：处置
  • 已处置：关闭
  • 已关闭：仅查看
  • 详情页建议分区域展示：不合格品信息、评审信息、处置信息、关闭信息
  • 状态字典类型为 mes_ncr_status，处置方式字典类型为 mes_ncr_disposition