# 订单服务 API 文档 **服务**: `hl-order-service` **接口总数**: 90 ## 目录 - **工单管理** (8 个接口) - **早鸟优惠计划管理** (6 个接口) - **管理端相册接口** (10 个接口) - **管理端订单接口** (24 个接口) - **管理端订单行程编辑** (18 个接口) - **订单待办接口** (7 个接口) - **订单配置接口** (2 个接口) - **退款政策管理** (6 个接口) - **退款管理** (9 个接口) --- ## 工单管理 ### `POST` /admin/order/work-order **创建工单** 创建旅途中的变更工单，需关联订单ID。 可指定处理人，未指定则进入待分配状态。可附带差价信息和资源详情JSON 【关联字典】 - 请求参数 type → 字典：work_order_type（工单类型） - 请求参数 priority → 字典：work_order_priority（工单优先级） - 返回字段 status → 字典：work_order_status（工单状态） - 返回字段 type → 字典：work_order_type（工单类型） - 返回字段 priority → 字典：work_order_priority（工单优先级） **请求体** `CreateWorkOrderRequest` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `assigneeAdminId` | `long` | | 指定处理人ID | | `assigneeName` | `string` | | 指定处理人姓名 | | `attachmentUrls` | `string` | | 附件URL(JSON数组) | | `costDifference` | `number` | | 差价(正数=客户需补差价, 负数=需退费给客户) | | `description` | `string` | 是 | 问题描述 | | `orderId` | `long` | 是 | 关联订单ID | | `priority` | `string` | 是 | 优先级: URGENT(紧急，如当天出发需处理)/NORMAL(普通) | | `resourceDetail` | `string` | | 资源详情JSON(酒店/车辆/景点信息) | | `type` | `string` | 是 | 工单类型: ROOM_CHANGE(换房)/ROOM_ADD(加房)/CHECKOUT_CHANGE(改退房日期)/HOTEL_ISSUE(酒店问题)/VEHICLE_CHANGE(换车)/SCENIC_ADD(加景点)/SCENIC_REMOVE(减景点)/OTHER(其他) | **响应** `统一响应结果«WorkOrderVO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `WorkOrderVO` | | 响应数据 | |   `assigneeAdminId` | `string` | | 处理人ID | |   `assigneeName` | `string` | | 处理人姓名 | |   `attachmentUrls` | `string` | | 附件URL(JSON数组) | |   `costDifference` | `number` | | 差价 | |   `createTime` | `string` | | 创建时间 | |   `creatorAdminId` | `string` | | 发起人ID | |   `creatorName` | `string` | | 发起人姓名 | |   `description` | `string` | | 问题描述 | |   `logs` | `工单操作日志VO[]` | | 操作日志列表 | |     `action` | `string` | | 操作动作 | |     `actionLabel` | `string` | | 操作动作标签 | |     `content` | `string` | | 操作内容 | |     `createdAt` | `string` | | 操作时间 | |     `logId` | `string` | | 日志ID | |     `operatorName` | `string` | | 操作人姓名 | |   `orderId` | `string` | | 关联订单ID | |   `orderNo` | `string` | | 关联订单编号 | |   `priority` | `string` | | 优先级 | |   `priorityLabel` | `string` | | 优先级标签 | |   `rejectReason` | `string` | | 驳回原因 | |   `resolution` | `string` | | 处理结果 | |   `resolvedAt` | `string` | | 处理完成时间 | |   `resourceDetail` | `string` | | 资源详情JSON | |   `status` | `string` | | 状态 | |   `statusLabel` | `string` | | 状态标签 | |   `type` | `string` | | 工单类型 | |   `typeLabel` | `string` | | 工单类型标签 | |   `updateTime` | `string` | | 更新时间 | |   `workOrderId` | `string` | | 工单ID | |   `workOrderNo` | `string` | | 工单编号 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/work-order/count-by-order/{orderId} **按订单查工单数量** 返回指定订单关联的工单总数，用于订单详情页展示工单角标 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **响应** `统一响应结果«int»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `int` | | 响应数据 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/work-order/list **工单列表** 分页查询工单，支持按状态/类型/优先级/订单编号/处理人筛选。 工单用于处理旅行中的突发变更需求（如换房、换车、加景点等） 【关联字典】 - 筛选参数 status → 字典：work_order_status（工单状态） - 筛选参数 type → 字典：work_order_type（工单类型） - 筛选参数 priority → 字典：work_order_priority（工单优先级） - 返回字段 status → 字典：work_order_status（工单状态） - 返回字段 type → 字典：work_order_type（工单类型） - 返回字段 priority → 字典：work_order_priority（工单优先级） **查询参数** | 参数 | 类型 | 必填 | 说明 | 示例 | | --- | --- | --- | --- | --- | | `assigneeAdminId` | `integer(int64)` | | 处理人ID | | | `orderNo` | `string` | | 订单编号(模糊) | | | `page` | `integer(int32)` | | 页码 | | | `pageSize` | `integer(int32)` | | 每页条数 | | | `priority` | `string` | | 优先级: URGENT/NORMAL | | | `status` | `string` | | 状态: PENDING/PROCESSING/RESOLVED/REJECTED | | | `type` | `string` | | 类型: ROOM_CHANGE/ROOM_ADD/CHECKOUT_CHANGE/HOTEL_ISSUE/VEHICLE_CHANGE/SCENIC_ADD/SCENIC_REMOVE/OTHER | | **响应** `统一响应结果«分页结果«WorkOrderVO»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `分页结果«WorkOrderVO»` | | 响应数据 | |   `page` | `int` | | 当前页码 | |   `pageSize` | `int` | | 每页条数 | |   `records` | `WorkOrderVO[]` | | 数据列表 | |     `assigneeAdminId` | `string` | | 处理人ID | |     `assigneeName` | `string` | | 处理人姓名 | |     `attachmentUrls` | `string` | | 附件URL(JSON数组) | |     `costDifference` | `number` | | 差价 | |     `createTime` | `string` | | 创建时间 | |     `creatorAdminId` | `string` | | 发起人ID | |     `creatorName` | `string` | | 发起人姓名 | |     `description` | `string` | | 问题描述 | |     `logs` | `工单操作日志VO[]` | | 操作日志列表 | |     `orderId` | `string` | | 关联订单ID | |     `orderNo` | `string` | | 关联订单编号 | |     `priority` | `string` | | 优先级 | |     `priorityLabel` | `string` | | 优先级标签 | |     `rejectReason` | `string` | | 驳回原因 | |     `resolution` | `string` | | 处理结果 | |     `resolvedAt` | `string` | | 处理完成时间 | |     `resourceDetail` | `string` | | 资源详情JSON | |     `status` | `string` | | 状态 | |     `statusLabel` | `string` | | 状态标签 | |     `type` | `string` | | 工单类型 | |     `typeLabel` | `string` | | 工单类型标签 | |     `updateTime` | `string` | | 更新时间 | |     `workOrderId` | `string` | | 工单ID | |     `workOrderNo` | `string` | | 工单编号 | |   `total` | `int` | | 总记录数 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/work-order/stats **工单统计** 返回各状态的工单数量和紧急工单数，用于工单管理页面顶部统计卡片 【关联字典】 - 返回字段中的状态key → 字典：work_order_status（工单状态） **响应** `统一响应结果«Map«string,object»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `object` | | 响应数据 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/work-order/{workOrderId} **工单详情** 返回工单完整信息，包括关联订单、资源详情、处理记录和备注列表 【关联字典】 - 返回字段 status → 字典：work_order_status（工单状态） - 返回字段 type → 字典：work_order_type（工单类型） - 返回字段 priority → 字典：work_order_priority（工单优先级） **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `workOrderId` | `integer` | | 工单ID | **响应** `统一响应结果«WorkOrderVO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `WorkOrderVO` | | 响应数据 | |   `assigneeAdminId` | `string` | | 处理人ID | |   `assigneeName` | `string` | | 处理人姓名 | |   `attachmentUrls` | `string` | | 附件URL(JSON数组) | |   `costDifference` | `number` | | 差价 | |   `createTime` | `string` | | 创建时间 | |   `creatorAdminId` | `string` | | 发起人ID | |   `creatorName` | `string` | | 发起人姓名 | |   `description` | `string` | | 问题描述 | |   `logs` | `工单操作日志VO[]` | | 操作日志列表 | |     `action` | `string` | | 操作动作 | |     `actionLabel` | `string` | | 操作动作标签 | |     `content` | `string` | | 操作内容 | |     `createdAt` | `string` | | 操作时间 | |     `logId` | `string` | | 日志ID | |     `operatorName` | `string` | | 操作人姓名 | |   `orderId` | `string` | | 关联订单ID | |   `orderNo` | `string` | | 关联订单编号 | |   `priority` | `string` | | 优先级 | |   `priorityLabel` | `string` | | 优先级标签 | |   `rejectReason` | `string` | | 驳回原因 | |   `resolution` | `string` | | 处理结果 | |   `resolvedAt` | `string` | | 处理完成时间 | |   `resourceDetail` | `string` | | 资源详情JSON | |   `status` | `string` | | 状态 | |   `statusLabel` | `string` | | 状态标签 | |   `type` | `string` | | 工单类型 | |   `typeLabel` | `string` | | 工单类型标签 | |   `updateTime` | `string` | | 更新时间 | |   `workOrderId` | `string` | | 工单ID | |   `workOrderNo` | `string` | | 工单编号 | | `message` | `string` | | 响应消息 | --- ### `PUT` /admin/order/work-order/{workOrderId}/assign **指派工单** 将工单分配给指定管理员处理。被指派人将在待办列表中看到该工单 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `workOrderId` | `integer` | | 工单ID | **查询参数** | 参数 | 类型 | 必填 | 说明 | 示例 | | --- | --- | --- | --- | --- | | `assigneeId` | `integer(int64)` | | 处理人ID | | | `assigneeName` | `string` | | 处理人姓名 | | **响应** `统一响应结果«WorkOrderVO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `WorkOrderVO` | | 响应数据 | |   `assigneeAdminId` | `string` | | 处理人ID | |   `assigneeName` | `string` | | 处理人姓名 | |   `attachmentUrls` | `string` | | 附件URL(JSON数组) | |   `costDifference` | `number` | | 差价 | |   `createTime` | `string` | | 创建时间 | |   `creatorAdminId` | `string` | | 发起人ID | |   `creatorName` | `string` | | 发起人姓名 | |   `description` | `string` | | 问题描述 | |   `logs` | `工单操作日志VO[]` | | 操作日志列表 | |     `action` | `string` | | 操作动作 | |     `actionLabel` | `string` | | 操作动作标签 | |     `content` | `string` | | 操作内容 | |     `createdAt` | `string` | | 操作时间 | |     `logId` | `string` | | 日志ID | |     `operatorName` | `string` | | 操作人姓名 | |   `orderId` | `string` | | 关联订单ID | |   `orderNo` | `string` | | 关联订单编号 | |   `priority` | `string` | | 优先级 | |   `priorityLabel` | `string` | | 优先级标签 | |   `rejectReason` | `string` | | 驳回原因 | |   `resolution` | `string` | | 处理结果 | |   `resolvedAt` | `string` | | 处理完成时间 | |   `resourceDetail` | `string` | | 资源详情JSON | |   `status` | `string` | | 状态 | |   `statusLabel` | `string` | | 状态标签 | |   `type` | `string` | | 工单类型 | |   `typeLabel` | `string` | | 工单类型标签 | |   `updateTime` | `string` | | 更新时间 | |   `workOrderId` | `string` | | 工单ID | |   `workOrderNo` | `string` | | 工单编号 | | `message` | `string` | | 响应消息 | --- ### `POST` /admin/order/work-order/{workOrderId}/comment **添加工单备注** 在工单中追加备注信息，用于内部沟通和处理过程记录 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `workOrderId` | `integer` | | 工单ID | **请求体** `object` **响应** `统一响应结果«WorkOrderVO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `WorkOrderVO` | | 响应数据 | |   `assigneeAdminId` | `string` | | 处理人ID | |   `assigneeName` | `string` | | 处理人姓名 | |   `attachmentUrls` | `string` | | 附件URL(JSON数组) | |   `costDifference` | `number` | | 差价 | |   `createTime` | `string` | | 创建时间 | |   `creatorAdminId` | `string` | | 发起人ID | |   `creatorName` | `string` | | 发起人姓名 | |   `description` | `string` | | 问题描述 | |   `logs` | `工单操作日志VO[]` | | 操作日志列表 | |     `action` | `string` | | 操作动作 | |     `actionLabel` | `string` | | 操作动作标签 | |     `content` | `string` | | 操作内容 | |     `createdAt` | `string` | | 操作时间 | |     `logId` | `string` | | 日志ID | |     `operatorName` | `string` | | 操作人姓名 | |   `orderId` | `string` | | 关联订单ID | |   `orderNo` | `string` | | 关联订单编号 | |   `priority` | `string` | | 优先级 | |   `priorityLabel` | `string` | | 优先级标签 | |   `rejectReason` | `string` | | 驳回原因 | |   `resolution` | `string` | | 处理结果 | |   `resolvedAt` | `string` | | 处理完成时间 | |   `resourceDetail` | `string` | | 资源详情JSON | |   `status` | `string` | | 状态 | |   `statusLabel` | `string` | | 状态标签 | |   `type` | `string` | | 工单类型 | |   `typeLabel` | `string` | | 工单类型标签 | |   `updateTime` | `string` | | 更新时间 | |   `workOrderId` | `string` | | 工单ID | |   `workOrderNo` | `string` | | 工单编号 | | `message` | `string` | | 响应消息 | --- ### `PUT` /admin/order/work-order/{workOrderId}/process **处理工单（解决/驳回）** 解决时需填写处理结果(resolution)，驳回时需填写驳回原因(rejectReason)。 可调整差价(costDifference)，正数表示加价，负数表示退费 【关联字典】 - 返回字段 status → 字典：work_order_status（工单状态） **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `workOrderId` | `integer` | | 工单ID | **请求体** `ProcessWorkOrderRequest` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `action` | `string` | 是 | 操作: RESOLVE(解决) / REJECT(驳回) | | `costDifference` | `number` | | 调整后差价 | | `rejectReason` | `string` | | 驳回原因(驳回时填写) | | `resolution` | `string` | | 处理结果(解决时填写) | **响应** `统一响应结果«WorkOrderVO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `WorkOrderVO` | | 响应数据 | |   `assigneeAdminId` | `string` | | 处理人ID | |   `assigneeName` | `string` | | 处理人姓名 | |   `attachmentUrls` | `string` | | 附件URL(JSON数组) | |   `costDifference` | `number` | | 差价 | |   `createTime` | `string` | | 创建时间 | |   `creatorAdminId` | `string` | | 发起人ID | |   `creatorName` | `string` | | 发起人姓名 | |   `description` | `string` | | 问题描述 | |   `logs` | `工单操作日志VO[]` | | 操作日志列表 | |     `action` | `string` | | 操作动作 | |     `actionLabel` | `string` | | 操作动作标签 | |     `content` | `string` | | 操作内容 | |     `createdAt` | `string` | | 操作时间 | |     `logId` | `string` | | 日志ID | |     `operatorName` | `string` | | 操作人姓名 | |   `orderId` | `string` | | 关联订单ID | |   `orderNo` | `string` | | 关联订单编号 | |   `priority` | `string` | | 优先级 | |   `priorityLabel` | `string` | | 优先级标签 | |   `rejectReason` | `string` | | 驳回原因 | |   `resolution` | `string` | | 处理结果 | |   `resolvedAt` | `string` | | 处理完成时间 | |   `resourceDetail` | `string` | | 资源详情JSON | |   `status` | `string` | | 状态 | |   `statusLabel` | `string` | | 状态标签 | |   `type` | `string` | | 工单类型 | |   `typeLabel` | `string` | | 工单类型标签 | |   `updateTime` | `string` | | 更新时间 | |   `workOrderId` | `string` | | 工单ID | |   `workOrderNo` | `string` | | 工单编号 | | `message` | `string` | | 响应消息 | --- ## 早鸟优惠计划管理 ### `POST` /admin/order/early-bird **创建早鸟优惠计划** 创建一个早鸟优惠计划，在指定日期范围内下单且满足最低人数条件的订单可享受优惠。 下单时系统自动匹配最优的早鸟计划。权限：仅超级管理员(SUPER_ADMIN) **请求体** `早鸟优惠计划请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `discountAmount` | `number` | 是 | 优惠金额（从订单总价中扣减的固定金额） | | `endDate` | `string` | 是 | 生效结束日期 | | `minPeople` | `int` | 是 | 最低出行人数（含成人+儿童），订单人数>=此值才能享受优惠 | | `planName` | `string` | 是 | 计划名称 | | `remark` | `string` | | 备注 | | `startDate` | `string` | 是 | 生效开始日期 | **响应** `统一响应结果«早鸟优惠计划VO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `早鸟优惠计划VO` | | 响应数据 | |   `createTime` | `string` | | 创建时间 | |   `createdBy` | `long` | | 创建人ID | |   `discountAmount` | `number` | | 优惠金额 | |   `enabled` | `boolean` | | 是否启用 | |   `endDate` | `string` | | 生效结束日期 | |   `minPeople` | `int` | | 最低人数 | |   `planId` | `long` | | 计划ID | |   `planName` | `string` | | 计划名称 | |   `remark` | `string` | | 备注 | |   `startDate` | `string` | | 生效开始日期 | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/early-bird/list **早鸟优惠计划列表** 分页查询所有早鸟优惠计划。权限：仅超级管理员(SUPER_ADMIN) **查询参数** | 参数 | 类型 | 必填 | 说明 | 示例 | | --- | --- | --- | --- | --- | | `page` | `integer(int32)` | | 页码 | | | `pageSize` | `integer(int32)` | | 每页条数 | | **响应** `统一响应结果«分页结果«早鸟优惠计划VO»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `分页结果«早鸟优惠计划VO»` | | 响应数据 | |   `page` | `int` | | 当前页码 | |   `pageSize` | `int` | | 每页条数 | |   `records` | `早鸟优惠计划VO[]` | | 数据列表 | |     `createTime` | `string` | | 创建时间 | |     `createdBy` | `long` | | 创建人ID | |     `discountAmount` | `number` | | 优惠金额 | |     `enabled` | `boolean` | | 是否启用 | |     `endDate` | `string` | | 生效结束日期 | |     `minPeople` | `int` | | 最低人数 | |     `planId` | `long` | | 计划ID | |     `planName` | `string` | | 计划名称 | |     `remark` | `string` | | 备注 | |     `startDate` | `string` | | 生效开始日期 | |     `updateTime` | `string` | | 更新时间 | |   `total` | `int` | | 总记录数 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/early-bird/{planId} **早鸟优惠计划详情** 权限：仅超级管理员(SUPER_ADMIN) **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `planId` | `integer` | | 早鸟计划ID | **响应** `统一响应结果«早鸟优惠计划VO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `早鸟优惠计划VO` | | 响应数据 | |   `createTime` | `string` | | 创建时间 | |   `createdBy` | `long` | | 创建人ID | |   `discountAmount` | `number` | | 优惠金额 | |   `enabled` | `boolean` | | 是否启用 | |   `endDate` | `string` | | 生效结束日期 | |   `minPeople` | `int` | | 最低人数 | |   `planId` | `long` | | 计划ID | |   `planName` | `string` | | 计划名称 | |   `remark` | `string` | | 备注 | |   `startDate` | `string` | | 生效开始日期 | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `PUT` /admin/order/early-bird/{planId} **修改早鸟优惠计划** 权限：仅超级管理员(SUPER_ADMIN)。修改不影响已下单的订单优惠 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `planId` | `integer` | | 早鸟计划ID | **请求体** `早鸟优惠计划请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `discountAmount` | `number` | 是 | 优惠金额（从订单总价中扣减的固定金额） | | `endDate` | `string` | 是 | 生效结束日期 | | `minPeople` | `int` | 是 | 最低出行人数（含成人+儿童），订单人数>=此值才能享受优惠 | | `planName` | `string` | 是 | 计划名称 | | `remark` | `string` | | 备注 | | `startDate` | `string` | 是 | 生效开始日期 | **响应** `统一响应结果«Void»` --- ### `DELETE` /admin/order/early-bird/{planId} **删除早鸟优惠计划** 权限：仅超级管理员(SUPER_ADMIN)。删除不影响已下单的订单优惠 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `planId` | `integer` | | 早鸟计划ID | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/early-bird/{planId}/toggle **启用/禁用早鸟优惠计划** 禁用后该计划不再参与自动匹配。权限：仅超级管理员(SUPER_ADMIN) **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `planId` | `integer` | | 早鸟计划ID | **查询参数** | 参数 | 类型 | 必填 | 说明 | 示例 | | --- | --- | --- | --- | --- | | `enabled` | `boolean` | | 是否启用 | | **响应** `统一响应结果«Void»` --- ## 管理端相册接口 ### `PUT` /admin/order/album/file/{albumFileId} **编辑文件信息** **关联字典**： - album_file_type（文件类型，返回字段fileType）：IMAGE=图片, VIDEO=视频 - album_location_type（地点类型，返回字段locationType）：RESOURCE=关联资源, CUSTOM=自定义地点 - resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `albumFileId` | `integer` | | 相册文件ID | **请求体** `AlbumFileUpdateRequest` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `customLocation` | `string` | | 自定义地点文本 | | `description` | `string` | | 文件描述 | | `locationType` | `string` | | 地点类型: RESOURCE/CUSTOM | | `resourceId` | `long` | | 资源ID | | `resourceName` | `string` | | 资源名称 | | `resourceType` | `string` | | 资源类型 | | `sortOrder` | `int` | | 排序号 | **响应** `统一响应结果«AlbumFileVO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `AlbumFileVO` | | 响应数据 | |   `albumFileId` | `long` | | 相册文件ID | |   `createTime` | `string` | | 创建时间 | |   `createdBy` | `long` | | 上传人ID | |   `customLocation` | `string` | | 自定义地点文本 | |   `description` | `string` | | 文件描述 | |   `fileId` | `long` | | 文件ID | |   `fileType` | `string` | | 文件类型: IMAGE/VIDEO | |   `folderId` | `long` | | 所属文件夹ID | |   `locationText` | `string` | | 地点显示文本 | |   `locationType` | `string` | | 地点类型: RESOURCE/CUSTOM | |   `ossUrl` | `string` | | 文件访问URL | |   `resourceId` | `long` | | 资源ID | |   `resourceName` | `string` | | 资源名称 | |   `resourceType` | `string` | | 资源类型 | |   `sortOrder` | `int` | | 排序号 | |   `thumbnailUrl` | `string` | | 缩略图URL | | `message` | `string` | | 响应消息 | --- ### `DELETE` /admin/order/album/file/{albumFileId} **删除文件** 删除相册中的单个文件（照片/视频）。仅上传者或超级管理员可操作，删除后C端用户不再可见。 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `albumFileId` | `integer` | | 相册文件ID | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/album/folder/{folderId} **编辑相册文件夹** 修改文件夹名称或描述。仅创建者或超级管理员可操作 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `folderId` | `integer` | | 文件夹ID | **请求体** `AlbumFolderRequest` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `folderName` | `string` | | 文件夹名称 | | `sortOrder` | `int` | | 排序号 | **响应** `统一响应结果«AlbumFolderVO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `AlbumFolderVO` | | 响应数据 | |   `coverThumbnailUrl` | `string` | | 封面缩略图URL | |   `coverUrl` | `string` | | 封面文件URL | |   `createTime` | `string` | | 创建时间 | |   `createdBy` | `long` | | 创建人ID | |   `fileCount` | `int` | | 文件数量 | |   `folderId` | `long` | | 文件夹ID | |   `folderName` | `string` | | 文件夹名称 | |   `orderId` | `long` | | 关联订单ID | |   `sortOrder` | `int` | | 排序号 | | `message` | `string` | | 响应消息 | --- ### `DELETE` /admin/order/album/folder/{folderId} **删除相册文件夹** 删除文件夹及其下所有文件。仅创建者或超级管理员可操作。删除后C端用户不再可见 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `folderId` | `integer` | | 文件夹ID | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/album/folder/{folderId}/cover **设置文件夹封面** 将文件夹中的指定文件设为封面图，封面图会在文件夹列表中展示。仅上传者或超级管理员可操作。 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `folderId` | `integer` | | 文件夹ID | **查询参数** | 参数 | 类型 | 必填 | 说明 | 示例 | | --- | --- | --- | --- | --- | | `albumFileId` | `integer(int64)` | | 相册文件ID | | **响应** `统一响应结果«Void»` --- ### `GET` /admin/order/album/folder/{folderId}/files **查询文件夹下的文件列表** **关联字典**： - album_file_type（文件类型，返回字段fileType）：IMAGE=图片, VIDEO=视频 - album_location_type（地点类型，返回字段locationType）：RESOURCE=关联资源, CUSTOM=自定义地点 - resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `folderId` | `integer` | | 文件夹ID | **查询参数** | 参数 | 类型 | 必填 | 说明 | 示例 | | --- | --- | --- | --- | --- | | `page` | `integer(int32)` | | 页码 | | | `size` | `integer(int32)` | | 每页数量 | | **响应** `统一响应结果«分页结果«AlbumFileVO»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `分页结果«AlbumFileVO»` | | 响应数据 | |   `page` | `int` | | 当前页码 | |   `pageSize` | `int` | | 每页条数 | |   `records` | `AlbumFileVO[]` | | 数据列表 | |     `albumFileId` | `long` | | 相册文件ID | |     `createTime` | `string` | | 创建时间 | |     `createdBy` | `long` | | 上传人ID | |     `customLocation` | `string` | | 自定义地点文本 | |     `description` | `string` | | 文件描述 | |     `fileId` | `long` | | 文件ID | |     `fileType` | `string` | | 文件类型: IMAGE/VIDEO | |     `folderId` | `long` | | 所属文件夹ID | |     `locationText` | `string` | | 地点显示文本 | |     `locationType` | `string` | | 地点类型: RESOURCE/CUSTOM | |     `ossUrl` | `string` | | 文件访问URL | |     `resourceId` | `long` | | 资源ID | |     `resourceName` | `string` | | 资源名称 | |     `resourceType` | `string` | | 资源类型 | |     `sortOrder` | `int` | | 排序号 | |     `thumbnailUrl` | `string` | | 缩略图URL | |   `total` | `int` | | 总记录数 | | `message` | `string` | | 响应消息 | --- ### `POST` /admin/order/album/folder/{folderId}/files **批量添加文件到文件夹** 一次添加多个照片/视频到指定文件夹。文件需先通过文件服务上传获取OSS URL **关联字典**： - album_file_type（文件类型，返回字段fileType）：IMAGE=图片, VIDEO=视频 - album_location_type（地点类型，返回字段locationType）：RESOURCE=关联资源, CUSTOM=自定义地点 - resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `folderId` | `integer` | | 文件夹ID | **请求体** `AlbumFileBatchAddRequest` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `files` | `AlbumFileAddRequest[]` | | 文件列表 | |   `customLocation` | `string` | | 自定义地点文本（地点类型为CUSTOM时） | |   `description` | `string` | | 文件描述 | |   `fileId` | `long` | | 文件ID（来自file_info） | |   `fileType` | `string` | | 文件类型: IMAGE/VIDEO | |   `locationType` | `string` | | 地点类型: RESOURCE/CUSTOM | |   `ossUrl` | `string` | | 文件访问URL | |   `resourceId` | `long` | | 资源ID（地点类型为RESOURCE时） | |   `resourceName` | `string` | | 资源名称（地点类型为RESOURCE时） | |   `resourceType` | `string` | | 资源类型（地点类型为RESOURCE时） | |   `sortOrder` | `int` | | 排序号 | |   `thumbnailUrl` | `string` | | 缩略图URL | **响应** `统一响应结果«List«AlbumFileVO»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `AlbumFileVO[]` | | 响应数据 | |   `albumFileId` | `long` | | 相册文件ID | |   `createTime` | `string` | | 创建时间 | |   `createdBy` | `long` | | 上传人ID | |   `customLocation` | `string` | | 自定义地点文本 | |   `description` | `string` | | 文件描述 | |   `fileId` | `long` | | 文件ID | |   `fileType` | `string` | | 文件类型: IMAGE/VIDEO | |   `folderId` | `long` | | 所属文件夹ID | |   `locationText` | `string` | | 地点显示文本 | |   `locationType` | `string` | | 地点类型: RESOURCE/CUSTOM | |   `ossUrl` | `string` | | 文件访问URL | |   `resourceId` | `long` | | 资源ID | |   `resourceName` | `string` | | 资源名称 | |   `resourceType` | `string` | | 资源类型 | |   `sortOrder` | `int` | | 排序号 | |   `thumbnailUrl` | `string` | | 缩略图URL | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/album/my-uploads **我的上传** 查询当前管理员上传的所有相册文件（跨订单），方便管理自己上传的内容 **关联字典**： - album_file_type（文件类型，返回字段fileType）：IMAGE=图片, VIDEO=视频 - album_location_type（地点类型，返回字段locationType）：RESOURCE=关联资源, CUSTOM=自定义地点 - resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆 **查询参数** | 参数 | 类型 | 必填 | 说明 | 示例 | | --- | --- | --- | --- | --- | | `page` | `integer(int32)` | | 页码 | | | `size` | `integer(int32)` | | 每页数量 | | **响应** `统一响应结果«分页结果«AlbumFileVO»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `分页结果«AlbumFileVO»` | | 响应数据 | |   `page` | `int` | | 当前页码 | |   `pageSize` | `int` | | 每页条数 | |   `records` | `AlbumFileVO[]` | | 数据列表 | |     `albumFileId` | `long` | | 相册文件ID | |     `createTime` | `string` | | 创建时间 | |     `createdBy` | `long` | | 上传人ID | |     `customLocation` | `string` | | 自定义地点文本 | |     `description` | `string` | | 文件描述 | |     `fileId` | `long` | | 文件ID | |     `fileType` | `string` | | 文件类型: IMAGE/VIDEO | |     `folderId` | `long` | | 所属文件夹ID | |     `locationText` | `string` | | 地点显示文本 | |     `locationType` | `string` | | 地点类型: RESOURCE/CUSTOM | |     `ossUrl` | `string` | | 文件访问URL | |     `resourceId` | `long` | | 资源ID | |     `resourceName` | `string` | | 资源名称 | |     `resourceType` | `string` | | 资源类型 | |     `sortOrder` | `int` | | 排序号 | |     `thumbnailUrl` | `string` | | 缩略图URL | |   `total` | `int` | | 总记录数 | | `message` | `string` | | 响应消息 | --- ### `POST` /admin/order/{orderId}/album/folder **创建相册文件夹** 为订单创建旅行相册文件夹（如'第一天风景'、'合影'等），用于组织旅途照片/视频 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `AlbumFolderRequest` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `folderName` | `string` | | 文件夹名称 | | `sortOrder` | `int` | | 排序号 | **响应** `统一响应结果«AlbumFolderVO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `AlbumFolderVO` | | 响应数据 | |   `coverThumbnailUrl` | `string` | | 封面缩略图URL | |   `coverUrl` | `string` | | 封面文件URL | |   `createTime` | `string` | | 创建时间 | |   `createdBy` | `long` | | 创建人ID | |   `fileCount` | `int` | | 文件数量 | |   `folderId` | `long` | | 文件夹ID | |   `folderName` | `string` | | 文件夹名称 | |   `orderId` | `long` | | 关联订单ID | |   `sortOrder` | `int` | | 排序号 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/{orderId}/album/folders **查询订单的文件夹列表** 获取指定订单的所有相册文件夹，含文件夹名称、描述、封面图、文件数量等信息。 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **响应** `统一响应结果«List«AlbumFolderVO»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `AlbumFolderVO[]` | | 响应数据 | |   `coverThumbnailUrl` | `string` | | 封面缩略图URL | |   `coverUrl` | `string` | | 封面文件URL | |   `createTime` | `string` | | 创建时间 | |   `createdBy` | `long` | | 创建人ID | |   `fileCount` | `int` | | 文件数量 | |   `folderId` | `long` | | 文件夹ID | |   `folderName` | `string` | | 文件夹名称 | |   `orderId` | `long` | | 关联订单ID | |   `sortOrder` | `int` | | 排序号 | | `message` | `string` | | 响应消息 | --- ## 管理端订单接口 ### `POST` /admin/order/create **创建订单（定制师代下单）** 创建订单流程：选择产品 → 填写联系人和出行人 → 系统计算报价 → 生成订单(PENDING_PAY状态) 权限：CUSTOM产品仅创建者可下单，CORE/ROUTE产品所有管理员可下单 【关联字典】 - 请求参数 productType → 字典：product_type（产品类型） - 请求参数 travelers[].travelerType → 字典：traveler_type（出行人类型） - 请求参数 travelers[].idCardType → 字典：id_card_type（证件类型） - 请求参数 travelers[].gender → 字典：gender（性别） - 返回字段 status → 字典：order_status（订单状态） - 返回字段 processStatus → 字典：order_process_status（订单内部流程状态） - 返回字段 productType → 字典：product_type（产品类型） - 返回字段 travelers[].travelerType → 字典：traveler_type（出行人类型） - 返回字段 travelers[].idCardType → 字典：id_card_type（证件类型） - 返回字段 travelers[].gender → 字典：gender（性别） **请求体** `管理员创建订单请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `adultCount` | `int` | | 成人数 | | `babyCount` | `int` | | 幼童数 | | `childCount` | `int` | | 儿童数 | | `childNeedBed` | `boolean` | | 儿童是否需要床位（影响房间分配和报价计算） | | `contactName` | `string` | 是 | 联系人姓名 | | `contactPhone` | `string` | 是 | 联系人电话 | | `customizerId` | `long` | | 定制师ID（可选，默认为创建人） | | `departureDate` | `string` | | 出发日期(GROUP产品可不传，从团期获取) | | `expiryMinutes` | `int` | | 支付时限（分钟），不传则使用全局默认值。超时未支付订单自动取消 | | `groupBatchId` | `long` | | 团期ID(GROUP产品必填) | | `productId` | `long` | 是 | 产品ID | | `remark` | `string` | | 备注 | | `roomCount` | `int` | | 房间数(GROUP产品，默认1) | | `travelers` | `出行人信息[]` | | 出行人列表 | |   `birthday` | `string` | 是 | 出生日期（必填，后端根据此字段自动判断人员类型） | |   `email` | `string` | | 电子邮箱 | |   `emergencyContact` | `string` | | 紧急联系人 | |   `emergencyPhone` | `string` | | 紧急联系电话 | |   `gender` | `int` | | 性别（字典：gender） | |   `idCardNo` | `string` | | 证件号码 | |   `idCardType` | `string` | | 证件类型（字典：id_card_type） | |   `name` | `string` | 是 | 出行人姓名 | |   `nationality` | `string` | | 国籍 | |   `phone` | `string` | | 手机号 | | `userPhone` | `string` | | 用户手机号（可选，用于关联C端用户）。如匹配到已注册用户则自动绑定订单 | | `youngChildCount` | `int` | | 小童数 | **响应** `统一响应结果«订单详情VO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `订单详情VO` | | 响应数据 | |   `adultCount` | `int` | | 成人数 | |   `babyCount` | `int` | | 幼童数 | |   `balanceAmount` | `number` | | 尾款金额（总售价-定金） | |   `balancePayMethod` | `string` | | 尾款支付方式: ONLINE=线上微信支付 OFFLINE=线下转账 | |   `balanceProofUrl` | `string` | | 尾款凭证URL | |   `cancelReason` | `string` | | 取消原因 | |   `cancelledAt` | `string` | | 取消时间 | |   `checklistConfirmed` | `boolean` | | 清单确认状态 | |   `childCount` | `int` | | 儿童数 | |   `completedAt` | `string` | | 完成时间 | |   `confirmedAt` | `string` | | 确认时间 | |   `contactName` | `string` | | 联系人姓名 | |   `contactPhone` | `string` | | 联系人电话 | |   `contracts` | `Map«string,object»[]` | | 合同列表（含signUrl/fileUrl/status等） | |   `createTime` | `string` | | 创建时间 | |   `creatorAdminId` | `long` | | 创建人管理员ID | |   `creatorName` | `string` | | 创建人姓名 | |   `customizerId` | `long` | | 定制师ID | |   `customizerName` | `string` | | 定制师姓名 | |   `departureDate` | `string` | | 出发日期 | |   `depositAmount` | `number` | | 定金金额 | |   `depositRatio` | `int` | | 定金比例 | |   `discountAmount` | `number` | | 优惠金额 | |   `discountReason` | `string` | | 优惠原因 | |   `discounts` | `OrderDiscount[]` | | 优惠列表 | |     `createTime` | `string` | | 创建时间 | |     `deletedAt` | `string` | | 删除时间（软删除） | |     `discountAmount` | `number` | | 优惠金额 | |     `discountId` | `long` | | 优惠ID | |     `discountName` | `string` | | 优惠名称 | |     `orderId` | `long` | | 订单ID | |     `updateTime` | `string` | | 更新时间 | |   `displayStatus` | `string` | | 前端显示状态（字典：order_display_status） | |   `displayStatusLabel` | `string` | | 前端显示状态标签（字典：order_display_status 翻译） | |   `expiryMinutes` | `int` | | 支付时限（分钟） | |   `expiryTime` | `string` | | 支付截止时间 | |   `hotelAssignments` | `string` | | 酒店分配信息JSON | |   `insurances` | `Map«string,object»[]` | | 保险订单列表（含productName/extPolicyNo/status/startDate/endDate等） | |   `mchId` | `string` | | 商户号 | |   `orderId` | `long` | | 订单ID | |   `orderNo` | `string` | | 订单号 | |   `paidAmount` | `number` | | 已付金额 | |   `paidAt` | `string` | | 支付时间 | |   `payMethodLabel` | `string` | | 支付方式标签（如：微信支付、定金微信+尾款线下） | |   `paymentMode` | `string` | | 支付模式（字典：payment_mode） | |   `processStatus` | `string` | | 内部流程状态（字典：order_process_status） | |   `processStatusLabel` | `string` | | 内部流程状态标签（字典：order_process_status 翻译） | |   `productCoverUrl` | `string` | | 产品封面图URL | |   `productId` | `long` | | 产品ID | |   `productName` | `string` | | 产品名称 | |   `productSnapshot` | `string` | | 产品快照JSON | |   `productType` | `string` | | 产品类型（字典：product_type） | |   `readyAt` | `string` | | 就绪时间 | |   `refundAmount` | `number` | | 退款金额（实退金额） | |   `remark` | `string` | | 备注 | |   `returnDate` | `string` | | 返程日期（出发日期 + 行程天数 - 1） | |   `reviewed` | `boolean` | | 是否已评价 | |   `roomInfo` | `string` | | 房间信息 | |   `sharerOpenid` | `string` | | 分享人微信openid | |   `status` | `string` | | 订单状态（字典：order_status） | |   `statusLabel` | `string` | | 订单状态标签（字典：order_status 翻译） | |   `timeline` | `OrderTimeline[]` | | 时间线列表 | |     `action` | `string` | | 操作动作 | |     `content` | `string` | | 操作内容 | |     `createTime` | `string` | | 创建时间 | |     `deletedAt` | `string` | | 删除时间（软删除） | |     `operatorId` | `long` | | 操作人ID | |     `operatorName` | `string` | | 操作人姓名 | |     `operatorType` | `string` | | 操作人类型：USER=用户 ADMIN=管理员 SYSTEM=系统 | |     `orderId` | `long` | | 订单ID | |     `timelineId` | `long` | | 时间线ID | |     `updateTime` | `string` | | 更新时间 | |   `todos` | `OrderTodo[]` | | 待办列表 | |     `assigneeAdminId` | `long` | | 指派管理员ID | |     `assigneeRoleKey` | `string` | | 指派角色Key | |     `completedAt` | `string` | | 完成时间 | |     `completedBy` | `long` | | 完成人ID | |     `createTime` | `string` | | 创建时间 | |     `deletedAt` | `string` | | 删除时间（软删除） | |     `lastNotifiedAt` | `string` | | 最后通知时间 | |     `notificationCount` | `int` | | 通知次数 | |     `orderId` | `long` | | 订单ID | |     `orderNo` | `string` | | 订单编号 | |     `sequence` | `int` | | 排序序号 | |     `status` | `string` | | 待办状态 | |     `todoId` | `long` | | 待办ID | |     `todoLabel` | `string` | | 待办标签 | |     `todoType` | `string` | | 待办类型 | |     `updateTime` | `string` | | 更新时间 | |   `totalCost` | `number` | | 总成本（仅管理员可见） | |   `totalPrice` | `number` | | 总售价 | |   `travelers` | `OrderTraveler[]` | | 出行人列表 | |     `birthday` | `string` | | 出生日期 | |     `createTime` | `string` | | 创建时间 | |     `deletedAt` | `string` | | 删除时间（软删除） | |     `email` | `string` | | 邮箱地址 | |     `emergencyContact` | `string` | | 紧急联系人姓名 | |     `emergencyPhone` | `string` | | 紧急联系人电话（加密存储） | |     `gender` | `int` | | 性别（字典：gender） | |     `idCardNo` | `string` | | 证件号码（加密存储） | |     `idCardType` | `string` | | 证件类型（字典：id_card_type） | |     `name` | `string` | | 出行人姓名 | |     `nationality` | `string` | | 国籍 | |     `orderId` | `long` | | 订单ID | |     `orderTravelerId` | `long` | | 出行人记录ID | |     `phone` | `string` | | 手机号码（加密存储） | |     `travelerType` | `string` | | 出行人类型（字典：traveler_type） | |     `updateTime` | `string` | | 更新时间 | |   `tripDays` | `int` | | 行程天数 | |   `tripNights` | `int` | | 行程晚数 | |   `unlockRequestedAt` | `string` | | 解锁请求时间 | |   `userId` | `long` | | 用户ID | |   `vehicleInfo` | `string` | | 车辆信息 | |   `youngChildCount` | `int` | | 小童数 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/list **订单列表** 支持按关键词（订单号/联系人/产品名）、状态、内部流程状态、产品类型筛选。 支持按创建时间/出发日期/总价排序。 返回分页结果，包含订单基本信息、状态、支付信息和产品封面 【关联字典】 - 筛选参数 status → 字典：order_status（订单状态） - 筛选参数 processStatus → 字典：order_process_status（订单内部流程状态） - 筛选参数 productType → 字典：product_type（产品类型） - 返回字段 status → 字典：order_status（订单状态） - 返回字段 processStatus → 字典：order_process_status（订单内部流程状态） - 返回字段 productType → 字典：product_type（产品类型） **查询参数** | 参数 | 类型 | 必填 | 说明 | 示例 | | --- | --- | --- | --- | --- | | `keyword` | `string` | | 搜索关键词（订单号/联系人姓名/产品名称） | HL2026 | | `page` | `integer(int32)` | | 页码 | 1 | | `pageSize` | `integer(int32)` | | 每页条数 | 20 | | `processStatus` | `string` | | 内部流程状态（字典：order_process_status） | PENDING_ROOM | | `productType` | `string` | | 产品类型（字典：product_type） | CORE | | `sortBy` | `string` | | 排序字段（createTime/departureDate/totalPrice） | createTime | | `sortDir` | `string` | | 排序方向（desc/asc） | desc | | `status` | `string` | | 订单状态（字典：order_status，支持逗号分隔多状态） | PAID | **响应** `统一响应结果«分页结果«管理员订单列表VO»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `分页结果«管理员订单列表VO»` | | 响应数据 | |   `page` | `int` | | 当前页码 | |   `pageSize` | `int` | | 每页条数 | |   `records` | `管理员订单列表VO[]` | | 数据列表 | |     `adultCount` | `int` | | 成人数 | |     `babyCount` | `int` | | 幼童数 | |     `balanceAmount` | `number` | | 尾款金额（DEPOSIT模式：总售价-定金-优惠） | |     `childCount` | `int` | | 儿童数 | |     `contactName` | `string` | | 联系人姓名 | |     `contactPhone` | `string` | | 联系人电话 | |     `createTime` | `string` | | 创建时间 | |     `creatorAdminId` | `long` | | 创建人管理员ID | |     `customizerName` | `string` | | 定制师名称 | |     `daysUntilDeparture` | `int` | | 距出发天数（负数表示已出发） | |     `departureDate` | `string` | | 出发日期 | |     `depositAmount` | `number` | | 定金金额 | |     `discountAmount` | `number` | | 优惠金额 | |     `mchId` | `string` | | 商户号 | |     `orderId` | `long` | | 订单ID | |     `orderNo` | `string` | | 订单号 | |     `paidAmount` | `number` | | 已付金额 | |     `paymentMode` | `string` | | 支付模式（字典：payment_mode） | |     `processStatus` | `string` | | 内部流程状态（字典：order_process_status） | |     `processStatusLabel` | `string` | | 内部流程状态标签（字典：order_process_status 翻译） | |     `productCoverUrl` | `string` | | 产品封面图URL | |     `productId` | `long` | | 产品ID | |     `productName` | `string` | | 产品名称 | |     `productType` | `string` | | 产品类型（字典：product_type） | |     `status` | `string` | | 订单状态（字典：order_status） | |     `statusLabel` | `string` | | 订单状态标签（字典：order_status 翻译） | |     `totalPrice` | `number` | | 总售价 | |     `tripDays` | `int` | | 行程天数 | |     `tripNights` | `int` | | 行程晚数 | |     `userId` | `long` | | 用户ID | |     `youngChildCount` | `int` | | 小童数 | |   `total` | `int` | | 总记录数 | | `message` | `string` | | 响应消息 | --- ### `POST` /admin/order/quote **报价预览** 根据产品、出发日期、人数组合实时计算报价。 返回各资源明细价格和合计金额，前端据此展示报价清单。 注意：报价仅供参考，最终价格以创建订单时为准（价格日历可能变动） **请求体** `报价预览请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `adultCount` | `int` | | 成人数 | | `babyCount` | `int` | | 幼童数 | | `childCount` | `int` | | 儿童数 | | `childNeedBed` | `boolean` | | 儿童是否需要床位 | | `departureDate` | `string` | 是 | 出发日期 | | `productId` | `long` | 是 | 产品ID | | `youngChildCount` | `int` | | 小童数 | **响应** `统一响应结果«Map«string,object»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `object` | | 响应数据 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/{orderId} **订单详情** 返回订单完整信息，包括：基本信息、产品快照、联系人、出行人列表、支付记录、优惠明细、时间线、内部流程状态等 【关联字典】 - 返回字段 status → 字典：order_status（订单状态） - 返回字段 processStatus → 字典：order_process_status（订单内部流程状态） - 返回字段 productType → 字典：product_type（产品类型） - 返回字段 travelers[].travelerType → 字典：traveler_type（出行人类型） - 返回字段 travelers[].idCardType → 字典：id_card_type（证件类型） - 返回字段 travelers[].gender → 字典：gender（性别） - 返回字段 timeline[].action → 字典：order_timeline_action（订单操作类型） - 返回字段 todos[].todoType → 字典：order_todo_type（订单待办类型） **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **响应** `统一响应结果«订单详情VO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `订单详情VO` | | 响应数据 | |   `adultCount` | `int` | | 成人数 | |   `babyCount` | `int` | | 幼童数 | |   `balanceAmount` | `number` | | 尾款金额（总售价-定金） | |   `balancePayMethod` | `string` | | 尾款支付方式: ONLINE=线上微信支付 OFFLINE=线下转账 | |   `balanceProofUrl` | `string` | | 尾款凭证URL | |   `cancelReason` | `string` | | 取消原因 | |   `cancelledAt` | `string` | | 取消时间 | |   `checklistConfirmed` | `boolean` | | 清单确认状态 | |   `childCount` | `int` | | 儿童数 | |   `completedAt` | `string` | | 完成时间 | |   `confirmedAt` | `string` | | 确认时间 | |   `contactName` | `string` | | 联系人姓名 | |   `contactPhone` | `string` | | 联系人电话 | |   `contracts` | `Map«string,object»[]` | | 合同列表（含signUrl/fileUrl/status等） | |   `createTime` | `string` | | 创建时间 | |   `creatorAdminId` | `long` | | 创建人管理员ID | |   `creatorName` | `string` | | 创建人姓名 | |   `customizerId` | `long` | | 定制师ID | |   `customizerName` | `string` | | 定制师姓名 | |   `departureDate` | `string` | | 出发日期 | |   `depositAmount` | `number` | | 定金金额 | |   `depositRatio` | `int` | | 定金比例 | |   `discountAmount` | `number` | | 优惠金额 | |   `discountReason` | `string` | | 优惠原因 | |   `discounts` | `OrderDiscount[]` | | 优惠列表 | |     `createTime` | `string` | | 创建时间 | |     `deletedAt` | `string` | | 删除时间（软删除） | |     `discountAmount` | `number` | | 优惠金额 | |     `discountId` | `long` | | 优惠ID | |     `discountName` | `string` | | 优惠名称 | |     `orderId` | `long` | | 订单ID | |     `updateTime` | `string` | | 更新时间 | |   `displayStatus` | `string` | | 前端显示状态（字典：order_display_status） | |   `displayStatusLabel` | `string` | | 前端显示状态标签（字典：order_display_status 翻译） | |   `expiryMinutes` | `int` | | 支付时限（分钟） | |   `expiryTime` | `string` | | 支付截止时间 | |   `hotelAssignments` | `string` | | 酒店分配信息JSON | |   `insurances` | `Map«string,object»[]` | | 保险订单列表（含productName/extPolicyNo/status/startDate/endDate等） | |   `mchId` | `string` | | 商户号 | |   `orderId` | `long` | | 订单ID | |   `orderNo` | `string` | | 订单号 | |   `paidAmount` | `number` | | 已付金额 | |   `paidAt` | `string` | | 支付时间 | |   `payMethodLabel` | `string` | | 支付方式标签（如：微信支付、定金微信+尾款线下） | |   `paymentMode` | `string` | | 支付模式（字典：payment_mode） | |   `processStatus` | `string` | | 内部流程状态（字典：order_process_status） | |   `processStatusLabel` | `string` | | 内部流程状态标签（字典：order_process_status 翻译） | |   `productCoverUrl` | `string` | | 产品封面图URL | |   `productId` | `long` | | 产品ID | |   `productName` | `string` | | 产品名称 | |   `productSnapshot` | `string` | | 产品快照JSON | |   `productType` | `string` | | 产品类型（字典：product_type） | |   `readyAt` | `string` | | 就绪时间 | |   `refundAmount` | `number` | | 退款金额（实退金额） | |   `remark` | `string` | | 备注 | |   `returnDate` | `string` | | 返程日期（出发日期 + 行程天数 - 1） | |   `reviewed` | `boolean` | | 是否已评价 | |   `roomInfo` | `string` | | 房间信息 | |   `sharerOpenid` | `string` | | 分享人微信openid | |   `status` | `string` | | 订单状态（字典：order_status） | |   `statusLabel` | `string` | | 订单状态标签（字典：order_status 翻译） | |   `timeline` | `OrderTimeline[]` | | 时间线列表 | |     `action` | `string` | | 操作动作 | |     `content` | `string` | | 操作内容 | |     `createTime` | `string` | | 创建时间 | |     `deletedAt` | `string` | | 删除时间（软删除） | |     `operatorId` | `long` | | 操作人ID | |     `operatorName` | `string` | | 操作人姓名 | |     `operatorType` | `string` | | 操作人类型：USER=用户 ADMIN=管理员 SYSTEM=系统 | |     `orderId` | `long` | | 订单ID | |     `timelineId` | `long` | | 时间线ID | |     `updateTime` | `string` | | 更新时间 | |   `todos` | `OrderTodo[]` | | 待办列表 | |     `assigneeAdminId` | `long` | | 指派管理员ID | |     `assigneeRoleKey` | `string` | | 指派角色Key | |     `completedAt` | `string` | | 完成时间 | |     `completedBy` | `long` | | 完成人ID | |     `createTime` | `string` | | 创建时间 | |     `deletedAt` | `string` | | 删除时间（软删除） | |     `lastNotifiedAt` | `string` | | 最后通知时间 | |     `notificationCount` | `int` | | 通知次数 | |     `orderId` | `long` | | 订单ID | |     `orderNo` | `string` | | 订单编号 | |     `sequence` | `int` | | 排序序号 | |     `status` | `string` | | 待办状态 | |     `todoId` | `long` | | 待办ID | |     `todoLabel` | `string` | | 待办标签 | |     `todoType` | `string` | | 待办类型 | |     `updateTime` | `string` | | 更新时间 | |   `totalCost` | `number` | | 总成本（仅管理员可见） | |   `totalPrice` | `number` | | 总售价 | |   `travelers` | `OrderTraveler[]` | | 出行人列表 | |     `birthday` | `string` | | 出生日期 | |     `createTime` | `string` | | 创建时间 | |     `deletedAt` | `string` | | 删除时间（软删除） | |     `email` | `string` | | 邮箱地址 | |     `emergencyContact` | `string` | | 紧急联系人姓名 | |     `emergencyPhone` | `string` | | 紧急联系人电话（加密存储） | |     `gender` | `int` | | 性别（字典：gender） | |     `idCardNo` | `string` | | 证件号码（加密存储） | |     `idCardType` | `string` | | 证件类型（字典：id_card_type） | |     `name` | `string` | | 出行人姓名 | |     `nationality` | `string` | | 国籍 | |     `orderId` | `long` | | 订单ID | |     `orderTravelerId` | `long` | | 出行人记录ID | |     `phone` | `string` | | 手机号码（加密存储） | |     `travelerType` | `string` | | 出行人类型（字典：traveler_type） | |     `updateTime` | `string` | | 更新时间 | |   `tripDays` | `int` | | 行程天数 | |   `tripNights` | `int` | | 行程晚数 | |   `unlockRequestedAt` | `string` | | 解锁请求时间 | |   `userId` | `long` | | 用户ID | |   `vehicleInfo` | `string` | | 车辆信息 | |   `youngChildCount` | `int` | | 小童数 | | `message` | `string` | | 响应消息 | --- ### `PUT` /admin/order/{orderId} **编辑订单** 修改订单的联系人、人数、出发日期、售价、成本、备注等信息。 仅传入需要修改的字段，未传入的字段不会被修改。 如果提供了出行人列表(travelers)，将替换订单的全部出行人。 已锁定的订单需先调用'申请修改'接口解锁后才能编辑 【关联字典】 - 请求参数 travelers[].travelerType → 字典：traveler_type（出行人类型） - 请求参数 travelers[].idCardType → 字典：id_card_type（证件类型） - 请求参数 travelers[].gender → 字典：gender（性别） **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `管理员修改订单请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `adultCount` | `int` | | 成人数 | | `babyCount` | `int` | | 幼童数 | | `childCount` | `int` | | 儿童数 | | `contactName` | `string` | | 联系人姓名 | | `contactPhone` | `string` | | 联系人电话 | | `departureDate` | `string` | | 出发日期 | | `depositAmount` | `number` | | 定金金额 | | `mchId` | `string` | | 商户号（微信支付商户号，多商户场景使用） | | `remark` | `string` | | 备注 | | `totalCost` | `number` | | 总成本 | | `totalPrice` | `number` | | 总售价 | | `travelers` | `出行人信息[]` | | 出行人列表（如提供则替换全部出行人，不传则不修改出行人） | |   `birthday` | `string` | 是 | 出生日期（必填，后端根据此字段自动判断人员类型） | |   `email` | `string` | | 电子邮箱 | |   `emergencyContact` | `string` | | 紧急联系人 | |   `emergencyPhone` | `string` | | 紧急联系电话 | |   `gender` | `int` | | 性别（字典：gender） | |   `idCardNo` | `string` | | 证件号码 | |   `idCardType` | `string` | | 证件类型（字典：id_card_type） | |   `name` | `string` | 是 | 出行人姓名 | |   `nationality` | `string` | | 国籍 | |   `phone` | `string` | | 手机号 | | `youngChildCount` | `int` | | 小童数 | **响应** `统一响应结果«Void»` --- ### `DELETE` /admin/order/{orderId} **删除订单** 仅待支付(PENDING_PAY)状态的订单可删除，其他状态不可删除 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/{orderId}/balance-pay-method **设置尾款支付方式** 设置订单尾款的支付方式。ONLINE=线上微信支付，OFFLINE=线下转账（需管理员手动记录尾款到账） **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **查询参数** | 参数 | 类型 | 必填 | 说明 | 示例 | | --- | --- | --- | --- | --- | | `balancePayMethod` | `string` | 是 | 支付方式：ONLINE-线上支付, OFFLINE-线下支付 | | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/{orderId}/cancel **取消订单** 管理员可取消的状态：待支付、已付定金、已全额支付、已确认、待付尾款 已付款订单取消后需走退款流程 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `管理员取消订单请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `reason` | `string` | 是 | 取消原因 | | `refundAmount` | `number` | | 退款金额（可选，不传则按退款政策自动计算；传0表示不退款） | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/{orderId}/confirm **确认订单** 确认订单后进入内部流程：待配房 → 待配车 → 待核算 → 就绪 前置条件：订单状态为已全额支付(PAID)或已付定金(DEPOSIT_PAID) **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/{orderId}/deposit **修改定金金额** 修改订单的定金金额。仅待支付(PENDING_PAY)状态可修改。 定金金额不能超过订单总价，修改后影响用户支付页面显示的应付金额 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `修改定金金额请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `amount` | `number` | 是 | 定金金额 | **响应** `统一响应结果«Void»` --- ### `POST` /admin/order/{orderId}/discount **添加优惠项** 为订单添加手动优惠（如会员折扣、老客优惠等）。 添加后系统自动重算订单应付金额。一个订单可添加多个优惠项 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `优惠项请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `discountAmount` | `number` | 是 | 优惠金额 | | `discountName` | `string` | 是 | 优惠项目名称 | **响应** `统一响应结果«OrderDiscount»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `OrderDiscount` | | 响应数据 | |   `createTime` | `string` | | 创建时间 | |   `deletedAt` | `string` | | 删除时间（软删除） | |   `discountAmount` | `number` | | 优惠金额 | |   `discountId` | `long` | | 优惠ID | |   `discountName` | `string` | | 优惠名称 | |   `orderId` | `long` | | 订单ID | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `PUT` /admin/order/{orderId}/discount/{discountId} **修改优惠项** 修改已添加的优惠项名称或金额，修改后自动重算订单应付金额 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `discountId` | `integer` | | 优惠项ID | | `orderId` | `integer` | | 订单ID | **请求体** `优惠项请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `discountAmount` | `number` | 是 | 优惠金额 | | `discountName` | `string` | 是 | 优惠项目名称 | **响应** `统一响应结果«Void»` --- ### `DELETE` /admin/order/{orderId}/discount/{discountId} **删除优惠项** 删除已添加的优惠项，删除后自动重算订单应付金额 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `discountId` | `integer` | | 优惠项ID | | `orderId` | `integer` | | 订单ID | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/{orderId}/hotel-assignment **分配酒店信息** 按家庭为订单分配具体的酒店房间（酒店名称、房型、入住/退房日期）。 每个家庭对应一条分配记录，分配后信息将展示在订单详情和C端行程中 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `酒店分配请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `assignments` | `单项酒店分配[]` | 是 | 酒店分配列表 | |   `checkInDate` | `string` | 是 | 入住日期(yyyy-MM-dd) | |   `checkOutDate` | `string` | 是 | 退房日期(yyyy-MM-dd) | |   `familyIndex` | `int` | 是 | 家庭序号 | |   `hotelName` | `string` | 是 | 酒店名称 | |   `roomType` | `string` | 是 | 房型 | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/{orderId}/process-status **推进内部流程** 内部流程推进顺序：待配房(PENDING_ROOM) → 待配车(PENDING_VEHICLE) → 待核算(PENDING_FINANCE) → 就绪(READY) 仅在订单状态为已确认(CONFIRMED)时有效，每次调用自动推进到下一步 【关联字典】 - 涉及字段 processStatus → 字典：order_process_status（订单内部流程状态） **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/{orderId}/record-balance **记录尾款（线下收取）** 管理员确认收到尾款 → 上传凭证。已确认(流程就绪)或待出行状态可操作 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `记录尾款请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `proofUrl` | `string` | | 支付凭证URL | | `remark` | `string` | | 备注 | **响应** `统一响应结果«Void»` --- ### `POST` /admin/order/{orderId}/remark **添加备注** 向订单时间线添加一条管理员备注。备注会记录操作人和时间，可用于内部沟通和订单跟踪 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `管理员备注请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `content` | `string` | 是 | 备注内容 | **响应** `统一响应结果«Void»` --- ### `POST` /admin/order/{orderId}/request-unlock **申请修改（解锁已锁定订单）** 清单确认后订单进入锁定状态，如需修改需先申请解锁 解锁后可重新编辑订单信息并再次确认清单 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `申请解锁订单请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `reason` | `string` | | 解锁原因 | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/{orderId}/room-info **更新房间信息（仅房务管理员/超级管理员）** 更新订单的房间分配信息（房型、房间号、入住安排等）。 **权限**：仅ROOM_MANAGER（房务管理员）或SUPER_ADMIN（超级管理员）可操作。 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `房间信息请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `roomInfo` | `string` | 是 | 房间信息 | **响应** `统一响应结果«Void»` --- ### `POST` /admin/order/{orderId}/room-info/check-diff **检测房型一致性** 检测当前房间配置是否与产品快照一致。返回 null 表示一致，否则返回不一致描述 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `string` **响应** `统一响应结果«string»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `string` | | 响应数据 | | `message` | `string` | | 响应消息 | --- ### `PUT` /admin/order/{orderId}/status **更新订单状态** 合法状态流转： - 待支付 → 已付定金/已全额支付/已取消 - 已付定金 → 已确认/已取消/售后中 - 已全额支付 → 已确认/已取消/售后中 - 已确认 → 待付尾款/待出行/已取消/售后中 - 待付尾款 → 待出行/已取消/售后中 - 待出行 → 旅行中/售后中 - 旅行中 → 已完成 - 已完成 → 售后中 - 售后中 → 退款中 - 退款中 → 已退款 【关联字典】 - 请求参数 status → 字典：order_status（订单状态） **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `更新订单状态请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `status` | `string` | 是 | 目标状态。可选值：PENDING_PAY(待支付)/DEPOSIT_PAID(已付定金)/PAID(已全额支付)/CONFIRMED(已确认)/PENDING_BALANCE(待付尾款)/PENDING_DEPARTURE(待出行)/TRAVELLING(旅行中)/COMPLETED(已完成)/AFTER_SALE(售后中)/REFUNDING(退款中)/REFUNDED(已退款)/CANCELLED(已取消) | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/{orderId}/vehicle-assignment **分配车辆信息** 为订单分配具体的车辆和司机信息（车型、品牌、车牌号、司机姓名和电话）。 分配后信息将展示在订单详情和C端行程中 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `车辆分配请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `driverName` | `string` | | 司机姓名 | | `driverPhone` | `string` | | 司机电话 | | `plateNumber` | `string` | | 车牌号 | | `vehicleBrand` | `string` | 是 | 品牌 | | `vehicleModel` | `string` | 是 | 车型 | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/{orderId}/vehicle-info **更新车辆信息（仅车务管理员/超级管理员）** 更新订单的车辆分配信息（车型、车牌号、司机等）。 **权限**：仅VEHICLE_MANAGER（车务管理员）或SUPER_ADMIN（超级管理员）可操作。 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `车辆信息请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `vehicleInfo` | `string` | 是 | 车辆信息 | **响应** `统一响应结果«Void»` --- ### `POST` /admin/order/{orderId}/vehicle-info/check-diff **检测车型一致性** 检测当前车辆配置是否与产品快照一致。返回 null 表示一致，否则返回不一致描述 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `string` **响应** `统一响应结果«string»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `string` | | 响应数据 | | `message` | `string` | | 响应消息 | --- ## 管理端订单行程编辑 ### `POST` /admin/order/{orderId}/itinerary/add **新增节点** 在某一天的行程中新增一个节点 **关联字典**： - itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换 - itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认 - resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `新增行程节点请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `balanceAdjustment` | `number` | | 尾款调整金额（正数=增加尾款，负数=减少尾款） | | `dayNumber` | `int` | | 行程天数编号（独立调用时必填，addDay子节点时自动继承） | | `description` | `string` | | 节点描述 | | `nodeName` | `string` | 是 | 节点名称 | | `nodeType` | `string` | 是 | 节点类型：SCENIC/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE/FREE/NOTE | | `reason` | `string` | | 修改原因（独立调用时必填，addDay子节点时自动继承） | | `resourceId` | `long` | | 关联资源ID | | `resourceType` | `string` | | 关联资源类型：SCENIC_SPOT/ACTIVITY/RESTAURANT/HOTEL/VEHICLE | | `sortOrder` | `int` | | 排序序号（插入位置，默认追加到末尾） | | `startTime` | `string` | | 开始时间 | **响应** `统一响应结果«OrderItineraryEdit»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `OrderItineraryEdit` | | 响应数据 | |   `action` | `string` | | 操作类型：SKIP/ADD | |   `balanceAdjustment` | `number` | | 尾款调整金额（正数=增加尾款，负数=减少尾款） | |   `changeDays` | `int` | | 变更天数 | |   `changeReasonCode` | `string` | | 变更原因代码（字典项） | |   `changeReasonLabel` | `string` | | 变更原因标签 | |   `confirmStatus` | `string` | | 确认状态：PENDING_CONFIRM/CONFIRMED | |   `confirmedAt` | `string` | | 确认时间 | |   `confirmedBy` | `long` | | 确认人ID | |   `createTime` | `string` | | 创建时间 | |   `dayNumber` | `int` | | 行程天数编号 | |   `deletedAt` | `string` | | 删除时间（软删除） | |   `description` | `string` | | 节点描述（ADD时） | |   `editId` | `long` | | 编辑ID | |   `newResourceName` | `string` | | 新资源名称（房型/车型） | |   `newUnitPrice` | `number` | | 新单价（日均） | |   `nodeId` | `string` | | 原节点ID（SKIP时必填） | |   `nodeName` | `string` | | 节点名称（ADD时） | |   `nodeType` | `string` | | 节点类型（ADD时） | |   `operatorId` | `long` | | 操作人ID | |   `operatorName` | `string` | | 操作人姓名 | |   `orderId` | `long` | | 订单ID | |   `originalResourceName` | `string` | | 原资源名称（房型/车型） | |   `originalUnitPrice` | `number` | | 原单价（日均） | |   `reason` | `string` | | 修改原因 | |   `resourceId` | `long` | | 关联资源ID | |   `resourceType` | `string` | | 关联资源类型：SCENIC_SPOT/ACTIVITY/RESTAURANT/HOTEL/VEHICLE | |   `sortOrder` | `int` | | 排序序号（ADD时） | |   `startTime` | `string` | | 开始时间（ADD时） | |   `suggestedAdjustment` | `number` | | 系统建议差价 | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `POST` /admin/order/{orderId}/itinerary/add-day **新增整天行程** 在订单行程中新增一整天（含多个节点） **关联字典**： - itinerary_edit_action（操作类型，返回字段action）：ADD_DAY=新增整天 - itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认 - resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `新增行程天请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `dayNumber` | `int` | 是 | 行程天数编号（插入位置，后续天数自动顺延） | | `dayTitle` | `string` | 是 | 天标题 | | `nodes` | `新增行程节点请求[]` | | 该天的行程节点列表 | |   `balanceAdjustment` | `number` | | 尾款调整金额（正数=增加尾款，负数=减少尾款） | |   `dayNumber` | `int` | | 行程天数编号（独立调用时必填，addDay子节点时自动继承） | |   `description` | `string` | | 节点描述 | |   `nodeName` | `string` | 是 | 节点名称 | |   `nodeType` | `string` | 是 | 节点类型：SCENIC/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE/FREE/NOTE | |   `reason` | `string` | | 修改原因（独立调用时必填，addDay子节点时自动继承） | |   `resourceId` | `long` | | 关联资源ID | |   `resourceType` | `string` | | 关联资源类型：SCENIC_SPOT/ACTIVITY/RESTAURANT/HOTEL/VEHICLE | |   `sortOrder` | `int` | | 排序序号（插入位置，默认追加到末尾） | |   `startTime` | `string` | | 开始时间 | | `prevDayHotel` | `PrevDayHotel` | | 前一天住宿配置（原最后一天无住宿，新增天数后需配置） | |   `hotelId` | `long` | | 酒店ID | |   `hotelName` | `string` | | 酒店名称 | |   `roomTypeId` | `long` | | 房型ID | |   `roomTypeName` | `string` | | 房型名称 | | `reason` | `string` | 是 | 变更原因 | **响应** `统一响应结果«List«OrderItineraryEdit»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `OrderItineraryEdit[]` | | 响应数据 | |   `action` | `string` | | 操作类型：SKIP/ADD | |   `balanceAdjustment` | `number` | | 尾款调整金额（正数=增加尾款，负数=减少尾款） | |   `changeDays` | `int` | | 变更天数 | |   `changeReasonCode` | `string` | | 变更原因代码（字典项） | |   `changeReasonLabel` | `string` | | 变更原因标签 | |   `confirmStatus` | `string` | | 确认状态：PENDING_CONFIRM/CONFIRMED | |   `confirmedAt` | `string` | | 确认时间 | |   `confirmedBy` | `long` | | 确认人ID | |   `createTime` | `string` | | 创建时间 | |   `dayNumber` | `int` | | 行程天数编号 | |   `deletedAt` | `string` | | 删除时间（软删除） | |   `description` | `string` | | 节点描述（ADD时） | |   `editId` | `long` | | 编辑ID | |   `newResourceName` | `string` | | 新资源名称（房型/车型） | |   `newUnitPrice` | `number` | | 新单价（日均） | |   `nodeId` | `string` | | 原节点ID（SKIP时必填） | |   `nodeName` | `string` | | 节点名称（ADD时） | |   `nodeType` | `string` | | 节点类型（ADD时） | |   `operatorId` | `long` | | 操作人ID | |   `operatorName` | `string` | | 操作人姓名 | |   `orderId` | `long` | | 订单ID | |   `originalResourceName` | `string` | | 原资源名称（房型/车型） | |   `originalUnitPrice` | `number` | | 原单价（日均） | |   `reason` | `string` | | 修改原因 | |   `resourceId` | `long` | | 关联资源ID | |   `resourceType` | `string` | | 关联资源类型：SCENIC_SPOT/ACTIVITY/RESTAURANT/HOTEL/VEHICLE | |   `sortOrder` | `int` | | 排序序号（ADD时） | |   `startTime` | `string` | | 开始时间（ADD时） | |   `suggestedAdjustment` | `number` | | 系统建议差价 | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `DELETE` /admin/order/{orderId}/itinerary/add/{editId} **删除新增的节点** 删除通过编辑新增的节点 **关联字典**： - itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换 - itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `editId` | `integer` | | 编辑记录ID | | `orderId` | `integer` | | 订单ID | **请求体** `撤销行程编辑请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `reason` | `string` | 是 | 撤销原因 | **响应** `统一响应结果«Void»` --- ### `GET` /admin/order/{orderId}/itinerary/balance-summary **获取尾款调整汇总** 返回行程编辑产生的尾款调整明细和总额 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **响应** `统一响应结果«Map«string,object»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `object` | | 响应数据 | | `message` | `string` | | 响应消息 | --- ### `POST` /admin/order/{orderId}/itinerary/confirm-all **批量确认所有待确认修改** 确认该订单所有待确认的行程编辑 **关联字典**： - itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **响应** `统一响应结果«int»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `int` | | 响应数据 | | `message` | `string` | | 响应消息 | --- ### `POST` /admin/order/{orderId}/itinerary/confirm/{editId} **确认单条修改** 确认一条待确认的行程编辑 **关联字典**： - itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `editId` | `integer` | | 编辑记录ID | | `orderId` | `integer` | | 订单ID | **响应** `统一响应结果«Void»` --- ### `DELETE` /admin/order/{orderId}/itinerary/day/{editId} **删除新增的整天行程** 删除通过新增操作添加的整天行程及其所有子节点，已确认的天不允许删除 **关联字典**： - itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `editId` | `integer` | | ADD_DAY编辑记录ID | | `orderId` | `integer` | | 订单ID | **请求体** `撤销行程编辑请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `reason` | `string` | 是 | 撤销原因 | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/{orderId}/itinerary/edit/{editId} **修改编辑记录** 修改待确认状态的编辑记录（如调整价格、名称等） **关联字典**： - itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换 - itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认 - resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `editId` | `integer` | | 编辑记录ID | | `orderId` | `integer` | | 订单ID | **请求体** `object` **响应** `统一响应结果«OrderItineraryEdit»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `OrderItineraryEdit` | | 响应数据 | |   `action` | `string` | | 操作类型：SKIP/ADD | |   `balanceAdjustment` | `number` | | 尾款调整金额（正数=增加尾款，负数=减少尾款） | |   `changeDays` | `int` | | 变更天数 | |   `changeReasonCode` | `string` | | 变更原因代码（字典项） | |   `changeReasonLabel` | `string` | | 变更原因标签 | |   `confirmStatus` | `string` | | 确认状态：PENDING_CONFIRM/CONFIRMED | |   `confirmedAt` | `string` | | 确认时间 | |   `confirmedBy` | `long` | | 确认人ID | |   `createTime` | `string` | | 创建时间 | |   `dayNumber` | `int` | | 行程天数编号 | |   `deletedAt` | `string` | | 删除时间（软删除） | |   `description` | `string` | | 节点描述（ADD时） | |   `editId` | `long` | | 编辑ID | |   `newResourceName` | `string` | | 新资源名称（房型/车型） | |   `newUnitPrice` | `number` | | 新单价（日均） | |   `nodeId` | `string` | | 原节点ID（SKIP时必填） | |   `nodeName` | `string` | | 节点名称（ADD时） | |   `nodeType` | `string` | | 节点类型（ADD时） | |   `operatorId` | `long` | | 操作人ID | |   `operatorName` | `string` | | 操作人姓名 | |   `orderId` | `long` | | 订单ID | |   `originalResourceName` | `string` | | 原资源名称（房型/车型） | |   `originalUnitPrice` | `number` | | 原单价（日均） | |   `reason` | `string` | | 修改原因 | |   `resourceId` | `long` | | 关联资源ID | |   `resourceType` | `string` | | 关联资源类型：SCENIC_SPOT/ACTIVITY/RESTAURANT/HOTEL/VEHICLE | |   `sortOrder` | `int` | | 排序序号（ADD时） | |   `startTime` | `string` | | 开始时间（ADD时） | |   `suggestedAdjustment` | `number` | | 系统建议差价 | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/{orderId}/itinerary/edits **获取行程编辑记录列表** **关联字典**： - itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换 - itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认 - resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **响应** `统一响应结果«List«OrderItineraryEdit»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `OrderItineraryEdit[]` | | 响应数据 | |   `action` | `string` | | 操作类型：SKIP/ADD | |   `balanceAdjustment` | `number` | | 尾款调整金额（正数=增加尾款，负数=减少尾款） | |   `changeDays` | `int` | | 变更天数 | |   `changeReasonCode` | `string` | | 变更原因代码（字典项） | |   `changeReasonLabel` | `string` | | 变更原因标签 | |   `confirmStatus` | `string` | | 确认状态：PENDING_CONFIRM/CONFIRMED | |   `confirmedAt` | `string` | | 确认时间 | |   `confirmedBy` | `long` | | 确认人ID | |   `createTime` | `string` | | 创建时间 | |   `dayNumber` | `int` | | 行程天数编号 | |   `deletedAt` | `string` | | 删除时间（软删除） | |   `description` | `string` | | 节点描述（ADD时） | |   `editId` | `long` | | 编辑ID | |   `newResourceName` | `string` | | 新资源名称（房型/车型） | |   `newUnitPrice` | `number` | | 新单价（日均） | |   `nodeId` | `string` | | 原节点ID（SKIP时必填） | |   `nodeName` | `string` | | 节点名称（ADD时） | |   `nodeType` | `string` | | 节点类型（ADD时） | |   `operatorId` | `long` | | 操作人ID | |   `operatorName` | `string` | | 操作人姓名 | |   `orderId` | `long` | | 订单ID | |   `originalResourceName` | `string` | | 原资源名称（房型/车型） | |   `originalUnitPrice` | `number` | | 原单价（日均） | |   `reason` | `string` | | 修改原因 | |   `resourceId` | `long` | | 关联资源ID | |   `resourceType` | `string` | | 关联资源类型：SCENIC_SPOT/ACTIVITY/RESTAURANT/HOTEL/VEHICLE | |   `sortOrder` | `int` | | 排序序号（ADD时） | |   `startTime` | `string` | | 开始时间（ADD时） | |   `suggestedAdjustment` | `number` | | 系统建议差价 | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/{orderId}/itinerary/merged **获取合并后的行程（原始+编辑）** **关联字典**： - itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换 - itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认 - resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **响应** `统一响应结果«List«Map«string,object»»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `Map«string,object»[]` | | 响应数据 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/{orderId}/itinerary/pending-count **获取待确认数量** 返回该订单待确认的编辑数量 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **响应** `统一响应结果«long»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `long` | | 响应数据 | | `message` | `string` | | 响应消息 | --- ### `DELETE` /admin/order/{orderId}/itinerary/pending/{editId} **撤回待确认的修改** 软删除一条待确认的编辑记录 **关联字典**： - itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `editId` | `integer` | | 编辑记录ID | | `orderId` | `integer` | | 订单ID | **请求体** `撤销行程编辑请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `reason` | `string` | 是 | 撤销原因 | **响应** `统一响应结果«Void»` --- ### `POST` /admin/order/{orderId}/itinerary/room-type-change **房型切换** 执行房型切换，自动计算差价，创建待确认记录 **关联字典**： - itinerary_edit_action（操作类型，返回字段action）：ROOM_CHANGE=房型切换 - itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认 - resource_type（资源类型，返回字段resourceType）：HOTEL=酒店 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `房型变更请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `balanceAdjustment` | `number` | | 尾款调整金额（可选，覆盖系统建议差价；正数=增加尾款，负数=减少尾款） | | `changeReasonCode` | `string` | | 变更原因代码（字典项 order_change_reason） | | `dayNumber` | `int` | 是 | 行程天数编号 | | `newRoomTypeId` | `long` | 是 | 新房型ID | | `originalRoomTypeId` | `long` | 是 | 原房型ID | | `reason` | `string` | 是 | 变更原因 | | `roomCount` | `int` | | 房间数量 | **响应** `统一响应结果«OrderItineraryEdit»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `OrderItineraryEdit` | | 响应数据 | |   `action` | `string` | | 操作类型：SKIP/ADD | |   `balanceAdjustment` | `number` | | 尾款调整金额（正数=增加尾款，负数=减少尾款） | |   `changeDays` | `int` | | 变更天数 | |   `changeReasonCode` | `string` | | 变更原因代码（字典项） | |   `changeReasonLabel` | `string` | | 变更原因标签 | |   `confirmStatus` | `string` | | 确认状态：PENDING_CONFIRM/CONFIRMED | |   `confirmedAt` | `string` | | 确认时间 | |   `confirmedBy` | `long` | | 确认人ID | |   `createTime` | `string` | | 创建时间 | |   `dayNumber` | `int` | | 行程天数编号 | |   `deletedAt` | `string` | | 删除时间（软删除） | |   `description` | `string` | | 节点描述（ADD时） | |   `editId` | `long` | | 编辑ID | |   `newResourceName` | `string` | | 新资源名称（房型/车型） | |   `newUnitPrice` | `number` | | 新单价（日均） | |   `nodeId` | `string` | | 原节点ID（SKIP时必填） | |   `nodeName` | `string` | | 节点名称（ADD时） | |   `nodeType` | `string` | | 节点类型（ADD时） | |   `operatorId` | `long` | | 操作人ID | |   `operatorName` | `string` | | 操作人姓名 | |   `orderId` | `long` | | 订单ID | |   `originalResourceName` | `string` | | 原资源名称（房型/车型） | |   `originalUnitPrice` | `number` | | 原单价（日均） | |   `reason` | `string` | | 修改原因 | |   `resourceId` | `long` | | 关联资源ID | |   `resourceType` | `string` | | 关联资源类型：SCENIC_SPOT/ACTIVITY/RESTAURANT/HOTEL/VEHICLE | |   `sortOrder` | `int` | | 排序序号（ADD时） | |   `startTime` | `string` | | 开始时间（ADD时） | |   `suggestedAdjustment` | `number` | | 系统建议差价 | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `POST` /admin/order/{orderId}/itinerary/room-type-change/preview **房型切换差价预览** 预览房型切换的差价，不创建记录 **关联字典**： - resource_type（资源类型，返回字段resourceType）：HOTEL=酒店 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `房型变更请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `balanceAdjustment` | `number` | | 尾款调整金额（可选，覆盖系统建议差价；正数=增加尾款，负数=减少尾款） | | `changeReasonCode` | `string` | | 变更原因代码（字典项 order_change_reason） | | `dayNumber` | `int` | 是 | 行程天数编号 | | `newRoomTypeId` | `long` | 是 | 新房型ID | | `originalRoomTypeId` | `long` | 是 | 原房型ID | | `reason` | `string` | 是 | 变更原因 | | `roomCount` | `int` | | 房间数量 | **响应** `统一响应结果«差价计算结果»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `差价计算结果` | | 响应数据 | |   `changeDays` | `int` | | 变更天数 | |   `description` | `string` | | 差价描述（中文说明） | |   `direction` | `string` | | 差价方向：UPGRADE=升级加价, DOWNGRADE=降级减价, SAME=价格不变 | |   `newName` | `string` | | 新资源名称 | |   `newUnitPrice` | `number` | | 新单价（日均） | |   `originalName` | `string` | | 原资源名称 | |   `originalUnitPrice` | `number` | | 原单价（日均） | |   `priceDiff` | `number` | | 差价金额（正数=需补款，负数=可退款） | | `message` | `string` | | 响应消息 | --- ### `POST` /admin/order/{orderId}/itinerary/skip **跳过节点** 将行程中的某个节点标记为跳过（客户不去） **关联字典**： - itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换 - itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认 - resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `跳过行程节点请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `balanceAdjustment` | `number` | | 尾款调整金额（正数=增加尾款，负数=减少尾款） | | `dayNumber` | `int` | 是 | 行程天数编号 | | `nodeId` | `string` | 是 | 节点ID | | `nodeName` | `string` | | 节点名称 | | `reason` | `string` | 是 | 修改原因 | **响应** `统一响应结果«OrderItineraryEdit»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `OrderItineraryEdit` | | 响应数据 | |   `action` | `string` | | 操作类型：SKIP/ADD | |   `balanceAdjustment` | `number` | | 尾款调整金额（正数=增加尾款，负数=减少尾款） | |   `changeDays` | `int` | | 变更天数 | |   `changeReasonCode` | `string` | | 变更原因代码（字典项） | |   `changeReasonLabel` | `string` | | 变更原因标签 | |   `confirmStatus` | `string` | | 确认状态：PENDING_CONFIRM/CONFIRMED | |   `confirmedAt` | `string` | | 确认时间 | |   `confirmedBy` | `long` | | 确认人ID | |   `createTime` | `string` | | 创建时间 | |   `dayNumber` | `int` | | 行程天数编号 | |   `deletedAt` | `string` | | 删除时间（软删除） | |   `description` | `string` | | 节点描述（ADD时） | |   `editId` | `long` | | 编辑ID | |   `newResourceName` | `string` | | 新资源名称（房型/车型） | |   `newUnitPrice` | `number` | | 新单价（日均） | |   `nodeId` | `string` | | 原节点ID（SKIP时必填） | |   `nodeName` | `string` | | 节点名称（ADD时） | |   `nodeType` | `string` | | 节点类型（ADD时） | |   `operatorId` | `long` | | 操作人ID | |   `operatorName` | `string` | | 操作人姓名 | |   `orderId` | `long` | | 订单ID | |   `originalResourceName` | `string` | | 原资源名称（房型/车型） | |   `originalUnitPrice` | `number` | | 原单价（日均） | |   `reason` | `string` | | 修改原因 | |   `resourceId` | `long` | | 关联资源ID | |   `resourceType` | `string` | | 关联资源类型：SCENIC_SPOT/ACTIVITY/RESTAURANT/HOTEL/VEHICLE | |   `sortOrder` | `int` | | 排序序号（ADD时） | |   `startTime` | `string` | | 开始时间（ADD时） | |   `suggestedAdjustment` | `number` | | 系统建议差价 | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `DELETE` /admin/order/{orderId}/itinerary/skip/{editId} **恢复跳过的节点** 取消跳过，恢复为正常状态 **关联字典**： - itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换 - itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `editId` | `integer` | | 编辑记录ID | | `orderId` | `integer` | | 订单ID | **请求体** `撤销行程编辑请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `reason` | `string` | 是 | 撤销原因 | **响应** `统一响应结果«Void»` --- ### `POST` /admin/order/{orderId}/itinerary/vehicle-type-change **车型切换** 执行车型切换，自动计算差价，创建待确认记录 **关联字典**： - itinerary_edit_action（操作类型，返回字段action）：VEHICLE_CHANGE=车型切换 - itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认 - resource_type（资源类型，返回字段resourceType）：VEHICLE=车辆 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `车型变更请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `balanceAdjustment` | `number` | | 尾款调整金额（可选，覆盖系统建议差价；正数=增加尾款，负数=减少尾款） | | `changeReasonCode` | `string` | | 变更原因代码（字典项 order_change_reason） | | `newVehicleId` | `long` | 是 | 新车辆ID | | `originalVehicleId` | `long` | 是 | 原车辆ID | | `reason` | `string` | 是 | 变更原因 | **响应** `统一响应结果«OrderItineraryEdit»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `OrderItineraryEdit` | | 响应数据 | |   `action` | `string` | | 操作类型：SKIP/ADD | |   `balanceAdjustment` | `number` | | 尾款调整金额（正数=增加尾款，负数=减少尾款） | |   `changeDays` | `int` | | 变更天数 | |   `changeReasonCode` | `string` | | 变更原因代码（字典项） | |   `changeReasonLabel` | `string` | | 变更原因标签 | |   `confirmStatus` | `string` | | 确认状态：PENDING_CONFIRM/CONFIRMED | |   `confirmedAt` | `string` | | 确认时间 | |   `confirmedBy` | `long` | | 确认人ID | |   `createTime` | `string` | | 创建时间 | |   `dayNumber` | `int` | | 行程天数编号 | |   `deletedAt` | `string` | | 删除时间（软删除） | |   `description` | `string` | | 节点描述（ADD时） | |   `editId` | `long` | | 编辑ID | |   `newResourceName` | `string` | | 新资源名称（房型/车型） | |   `newUnitPrice` | `number` | | 新单价（日均） | |   `nodeId` | `string` | | 原节点ID（SKIP时必填） | |   `nodeName` | `string` | | 节点名称（ADD时） | |   `nodeType` | `string` | | 节点类型（ADD时） | |   `operatorId` | `long` | | 操作人ID | |   `operatorName` | `string` | | 操作人姓名 | |   `orderId` | `long` | | 订单ID | |   `originalResourceName` | `string` | | 原资源名称（房型/车型） | |   `originalUnitPrice` | `number` | | 原单价（日均） | |   `reason` | `string` | | 修改原因 | |   `resourceId` | `long` | | 关联资源ID | |   `resourceType` | `string` | | 关联资源类型：SCENIC_SPOT/ACTIVITY/RESTAURANT/HOTEL/VEHICLE | |   `sortOrder` | `int` | | 排序序号（ADD时） | |   `startTime` | `string` | | 开始时间（ADD时） | |   `suggestedAdjustment` | `number` | | 系统建议差价 | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `POST` /admin/order/{orderId}/itinerary/vehicle-type-change/preview **车型切换差价预览** 预览车型切换的差价，不创建记录 **关联字典**： - resource_type（资源类型，返回字段resourceType）：VEHICLE=车辆 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `车型变更请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `balanceAdjustment` | `number` | | 尾款调整金额（可选，覆盖系统建议差价；正数=增加尾款，负数=减少尾款） | | `changeReasonCode` | `string` | | 变更原因代码（字典项 order_change_reason） | | `newVehicleId` | `long` | 是 | 新车辆ID | | `originalVehicleId` | `long` | 是 | 原车辆ID | | `reason` | `string` | 是 | 变更原因 | **响应** `统一响应结果«差价计算结果»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `差价计算结果` | | 响应数据 | |   `changeDays` | `int` | | 变更天数 | |   `description` | `string` | | 差价描述（中文说明） | |   `direction` | `string` | | 差价方向：UPGRADE=升级加价, DOWNGRADE=降级减价, SAME=价格不变 | |   `newName` | `string` | | 新资源名称 | |   `newUnitPrice` | `number` | | 新单价（日均） | |   `originalName` | `string` | | 原资源名称 | |   `originalUnitPrice` | `number` | | 原单价（日均） | |   `priceDiff` | `number` | | 差价金额（正数=需补款，负数=可退款） | | `message` | `string` | | 响应消息 | --- ## 订单待办接口 ### `GET` /admin/order/todo/contract-eligible **可签合同订单列表（保险已完成）** 查询保险待办已完成、可以进入签合同环节的订单列表。 用于合同管理页面展示待签合同的订单 【关联字典】 - 返回字段 todoType → 字典：order_todo_type（订单待办类型） - 返回字段 orderStatus → 字典：order_status（订单状态） **响应** `统一响应结果«List«订单待办VO»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `订单待办VO[]` | | 响应数据 | |   `assigneeAdminId` | `long` | | 负责管理员ID | |   `assigneeRoleKey` | `string` | | 负责角色标识 | |   `blocked` | `boolean` | | 是否阻塞 | |   `blockedReason` | `string` | | 阻塞原因 | |   `completedAt` | `string` | | 完成时间 | |   `completedBy` | `long` | | 完成人ID | |   `contactName` | `string` | | 联系人姓名（关联查询） | |   `createTime` | `string` | | 创建时间 | |   `departureDate` | `string` | | 出发日期（关联查询） | |   `orderId` | `long` | | 订单ID | |   `orderNo` | `string` | | 订单号 | |   `orderStatus` | `string` | | 订单状态（关联查询） | |   `productName` | `string` | | 产品名称（关联查询） | |   `sequence` | `int` | | 排序序号 | |   `status` | `string` | | 待办状态 | |   `todoId` | `long` | | 待办ID | |   `todoLabel` | `string` | | 待办名称 | |   `todoType` | `string` | | 待办类型 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/todo/customizer-list **定制师列表** 获取所有定制师(CUSTOMIZER角色)的列表，用于更换定制师时选择目标定制师 **响应** `统一响应结果«List«管理员基本信息»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `管理员基本信息[]` | | 响应数据 | |   `adminId` | `long` | | 管理员ID | |   `avatarUrl` | `string` | | 头像URL | |   `username` | `string` | | 用户名 | |   `wechatName` | `string` | | 企微用户名称 | |   `wechatUserid` | `string` | | 企微用户ID | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/todo/my-count **我的待办数量** 返回当前管理员未完成的待办总数，用于首页角标/红点提醒 **响应** `统一响应结果«int»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `int` | | 响应数据 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/todo/my-list **我的待办列表** 根据当前管理员ID和角色，查询分配给自己的未完成待办。 超级管理员可看到所有待办，其他角色只能看到对应类型的待办 【关联字典】 - 返回字段 todoType → 字典：order_todo_type（订单待办类型） - 返回字段 orderStatus → 字典：order_status（订单状态） **响应** `统一响应结果«List«订单待办VO»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `订单待办VO[]` | | 响应数据 | |   `assigneeAdminId` | `long` | | 负责管理员ID | |   `assigneeRoleKey` | `string` | | 负责角色标识 | |   `blocked` | `boolean` | | 是否阻塞 | |   `blockedReason` | `string` | | 阻塞原因 | |   `completedAt` | `string` | | 完成时间 | |   `completedBy` | `long` | | 完成人ID | |   `contactName` | `string` | | 联系人姓名（关联查询） | |   `createTime` | `string` | | 创建时间 | |   `departureDate` | `string` | | 出发日期（关联查询） | |   `orderId` | `long` | | 订单ID | |   `orderNo` | `string` | | 订单号 | |   `orderStatus` | `string` | | 订单状态（关联查询） | |   `productName` | `string` | | 产品名称（关联查询） | |   `sequence` | `int` | | 排序序号 | |   `status` | `string` | | 待办状态 | |   `todoId` | `long` | | 待办ID | |   `todoLabel` | `string` | | 待办名称 | |   `todoType` | `string` | | 待办类型 | | `message` | `string` | | 响应消息 | --- ### `PUT` /admin/order/todo/{todoId}/complete **完成待办** 将指定待办标记为已完成。 需要对应角色权限：如配房待办需ROOM_MANAGER角色，配车待办需VEHICLE_MANAGER角色。 完成后系统自动检查是否所有必要待办已完成，若是则推进内部流程 【关联字典】 - 涉及字段 todoType → 字典：order_todo_type（订单待办类型） **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `todoId` | `integer` | | 待办ID | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/{orderId}/customizer **更换定制师** 将订单转派给另一位定制师。更换后原定制师的待办自动转移，订单时间线会记录此操作 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **请求体** `更换定制师请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `customizerId` | `long` | 是 | 定制师ID | **响应** `统一响应结果«Void»` --- ### `GET` /admin/order/{orderId}/todos **获取订单待办列表** 返回指定订单的所有待办项（含已完成和未完成）。 待办类型包括：配房、配车、签合同、购保险、核算等，随内部流程自动生成 【关联字典】 - 返回字段 todoType → 字典：order_todo_type（订单待办类型） **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `orderId` | `integer` | | 订单ID | **响应** `统一响应结果«List«OrderTodo»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `OrderTodo[]` | | 响应数据 | |   `assigneeAdminId` | `long` | | 指派管理员ID | |   `assigneeRoleKey` | `string` | | 指派角色Key | |   `completedAt` | `string` | | 完成时间 | |   `completedBy` | `long` | | 完成人ID | |   `createTime` | `string` | | 创建时间 | |   `deletedAt` | `string` | | 删除时间（软删除） | |   `lastNotifiedAt` | `string` | | 最后通知时间 | |   `notificationCount` | `int` | | 通知次数 | |   `orderId` | `long` | | 订单ID | |   `orderNo` | `string` | | 订单编号 | |   `sequence` | `int` | | 排序序号 | |   `status` | `string` | | 待办状态 | |   `todoId` | `long` | | 待办ID | |   `todoLabel` | `string` | | 待办标签 | |   `todoType` | `string` | | 待办类型 | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ## 订单配置接口 ### `GET` /admin/order/config/expiry-minutes **获取订单过期配置** 获取当前的订单未支付自动过期时间（分钟）。 返回当前值、默认值和配置来源（redis=已自定义, default=使用默认值） **响应** `统一响应结果«Map«string,object»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `object` | | 响应数据 | | `message` | `string` | | 响应消息 | --- ### `PUT` /admin/order/config/expiry-minutes **设置订单过期时间（分钟）** 修改订单未支付自动取消的等待时间。存储在Redis中，即时生效。 仅影响新创建的订单，已有订单的过期时间不变 **请求体** `修改订单过期时间请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `minutes` | `int` | 是 | 过期时间（分钟） | **响应** `统一响应结果«Void»` --- ## 退款政策管理 ### `POST` /admin/order/refund-policy **创建退款政策** 退款政策定义按产品类型和距出发天数的退款比例阶梯 例如：出发前30天退90%，前15天退70%，前7天退50%，7天内不可退 每种产品类型可配置独立的退款政策，用户申请退款时系统自动匹配 【关联字典】 - 请求参数 refundType → 字典：refund_type（退款类型） - 请求参数 productType → 字典：product_type（产品类型） **请求体** `退款政策请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `endDate` | `string` | | 生效结束日期 | | `isDefault` | `boolean` | | 是否为默认政策 | | `policyName` | `string` | 是 | 政策名称 | | `refundType` | `string` | 是 | 退款类型 | | `remark` | `string` | | 备注 | | `rules` | `退款规则项[]` | 是 | 退款规则列表 | |   `minDays` | `int` | 是 | 距出发最少天数（含当天）。例如：minDays=7表示出发前7天及以上适用此规则 | |   `refundRatio` | `int` | 是 | 退款比例（百分比，0-100）。例如：80表示退已付金额的80% | | `startDate` | `string` | | 生效开始日期 | **响应** `统一响应结果«退款政策VO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `退款政策VO` | | 响应数据 | |   `createTime` | `string` | | 创建时间 | |   `createdBy` | `long` | | 创建人ID | |   `enabled` | `boolean` | | 是否启用 | |   `endDate` | `string` | | 生效结束日期 | |   `isDefault` | `boolean` | | 是否为默认政策 | |   `policyId` | `long` | | 政策ID | |   `policyName` | `string` | | 政策名称 | |   `refundType` | `string` | | 退款类型 | |   `remark` | `string` | | 备注 | |   `rules` | `退款规则VO[]` | | 退款规则列表 | |     `minDays` | `int` | | 距出发最少天数 | |     `refundRatio` | `int` | | 退款比例（百分比） | |     `ruleId` | `long` | | 规则ID | |   `startDate` | `string` | | 生效开始日期 | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/refund-policy/list **退款政策列表** 【关联字典】 - 返回字段 refundType → 字典：refund_type（退款类型） - 返回字段 productType → 字典：product_type（产品类型） **响应** `统一响应结果«List«退款政策VO»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `退款政策VO[]` | | 响应数据 | |   `createTime` | `string` | | 创建时间 | |   `createdBy` | `long` | | 创建人ID | |   `enabled` | `boolean` | | 是否启用 | |   `endDate` | `string` | | 生效结束日期 | |   `isDefault` | `boolean` | | 是否为默认政策 | |   `policyId` | `long` | | 政策ID | |   `policyName` | `string` | | 政策名称 | |   `refundType` | `string` | | 退款类型 | |   `remark` | `string` | | 备注 | |   `rules` | `退款规则VO[]` | | 退款规则列表 | |     `minDays` | `int` | | 距出发最少天数 | |     `refundRatio` | `int` | | 退款比例（百分比） | |     `ruleId` | `long` | | 规则ID | |   `startDate` | `string` | | 生效开始日期 | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/refund-policy/{policyId} **退款政策详情** 【关联字典】 - 返回字段 refundType → 字典：refund_type（退款类型） - 返回字段 productType → 字典：product_type（产品类型） **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `policyId` | `integer` | | 退款政策ID | **响应** `统一响应结果«退款政策VO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `退款政策VO` | | 响应数据 | |   `createTime` | `string` | | 创建时间 | |   `createdBy` | `long` | | 创建人ID | |   `enabled` | `boolean` | | 是否启用 | |   `endDate` | `string` | | 生效结束日期 | |   `isDefault` | `boolean` | | 是否为默认政策 | |   `policyId` | `long` | | 政策ID | |   `policyName` | `string` | | 政策名称 | |   `refundType` | `string` | | 退款类型 | |   `remark` | `string` | | 备注 | |   `rules` | `退款规则VO[]` | | 退款规则列表 | |     `minDays` | `int` | | 距出发最少天数 | |     `refundRatio` | `int` | | 退款比例（百分比） | |     `ruleId` | `long` | | 规则ID | |   `startDate` | `string` | | 生效开始日期 | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `PUT` /admin/order/refund-policy/{policyId} **修改退款政策** 【关联字典】 - 请求参数 refundType → 字典：refund_type（退款类型） - 请求参数 productType → 字典：product_type（产品类型） **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `policyId` | `integer` | | 退款政策ID | **请求体** `退款政策请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `endDate` | `string` | | 生效结束日期 | | `isDefault` | `boolean` | | 是否为默认政策 | | `policyName` | `string` | 是 | 政策名称 | | `refundType` | `string` | 是 | 退款类型 | | `remark` | `string` | | 备注 | | `rules` | `退款规则项[]` | 是 | 退款规则列表 | |   `minDays` | `int` | 是 | 距出发最少天数（含当天）。例如：minDays=7表示出发前7天及以上适用此规则 | |   `refundRatio` | `int` | 是 | 退款比例（百分比，0-100）。例如：80表示退已付金额的80% | | `startDate` | `string` | | 生效开始日期 | **响应** `统一响应结果«退款政策VO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `退款政策VO` | | 响应数据 | |   `createTime` | `string` | | 创建时间 | |   `createdBy` | `long` | | 创建人ID | |   `enabled` | `boolean` | | 是否启用 | |   `endDate` | `string` | | 生效结束日期 | |   `isDefault` | `boolean` | | 是否为默认政策 | |   `policyId` | `long` | | 政策ID | |   `policyName` | `string` | | 政策名称 | |   `refundType` | `string` | | 退款类型 | |   `remark` | `string` | | 备注 | |   `rules` | `退款规则VO[]` | | 退款规则列表 | |     `minDays` | `int` | | 距出发最少天数 | |     `refundRatio` | `int` | | 退款比例（百分比） | |     `ruleId` | `long` | | 规则ID | |   `startDate` | `string` | | 生效开始日期 | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `DELETE` /admin/order/refund-policy/{policyId} **删除退款政策** 软删除退款政策。删除后该产品类型将使用默认退款规则。不影响已使用该政策处理的历史退款申请。 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `policyId` | `integer` | | 退款政策ID | **响应** `统一响应结果«Void»` --- ### `PUT` /admin/order/refund-policy/{policyId}/toggle **启用/禁用退款政策** 禁用后该政策不再参与退款金额计算，对应产品类型将使用默认退款规则 同一产品类型仅允许一个启用中的政策 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `policyId` | `integer` | | 退款政策ID | **查询参数** | 参数 | 类型 | 必填 | 说明 | 示例 | | --- | --- | --- | --- | --- | | `enabled` | `boolean` | | 是否启用 | | **响应** `统一响应结果«Void»` --- ## 退款管理 ### `GET` /admin/order/refund/list **退款申请列表** 分页查询退款申请，支持按状态筛选。 状态包括：PENDING(待审批)、APPROVED(已通过)、REJECTED(已拒绝)、REFUNDING(退款中)、REFUNDED(已退款)、CANCELLED(已撤回)、APPEAL(申诉中) 【关联字典】 - 筛选参数 status → 字典：refund_status（退款状态） - 返回字段 status → 字典：refund_status（退款状态） **查询参数** | 参数 | 类型 | 必填 | 说明 | 示例 | | --- | --- | --- | --- | --- | | `page` | `integer(int32)` | | 页码 | | | `pageSize` | `integer(int32)` | | 每页条数 | | | `status` | `string` | | 状态 | | **响应** `统一响应结果«分页结果«退款申请VO»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `分页结果«退款申请VO»` | | 响应数据 | |   `page` | `int` | | 当前页码 | |   `pageSize` | `int` | | 每页条数 | |   `records` | `退款申请VO[]` | | 数据列表 | |     `actualAmount` | `number` | | 实际退款金额 | |     `appealAmount` | `number` | | 申诉退款金额 | |     `appealReason` | `string` | | 申诉原因 | |     `appealStatus` | `int` | | 申诉状态: 1-处理中 2-通过 3-驳回 | |     `appealStatusLabel` | `string` | | 申诉状态标签 | |     `appealedAt` | `string` | | 申诉时间 | |     `applicantId` | `long` | | 申请人ID | |     `applicantName` | `string` | | 申请人姓名 | |     `applicantType` | `string` | | 申请人类型（USER/ADMIN） | |     `applicationId` | `long` | | 申请ID | |     `approvalNo` | `string` | | 审批编号 | |     `calculatedAmount` | `number` | | 计算退款金额 | |     `createTime` | `string` | | 创建时间 | |     `daysBeforeDept` | `int` | | 距出发天数 | |     `departureDate` | `string` | | 出发日期 | |     `orderId` | `long` | | 订单ID | |     `orderNo` | `string` | | 订单号 | |     `paidAmount` | `number` | | 已付金额 | |     `policyId` | `long` | | 退款政策ID | |     `policyName` | `string` | | 退款政策名称 | |     `productName` | `string` | | 产品名称 | |     `reasonDetail` | `string` | | 补充说明 | |     `reasonId` | `long` | | 退款原因ID | |     `reasonText` | `string` | | 退款原因 | |     `refundRatio` | `int` | | 退款比例（百分比） | |     `refundType` | `string` | | 退款类型（字典：refund_type） | |     `refundTypeLabel` | `string` | | 退款类型标签（字典：refund_type 翻译） | |     `refundedAt` | `string` | | 退款完成时间 | |     `reviewAdminId` | `long` | | 审批管理员ID | |     `reviewAdminName` | `string` | | 审批管理员姓名 | |     `reviewRemark` | `string` | | 审批备注 | |     `reviewedAt` | `string` | | 审批时间 | |     `status` | `string` | | 退款状态（字典：refund_status） | |     `statusLabel` | `string` | | 退款状态标签（字典：refund_status 翻译） | |     `updateTime` | `string` | | 更新时间 | |   `total` | `int` | | 总记录数 | | `message` | `string` | | 响应消息 | --- ### `POST` /admin/order/refund/reason **创建退款原因** 新增退款原因选项，C端用户申请退款时可选择。按sortOrder排序展示 【关联字典】 - 请求参数 category → 字典：refund_reason_category（退款原因分类） **请求体** `创建退款原因请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `category` | `string` | | 分类 | | `reasonText` | `string` | 是 | 退款原因文本 | | `sortOrder` | `int` | | 排序号 | **响应** `统一响应结果«退款原因VO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `退款原因VO` | | 响应数据 | |   `category` | `string` | | 原因分类 | |   `enabled` | `boolean` | | 是否启用 | |   `reasonId` | `long` | | 原因ID | |   `reasonText` | `string` | | 原因描述 | |   `sortOrder` | `int` | | 排序序号 | | `message` | `string` | | 响应消息 | --- ### `GET` /admin/order/refund/reason/list **退款原因列表** 获取所有退款原因选项（含禁用的），用于退款原因管理页面 【关联字典】 - 返回字段 category → 字典：refund_reason_category（退款原因分类） **响应** `统一响应结果«List«退款原因VO»»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `退款原因VO[]` | | 响应数据 | |   `category` | `string` | | 原因分类 | |   `enabled` | `boolean` | | 是否启用 | |   `reasonId` | `long` | | 原因ID | |   `reasonText` | `string` | | 原因描述 | |   `sortOrder` | `int` | | 排序序号 | | `message` | `string` | | 响应消息 | --- ### `PUT` /admin/order/refund/reason/{reasonId} **修改退款原因** 修改退款原因的文本、分类或排序，不影响已使用该原因的历史退款申请 【关联字典】 - 请求参数 category → 字典：refund_reason_category（退款原因分类） **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `reasonId` | `integer` | | 退款原因ID | **请求体** `修改退款原因请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `category` | `string` | | 分类 | | `reasonText` | `string` | | 退款原因文本 | | `sortOrder` | `int` | | 排序号 | **响应** `统一响应结果«退款原因VO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `退款原因VO` | | 响应数据 | |   `category` | `string` | | 原因分类 | |   `enabled` | `boolean` | | 是否启用 | |   `reasonId` | `long` | | 原因ID | |   `reasonText` | `string` | | 原因描述 | |   `sortOrder` | `int` | | 排序序号 | | `message` | `string` | | 响应消息 | --- ### `DELETE` /admin/order/refund/reason/{reasonId} **删除退款原因** 软删除退款原因，删除后C端不再展示。不影响已使用该原因的历史退款申请 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `reasonId` | `integer` | | 退款原因ID | **响应** `统一响应结果«Void»` --- ### `GET` /admin/order/refund/{applicationId} **退款申请详情** 返回退款申请的完整信息，包括退款原因、申请金额、实退金额、审批记录、申诉信息等 【关联字典】 - 返回字段 status → 字典：refund_status（退款状态） **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `applicationId` | `integer` | | 退款申请ID | **响应** `统一响应结果«退款申请VO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `退款申请VO` | | 响应数据 | |   `actualAmount` | `number` | | 实际退款金额 | |   `appealAmount` | `number` | | 申诉退款金额 | |   `appealReason` | `string` | | 申诉原因 | |   `appealStatus` | `int` | | 申诉状态: 1-处理中 2-通过 3-驳回 | |   `appealStatusLabel` | `string` | | 申诉状态标签 | |   `appealedAt` | `string` | | 申诉时间 | |   `applicantId` | `long` | | 申请人ID | |   `applicantName` | `string` | | 申请人姓名 | |   `applicantType` | `string` | | 申请人类型（USER/ADMIN） | |   `applicationId` | `long` | | 申请ID | |   `approvalNo` | `string` | | 审批编号 | |   `calculatedAmount` | `number` | | 计算退款金额 | |   `createTime` | `string` | | 创建时间 | |   `daysBeforeDept` | `int` | | 距出发天数 | |   `departureDate` | `string` | | 出发日期 | |   `orderId` | `long` | | 订单ID | |   `orderNo` | `string` | | 订单号 | |   `paidAmount` | `number` | | 已付金额 | |   `policyId` | `long` | | 退款政策ID | |   `policyName` | `string` | | 退款政策名称 | |   `productName` | `string` | | 产品名称 | |   `reasonDetail` | `string` | | 补充说明 | |   `reasonId` | `long` | | 退款原因ID | |   `reasonText` | `string` | | 退款原因 | |   `refundRatio` | `int` | | 退款比例（百分比） | |   `refundType` | `string` | | 退款类型（字典：refund_type） | |   `refundTypeLabel` | `string` | | 退款类型标签（字典：refund_type 翻译） | |   `refundedAt` | `string` | | 退款完成时间 | |   `reviewAdminId` | `long` | | 审批管理员ID | |   `reviewAdminName` | `string` | | 审批管理员姓名 | |   `reviewRemark` | `string` | | 审批备注 | |   `reviewedAt` | `string` | | 审批时间 | |   `status` | `string` | | 退款状态（字典：refund_status） | |   `statusLabel` | `string` | | 退款状态标签（字典：refund_status 翻译） | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `PUT` /admin/order/refund/{applicationId}/complete **手动完成退款** 用于测试订单或线下退款场景。将处于'退款中'状态的退款申请直接标记为'已退款' **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `applicationId` | `integer` | | 退款申请ID | **响应** `统一响应结果«退款申请VO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `退款申请VO` | | 响应数据 | |   `actualAmount` | `number` | | 实际退款金额 | |   `appealAmount` | `number` | | 申诉退款金额 | |   `appealReason` | `string` | | 申诉原因 | |   `appealStatus` | `int` | | 申诉状态: 1-处理中 2-通过 3-驳回 | |   `appealStatusLabel` | `string` | | 申诉状态标签 | |   `appealedAt` | `string` | | 申诉时间 | |   `applicantId` | `long` | | 申请人ID | |   `applicantName` | `string` | | 申请人姓名 | |   `applicantType` | `string` | | 申请人类型（USER/ADMIN） | |   `applicationId` | `long` | | 申请ID | |   `approvalNo` | `string` | | 审批编号 | |   `calculatedAmount` | `number` | | 计算退款金额 | |   `createTime` | `string` | | 创建时间 | |   `daysBeforeDept` | `int` | | 距出发天数 | |   `departureDate` | `string` | | 出发日期 | |   `orderId` | `long` | | 订单ID | |   `orderNo` | `string` | | 订单号 | |   `paidAmount` | `number` | | 已付金额 | |   `policyId` | `long` | | 退款政策ID | |   `policyName` | `string` | | 退款政策名称 | |   `productName` | `string` | | 产品名称 | |   `reasonDetail` | `string` | | 补充说明 | |   `reasonId` | `long` | | 退款原因ID | |   `reasonText` | `string` | | 退款原因 | |   `refundRatio` | `int` | | 退款比例（百分比） | |   `refundType` | `string` | | 退款类型（字典：refund_type） | |   `refundTypeLabel` | `string` | | 退款类型标签（字典：refund_type 翻译） | |   `refundedAt` | `string` | | 退款完成时间 | |   `reviewAdminId` | `long` | | 审批管理员ID | |   `reviewAdminName` | `string` | | 审批管理员姓名 | |   `reviewRemark` | `string` | | 审批备注 | |   `reviewedAt` | `string` | | 审批时间 | |   `status` | `string` | | 退款状态（字典：refund_status） | |   `statusLabel` | `string` | | 退款状态标签（字典：refund_status 翻译） | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `PUT` /admin/order/refund/{applicationId}/execute-appeal **申诉通过后执行退款** 申诉退款流程：用户发起申诉 → 企微OA审批 → 审批通过后管理员确认实退金额 → 调起微信退款 **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `applicationId` | `integer` | | 退款申请ID | **请求体** `申诉退款执行请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `actualAmount` | `number` | 是 | 实际退款金额 | | `remark` | `string` | | 备注 | **响应** `统一响应结果«退款申请VO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `退款申请VO` | | 响应数据 | |   `actualAmount` | `number` | | 实际退款金额 | |   `appealAmount` | `number` | | 申诉退款金额 | |   `appealReason` | `string` | | 申诉原因 | |   `appealStatus` | `int` | | 申诉状态: 1-处理中 2-通过 3-驳回 | |   `appealStatusLabel` | `string` | | 申诉状态标签 | |   `appealedAt` | `string` | | 申诉时间 | |   `applicantId` | `long` | | 申请人ID | |   `applicantName` | `string` | | 申请人姓名 | |   `applicantType` | `string` | | 申请人类型（USER/ADMIN） | |   `applicationId` | `long` | | 申请ID | |   `approvalNo` | `string` | | 审批编号 | |   `calculatedAmount` | `number` | | 计算退款金额 | |   `createTime` | `string` | | 创建时间 | |   `daysBeforeDept` | `int` | | 距出发天数 | |   `departureDate` | `string` | | 出发日期 | |   `orderId` | `long` | | 订单ID | |   `orderNo` | `string` | | 订单号 | |   `paidAmount` | `number` | | 已付金额 | |   `policyId` | `long` | | 退款政策ID | |   `policyName` | `string` | | 退款政策名称 | |   `productName` | `string` | | 产品名称 | |   `reasonDetail` | `string` | | 补充说明 | |   `reasonId` | `long` | | 退款原因ID | |   `reasonText` | `string` | | 退款原因 | |   `refundRatio` | `int` | | 退款比例（百分比） | |   `refundType` | `string` | | 退款类型（字典：refund_type） | |   `refundTypeLabel` | `string` | | 退款类型标签（字典：refund_type 翻译） | |   `refundedAt` | `string` | | 退款完成时间 | |   `reviewAdminId` | `long` | | 审批管理员ID | |   `reviewAdminName` | `string` | | 审批管理员姓名 | |   `reviewRemark` | `string` | | 审批备注 | |   `reviewedAt` | `string` | | 审批时间 | |   `status` | `string` | | 退款状态（字典：refund_status） | |   `statusLabel` | `string` | | 退款状态标签（字典：refund_status 翻译） | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | --- ### `PUT` /admin/order/refund/{applicationId}/review **审批退款申请** 退款审批流程：查看退款申请 → 决定通过/拒绝 → 通过时填写实退金额 → 系统自动调起微信退款 拒绝后用户可发起申诉 【关联字典】 - 返回字段 status → 字典：refund_status（退款状态） **路径参数** | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `applicationId` | `integer` | | 退款申请ID | **请求体** `管理员退款审批请求` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `action` | `string` | 是 | 审批结果：APPROVE=通过（自动调起微信退款）、REJECT=拒绝（用户可发起申诉） | | `actualAmount` | `number` | | 实际退款金额（审批通过时可调整，不传则使用申请金额）。不能超过订单已付金额 | | `remark` | `string` | | 审批备注 | **响应** `统一响应结果«退款申请VO»` | 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | `code` | `int` | | 状态码 | | `data` | `退款申请VO` | | 响应数据 | |   `actualAmount` | `number` | | 实际退款金额 | |   `appealAmount` | `number` | | 申诉退款金额 | |   `appealReason` | `string` | | 申诉原因 | |   `appealStatus` | `int` | | 申诉状态: 1-处理中 2-通过 3-驳回 | |   `appealStatusLabel` | `string` | | 申诉状态标签 | |   `appealedAt` | `string` | | 申诉时间 | |   `applicantId` | `long` | | 申请人ID | |   `applicantName` | `string` | | 申请人姓名 | |   `applicantType` | `string` | | 申请人类型（USER/ADMIN） | |   `applicationId` | `long` | | 申请ID | |   `approvalNo` | `string` | | 审批编号 | |   `calculatedAmount` | `number` | | 计算退款金额 | |   `createTime` | `string` | | 创建时间 | |   `daysBeforeDept` | `int` | | 距出发天数 | |   `departureDate` | `string` | | 出发日期 | |   `orderId` | `long` | | 订单ID | |   `orderNo` | `string` | | 订单号 | |   `paidAmount` | `number` | | 已付金额 | |   `policyId` | `long` | | 退款政策ID | |   `policyName` | `string` | | 退款政策名称 | |   `productName` | `string` | | 产品名称 | |   `reasonDetail` | `string` | | 补充说明 | |   `reasonId` | `long` | | 退款原因ID | |   `reasonText` | `string` | | 退款原因 | |   `refundRatio` | `int` | | 退款比例（百分比） | |   `refundType` | `string` | | 退款类型（字典：refund_type） | |   `refundTypeLabel` | `string` | | 退款类型标签（字典：refund_type 翻译） | |   `refundedAt` | `string` | | 退款完成时间 | |   `reviewAdminId` | `long` | | 审批管理员ID | |   `reviewAdminName` | `string` | | 审批管理员姓名 | |   `reviewRemark` | `string` | | 审批备注 | |   `reviewedAt` | `string` | | 审批时间 | |   `status` | `string` | | 退款状态（字典：refund_status） | |   `statusLabel` | `string` | | 退款状态标签（字典：refund_status 翻译） | |   `updateTime` | `string` | | 更新时间 | | `message` | `string` | | 响应消息 | ---