From b22345d16739c3915fc1d17d64a2139c11a76f5a Mon Sep 17 00:00:00 2001 From: jw Date: Tue, 8 Sep 2026 18:57:33 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#7294=20=E8=A1=A5=E5=85=85?= =?UTF-8?q?=20actualRefundAmount=20=E7=9A=84=E6=9A=82=E5=AE=9A=E5=80=BC/?= =?UTF-8?q?=E5=AE=9A=E7=A8=BF=E5=80=BC=E5=8F=A3=E5=BE=84=EF=BC=88PR=20#735?= =?UTF-8?q?4=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 退款单在流团事务【提交之后】才建（异步），所以 approve 响应体里的 actualRefundAmount 是暂定值＝退款诉求合计；随后服务端逐户回读实际建单结果， 把没建出退款单的户剔掉，改写成定稿值。要展示准确金额请重新拉一次详情。 本文原本已写「actualRefundAmount 只统计成功发起退款的户」，PR #7354 之前 实现其实是 Σ诉求、有户建单失败就对不上；现在实现与本文口径一致了。 顺带修两处当前校验器不再接受的 frontmatter： consumer hl-ui → admin；not_required 不得保留 frontend_owner / verified_at。 Co-Authored-By: Claude Opus 5 (1M context) --- ...已付款户也取消并发起退款-修改接口-管理后台.md | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/changelogs-v2/2026-09/08_7294_流团对已付款户也取消并发起退款-修改接口-管理后台.md b/changelogs-v2/2026-09/08_7294_流团对已付款户也取消并发起退款-修改接口-管理后台.md index d5cbdd7d..39c22733 100644 --- a/changelogs-v2/2026-09/08_7294_流团对已付款户也取消并发起退款-修改接口-管理后台.md +++ b/changelogs-v2/2026-09/08_7294_流团对已付款户也取消并发起退款-修改接口-管理后台.md @@ -2,17 +2,17 @@ schema: "hl-changelog/v2" ticket: "7294" title: "批准流团后已付款户会被自动取消并发起退款；审批单实退金额不再恒为 0；新增 589554 出行中户硬闸" -consumer: "hl-ui" +consumer: "admin" author: "jw(GIT)" change_type: "修改接口" backend_status: "deployed" gateway_status: "verified" frontend_status: "not_required" -frontend_owner: "mmg" +frontend_owner: "" frontend_ref: "" target_release: "" -verified_at: "2026-09-08" -status_note: "前端不改:接口出入参零变化;actualRefundAmount 前端本就直显后端权威值(group-batch-approval/index.vue 与 withdraw/index.vue formatPrice 直读),口径修正由后端算;589554 出行中户硬闸由拦截器透后端 message(无中央错误码字典)。" +verified_at: "" +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" base: "dev-v3" --- @@ -135,6 +135,16 @@ Content-Type: application/json `actualRefundAmount` 只统计成功发起退款的户，因此**可能小于 `estimatedRefundAmount`**， 差额由服务端日志里的「未处理清单」解释。 +⚠️ **`actualRefundAmount` 会在批准之后被改写一次，前端不要缓存 approve 响应里的那个值。** +退款单是在流团事务**提交之后**才建的（异步），所以 approve 响应体里带回的 +`actualRefundAmount` 是**暂定值**＝本次发出的退款诉求合计；随后服务端逐户回读实际建单结果， +把没建出退款单的户剔掉，改写成**定稿值**。两者在「全部建单成功」时相同， +有户建单失败时定稿值更小。 + +定稿通常在 1 秒内完成。**要展示准确金额，请在 approve 返回后重新拉一次 +`GET /v3/admin/order/group-batch/disband/:approvalId`**， +或直接以列表 / 详情接口的值为准，不要直接渲染 approve 响应里的这个字段。 + ```json { "code": 200,