3.1 KiB
3.1 KiB
通知模板修正 + 订单详情字段补全
类型: fix 日期: 2026-03-20 涉及服务: hl-order-service、hl-mp-service 后端状态: ✅ 已完成并部署
一、小程序订单详情接口新增字段
GET /mp/order/{orderId} 订单详情
响应新增以下字段：
| 字段 | 类型 | 说明 |
|---|---|---|
| surchargeAmount | BigDecimal | 费用增加总额（如升级房型补差价） |
| surcharges | List | 费用增加项列表（同优惠项 discounts 结构对称） |
| displayStatus | String | 展示状态（前端主要使用此字段展示订单状态） |
| displayStatusLabel | String | 展示状态中文标签 |
| transportSegments | List | 交通段列表（大交通信息） |
| sharerOpenid | String | 分享者openid |
displayStatus 枚举值
| 值 | 标签 | 说明 |
|---|---|---|
| PENDING_PAY | 待支付 | 订单创建未支付 |
| DEPOSIT_PAID | 已付定金 | 定金已支付 |
| PAID | 已支付 | 全款已支付 |
| CONFIRMED | 已确认 | 订单已确认 |
| PENDING_BALANCE | 待付尾款 | 等待用户支付尾款 |
| PENDING_DEPARTURE | 待出发 | 内部流程完成，等待出发 |
| TRAVELLING | 出行中 | 行程进行中 |
| COMPLETED | 已完成 | 行程结束 |
| CANCELLED | 已取消 | 订单已取消 |
| REFUNDING | 退款中 | 退款处理中 |
| REFUNDED | 已退款 | 退款完成 |
surcharges 列表项结构
| 字段 | 类型 | 说明 |
|---|---|---|
| surchargeId | String | 费用增加项ID |
| orderId | String | 订单ID |
| surchargeName | String | 费用增加项名称（如"升级房型补差价"） |
| surchargeAmount | BigDecimal | 金额 |
| createTime | DateTime | 创建时间 |
前端使用建议
- 订单状态展示：优先使用
displayStatus+displayStatusLabel，而非status - 金额汇总区域：新增"费用增加"行
总价: ¥3000.00 优惠: -¥100.00 增加: +¥200.00 ← 新增（surchargeAmount > 0 时显示） 定金: ¥1000.00 尾款: ¥2100.00 - 费用增加项列表：在优惠项列表下方展示 surcharges 列表
二、通知消息内容修正
所有通知模板（站内信/短信/订阅消息/公众号）内容已优化，前端无需改动，后端自动生效。
以下是修正的内容汇总（仅供参考，前端不需要处理模板内容）：
| 事件 | 修正前问题 | 修正后 |
|---|---|---|
| 定金支付成功 | 缺出发日期 | 补充出发日期 + 尾款提示 |
| 全款支付成功 | 缺出发日期 | 补充出发日期 |
| 订单已取消 | 变量名不匹配，reason显示为空 | 修正变量名，正确显示取消原因 |
| 退款已申请 | 缺退款金额 | 补充退款金额 |
| 退款被驳回 | 变量名不匹配，原因显示为空 | 修正变量名，正确显示驳回原因 |
| 行程已修改 | 变量名不匹配 | 修正变量名 |
| 房型/车型已变更 | 变量名不匹配 | 修正变量名 |
| 修改已确认 | 模板内容为空 | 补全模板 |
| 级联失效通知 | 变量名不匹配 | 修正变量名 |
| 所有金额 | 缺 ¥ 符号 | 统一加 ¥ 前缀 |