# ERP 采购订单质检字段与 MES 来料检验自动创建 - 前端联调方案

## 涉及页面

- ERP 采购订单列表页
- ERP 采购订单新增/编辑页
- ERP 采购订单详情页
- MES 到货通知单列表页
- MES 到货通知单详情页
- MES 来料检验（IQC）列表页

## 业务流程

### 1. 采购订单新增质检标识

1. 用户在 ERP 采购订单新增/编辑页面，可以为每个产品明细勾选"是否需要来料检验"
2. 保存时，`qcCheckFlag` 字段随订单明细一起保存

### 2. 从采购订单生成到货通知单

1. 用户点击"生成到货通知单"按钮
2. 系统自动将采购订单明细的 `qcCheckFlag` 带入到货通知单行的 `iqcCheckFlag`
3. 用户可在到货通知单详情页修改每行的质检标识

### 3. 到货通知单提交自动创建 IQC

1. 用户提交到货通知单
2. 如果有行标记为需要质检（`iqcCheckFlag = true`）：
   - 到货通知单状态变为"待质检"
   - 系统自动为每个需要质检的行创建一条 IQC 来料检验单
   - 行上的 `iqcId` 关联到创建的检验单
3. 如果没有需要质检的行，状态直接变为"待入库"

## API 变更

### ERP 采购订单

#### 请求参数变更

**ErpPurchaseOrderSaveReqVO.Item 新增字段：**

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| qcCheckFlag | Boolean | 否 | 是否需要来料检验 |

#### 响应参数变更

**ErpPurchaseOrderRespVO.Item 新增字段：**

| 字段 | 类型 | 说明 |
|------|------|------|
| qcCheckFlag | Boolean | 是否需要来料检验 |

### MES 到货通知单

#### 响应参数变更

**到货通知单行新增字段（已存在，强调带入逻辑）：**

| 字段 | 类型 | 说明 |
|------|------|------|
| iqcCheckFlag | Boolean | 是否需要来料检验（从采购订单带入） |
| iqcId | Long | 关联的 IQC 检验单 ID（提交后自动创建） |

## 字段展示规则

### ERP 采购订单

| 字段 | 展示位置 | 说明 |
|------|----------|------|
| 是否质检 | 订单明细表格 | 使用 Checkbox 或 Switch 展示，可编辑 |

### MES 到货通知单

| 字段 | 展示位置 | 说明 |
|------|----------|------|
| 是否质检 | 行明细表格 | 使用 Tag 或 Checkbox 展示，提交后不可修改 |
| IQC 检验单 | 行明细表格 | 关联的检验单编号，点击可跳转（提交后自动关联） |

### MES 来料检验

| 字段 | 展示位置 | 说明 |
|------|----------|------|
| 来源单据 | 详情页 | 显示到货通知单编号，点击可跳转 |
| 来源单据行 | 详情页 | 显示到货通知单行编号 |

## 业务规则说明

| 场景 | 规则 |
|------|------|
| 采购订单保存 | `qcCheckFlag` 默认为 false（不质检） |
| 生成到货通知单 | 从采购订单明细带入 `qcCheckFlag` 到 `iqcCheckFlag` |
| 到货通知单提交 | 如有需要质检的行，自动创建 IQC 检验单并关联 |
| IQC 创建条件 | 物料必须配置了 IQC 检验模板，否则跳过并记录日志 |
| IQC 单据状态 | 自动创建的 IQC 为草稿状态，需要检验员填写检验结果 |

## 注意事项

1. **检验模板配置**：物料必须先在 MES 质量模块配置 IQC 检验模板，否则自动创建 IQC 会失败
2. **数据带入**：从采购订单生成到货通知单时，质检标识会自动带入，但用户可在到货通知单中修改
3. **状态流转**：到货通知单提交后，需要质检的行会进入"待质检"状态，所有检验完成后才可入库
4. **检验单关联**：提交后行上会关联 IQC 检验单 ID，点击可跳转查看检验详情
5. **异常处理**：如果某行创建 IQC 失败（如缺少模板），不会中断整个提交流程，会记录日志继续处理其他行