docs(changelog): #7294 补充 actualRefundAmount 的暂定值/定稿值口径(PR #7354)
changelog-filename-gate / validate (push) Successful in 2s

退款单在流团事务【提交之后】才建(异步),所以 approve 响应体里的
actualRefundAmount 是暂定值=退款诉求合计;随后服务端逐户回读实际建单结果,
把没建出退款单的户剔掉,改写成定稿值。要展示准确金额请重新拉一次详情。

本文原本已写「actualRefundAmount 只统计成功发起退款的户」,PR #7354 之前
实现其实是 Σ诉求、有户建单失败就对不上;现在实现与本文口径一致了。

顺带修两处当前校验器不再接受的 frontmatter:
consumer hl-ui → admin;not_required 不得保留 frontend_owner / verified_at。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
这个提交包含在:
jw
2026-09-08 18:58:20 +08:00
共同撰写人 Claude Opus 5
父节点 0081bc5682
当前提交 b22345d167
@@ -2,17 +2,17 @@
schema: "hl-changelog/v2" schema: "hl-changelog/v2"
ticket: "7294" ticket: "7294"
title: "批准流团后已付款户会被自动取消并发起退款;审批单实退金额不再恒为 0;新增 589554 出行中户硬闸" title: "批准流团后已付款户会被自动取消并发起退款;审批单实退金额不再恒为 0;新增 589554 出行中户硬闸"
consumer: "hl-ui" consumer: "admin"
author: "jw(GIT)" author: "jw(GIT)"
change_type: "修改接口" change_type: "修改接口"
backend_status: "deployed" backend_status: "deployed"
gateway_status: "verified" gateway_status: "verified"
frontend_status: "not_required" frontend_status: "not_required"
frontend_owner: "mmg" frontend_owner: ""
frontend_ref: "" frontend_ref: ""
target_release: "" target_release: ""
verified_at: "2026-09-08" verified_at: ""
status_note: "前端不改:接口出入参零变化;actualRefundAmount 前端本就直显后端权威值(group-batch-approval/index.vue 与 withdraw/index.vue formatPrice 直读),口径修正由后端算;589554 出行中户硬闸由拦截器透后端 message(无中央错误码字典)。" status_note: "前端不改:接口出入参零变化;actualRefundAmount 前端本就直显后端权威值(group-batch-approval/index.vue 与 withdraw/index.vue formatPrice 直读),口径修正由后端算;589554 出行中户硬闸由拦截器透后端 message(无中央错误码字典)。补充(PR #7354):approve 响应里的 actualRefundAmount 是暂定值,定稿在提交后异步改写(约 1 秒内);上述两个页面读的是列表/详情接口不是 approve 响应,故仍不需要改,但请勿改成直接渲染 approve 响应的该字段。"
updated_at: "2026-09-08" updated_at: "2026-09-08"
base: "dev-v3" base: "dev-v3"
--- ---
@@ -135,6 +135,16 @@ Content-Type: application/json
`actualRefundAmount` 只统计成功发起退款的户,因此**可能小于 `estimatedRefundAmount`**, `actualRefundAmount` 只统计成功发起退款的户,因此**可能小于 `estimatedRefundAmount`**,
差额由服务端日志里的「未处理清单」解释。 差额由服务端日志里的「未处理清单」解释。
⚠️ **`actualRefundAmount` 会在批准之后被改写一次,前端不要缓存 approve 响应里的那个值。**
退款单是在流团事务**提交之后**才建的(异步),所以 approve 响应体里带回的
`actualRefundAmount` 是**暂定值**=本次发出的退款诉求合计;随后服务端逐户回读实际建单结果,
把没建出退款单的户剔掉,改写成**定稿值**。两者在「全部建单成功」时相同,
有户建单失败时定稿值更小。
定稿通常在 1 秒内完成。**要展示准确金额,请在 approve 返回后重新拉一次
`GET /v3/admin/order/group-batch/disband/:approvalId`**,
或直接以列表 / 详情接口的值为准,不要直接渲染 approve 响应里的这个字段。
```json ```json
{ {
"code": 200, "code": 200,