# API 变更通知

**更新时间**: 2026-04-13 18:12

## ⚠️ Breaking Changes (70)

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

### 支付服务

**接口删除**

- ❌ ~~`POST /admin/product/item`~~
- ❌ ~~`PUT /admin/product/item/{id}/basic`~~

**字段删除**

| 数据对象 | 删除字段 | 原类型 |
| --- | --- | --- |
| `GroupTourBatchDO` | ~~`createBy`~~ | `integer(int64)` |
| `管理端 - Step1 基础信息保存` | ~~`balanceDueDays`~~ | `integer(int32)` |
| `管理端 - Step1 基础信息保存` | ~~`carouselImages`~~ | `string[]` |
| `管理端 - Step1 基础信息保存` | ~~`childAgeMax`~~ | `integer(int32)` |
| `管理端 - Step1 基础信息保存` | ~~`childAgeMin`~~ | `integer(int32)` |
| `管理端 - Step1 基础信息保存` | ~~`contactPhone`~~ | `string` |
| `管理端 - Step1 基础信息保存` | ~~`creatorAvatarUrl`~~ | `string` |
| `管理端 - Step1 基础信息保存` | ~~`creatorIntro`~~ | `string` |
| `管理端 - Step1 基础信息保存` | ~~`customerName`~~ | `string` |
| `管理端 - Step1 基础信息保存` | ~~`customizerId`~~ | `integer(int64)` |
| `管理端 - Step1 基础信息保存` | ~~`defaultDailyStock`~~ | `integer(int32)` |
| `管理端 - Step1 基础信息保存` | ~~`defaultRoomCount`~~ | `integer(int32)` |
| `管理端 - Step1 基础信息保存` | ~~`departureDate`~~ | `string(date)` |
| `管理端 - Step1 基础信息保存` | ~~`depositAmount`~~ | `number` |
| `管理端 - Step1 基础信息保存` | ~~`depositRatio`~~ | `integer(int32)` |
| `管理端 - Step1 基础信息保存` | ~~`diningHighlights`~~ | `object[]` |
| `管理端 - Step1 基础信息保存` | ~~`infantAgeMax`~~ | `integer(int32)` |
| `管理端 - Step1 基础信息保存` | ~~`infantDefaultPrice`~~ | `number` |
| `管理端 - Step1 基础信息保存` | ~~`isBooking`~~ | `boolean` |
| `管理端 - Step1 基础信息保存` | ~~`maxAdultPerOrder`~~ | `integer(int32)` |
| `管理端 - Step1 基础信息保存` | ~~`maxChildPerOrder`~~ | `integer(int32)` |
| `管理端 - Step1 基础信息保存` | ~~`mchId`~~ | `string` |
| `管理端 - Step1 基础信息保存` | ~~`minAdultPerOrder`~~ | `integer(int32)` |
| `管理端 - Step1 基础信息保存` | ~~`minGroupSize`~~ | `integer(int32)` |
| `管理端 - Step1 基础信息保存` | ~~`paymentType`~~ | `string` |
| `管理端 - Step1 基础信息保存` | ~~`photographyItems`~~ | `object[]` |
| `管理端 - Step1 基础信息保存` | ~~`safetyItems`~~ | `object[]` |
| `管理端 - Step1 基础信息保存` | ~~`seasons`~~ | `string[]` |
| `管理端 - Step1 基础信息保存` | ~~`showChatGroup`~~ | `boolean` |
| `管理端 - Step1 基础信息保存` | ~~`showReview`~~ | `boolean` |
| `管理端 - Step1 基础信息保存` | ~~`showTripDistance`~~ | `boolean` |
| `管理端 - Step1 基础信息保存` | ~~`showTripTime`~~ | `boolean` |
| `管理端 - Step1 基础信息保存` | ~~`toddlerAgeMax`~~ | `integer(int32)` |
| `管理端 - Step1 基础信息保存` | ~~`version`~~ | `integer(int32)` |
| `管理端 - Step2 行程保存` | ~~`version`~~ | `integer(int32)` |
| `管理端 - Step3 路线与备品保存` | ~~`routeName`~~ | `string` |
| `管理端 - Step3 路线与备品保存` | ~~`staffCostIds`~~ | `integer[]` |
| `管理端 - Step3 路线与备品保存` | ~~`vehicleModelId`~~ | `integer(int64)` |
| `管理端 - Step3 路线与备品保存` | ~~`version`~~ | `integer(int32)` |
| `管理端 - Step5 补充信息保存` | ~~`version`~~ | `integer(int32)` |
| `管理端 - 产品列表项` | ~~`createBy`~~ | `integer(int64)` |
| `管理端 - 产品列表项` | ~~`version`~~ | `integer(int32)` |
| `管理端 - 产品详情` | ~~`createBy`~~ | `integer(int64)` |
| `管理端 - 产品详情` | ~~`creatorAvatarUrl`~~ | `string` |
| `管理端 - 产品详情` | ~~`creatorIntro`~~ | `string` |
| `管理端 - 产品详情` | ~~`customerName`~~ | `string` |
| `管理端 - 产品详情` | ~~`customizerId`~~ | `integer(int64)` |
| `管理端 - 产品详情` | ~~`departureDate`~~ | `string(date)` |
| `管理端 - 产品详情` | ~~`mchId`~~ | `string` |
| `管理端 - 产品详情` | ~~`priceVersion`~~ | `integer(int32)` |
| `管理端 - 产品详情` | ~~`version`~~ | `integer(int32)` |
| `管理端 - 价格日历批量设置` | ~~`version`~~ | `integer(int32)` |
| `管理端 - 产品线详情/列表项` | ~~`createBy`~~ | `integer(int64)` |
| `小程序端 - 产品详情` | ~~`creatorAvatarUrl`~~ | `string` |
| `小程序端 - 产品详情` | ~~`creatorIntro`~~ | `string` |

**字段重命名**

| 数据对象 | 原字段 | 新字段 | 类型 |
| --- | --- | --- | --- |
| `GroupTourBatchDO` | ~~`createBy`~~ | `createdBy` | `integer(int64)` |
| `管理端 - Step1 基础信息保存` | ~~`contactPhone`~~ | `category` | `string` |
| `管理端 - Step1 基础信息保存` | ~~`creatorAvatarUrl`~~ | `productType` | `string` |
| `管理端 - Step1 基础信息保存` | ~~`customizerId`~~ | `productId` | `integer(int64)` |
| `管理端 - 产品列表项` | ~~`createBy`~~ | `createdBy` | `integer(int64)` |
| `管理端 - 产品列表项` | ~~`version`~~ | `sortOrder` | `integer(int32)` |
| `管理端 - 产品详情` | ~~`createBy`~~ | `createdBy` | `integer(int64)` |
| `管理端 - 产品详情` | ~~`creatorAvatarUrl`~~ | `category` | `string` |
| `管理端 - 产品详情` | ~~`priceVersion`~~ | `currentStep` | `integer(int32)` |
| `管理端 - 产品线详情/列表项` | ~~`createBy`~~ | `createdBy` | `integer(int64)` |

**字段类型变化**

| 数据对象 | 字段 | 原类型 | 新类型 |
| --- | --- | --- | --- |
| `管理端 - Step1 基础信息保存` | `tiers` | `档位项[]` | `规格项[]` |
| `管理端 - 产品线详情/列表项` | `seasons` | `object` | `string[]` |
| `管理端 - 产品线详情/列表项` | `tags` | `object` | `string[]` |

## ℹ️ 新增 (49)

### 支付服务

**新增接口**

- 🆕 `POST /admin/product/item/basic`

**新增字段**

| 数据对象 | 新增字段 | 类型 |
| --- | --- | --- |
| `GroupBatchStaffDO` | `createdBy` | `integer(int64)` |
| `GroupBatchStaffDO` | `updatedBy` | `integer(int64)` |
| `GroupTourBatchDO` | `createdBy` | `integer(int64)` |
| `GroupTourBatchDO` | `updatedBy` | `integer(int64)` |
| `ProductCrowdBenefitDO` | `createdBy` | `integer(int64)` |
| `ProductCrowdBenefitDO` | `updatedBy` | `integer(int64)` |
| `ProductFeeItemDO` | `createdBy` | `integer(int64)` |
| `ProductFeeItemDO` | `updatedBy` | `integer(int64)` |
| `ProductPriceCalendarDO` | `createdBy` | `integer(int64)` |
| `ProductPriceCalendarDO` | `updatedBy` | `integer(int64)` |
| `ProductRouteInfoDO` | `createdBy` | `integer(int64)` |
| `ProductRouteInfoDO` | `updatedBy` | `integer(int64)` |
| `ProductSupplementDO` | `createdBy` | `integer(int64)` |
| `ProductSupplementDO` | `updatedBy` | `integer(int64)` |
| `ProductSuppliesDO` | `createdBy` | `integer(int64)` |
| `ProductSuppliesDO` | `updatedBy` | `integer(int64)` |
| `管理端 - Step1 基础信息保存` | `category` | `string` |
| `管理端 - Step1 基础信息保存` | `productId` | `integer(int64)` |
| `管理端 - Step1 基础信息保存` | `productType` | `string` |
| `管理端 - 产品列表项` | `category` | `string` |
| `管理端 - 产品列表项` | `createdBy` | `integer(int64)` |
| `管理端 - 产品列表项` | `createdByName` | `string` |
| `管理端 - 产品列表项` | `lineId` | `integer(int64)` |
| `管理端 - 产品列表项` | `lineName` | `string` |
| `管理端 - 产品列表项` | `seasons` | `string[]` |
| `管理端 - 产品列表项` | `sortOrder` | `integer(int32)` |
| `管理端 - 产品列表项` | `startPrice` | `number` |
| `管理端 - 产品列表项` | `subtitle` | `string` |
| `管理端 - 产品列表项` | `tags` | `string[]` |
| `管理端 - 产品列表项` | `tierCount` | `integer(int32)` |
| `管理端 - 产品列表项` | `tripNights` | `integer(int32)` |
| `管理端 - 产品详情` | `category` | `string` |
| `管理端 - 产品详情` | `createdBy` | `integer(int64)` |
| `管理端 - 产品详情` | `currentStep` | `integer(int32)` |
| `管理端 - 产品线详情/列表项` | `createdBy` | `integer(int64)` |
| `管理端 - 产品线详情/列表项` | `productCount` | `integer(int64)` |
| `ProductDayHotelDO` | `createdBy` | `integer(int64)` |
| `ProductDayHotelDO` | `updatedBy` | `integer(int64)` |
| `小程序端 - 产品列表项` | `lineName` | `string` |
| `小程序端 - 产品列表项` | `paymentType` | `string` |
| `小程序端 - 产品列表项` | `seasons` | `string[]` |
| `小程序端 - 产品列表项` | `sortOrder` | `integer(int32)` |
| `小程序端 - 产品列表项` | `startPrice` | `number` |
| `小程序端 - 产品列表项` | `startPriceLabel` | `string` |
| `小程序端 - 产品列表项` | `tags` | `string[]` |
| `小程序端 - 产品列表项` | `tierCount` | `integer(int32)` |
| `小程序端 - 产品列表项` | `tripNights` | `integer(int32)` |

### 字典变更

**新增字典项**

| 字典 | 新增值 | 标签 |
| --- | --- | --- |
| `vehicle_type`（车型） | `GROUP` | 小蒙马专用 |