hl-api-changelog/changelogs/2026-03/24_1745_sync.md

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[]