From b4fbfe6f20fbf69e6b4d5aa182e2277b02fd0bc1 Mon Sep 17 00:00:00 2001 From: Mimingguang <498526323@qq.com> Date: Mon, 21 Sep 2026 15:13:53 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#8045=20=E5=89=8D=E7=AB=AF?= =?UTF-8?q?=E5=B7=B2=E4=BA=A4=E4=BB=98=20verified(hl-admin=20v2.1=20e680cf?= =?UTF-8?q?10)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ..._团期详情返回整团待收unpaidAmount-修改接口-管理后台.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/changelogs-v2/2026-09/21_8045_团期详情返回整团待收unpaidAmount-修改接口-管理后台.md b/changelogs-v2/2026-09/21_8045_团期详情返回整团待收unpaidAmount-修改接口-管理后台.md index 413ace48..918e7297 100644 --- a/changelogs-v2/2026-09/21_8045_团期详情返回整团待收unpaidAmount-修改接口-管理后台.md +++ b/changelogs-v2/2026-09/21_8045_团期详情返回整团待收unpaidAmount-修改接口-管理后台.md @@ -7,12 +7,12 @@ author: "jw(GIT)" change_type: "修改接口" backend_status: "deployed" gateway_status: "verified" -frontend_status: "pending" +frontend_status: "verified" frontend_owner: "mmg" -frontend_ref: "" -target_release: "" +frontend_ref: "e680cf10c2b8c0377ea89d21ab13eea1e740f429" +target_release: "v2.1" verified_at: "2026-09-21" -status_note: "团期详情端点（A2）新增响应字段 unpaidAmount（整团待收），值 = max(0, receivableAmount − receivedAmount)，恒非 null 恒非负，字符串型金额。此前该端点已同时返回 receivableAmount 与 receivedAmount，但没有待收字段，前端只能自己做减法——而本页子订单项的 balanceAmount 是另一套算法（扣退款、取消单归 0），前端自算会在同一屏里产生第二套口径，故由后端给出。列表页（A1）早已有同名字段，本次是把详情页补齐，两处同源同公式。⚠️ 两点必须读：① 本字段按「毛累计已付」算，发生过退款的团偏小；逐户扣退款的权威待收在财务 tab 的 items/totals，不是财务 tab 的顶层 unpaidAmount（顶层与本字段同源同公式，数值一致）——同页展示两者时请在 UI 上区分标注（实测见「八」）。② 不要把它与子订单项的 balanceAmount 混用。本页既有四个金额字段（receivableAmount / receivedAmount / totalReceivable / totalReceived）的值、名称、形态逐字未变，纯增量。" +status_note: "团期详情端点（A2）新增响应字段 unpaidAmount（整团待收），值 = max(0, receivableAmount − receivedAmount)，恒非 null 恒非负，字符串型金额。此前该端点已同时返回 receivableAmount 与 receivedAmount，但没有待收字段，前端只能自己做减法——而本页子订单项的 balanceAmount 是另一套算法（扣退款、取消单归 0），前端自算会在同一屏里产生第二套口径，故由后端给出。【前端交付 2026-09-21 mmg：BatchHero 金额区补「待收」直显 detail.unpaidAmount（warning 色，缺失兜底 —，不自算），NTooltip 标注「退款不回减，权威待收以财务 tab 明细/合计为准」；FinanceTab 早已展示 totals/items unpaidAmount 零改动；BatchHero 8 例全过，hl-admin v2.1 e680cf10。】列表页（A1）早已有同名字段，本次是把详情页补齐，两处同源同公式。⚠️ 两点必须读：① 本字段按「毛累计已付」算，发生过退款的团偏小；逐户扣退款的权威待收在财务 tab 的 items/totals，不是财务 tab 的顶层 unpaidAmount（顶层与本字段同源同公式，数值一致）——同页展示两者时请在 UI 上区分标注（实测见「八」）。② 不要把它与子订单项的 balanceAmount 混用。本页既有四个金额字段（receivableAmount / receivedAmount / totalReceivable / totalReceived）的值、名称、形态逐字未变，纯增量。" updated_at: "2026-09-21" base: "dev-v3" ---