# 采购订单导入重复检测与采购申请批量提交 - 前端联调方案 ## 涉及页面 - ERP → 采购管理 → 采购订单 → 导入弹窗 - ERP → 采购管理 → 采购申请 → 列表工具栏、提交审批流程弹窗 ## 业务流程与数据带入 1. 采购申请列表勾选多张单据 → 点击「批量提交」→ 前端过滤出“未提交(0)/审批不通过(30)”的申请 → 选择审批流程 → 按每批 50 张调用批量提交接口。 2. 批量提交逐张创建 BPM 流程实例并回写申请状态为“审批中(10)”,单张失败不影响其它申请,失败原因按申请单号返回。 3. 采购申请审批通过且已填供应商时,后端先按“供应商 + 明细(物料、数量、单价、税率)”匹配系统内已审核且尚未入库/退货的采购订单: - 匹配到:把申请关联到该订单,并回填订单明细的申请明细编号,不再生成新订单; - 匹配不到:保持原有逻辑自动生成一张已审核采购订单。 4. 采购订单导入时,后端按以下顺序识别重复: - 文件中的“采购单编号”在系统内已存在; - 文件中的“采购单编号”留空(由系统自动生成编号)且供应商、明细、数量、单价、税率与系统内已有订单完全一致。 5. 发现重复且未开启覆盖时,重复订单不落库,返回 `duplicateList`;前端弹框提示,用户确认覆盖后以 `overwrite=true` 重新导入。 6. 已入库、已退货、已关联发票或已关联采购申请、已提交审批流程的订单禁止覆盖,覆盖失败原因进入 `failureList`。 ## API | 方法 | 路径 | 说明 | |------|------|------| | POST | /erp/purchase-order/import | 导入采购订单(新增 `overwrite` 参数、响应新增 `duplicateList`) | | PUT | /erp/purchase-request/submit-batch | 批量提交采购申请审批(新增) | ### 1. 导入采购订单 **请求参数(multipart/form-data):** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | file | File | 是 | xls/xlsx 文件 | | directApprove | Boolean | 否 | 是否直接将导入订单置为“已审核(20)”,默认 false | | overwrite | Boolean | 否 | 是否覆盖重复订单,默认 false;false 时重复项只返回不落库 | **响应新增字段:** | 字段 | 类型 | 说明 | |------|------|------| | duplicateList | Array | 检测到的重复订单;未开启覆盖时这些订单未导入 | | duplicateList[].key | String | 导入文件中的采购单编号;编号为空时为“第 N 行” | | duplicateList[].existingNo | String | 系统内已存在的采购订单编号 | | duplicateList[].existingId | Number | 系统内已存在的采购订单编号 | | duplicateList[].reason | String | 重复原因:采购单编号已存在 / 供应商、明细、数量、单价、金额与已有订单一致 | **响应示例:** ```json { "code": 0, "data": { "createList": ["CGDD20261105000001"], "updateList": [], "failureList": {}, "duplicateList": [ { "key": "第 2 行", "existingNo": "CGDD20261014000006", "existingId": 2106, "reason": "供应商、明细、数量、单价、金额与已有订单一致" } ] } } ``` ### 2. 批量提交采购申请 **请求参数(query):** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | ids | String | 是 | 采购申请编号,多个用英文逗号分隔 | | processDefinitionKey | String | 是 | BPM 审批流程定义 Key | **响应字段:** | 字段 | 类型 | 说明 | |------|------|------| | successIds | Number[] | 提交成功的采购申请编号 | | failureMap | Object | 提交失败集合;key 为采购申请单号(取不到单号时为“编号 xxx”),value 为失败原因 | **响应示例:** ```json { "code": 0, "data": { "successIds": [2195, 2196], "failureMap": { "CGSQ20261105000003": "提交失败,采购申请单(CGSQ20261105000003)没有明细,请先添加明细后再提交" } } } ``` ## 字段展示规则 | 字段 | 展示位置 | 说明 | |------|----------|------| | duplicateList | 导入结果区、重复确认弹框 | 展示导入文件标识 → 已存在订单编号 + 重复原因 | | updateList | 导入结果区 | 覆盖模式下展示被更新订单编号 | | failureMap | 批量提交结果弹框 | 逐条展示“申请单号:失败原因” | ## 业务规则说明 | 场景 | 规则 | |------|------| | 批量提交范围 | 仅“未提交(0)”和“审批不通过(30)”的申请可提交;其它状态自动跳过并提示 | | 批量提交事务 | 每张申请独立事务,单张失败不回滚其它申请 | | 导入重复-单号 | 文件填写了“采购单编号”且系统已存在,判定重复 | | 导入重复-无单号 | 文件未填“采购单编号”时,才按“供应商 + 明细”指纹判定重复;填写了明确单号的正常重复采购不会被指纹拦截 | | 覆盖限制 | 已入库、已退货、已关联发票、已关联采购申请、已提交审批流程的订单不可覆盖 | | 审批自动生成 | 匹配到相同已审核订单时只建立关联,不重复生成订单;匹配不到才新增 | ## 注意事项 - 导入重复弹框提供“覆盖重复订单”和“不覆盖”两个选项;选择不覆盖时,重复项保留在结果区,可再次点击“覆盖重复订单”。 - 若确认是正常的新采购而非重复上传,需在文件中填写一个系统中不存在的采购单编号后重新导入。 - 批量提交建议按 50 张一批调用,避免一次提交过多导致请求超时。 - `overwrite=true` 会重新处理整个文件,包含首次已成功新增的非重复项,因此 `updateList` 可能包含这些订单编号。