编辑 | blame | 历史 | 原始文档

采购订单导入重复检测与采购申请批量提交 - 前端联调方案

涉及页面

  • ERP → 采购管理 → 采购订单 → 导入弹窗
  • ERP → 采购管理 → 采购申请 → 列表工具栏、提交审批流程弹窗

业务流程与数据带入

  1. 采购申请列表勾选多张单据 → 点击「批量提交」→ 前端过滤出“未提交(0)/审批不通过(30)”的申请 → 选择审批流程 → 按每批 50 张调用批量提交接口。
  2. 批量提交逐张创建 BPM 流程实例并回写申请状态为“审批中(10)”,单张失败不影响其它申请,失败原因按申请单号返回。
  3. 采购申请审批通过且已填供应商时,后端先按“供应商 + 明细(物料、数量、单价、税率)”匹配系统内已审核且尚未入库/退货的采购订单:
  • 匹配到:把申请关联到该订单,并回填订单明细的申请明细编号,不再生成新订单;
  • 匹配不到:保持原有逻辑自动生成一张已审核采购订单。
  1. 采购订单导入时,后端按以下顺序识别重复:
  • 文件中的“采购单编号”在系统内已存在;
  • 文件中的“采购单编号”留空(由系统自动生成编号)且供应商、明细、数量、单价、税率与系统内已有订单完全一致。
  1. 发现重复且未开启覆盖时,重复订单不落库,返回 duplicateList;前端弹框提示,用户确认覆盖后以 overwrite=true 重新导入。
  2. 已入库、已退货、已关联发票或已关联采购申请、已提交审批流程的订单禁止覆盖,覆盖失败原因进入 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 重复原因:采购单编号已存在 / 供应商、明细、数量、单价、金额与已有订单一致

响应示例:

{
  "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 为失败原因

响应示例:

{
  "code": 0,
  "data": {
    "successIds": [2195, 2196],
    "failureMap": {
      "CGSQ20261105000003": "提交失败,采购申请单(CGSQ20261105000003)没有明细,请先添加明细后再提交"
    }
  }
}

字段展示规则

字段 展示位置 说明
duplicateList 导入结果区、重复确认弹框 展示导入文件标识 → 已存在订单编号 + 重复原因
updateList 导入结果区 覆盖模式下展示被更新订单编号
failureMap 批量提交结果弹框 逐条展示“申请单号:失败原因”

业务规则说明

场景 规则
批量提交范围 仅“未提交(0)”和“审批不通过(30)”的申请可提交;其它状态自动跳过并提示
批量提交事务 每张申请独立事务,单张失败不回滚其它申请
导入重复-单号 文件填写了“采购单编号”且系统已存在,判定重复
导入重复-无单号 文件未填“采购单编号”时,才按“供应商 + 明细”指纹判定重复;填写了明确单号的正常重复采购不会被指纹拦截
覆盖限制 已入库、已退货、已关联发票、已关联采购申请、已提交审批流程的订单不可覆盖
审批自动生成 匹配到相同已审核订单时只建立关联,不重复生成订单;匹配不到才新增

注意事项

  • 导入重复弹框提供“覆盖重复订单”和“不覆盖”两个选项;选择不覆盖时,重复项保留在结果区,可再次点击“覆盖重复订单”。
  • 若确认是正常的新采购而非重复上传,需在文件中填写一个系统中不存在的采购单编号后重新导入。
  • 批量提交建议按 50 张一批调用,避免一次提交过多导致请求超时。
  • overwrite=true 会重新处理整个文件,包含首次已成功新增的非重复项,因此 updateList 可能包含这些订单编号。