yaosutu
edab50a6a8
changelog-filename-gate / validate (push) Failing after 2s
- 费用报销：page 加 statuses 多状态筛选、detail 加 payRecords 付款记录、表单补 applicantId/payeeAccount/voucherUrl、透出经办人 operatorId/operatorName、598705 文案放宽；含部门组织树/员工选择器/所属公司 travel_agency/费用分类 关联接口指引 - 费用支付：出纳域对接说明（queue/pay/payments 按 EXPENSE 路由），接口无变更
4.0 KiB
4.0 KiB
schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base
| schema | ticket | title | consumer | author | change_type | backend_status | gateway_status | frontend_status | frontend_owner | frontend_ref | target_release | verified_at | status_note | updated_at | base |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hl-changelog/v2 | expense-pay | 费用支付（出纳）：报销审批通过后的付款链路对接说明——队列/登记付款/已付台账按 EXPENSE 路由 | admin | yst | 修改接口 | deployed | not_required | not_required | 📘 对接说明（出纳域接口本次无变更）：费用报销 APPROVED 后进出纳队列付款，复用统一出纳接口 /admin/finance/cashier/*，按 payType/bizType=EXPENSE 路由。本文给前端费用支付页的对接口径。 | 2026-09-13 | dev-v3 |
费用支付（出纳）—— 报销付款链路对接说明
服务: hl-order-service-v3（hl-finance 财务模块·出纳域） 端: 管理后台 类型: 📘 对接说明（出纳域接口本次无变更，仅说明费用支付页怎么接） 日期: 2026-09-13 关联: 费用报销 changelog（
13_expense_费用报销多状态与申请人经办人）
一、接口背景
费用报销单 APPROVED（审批通过）后进入出纳待付款队列，由出纳登记打款、回写报销单 PAID。费用支付不单独建接口，复用财务统一出纳接口 /admin/finance/cashier/*，按 payType / bizType = EXPENSE 路由出报销这一类的待付/已付数据。
二、付款链路（报销视角）
报销单 approve(APPROVED) → 出纳队列出现该待付单 → 出纳登记付款(pay, bizType=EXPENSE)
→ 记资金流水 OUT + 回写报销单 PAID + 重算结存 → 已付款台账可查 / 报销详情 payRecords 回显
报销单若有"冲抵借款"（offsetLoanAmt>0），出纳按
payableAmt（应付差额）付款，非全额 amount。
三、涉及接口（均为出纳域现有接口，按 EXPENSE 过滤）
① 出纳待付款队列 — GET /admin/finance/cashier/queue
- 入参：
payType=EXPENSE（费用报销）+ page/pageSize（其余筛选项按 VO） - 出参行：报销单号 / 申请人 / 金额（应付 payableAmt）/ 状态 / 等
- 费用支付页"待付款"列表 = 本接口 payType=EXPENSE
② 登记付款 — POST /admin/finance/cashier/pay
- 入参：
bizType=EXPENSE+bizId(报销单ID) + 出账账户 fundAccountId + 金额 + 手续费 + 付款日期 + 凭证 voucherUrl 等 - 动作：记资金流水 OUT + 回写报销单 PAID + 重算账户结存 + 透支闸校验
- 幂等/并发：同一报销单重复付款会被状态守卫拦截（已 PAID 不可重复付）
③ 已付款流水台账 — GET /admin/finance/cashier/payments/page
- 入参：
bizType=EXPENSE+ page/pageSize - 费用支付页"已付款"列表 = 本接口 bizType=EXPENSE
四、字段对接要点
| 前端展示 | 来源 |
|---|---|
| 待付款列表 | cashier/queue?payType=EXPENSE |
| 已付款列表 | cashier/payments/page?bizType=EXPENSE |
| 登记付款动作 | cashier/pay（bizType=EXPENSE） |
| 单张报销的付款记录（含付款凭证） | 报销详情 GET /admin/finance/expenses/{id} 的 payRecords（见报销 changelog） |
五、注意事项
- 费用支付复用统一出纳队列/付款/台账接口，不要为报销单独写支付接口；靠
payType/bizType=EXPENSE区分业务类型。 - 付款金额以报销单
payableAmt（应付差额）为准（有冲抵借款时 ≠ 报销总额 amount）。 - 付款凭证（出纳回单）通过
cashier/pay的 voucherUrl 上传，回显在报销详情payRecords[].voucherUrl，与报销"申请凭证" voucherUrl 是两个不同字段。 - 出账账户下拉用资金账户接口（
GET /admin/finance/fund-accounts启用项，取 ACTIVE 且非冻结账户）。
六、关联 / 联系人
- 报销单据 changelog：
13_expense_费用报销多状态与申请人经办人-修改接口-管理后台.md - 出纳域（统一收付）：hl-finance
CashierController（queue/pay/payments/confirm-in） - 负责人：yst（腰苏图）