hl-api-changelog/changelogs-v2/2026-09/09_7003_资金流水-新增接口-管理后台.md

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	7003	资金流水（分页 + 详情，只读）	admin	yst	新增接口	deployed	verified	verified	mmg	21540997		2026-09-09	后端已合 dev-v3（account 资金账户域）并部署测试服。只读；balanceAfter 勾稽；列表行+详情补 remark 字段（#7133）。	2026-09-09	dev-v3

资金流水

1. 接口背景

财务域「资金流水」：资金账户每笔出入账的流水记录（只读）。来源包括付款、预付、报销、收款、业务外、互转、盘盈盘亏、期初调整等。本期列表行与详情补充 remark 字段（互转备注/盘盈盘亏/期初调整原因，#7133）。

2. 变更清单

类型	接口	说明
新增	GET /admin/finance/fund-flows/page	流水分页（flowAt 倒序）
新增	GET /admin/finance/fund-flows/{id}	流水详情

3. 接口详情

3.1 分页 GET /page

入参（Query + 分页，均可选）：fundAccountId / accountType / direction / bizType / flowNo（模糊）/ flowAtStart / flowAtEnd（yyyy-MM-dd）/ pageNo / pageSize。

出参行（FundFlowRowRespVO，Long ID 序列化为 String）：

字段	类型	说明
id	String	流水ID
flowNo	String	流水号（日期前缀）
fundAccountId	String	资金账户ID
accountName	String	账户名称
accountType	String	账户类型
direction	String	OUT 出 / IN 入
amount	BigDecimal	金额
bizType	String	业务类型
bizId	String	业务单据ID（可空）
bizNo	String	业务单号（手写动作 TRANSFER/INVENTORY/OPENING 恒为 null）
balanceAfter	BigDecimal	本笔记完后结存快照（勾稽）
transferGroupId	String	互转组ID（仅 TRANSFER）
fee	BigDecimal	手续费（仅 TRANSFER，挂转出行）
counterparty	String	对方账户/往来（脱敏）
flowAt	String	记账时间（yyyy-MM-dd HH:mm:ss）
voucherUrl	String	佐证影像
remark	String	备注（互转备注/盘盈盘亏/期初调整原因）

3.2 详情 GET /{id}

出参 = 行全字段 + pairedFlowId（互转对侧流水ID，仅 TRANSFER）+ operatorName（经办人）。

4. 枚举 / 数据字典

字段	取值
accountType	BANK / CASH / THIRD_PARTY / INTERNAL_VIRTUAL
direction	OUT 出账 / IN 入账
bizType	PAYMENT 付款 / PREPAY 预付 / EXPENSE 费用 / REIMBURSE 报销 / RECEIPT 收款 / STAFF_LOAN 员工借款 / COMPANY_LOAN 公司借款 / NONBIZ 业务外 / ADVANCE 预支 / TRANSFER 互转 / ORDER_PAY 订单支付 / INVENTORY 盘盈盘亏 / OPENING 期初调整

5. 错误码（段位 595100-595199）

码	含义
595101	流水不存在（查询路径仅见此码）
595102-595106	写入侧（金额无效/余额不足/并发冲突/期初调整非法/盘盈盘亏方向无效），查询不触发

6. 示例

按账户+方向查

GET /admin/finance/fund-flows/page?fundAccountId=2097...&direction=OUT&pageNo=1&pageSize=20
→ 200 {"records":[{"flowNo":"LS20260909...","direction":"OUT","amount":100.00,"balanceAfter":4900.00,"bizType":"PAYMENT",...}],"total":N}

详情（互转带对侧）

GET /admin/finance/fund-flows/{id}
→ 200 {..., "bizType":"TRANSFER","transferGroupId":"...","pairedFlowId":"...","remark":"银行取现"}

7. 注意事项

• 流水只读，无新增/修改/删除端点（由业务动作产生）。
• balanceAfter 为该笔记完后的结存快照，可用于逐笔勾稽。
• 手写动作（互转/盘盈盘亏/期初）无关联业务单号，bizNo 为 null。
• 长整型 ID 序列化为字符串。

8. 关联 / 联系人

• Issue：https://git.1814.love:8443/wx/HL/issues/7003 ｜ remark 出参 #7133
• Commit：https://git.1814.love:8443/wx/HL/commit/b46269a4d4
• 负责人：腰苏图（yst）