采购来票 + 付款关联来票 - 前端联调方案

涉及页面

• 采购来票管理页（**新建页面**，参考采购申请/采购订单页面结构）
• 采购订单详情页（展示该订单下已关联的来票信息）
• 付款单管理页（新建/编辑弹窗、列表、详情）
• 付款单详情页（展示关联的来票信息）

业务流程与数据带入

1. 采购订单（审核通过）-> 创建来票：purchaseOrderId 必选，供应商自动带出（以采购订单的供应商为准，前端无需传 supplierId，由后端按采购订单查询设置）。
2. 来票创建后 -> 上传发票附件（走 system 模块 Storage API）。
3. 来票提交审批 -> 审批通过 -> 才可作为付款关联对象。
4. 新建付款单 -> 选择关联来票（invoiceId 必填）：从 GET /erp/purchase-invoice/simple-list?supplierId=&purchaseOrderId= 选择，仅显示"审批通过 + 已上传附件 + 剩余可付金额 > 0"的来票；选择后 remainingInvoicePrice 可用于预填付款金额上限。

对应关系：**采购订单(1) -> 来票(N) -> 付款(M)**。

API

1. 来票管理（新）

创建/更新来票请求参数：

来票分页/详情响应新增字段：

simple-list 响应：

2. 付款单（接口变更）

请求参数新增：

响应字段新增：

响应示例：

{
  "code": 0,
  "data": {
    "id": 1,
    "no": "FKD20260810000001",
    "invoiceId": 100,
    "invoice": {
      "id": 100,
      "no": "FPD20260810000001",
      "invoiceNo": "02564178",
      "invoiceTitle": "XX科技有限公司",
      "price": 9000.00,
      "auditStatus": 20
    },
    "paymentPrice": 5000.00
  }
}

字段展示规则

业务规则说明

注意事项

• 来票供应商不从前端传入，创建/更新时由后端根据采购订单自动设置，前端表单只展示。
• 付款表单选择来票时，先按供应商过滤（supplierId），可选订单时传 purchaseOrderId 进一步过滤。
• remainingInvoicePrice 为负数或 0 的来票不会出现在 simple-list 中，前端可直接按返回列表渲染。
• 付款金额校验在后端，前端可将来票的 remainingInvoicePrice 作为付款金额输入上限提示。
• 来票审批状态变化通过 BPM 回调更新，前端无需处理，分页接口直接返回最新状态。
• 来票发票附件上传使用 system 模块 Storage API（upload -> bind），不要使用旧版 /infra/file 接口。