# 微信小程序 · 订单详情新增 groupBatchId（团期 ID）

- **变更日期**: 2026-04-23
- **PR**: #1300
- **端**: 微信小程序（管理端不涉及）
- **影响面**: 订单详情（仅小蒙马 GROUP 订单有值）
- **兼容性**: **完全向后兼容**（纯新增字段，旧前端不读即可忽略）

---

## 变化一句话

微信小程序订单详情返回体 `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）