docs(finance): 更正 7232 changelog §10 出纳付款登记入参字段名勘误
changelog-filename-gate / validate (push) Failing after 2s

前端联调反馈 cashier/pay bizType=EXPENSE 报 400 出账账户不能为空/付款金额不能为空。
经测试服实调实证:后端 cashier/pay 为全 bizType 统一扁平入参,付款账户/金额字段名
固定为 payAccountId/amount(@NotNull 文案与前端 400 逐字一致),changelog §10 误把
输出字段名 fundAccountId/actualAmount 写进了请求入参表,前端据此调用触发校验失败。

更正内容(§10):
- 入参表 fundAccountId→payAccountId、actualAmount→amount,并补全量必填字段 payDate 等
- 变更点说明补「回写列名非入参字段」澄清
- 新增请求/成功响应示例(可直接照抄)
- 598602 错误文案对齐实测「业务单状态非已批准,不可付款」
- frontmatter status_note 追加勘误说明 + updated_at 升 2026-09-10

验证(测试服,FY-202609100001):
错误字段→复现 400;正确字段 payAccountId/amount→付款成功 LS202609100002、
余额 114894→114594、报销单回写 PAID+fundAccountId+paidAt、重复付款 598602 防重拦下。

Refs #7232
这个提交包含在:
yaosutu
2026-09-10 15:19:23 +08:00
父节点 4281aa8aca
当前提交 be7415b771
@@ -12,8 +12,8 @@ frontend_owner: "mmg"
frontend_ref: "f104b541"
target_release: "v2.1"
verified_at: "2026-09-10"
status_note: "verified 2026-09-10 mmg: expense.js 八端点+EXPENSE_STATUS 五态映射;expense/expense 列表页(状态/部门/公司/关键字筛选,分类末级按名传/公司按名传/部门手录注释,驳回 rejectReason 必填,详情按 REJECTED/PAID 条件显,操作列按状态机分叉);出纳 cashier 三端点扩容 EXPENSE 线随 #7217 一并交付(commit 7278c5f9)。expense.spec 锁端点/ID 透传/状态兜底。checkpoint 全绿。"
updated_at: "2026-09-07"
status_note: "verified 2026-09-10 mmg: expense.js 八端点+EXPENSE_STATUS 五态映射;expense/expense 列表页(状态/部门/公司/关键字筛选,分类末级按名传/公司按名传/部门手录注释,驳回 rejectReason 必填,详情按 REJECTED/PAID 条件显,操作列按状态机分叉);出纳 cashier 三端点扩容 EXPENSE 线随 #7217 一并交付(commit 7278c5f9)。expense.spec 锁端点/ID 透传/状态兜底。checkpoint 全绿。2026-09-10 后端更正:§10 出纳付款登记入参字段名勘误——付款账户/金额实为统一扁平字段 payAccountId/amount(此前误写为输出字段名 fundAccountId/actualAmount,前端据此调用会触发 400 出账账户不能为空/付款金额不能为空),已补全量必填字段与请求/响应示例并经测试服实调验证。"
updated_at: "2026-09-10"
base: "dev-v3"
---
@@ -365,17 +365,47 @@ Authorization: Bearer <admin-token>
#### 变更点
入参 `bizType` 枚举新增 `EXPENSE` 值。`bizType=EXPENSE` 时 `bizId` 传报销单 ID,登记付款后回写 `fin_expense` 状态为 `PAID`、记录 `fundAccountId` / `paidAt`,同事务记资金流水。
入参 `bizType` 枚举新增 `EXPENSE` 值。`bizType=EXPENSE` 时 `bizId` 传报销单 ID,登记付款后回写 `fin_expense` 状态为 `PAID`、记录 `fundAccountId` / `paidAt`(回写列名,非入参字段),同事务记资金流水。
#### 入参(Body,关键字段)
> ⚠️ 出纳付款登记为**全 bizType 统一扁平入参**(NONBIZ / EXPENSE / PAYMENT / PREPAY 共用同一套字段),付款账户 / 金额字段名固定为 `payAccountId` / `amount`。下方为全量必填/关键字段:
| 字段 | 类型 | 必填 | 约束 | 说明 |
|---|---|---:|---|---|
| `bizType` | String | 是 | 新增 `EXPENSE` | 业务类型;费用报销传 `EXPENSE` |
| `bizId` | String | 是 | 对应业务单据 ID | `bizType=EXPENSE` 时传报销单 ID |
| `fundAccountId` | String | 是 | 必须存在 | 付款资金账户 ID |
| `actualAmount` | Number | 是 | >0 | 出纳手录实际打款金额(默认带入 payableAmt,可改) |
| 其余字段 | — | — | — | 与既有 NONBIZ 线一致,不变 |
| `payAccountId` | String | 是 | 必须存在且 ACTIVE | 出账资金账户 ID(fin_fund_account) |
| `amount` | Number | 是 | >0 | 付款金额(出纳按实际打款金额录入,可与应付不一致) |
| `payDate` | String | 是 | yyyy-MM-dd | 付款日期(可回溯补录) |
| `payMethod` | String | 否 | 字典 fin_pay_way | 付款方式(CASH/BANK_TRANSFER/WECHAT/ALIPAY) |
| `fee` | Number | 否 | ≥0 | 手续费(挂出账流水) |
| `voucherNo` | String | 否 | — | 付款凭证号 |
| `voucherUrl` | String | 否 | — | 付款凭证影像 URL |
#### 请求示例(bizType=EXPENSE)
```json
{
"bizType": "EXPENSE",
"bizId": "2097885645098659841",
"payAccountId": "2095340438490583041",
"amount": 300.00,
"payDate": "2026-09-10",
"payMethod": "BANK_TRANSFER"
}
```
#### 成功响应
```json
{
"code": 200,
"message": "成功",
"data": { "flowId": "2097946971271495682", "flowNo": "LS202609100002", "balanceAfter": 114594.0, "bizId": "2097885645098659841" },
"success": true
}
```
#### 业务边界
@@ -387,7 +417,7 @@ Authorization: Bearer <admin-token>
重复付款:
```json
{"code":598602,"message":"该单据已付款,请勿重复操作","success":false,"data":null}
{"code":598602,"message":"业务单状态非已批准,不可付款","success":false,"data":null}
```
付款类型非法(598607 文案已扩为含 EXPENSE):