# API 变更通知

**更新时间**: 2026-03-24 17:46

## ⚠️ Breaking Changes (6)

> **前端必须处理的变更，不处理会导致功能异常**

### 订单服务

**字段删除**

| 数据对象 | 删除字段 | 原类型 |
| --- | --- | --- |
| `退款政策VO` | ~~`isDefault`~~ | `boolean` |
| `退款政策VO` | ~~`refundType`~~ | `string` |
| `退款政策请求` | ~~`isDefault`~~ | `boolean` |
| `退款政策请求` | ~~`refundType`~~ | `string` |

**字段类型变化**

| 数据对象 | 字段 | 原类型 | 新类型 |
| --- | --- | --- | --- |
| `OrderTraveler` | `gender` | `integer(int32)` | `string` |
| `出行人信息` | `gender` | `integer(int32)` | `string` |

## ℹ️ 新增 (23)

### 订单服务

**新增接口**

- 🆕 `DELETE /admin/order/{orderId}/surcharge/{surchargeId}`
- 🆕 `GET /admin/order/{orderId}/travelers`
- 🆕 `POST /admin/order/{orderId}/surcharge`
- 🆕 `PUT /admin/order/{orderId}/surcharge/{surchargeId}`

**新增字段**

| 数据对象 | 新增字段 | 类型 |
| --- | --- | --- |
| `OrderTimeline` | `actionLabel` | `string` |
| `OrderTimeline` | `operatorTypeLabel` | `string` |
| `OrderTodo` | `assigneeRoleLabel` | `string` |
| `OrderTodo` | `todoTypeLabel` | `string` |
| `OrderTraveler` | `idCardTypeLabel` | `string` |
| `OrderTraveler` | `insurancePolicies` | `Map«string,object»[]` |
| `OrderTraveler` | `travelerTypeLabel` | `string` |
| `管理员修改订单请求` | `customizerId` | `integer(int64)` |
| `管理员订单列表VO` | `checklistConfirmed` | `boolean` |
| `管理员订单列表VO` | `mchName` | `string` |
| `管理员订单列表VO` | `surchargeAmount` | `number` |
| `订单详情VO` | `hotelAssignmentDetails` | `酒店分配详情（按家庭分组）[]` |
| `订单详情VO` | `mchName` | `string` |
| `订单详情VO` | `paymentModeLabel` | `string` |
| `订单详情VO` | `pendingUpgradeAmount` | `number` |
| `订单详情VO` | `productTypeLabel` | `string` |
| `订单详情VO` | `refundPolicy` | `退款政策VO` |
| `订单详情VO` | `surchargeAmount` | `number` |
| `订单详情VO` | `surcharges` | `OrderSurcharge[]` |