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,