84 行
3.1 KiB
Markdown
84 行
3.1 KiB
Markdown
# 通知模板修正 + 订单详情字段补全
|
||
|
||
> **类型**: 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显示为空 | 修正变量名，正确显示取消原因 |
|
||
| 退款已申请 | 缺退款金额 | 补充退款金额 |
|
||
| 退款被驳回 | 变量名不匹配，原因显示为空 | 修正变量名，正确显示驳回原因 |
|
||
| 行程已修改 | 变量名不匹配 | 修正变量名 |
|
||
| 房型/车型已变更 | 变量名不匹配 | 修正变量名 |
|
||
| 修改已确认 | 模板内容为空 | 补全模板 |
|
||
| 级联失效通知 | 变量名不匹配 | 修正变量名 |
|
||
| 所有金额 | 缺 ¥ 符号 | 统一加 ¥ 前缀 |
|