合同管理新增"已开票金额/未开票金额"字段 - 前端联调方案

涉及页面

合同管理列表页
合同详情页
创建开票 / 创建回款时选择合同的下拉（simple-list）

API

本次**不改动任何接口路径、方法、请求参数**，仅合同相关接口的**响应结构新增两个字段**。

方法	路径	说明
GET	/crm/contract/page	合同分页列表（新增字段）
GET	/crm/contract/get	合同详情（新增字段）
GET	/crm/contract/page-by-customer	按客户分页（新增字段）
GET	/crm/contract/page-by-business	按商机分页（新增字段）
GET	/crm/contract/simple-list	合同下拉（新增字段）

响应字段新增：

字段	类型	说明
totalInvoicePrice	BigDecimal	已开票金额（元），统计审批通过 + 审批中的开票单金额合计
unInvoicePrice	BigDecimal	未开票金额（元），等于 `totalPrice - totalInvoicePrice`，仅列表/详情接口返回，simple-list 不返回

响应示例（列表/详情）：

{
  "code": 0,
  "data": {
    "totalPrice": 1000000.00,
    "totalReceivablePrice": 400000.00,
    "totalInvoicePrice": 1000000.00,
    "unInvoicePrice": 0.00
  }
}

字段展示规则

字段	展示位置	说明
已开票金额（totalInvoicePrice）	列表表格列、详情页金额区域	含审批中的开票单金额，与后端防超校验口径一致
未开票金额（unInvoicePrice）	列表表格列、详情页金额区域	合同金额 - 已开票金额，可同时用于展示"剩余可开票金额"

业务规则说明

场景	规则
审批中的开票单	计入"已开票金额"，占用合同额度（与后端提交开票时的校验一致，前端展示的剩余额度才准确）
审批被驳回 / 取消的开票单	不计入"已开票金额"，额度自动释放
未开票金额	若为负数说明已超开（正常流程后端已拦截，不会出现）
合同下拉（simple-list）	返回 totalInvoicePrice，可用于在创建开票/回款时提示剩余可开金额

注意事项

字段语义是"含审批中"，不是"实际已开出票"金额，前端展示时文案建议用"已开票金额（含审批中）"避免歧义。
新增字段仅用于展示，前端**不要**提交这两个字段（后端不接收，属只读汇总字段）。
Excel 导出本次未新增这两列，如需导出可另行申请。