17648b8961
- #1314 mp-contract: Map → MpContractVO / MpContractDetailVO 强类型化 - #1313 mp-refund preview refundRatio 恒 0 bug 修复 - #1306 mp-order balanceAmount 计算口径统一(FULL 也返回, 公式含 paid) - #1309 mp-order guide/photographer avatarUrl 快照补齐(新订单生效) - #1300 mp-order detail 新增 groupBatchId(GROUP 才有值) - #1298 mp-group order youngChildCount 保留不再强制清零 - #1289 mp-pre-trip checklist 6→7 项 + DEPARTURE_INFO + WARNING 状态
64 行
1.5 KiB
Markdown
64 行
1.5 KiB
Markdown
# MP 订单详情 · 新增 groupBatchId（团期 ID）
|
||
|
||
- **变更日期**: 2026-04-23
|
||
- **PR**: #1300
|
||
- **影响面**: 小程序端 · 订单详情（仅小蒙马 GROUP 订单有值）
|
||
- **兼容性**: **完全向后兼容**（纯新增字段，旧前端不读即可忽略）
|
||
|
||
---
|
||
|
||
## 变化一句话
|
||
|
||
MP 订单详情返回体 `MpOrderDetailVO` 新增 `groupBatchId` 字段，仅小蒙马 GROUP 订单有值，前端可据此跳转到对应团期详情页。
|
||
|
||
---
|
||
|
||
## 接口
|
||
|
||
`GET /mp/order/{orderId}`（以及走 BFF 的同类接口）
|
||
|
||
### 新增字段
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|---|---|---|
|
||
| `groupBatchId` | Long | 团期 ID。仅 GROUP（小蒙马）订单有值；CORE（自驾/自助游）、CUSTOM（定制）等订单为 null |
|
||
|
||
### 返回示例
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"orderId": 1900001,
|
||
"orderNo": "XMM20260423001",
|
||
"groupCode": "0001",
|
||
"groupBatchId": 2045401225939079169,
|
||
"productId": 1893012345678901234,
|
||
"productName": "...",
|
||
"...": "..."
|
||
},
|
||
"success": true
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 前端接入场景（参考）
|
||
|
||
「我的订单 → 订单详情 → 团期入口」点击后用 `groupBatchId` 跳团期详情页；非 GROUP 订单为 null 时隐藏入口即可。
|
||
|
||
---
|
||
|
||
## 不影响范围
|
||
|
||
- 其它订单字段（`orderNo / groupCode / productId / productName / ...`）**零变化**
|
||
- 管理端订单详情 DTO **不涉及**
|
||
- 下单/支付/退款链路 **零影响**
|
||
|
||
---
|
||
|
||
## 相关
|
||
|
||
- PR：[wx/HL#1300](https://git.1814.love:8443/wx/HL/pulls/1300)
|
||
- 部署：`hl-order-service-v2`（8094）+ `hl-mp-service`（8085）
|