docs(changelog): #7294 补充 actualRefundAmount 的暂定值/定稿值口径(PR #7354)
changelog-filename-gate / validate (push) Successful in 2s
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>
这个提交包含在:
@@ -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,
|
||||||
|
|||||||
在新工单中引用
屏蔽一个用户