# 采购来票关联多张采购订单(分摊) - 前端联调方案 ## 背景 宁夏万通需求:采购来票中的「采购订单」由单选改为多选,识别录入同样支持。一张来票可以分摊到多张采购订单上,每张订单记录本次分摊金额,订单的「未开票金额」按分摊明细累计。 ## 涉及页面 - 采购管理 - 采购来票(新增 / 编辑 / 详情弹窗、列表) - 采购管理 - 采购来票识别录入(识别结果进入同一个新增弹窗) - 采购管理 - 采购订单(列表「未开票金额」列、可来票登记筛选) - 采购管理 - 付款单(按采购订单选择来票时,走分摊明细) ## 业务流程与数据带入 1. 新增来票:选择采购订单(可多选,仅已审核通过、未开票金额大于 0、且与首张订单同一供应商的订单)-> 系统按所选订单的未开票金额自动分摊来票金额,可手工调整。 2. 来票金额变化 -> 已选订单按顺序重新自动分摊(每张先填满未开票金额,剩余顺延下一张)。 3. 识别录入(OCR)-> 识别出的金额带入来票金额,仍需人工选择采购订单并分摊。 4. 保存后 -> 采购订单的「未开票金额」= 订单金额 − 该订单所有来票分摊合计;分摊完的订单不再出现在可选列表。 ## API | 方法 | 路径 | 说明 | |------|------|------| | POST | /erp/purchase-invoice/create | 新增来票,改为传分摊明细 orderAllocations | | PUT | /erp/purchase-invoice/update | 修改来票,可更换订单、重设分摊 | | GET | /erp/purchase-invoice/get | 详情,返回分摊明细及每张订单的未开票金额 | | GET | /erp/purchase-invoice/page | 列表,支持按 purchaseOrderId 过滤,返回订单号汇总 | | GET | /erp/purchase-order/page | 采购订单列表,remainInvoicePrice 改为按分摊明细计算,remainPriceEnable 同步;新增 invoiceId 参数 | **create / update 请求参数(变化部分):** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | orderAllocations | Array | 是 | 采购订单分摊明细,至少一行 | | orderAllocations[].purchaseOrderId | Long | 是 | 采购订单编号 | | orderAllocations[].price | BigDecimal | 是 | 本张来票分摊到该订单的金额,不能小于 0 | | purchaseOrderId | Long | 否 | **不再由前端传**,后端取分摊明细第一行回填 | | supplierId | Long | 否 | **不再由前端传**,后端取第一张订单的供应商回填 | | price | BigDecimal | 是 | 来票金额,必须大于等于各行分摊金额之和(未分摊部分可后续编辑补充订单) | **page 请求参数新增:** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | purchaseOrderId | Long | 否 | 按采购订单过滤来票(命中分摊明细) | | invoiceId | Long | 否 | 编辑来票时传本张来票编号:未开票金额与 remainPriceEnable 计算时剔除该来票自身的分摊,相当于把它已分摊的金额退回订单(采购来票选订单弹窗使用) | **create / update 响应:** `{ "code": 0, "data": 1 }`(来票编号) **page / get 响应新增字段:** | 字段 | 类型 | 说明 | |------|------|------| | orderNos | String | 关联采购订单号,多张以「、」拼接(列表展示) | | orderCount | Integer | 关联采购订单数量 | | orderAllocations | Array | 分摊明细,字段见下表 | **orderAllocations 字段:** | 字段 | 类型 | 说明 | |------|------|------| | purchaseOrderId | Long | 采购订单编号 | | orderNo | String | 采购订单号 | | supplierId / supplierName | Long / String | 订单供应商 | | orderTotalPrice | BigDecimal | 订单金额(含税) | | invoicedPrice | BigDecimal | 该订单**其他**来票已占用金额(不含本张来票) | | remainPrice | BigDecimal | 该订单未开票金额(不含本张来票),即本次最多可分摊金额 | | price | BigDecimal | 本张来票分摊到该订单的金额 | **采购订单列表(/erp/purchase-order/page)字段口径变化:** | 字段 | 说明 | |------|------| | remainInvoicePrice | 订单金额 − 该订单所有来票分摊合计(原为订单金额 − 单张来票金额) | | remainPriceEnable=true | 只返回未开票金额 > 0 的订单,口径同步改为按分摊明细计算 | ## 字段展示规则 | 字段 | 展示位置 | 说明 | |------|----------|------| | 采购订单 | 来票新增/编辑弹窗 | 多选弹窗(已审核 + 未开票金额大于 0),表格列:订单号、供应商、订单金额、未开票金额、本次分摊金额(可编辑)、移除 | | 分摊合计 / 待分摊差额 | 分摊表格下方 | 实时显示;差额为正(未分摊)允许保存,为负(超出)时保存被拦截 | | 供应商 | 来票表单 | 由所选订单供应商带出(同一供应商),只读 | | 采购订单编号 | 来票列表 | 展示 orderNos;历史数据回退到主订单号 | | 未开票金额 | 采购订单列表 / 选择弹窗 | 按分摊明细实时计算 | ## 业务规则说明 | 场景 | 规则 | |------|------| | 分摊合计 | 不能大于来票金额(超出时报错并列出来票金额、分摊合计和超出金额);允许小于来票金额,未分摊部分可保存后编辑来票再补充采购订单 | | 单订单上限 | 每行分摊金额不得超过该订单「未开票金额」(订单金额 − 其他来票已占用) | | 订单重复 | 同一张来票内同一订单只能出现一次 | | 订单状态 | 只有已审核通过(status=20)的采购订单才能登记来票 | | 供应商 | **必须同一供应商**:所选采购订单的供应商不一致时保存被拦截,并列出各供应商及其订单号 | | 额度占用 | 来票创建后即占用订单未开票额度(无审核流程),删除后释放 | | 编辑 | 允许更换订单、调整分摊;校验与弹窗未开票金额计算均排除本张来票自身的分摊,已分摊金额退回订单 | | 删除 | 有有效付款单关联的来票不允许删除;删除同时释放分摊额度 | ## 注意事项 - 数据库需先执行 `docs/sql/erp_purchase_invoice_order_20261104.sql`(新建 `erp_purchase_invoice_order` 分摊表,并回填历史来票)。 - 历史来票若没有分摊明细,列表/详情按主订单兜底展示;编辑保存后会按新规则重建分摊明细。 - 付款单按采购订单选择来票时,改为按分摊明细匹配订单(一张来票可命中多张订单)。 - 前端自动分摊按「所选订单的勾选顺序」依次填满,调整某行金额后差额会自动顺延给其他订单,仍受各自上限约束。 - 已开票金额合计不会超过订单金额(订单未开票金额不会为负);来票金额小于订单金额时,差额保留在该订单的未开票金额中,下次开票仍可选择该订单。