hl-api-changelog/changelogs/2026-04/27_breaking_order-v2_pending-upgrade-amount-removed.md

⚠️ Breaking: 订单详情响应硬删 pendingUpgradeAmount 字段

日期: 2026-04-27 PR: #1320 (T+2 周收尾, 主 PR #1318) 类型: Breaking — 字段从响应中移除 影响端: 管理后台 (admin) + 微信小程序 (mp)

---

影响接口

• GET /admin/orders/{id}(订单详情 - 管理端)
• GET /mp/orders/{id}(订单详情 - 小程序端)

两个接口的响应顶层 OrderDetailVO 不再返回 pendingUpgradeAmount 字段。

字段含义(已废弃)

"pendingUpgradeAmount": "0.00"   // 待确认差价总额(配房/配车升级未确认)

主 PR #1318 (2026-04-23) 上线 V2 流程后, 差价已归并入 OrderDiscount(负) / OrderSurcharge(正), 该字段值已恒为 0.00(兼容字段)。今天 (T+2 周) 完成硬删。

前端动作

必须 ✅

• 移除任何对响应 pendingUpgradeAmount 字段的读取与渲染代码(undefined 不会触发渲染异常,但属于死代码)

建议 (如确实需要差价) ✅

• 走订单优惠/增项明细字段 — 各自带 confirmed 状态:
  • discounts: [{ amount, confirmed, sourceType, ...}]
  • surcharges: [{ amount, confirmed, sourceType, ...}]
• 用 surchargeAmount 字段(已确认增项总额)代替原"待确认差价"用途时,需注意语义已变为已确认

不受影响的字段(保留)

• OrderDetailVO.discountAmount(优惠总额)
• OrderDetailVO.surchargeAmount(增项总额)
• OrderDetailVO.depositAmount / depositRatio(订金)
• 其它金额字段全部不动

部署时机

• dev 已合并 (af55ee62), 测试服部署后立即生效
• 正式服将在测试服稳定 ≥ 24h 后部署

关联

• 主 PR #1318 (订单内部流程 V2, 已合并 2026-04-23)
• 后端 changelog: hl-backend-changelog/changelogs/2026-04/2026-04-27_order-v2_t2-cleanup-pending-upgrade-amount-and-dict-hard-delete.md