docs(finance): 费用报销 changelog 冲抵勾稽自包含——内联 offsettable 用法
changelog-filename-gate / validate (push) Failing after 2s

原 §七 错误码 599107/599113 写"见 PR #7566 冲抵借款 changelog"违反自包含铁律。
本次补全:599107/599113 拆行写清触发条件 + 新增「冲抵勾稽(自包含)」段——
内联 GET /admin/finance/staff-loans/offsettable 端点用法与出参(balanceAmt 可冲上限)、
use=min(报销剩余额度,借款余额) 勾稽规则、offsetLoanAmt/payableAmt 关系,
指向员工借款申请与审批篇准确文件名。
这个提交包含在:
yaosutu
2026-09-13 17:51:23 +08:00
父节点 1191b6e046
当前提交 9ad6178c3c
@@ -109,7 +109,10 @@ offsetLoanAmt、fundAccountId、approvalInstanceId、rejectReason、paidAt,及
|---|---|---| |---|---|---|
| 598705 | 部门/公司主体/申请人非法 | **文案放宽**(原"部门或公司主体非法"):部门须在组织树 / 公司主体须 travel_agency 启用 / 申请人须存在且带真名 | | 598705 | 部门/公司主体/申请人非法 | **文案放宽**(原"部门或公司主体非法"):部门须在组织树 / 公司主体须 travel_agency 启用 / 申请人须存在且带真名 |
| 599112 | 冲抵借款时申请人必填 | offsetLoanIds 非空但 applicantId 空 | | 599112 | 冲抵借款时申请人必填 | offsetLoanIds 非空但 applicantId 空 |
| 599107 / 599113 | 冲抵借款相关 | 见 PR #7566 冲抵借款 changelog | | 599107 | 借款可冲余额不足,请重新勾选 | 勾选借款的 balanceAmt(可冲上限)不足以覆盖拟冲额 |
| 599113 | 勾选借款与报销申请人不一致 | offsetLoanIds 里借款单的借款人 ≠ 本报销单 applicantId |
**冲抵勾稽(自包含)**:勾选冲抵用 `GET /admin/finance/staff-loans/offsettable?staffId=<申请人adminId>` 查本申请人名下可冲借款,返回 `[{id, loanNo, amount, repaidAmt, balanceAmt(可冲上限), loanDate, purpose}]`,前端勾选后把选中借款单 `id` 数组传 `offsetLoanIds`。按勾选顺序逐笔 use=min(报销剩余额度, 该借款 balanceAmt);后端汇总落 `offsetLoanAmt`,`payableAmt = amount − offsetLoanAmt`(出纳按此差额付款)。借款单侧字段/状态机详见 `13_staffloan_员工借款申请与审批-新增接口-管理后台.md`。
## 八、示例 ## 八、示例