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