{ "swagger": "2.0", "info": { "title": "订单服务", "version": "1.0.0" }, "basePath": "/", "paths": { "/admin/order/album/file/{albumFileId}": { "put": { "tags": [ "管理端相册接口" ], "summary": "编辑文件信息", "description": "**关联字典**：\n- album_file_type（文件类型，返回字段fileType）：IMAGE=图片, VIDEO=视频\n- album_location_type（地点类型，返回字段locationType）：RESOURCE=关联资源, CUSTOM=自定义地点\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆", "operationId": "updateFileUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "albumFileId", "in": "path", "description": "相册文件ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/AlbumFileUpdateRequest", "originalRef": "AlbumFileUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«AlbumFileVO»", "originalRef": "统一响应结果«AlbumFileVO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«AlbumFileVO»", "originalRef": "统一响应结果«AlbumFileVO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "delete": { "tags": [ "管理端相册接口" ], "summary": "删除文件", "description": "删除相册中的单个文件（照片/视频）。仅上传者或超级管理员可操作，删除后C端用户不再可见。", "operationId": "deleteFileUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "albumFileId", "in": "path", "description": "相册文件ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/album/folder/{folderId}": { "put": { "tags": [ "管理端相册接口" ], "summary": "编辑相册文件夹", "description": "修改文件夹名称或描述。仅创建者或超级管理员可操作", "operationId": "updateFolderUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "folderId", "in": "path", "description": "文件夹ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/AlbumFolderRequest", "originalRef": "AlbumFolderRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«AlbumFolderVO»", "originalRef": "统一响应结果«AlbumFolderVO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«AlbumFolderVO»", "originalRef": "统一响应结果«AlbumFolderVO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "delete": { "tags": [ "管理端相册接口" ], "summary": "删除相册文件夹", "description": "删除文件夹及其下所有文件。仅创建者或超级管理员可操作。删除后C端用户不再可见", "operationId": "deleteFolderUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "folderId", "in": "path", "description": "文件夹ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/album/folder/{folderId}/cover": { "put": { "tags": [ "管理端相册接口" ], "summary": "设置文件夹封面", "description": "将文件夹中的指定文件设为封面图，封面图会在文件夹列表中展示。仅上传者或超级管理员可操作。", "operationId": "setCoverUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "albumFileId", "in": "query", "description": "相册文件ID", "required": false, "type": "integer", "format": "int64", "allowEmptyValue": false }, { "name": "folderId", "in": "path", "description": "文件夹ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/album/folder/{folderId}/files": { "get": { "tags": [ "管理端相册接口" ], "summary": "查询文件夹下的文件列表", "description": "**关联字典**：\n- album_file_type（文件类型，返回字段fileType）：IMAGE=图片, VIDEO=视频\n- album_location_type（地点类型，返回字段locationType）：RESOURCE=关联资源, CUSTOM=自定义地点\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆", "operationId": "listFilesUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "folderId", "in": "path", "description": "文件夹ID", "required": false, "type": "integer", "format": "int64" }, { "name": "page", "in": "query", "description": "页码", "required": false, "type": "integer", "default": 1, "format": "int32", "allowEmptyValue": false }, { "name": "size", "in": "query", "description": "每页数量", "required": false, "type": "integer", "default": 20, "format": "int32", "allowEmptyValue": false } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«AlbumFileVO»»", "originalRef": "统一响应结果«分页结果«AlbumFileVO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«AlbumFileVO»»", "originalRef": "统一响应结果«分页结果«AlbumFileVO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "post": { "tags": [ "管理端相册接口" ], "summary": "批量添加文件到文件夹", "description": "一次添加多个照片/视频到指定文件夹。文件需先通过文件服务上传获取OSS URL\n\n**关联字典**：\n- album_file_type（文件类型，返回字段fileType）：IMAGE=图片, VIDEO=视频\n- album_location_type（地点类型，返回字段locationType）：RESOURCE=关联资源, CUSTOM=自定义地点\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆", "operationId": "addFilesUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "folderId", "in": "path", "description": "文件夹ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/AlbumFileBatchAddRequest", "originalRef": "AlbumFileBatchAddRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«AlbumFileVO»»", "originalRef": "统一响应结果«List«AlbumFileVO»»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«AlbumFileVO»»", "originalRef": "统一响应结果«List«AlbumFileVO»»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/album/my-uploads": { "get": { "tags": [ "管理端相册接口" ], "summary": "我的上传", "description": "查询当前管理员上传的所有相册文件（跨订单），方便管理自己上传的内容\n\n**关联字典**：\n- album_file_type（文件类型，返回字段fileType）：IMAGE=图片, VIDEO=视频\n- album_location_type（地点类型，返回字段locationType）：RESOURCE=关联资源, CUSTOM=自定义地点\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆", "operationId": "listMyUploadsUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "page", "in": "query", "description": "页码", "required": false, "type": "integer", "default": 1, "format": "int32", "allowEmptyValue": false }, { "name": "size", "in": "query", "description": "每页数量", "required": false, "type": "integer", "default": 20, "format": "int32", "allowEmptyValue": false } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«AlbumFileVO»»", "originalRef": "统一响应结果«分页结果«AlbumFileVO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«AlbumFileVO»»", "originalRef": "统一响应结果«分页结果«AlbumFileVO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/config/expiry-minutes": { "get": { "tags": [ "订单配置接口" ], "summary": "获取订单过期配置", "description": "获取当前的订单未支付自动过期时间（分钟）。\n返回当前值、默认值和配置来源（redis=已自定义, default=使用默认值）", "operationId": "getExpiryMinutesUsingGET", "produces": [ "*/*" ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Map«string,object»»", "originalRef": "统一响应结果«Map«string,object»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Map«string,object»»", "originalRef": "统一响应结果«Map«string,object»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "put": { "tags": [ "订单配置接口" ], "summary": "设置订单过期时间（分钟）", "description": "修改订单未支付自动取消的等待时间。存储在Redis中，即时生效。\n仅影响新创建的订单，已有订单的过期时间不变", "operationId": "setExpiryMinutesUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "expiryRequest", "description": "修改订单过期时间请求", "required": false, "schema": { "$ref": "#/definitions/修改订单过期时间请求", "originalRef": "修改订单过期时间请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/create": { "post": { "tags": [ "管理端订单接口" ], "summary": "创建订单（定制师代下单）", "description": "创建订单流程：选择产品 → 填写联系人和出行人 → 系统计算报价 → 生成订单(PENDING_PAY状态)\n\n权限：CUSTOM产品仅创建者可下单，CORE/ROUTE产品所有管理员可下单\n\n【关联字典】\n- 请求参数 productType → 字典：product_type（产品类型）\n- 请求参数 travelers[].travelerType → 字典：traveler_type（出行人类型）\n- 请求参数 travelers[].idCardType → 字典：id_card_type（证件类型）\n- 请求参数 travelers[].gender → 字典：gender（性别）\n- 返回字段 status → 字典：order_status（订单状态）\n- 返回字段 processStatus → 字典：order_process_status（订单内部流程状态）\n- 返回字段 productType → 字典：product_type（产品类型）\n- 返回字段 travelers[].travelerType → 字典：traveler_type（出行人类型）\n- 返回字段 travelers[].idCardType → 字典：id_card_type（证件类型）\n- 返回字段 travelers[].gender → 字典：gender（性别）", "operationId": "createOrderUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "createRequest", "description": "创建订单请求", "required": false, "schema": { "$ref": "#/definitions/管理员创建订单请求", "originalRef": "管理员创建订单请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«订单详情VO»", "originalRef": "统一响应结果«订单详情VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«订单详情VO»", "originalRef": "统一响应结果«订单详情VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/early-bird": { "post": { "tags": [ "早鸟优惠计划管理" ], "summary": "创建早鸟优惠计划", "description": "创建一个早鸟优惠计划，在指定日期范围内下单且满足最低人数条件的订单可享受优惠。\n下单时系统自动匹配最优的早鸟计划。权限：仅超级管理员(SUPER_ADMIN)", "operationId": "createUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "planRequest", "description": "创建早鸟计划请求", "required": false, "schema": { "$ref": "#/definitions/早鸟优惠计划请求", "originalRef": "早鸟优惠计划请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«早鸟优惠计划VO»", "originalRef": "统一响应结果«早鸟优惠计划VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«早鸟优惠计划VO»", "originalRef": "统一响应结果«早鸟优惠计划VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/early-bird/list": { "get": { "tags": [ "早鸟优惠计划管理" ], "summary": "早鸟优惠计划列表", "description": "分页查询所有早鸟优惠计划。权限：仅超级管理员(SUPER_ADMIN)", "operationId": "listUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "page", "in": "query", "description": "页码", "required": false, "type": "integer", "default": 1, "format": "int32", "allowEmptyValue": false }, { "name": "pageSize", "in": "query", "description": "每页条数", "required": false, "type": "integer", "default": 20, "format": "int32", "allowEmptyValue": false } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«早鸟优惠计划VO»»", "originalRef": "统一响应结果«分页结果«早鸟优惠计划VO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«早鸟优惠计划VO»»", "originalRef": "统一响应结果«分页结果«早鸟优惠计划VO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/early-bird/{planId}": { "get": { "tags": [ "早鸟优惠计划管理" ], "summary": "早鸟优惠计划详情", "description": "权限：仅超级管理员(SUPER_ADMIN)", "operationId": "detailUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "planId", "in": "path", "description": "早鸟计划ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«早鸟优惠计划VO»", "originalRef": "统一响应结果«早鸟优惠计划VO»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«早鸟优惠计划VO»", "originalRef": "统一响应结果«早鸟优惠计划VO»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "put": { "tags": [ "早鸟优惠计划管理" ], "summary": "修改早鸟优惠计划", "description": "权限：仅超级管理员(SUPER_ADMIN)。修改不影响已下单的订单优惠", "operationId": "updateUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "planId", "in": "path", "description": "早鸟计划ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "planRequest", "description": "修改早鸟计划请求", "required": false, "schema": { "$ref": "#/definitions/早鸟优惠计划请求", "originalRef": "早鸟优惠计划请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "delete": { "tags": [ "早鸟优惠计划管理" ], "summary": "删除早鸟优惠计划", "description": "权限：仅超级管理员(SUPER_ADMIN)。删除不影响已下单的订单优惠", "operationId": "deleteUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "planId", "in": "path", "description": "早鸟计划ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/early-bird/{planId}/toggle": { "put": { "tags": [ "早鸟优惠计划管理" ], "summary": "启用/禁用早鸟优惠计划", "description": "禁用后该计划不再参与自动匹配。权限：仅超级管理员(SUPER_ADMIN)", "operationId": "toggleUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "enabled", "in": "query", "description": "是否启用", "required": false, "type": "boolean", "allowEmptyValue": false }, { "name": "planId", "in": "path", "description": "早鸟计划ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/list": { "get": { "tags": [ "管理端订单接口" ], "summary": "订单列表", "description": "支持按关键词（订单号/联系人/产品名）、状态、内部流程状态、产品类型筛选。\n支持按创建时间/出发日期/总价排序。\n\n返回分页结果，包含订单基本信息、状态、支付信息和产品封面\n\n【关联字典】\n- 筛选参数 status → 字典：order_status（订单状态）\n- 筛选参数 processStatus → 字典：order_process_status（订单内部流程状态）\n- 筛选参数 productType → 字典：product_type（产品类型）\n- 返回字段 status → 字典：order_status（订单状态）\n- 返回字段 processStatus → 字典：order_process_status（订单内部流程状态）\n- 返回字段 productType → 字典：product_type（产品类型）", "operationId": "listOrdersUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "keyword", "in": "query", "description": "搜索关键词（订单号/联系人姓名/产品名称）", "required": false, "type": "string", "x-example": "HL2026" }, { "name": "page", "in": "query", "description": "页码", "required": false, "type": "integer", "format": "int32", "x-example": 1 }, { "name": "pageSize", "in": "query", "description": "每页条数", "required": false, "type": "integer", "format": "int32", "x-example": 20 }, { "name": "processStatus", "in": "query", "description": "内部流程状态（字典：order_process_status）", "required": false, "type": "string", "x-example": "PENDING_ROOM" }, { "name": "productType", "in": "query", "description": "产品类型（字典：product_type）", "required": false, "type": "string", "x-example": "CORE" }, { "name": "sortBy", "in": "query", "description": "排序字段（createTime/departureDate/totalPrice）", "required": false, "type": "string", "x-example": "createTime" }, { "name": "sortDir", "in": "query", "description": "排序方向（desc/asc）", "required": false, "type": "string", "x-example": "desc" }, { "name": "status", "in": "query", "description": "订单状态（字典：order_status，支持逗号分隔多状态）", "required": false, "type": "string", "x-example": "PAID" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«管理员订单列表VO»»", "originalRef": "统一响应结果«分页结果«管理员订单列表VO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«管理员订单列表VO»»", "originalRef": "统一响应结果«分页结果«管理员订单列表VO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/quote": { "post": { "tags": [ "管理端订单接口" ], "summary": "报价预览", "description": "根据产品、出发日期、人数组合实时计算报价。\n返回各资源明细价格和合计金额，前端据此展示报价清单。\n\n注意：报价仅供参考，最终价格以创建订单时为准（价格日历可能变动）", "operationId": "quotePreviewUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "quoteRequest", "description": "报价预览请求", "required": false, "schema": { "$ref": "#/definitions/报价预览请求", "originalRef": "报价预览请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Map«string,object»»", "originalRef": "统一响应结果«Map«string,object»»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Map«string,object»»", "originalRef": "统一响应结果«Map«string,object»»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/todo/contract-eligible": { "get": { "tags": [ "订单待办接口" ], "summary": "可签合同订单列表（保险已完成）", "description": "查询保险待办已完成、可以进入签合同环节的订单列表。\n用于合同管理页面展示待签合同的订单\n\n【关联字典】\n- 返回字段 todoType → 字典：order_todo_type（订单待办类型）\n- 返回字段 orderStatus → 字典：order_status（订单状态）", "operationId": "getContractEligibleOrdersUsingGET", "produces": [ "*/*" ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«订单待办VO»»", "originalRef": "统一响应结果«List«订单待办VO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«订单待办VO»»", "originalRef": "统一响应结果«List«订单待办VO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/todo/customizer-list": { "get": { "tags": [ "订单待办接口" ], "summary": "定制师列表", "description": "获取所有定制师(CUSTOMIZER角色)的列表，用于更换定制师时选择目标定制师", "operationId": "getCustomizerListUsingGET", "produces": [ "*/*" ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«管理员基本信息»»", "originalRef": "统一响应结果«List«管理员基本信息»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«管理员基本信息»»", "originalRef": "统一响应结果«List«管理员基本信息»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/todo/my-count": { "get": { "tags": [ "订单待办接口" ], "summary": "我的待办数量", "description": "返回当前管理员未完成的待办总数，用于首页角标/红点提醒", "operationId": "getMyTodosCountUsingGET", "produces": [ "*/*" ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«int»", "originalRef": "统一响应结果«int»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«int»", "originalRef": "统一响应结果«int»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/todo/my-list": { "get": { "tags": [ "订单待办接口" ], "summary": "我的待办列表", "description": "根据当前管理员ID和角色，查询分配给自己的未完成待办。\n超级管理员可看到所有待办，其他角色只能看到对应类型的待办\n\n【关联字典】\n- 返回字段 todoType → 字典：order_todo_type（订单待办类型）\n- 返回字段 orderStatus → 字典：order_status（订单状态）", "operationId": "getMyTodosUsingGET", "produces": [ "*/*" ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«订单待办VO»»", "originalRef": "统一响应结果«List«订单待办VO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«订单待办VO»»", "originalRef": "统一响应结果«List«订单待办VO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/todo/{todoId}/complete": { "put": { "tags": [ "订单待办接口" ], "summary": "完成待办", "description": "将指定待办标记为已完成。\n需要对应角色权限：如配房待办需ROOM_MANAGER角色，配车待办需VEHICLE_MANAGER角色。\n\n完成后系统自动检查是否所有必要待办已完成，若是则推进内部流程\n\n【关联字典】\n- 涉及字段 todoType → 字典：order_todo_type（订单待办类型）", "operationId": "completeTodoUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "todoId", "in": "path", "description": "待办ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/work-order": { "post": { "tags": [ "工单管理" ], "summary": "创建工单", "description": "创建旅途中的变更工单，需关联订单ID。\n可指定处理人，未指定则进入待分配状态。可附带差价信息和资源详情JSON\n\n【关联字典】\n- 请求参数 type → 字典：work_order_type（工单类型）\n- 请求参数 priority → 字典：work_order_priority（工单优先级）\n- 返回字段 status → 字典：work_order_status（工单状态）\n- 返回字段 type → 字典：work_order_type（工单类型）\n- 返回字段 priority → 字典：work_order_priority（工单优先级）", "operationId": "createUsingPOST_1", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "body", "description": "body", "required": true, "schema": { "$ref": "#/definitions/CreateWorkOrderRequest", "originalRef": "CreateWorkOrderRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«WorkOrderVO»", "originalRef": "统一响应结果«WorkOrderVO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«WorkOrderVO»", "originalRef": "统一响应结果«WorkOrderVO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/work-order/count-by-order/{orderId}": { "get": { "tags": [ "工单管理" ], "summary": "按订单查工单数量", "description": "返回指定订单关联的工单总数，用于订单详情页展示工单角标", "operationId": "countByOrderUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«int»", "originalRef": "统一响应结果«int»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«int»", "originalRef": "统一响应结果«int»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/work-order/list": { "get": { "tags": [ "工单管理" ], "summary": "工单列表", "description": "分页查询工单，支持按状态/类型/优先级/订单编号/处理人筛选。\n工单用于处理旅行中的突发变更需求（如换房、换车、加景点等）\n\n【关联字典】\n- 筛选参数 status → 字典：work_order_status（工单状态）\n- 筛选参数 type → 字典：work_order_type（工单类型）\n- 筛选参数 priority → 字典：work_order_priority（工单优先级）\n- 返回字段 status → 字典：work_order_status（工单状态）\n- 返回字段 type → 字典：work_order_type（工单类型）\n- 返回字段 priority → 字典：work_order_priority（工单优先级）", "operationId": "listUsingGET_1", "produces": [ "*/*" ], "parameters": [ { "name": "assigneeAdminId", "in": "query", "description": "处理人ID", "required": false, "type": "integer", "format": "int64", "allowEmptyValue": false }, { "name": "orderNo", "in": "query", "description": "订单编号(模糊)", "required": false, "type": "string", "allowEmptyValue": false }, { "name": "page", "in": "query", "description": "页码", "required": false, "type": "integer", "default": 1, "format": "int32", "allowEmptyValue": false }, { "name": "pageSize", "in": "query", "description": "每页条数", "required": false, "type": "integer", "default": 20, "format": "int32", "allowEmptyValue": false }, { "name": "priority", "in": "query", "description": "优先级: URGENT/NORMAL", "required": false, "type": "string", "allowEmptyValue": false }, { "name": "status", "in": "query", "description": "状态: PENDING/PROCESSING/RESOLVED/REJECTED", "required": false, "type": "string", "allowEmptyValue": false }, { "name": "type", "in": "query", "description": "类型: ROOM_CHANGE/ROOM_ADD/CHECKOUT_CHANGE/HOTEL_ISSUE/VEHICLE_CHANGE/SCENIC_ADD/SCENIC_REMOVE/OTHER", "required": false, "type": "string", "allowEmptyValue": false } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«WorkOrderVO»»", "originalRef": "统一响应结果«分页结果«WorkOrderVO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«WorkOrderVO»»", "originalRef": "统一响应结果«分页结果«WorkOrderVO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/work-order/stats": { "get": { "tags": [ "工单管理" ], "summary": "工单统计", "description": "返回各状态的工单数量和紧急工单数，用于工单管理页面顶部统计卡片\n\n【关联字典】\n- 返回字段中的状态key → 字典：work_order_status（工单状态）", "operationId": "getStatsUsingGET", "produces": [ "*/*" ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Map«string,object»»", "originalRef": "统一响应结果«Map«string,object»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Map«string,object»»", "originalRef": "统一响应结果«Map«string,object»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/work-order/{workOrderId}": { "get": { "tags": [ "工单管理" ], "summary": "工单详情", "description": "返回工单完整信息，包括关联订单、资源详情、处理记录和备注列表\n\n【关联字典】\n- 返回字段 status → 字典：work_order_status（工单状态）\n- 返回字段 type → 字典：work_order_type（工单类型）\n- 返回字段 priority → 字典：work_order_priority（工单优先级）", "operationId": "getDetailUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "workOrderId", "in": "path", "description": "工单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«WorkOrderVO»", "originalRef": "统一响应结果«WorkOrderVO»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«WorkOrderVO»", "originalRef": "统一响应结果«WorkOrderVO»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/work-order/{workOrderId}/assign": { "put": { "tags": [ "工单管理" ], "summary": "指派工单", "description": "将工单分配给指定管理员处理。被指派人将在待办列表中看到该工单", "operationId": "assignUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "assigneeId", "in": "query", "description": "处理人ID", "required": false, "type": "integer", "format": "int64", "allowEmptyValue": false }, { "name": "assigneeName", "in": "query", "description": "处理人姓名", "required": false, "type": "string", "allowEmptyValue": false }, { "name": "workOrderId", "in": "path", "description": "工单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«WorkOrderVO»", "originalRef": "统一响应结果«WorkOrderVO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«WorkOrderVO»", "originalRef": "统一响应结果«WorkOrderVO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/work-order/{workOrderId}/comment": { "post": { "tags": [ "工单管理" ], "summary": "添加工单备注", "description": "在工单中追加备注信息，用于内部沟通和处理过程记录", "operationId": "addCommentUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "workOrderId", "in": "path", "description": "工单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "body", "description": "body", "required": true, "schema": { "type": "object", "additionalProperties": { "type": "string" } } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«WorkOrderVO»", "originalRef": "统一响应结果«WorkOrderVO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«WorkOrderVO»", "originalRef": "统一响应结果«WorkOrderVO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/work-order/{workOrderId}/process": { "put": { "tags": [ "工单管理" ], "summary": "处理工单（解决/驳回）", "description": "解决时需填写处理结果(resolution)，驳回时需填写驳回原因(rejectReason)。\n可调整差价(costDifference)，正数表示加价，负数表示退费\n\n【关联字典】\n- 返回字段 status → 字典：work_order_status（工单状态）", "operationId": "processUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "workOrderId", "in": "path", "description": "工单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "body", "description": "body", "required": true, "schema": { "$ref": "#/definitions/ProcessWorkOrderRequest", "originalRef": "ProcessWorkOrderRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«WorkOrderVO»", "originalRef": "统一响应结果«WorkOrderVO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«WorkOrderVO»", "originalRef": "统一响应结果«WorkOrderVO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}": { "get": { "tags": [ "管理端订单接口" ], "summary": "订单详情", "description": "返回订单完整信息，包括：基本信息、产品快照、联系人、出行人列表、支付记录、优惠明细、时间线、内部流程状态等\n\n【关联字典】\n- 返回字段 status → 字典：order_status（订单状态）\n- 返回字段 processStatus → 字典：order_process_status（订单内部流程状态）\n- 返回字段 productType → 字典：product_type（产品类型）\n- 返回字段 travelers[].travelerType → 字典：traveler_type（出行人类型）\n- 返回字段 travelers[].idCardType → 字典：id_card_type（证件类型）\n- 返回字段 travelers[].gender → 字典：gender（性别）\n- 返回字段 timeline[].action → 字典：order_timeline_action（订单操作类型）\n- 返回字段 todos[].todoType → 字典：order_todo_type（订单待办类型）", "operationId": "getOrderUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«订单详情VO»", "originalRef": "统一响应结果«订单详情VO»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«订单详情VO»", "originalRef": "统一响应结果«订单详情VO»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "put": { "tags": [ "管理端订单接口" ], "summary": "编辑订单", "description": "修改订单的联系人、人数、出发日期、售价、成本、备注等信息。\n仅传入需要修改的字段，未传入的字段不会被修改。\n\n如果提供了出行人列表(travelers)，将替换订单的全部出行人。\n已锁定的订单需先调用'申请修改'接口解锁后才能编辑\n\n【关联字典】\n- 请求参数 travelers[].travelerType → 字典：traveler_type（出行人类型）\n- 请求参数 travelers[].idCardType → 字典：id_card_type（证件类型）\n- 请求参数 travelers[].gender → 字典：gender（性别）", "operationId": "editOrderUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "updateRequest", "description": "编辑订单请求", "required": false, "schema": { "$ref": "#/definitions/管理员修改订单请求", "originalRef": "管理员修改订单请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "delete": { "tags": [ "管理端订单接口" ], "summary": "删除订单", "description": "仅待支付(PENDING_PAY)状态的订单可删除，其他状态不可删除", "operationId": "deleteOrderUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/album/folder": { "post": { "tags": [ "管理端相册接口" ], "summary": "创建相册文件夹", "description": "为订单创建旅行相册文件夹（如'第一天风景'、'合影'等），用于组织旅途照片/视频", "operationId": "createFolderUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/AlbumFolderRequest", "originalRef": "AlbumFolderRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«AlbumFolderVO»", "originalRef": "统一响应结果«AlbumFolderVO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«AlbumFolderVO»", "originalRef": "统一响应结果«AlbumFolderVO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/album/folders": { "get": { "tags": [ "管理端相册接口" ], "summary": "查询订单的文件夹列表", "description": "获取指定订单的所有相册文件夹，含文件夹名称、描述、封面图、文件数量等信息。", "operationId": "listFoldersUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«AlbumFolderVO»»", "originalRef": "统一响应结果«List«AlbumFolderVO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«AlbumFolderVO»»", "originalRef": "统一响应结果«List«AlbumFolderVO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/balance-pay-method": { "put": { "tags": [ "管理端订单接口" ], "summary": "设置尾款支付方式", "description": "设置订单尾款的支付方式。ONLINE=线上微信支付，OFFLINE=线下转账（需管理员手动记录尾款到账）", "operationId": "setBalancePayMethodUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "balancePayMethod", "in": "query", "description": "支付方式：ONLINE-线上支付, OFFLINE-线下支付", "required": true, "type": "string", "allowEmptyValue": false }, { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/cancel": { "put": { "tags": [ "管理端订单接口" ], "summary": "取消订单", "description": "管理员可取消的状态：待支付、已付定金、已全额支付、已确认、待付尾款\n\n已付款订单取消后需走退款流程", "operationId": "cancelOrderUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "cancelRequest", "description": "取消订单请求", "required": false, "schema": { "$ref": "#/definitions/管理员取消订单请求", "originalRef": "管理员取消订单请求" } }, { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/confirm": { "put": { "tags": [ "管理端订单接口" ], "summary": "确认订单", "description": "确认订单后进入内部流程：待配房 → 待配车 → 待核算 → 就绪\n\n前置条件：订单状态为已全额支付(PAID)或已付定金(DEPOSIT_PAID)", "operationId": "confirmOrderUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/customizer": { "put": { "tags": [ "订单待办接口" ], "summary": "更换定制师", "description": "将订单转派给另一位定制师。更换后原定制师的待办自动转移，订单时间线会记录此操作", "operationId": "changeCustomizerUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "body", "description": "定制师信息", "required": false, "schema": { "$ref": "#/definitions/更换定制师请求", "originalRef": "更换定制师请求" } }, { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/deposit": { "put": { "tags": [ "管理端订单接口" ], "summary": "修改定金金额", "description": "修改订单的定金金额。仅待支付(PENDING_PAY)状态可修改。\n\n定金金额不能超过订单总价，修改后影响用户支付页面显示的应付金额", "operationId": "updateDepositUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "depositRequest", "description": "修改定金金额请求", "required": false, "schema": { "$ref": "#/definitions/修改定金金额请求", "originalRef": "修改定金金额请求" } }, { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/discount": { "post": { "tags": [ "管理端订单接口" ], "summary": "添加优惠项", "description": "为订单添加手动优惠（如会员折扣、老客优惠等）。\n添加后系统自动重算订单应付金额。一个订单可添加多个优惠项", "operationId": "addDiscountUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "discountRequest", "description": "优惠项请求", "required": false, "schema": { "$ref": "#/definitions/优惠项请求", "originalRef": "优惠项请求" } }, { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«OrderDiscount»", "originalRef": "统一响应结果«OrderDiscount»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«OrderDiscount»", "originalRef": "统一响应结果«OrderDiscount»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/discount/{discountId}": { "put": { "tags": [ "管理端订单接口" ], "summary": "修改优惠项", "description": "修改已添加的优惠项名称或金额，修改后自动重算订单应付金额", "operationId": "updateDiscountUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "discountId", "in": "path", "description": "优惠项ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "discountRequest", "description": "优惠项请求", "required": false, "schema": { "$ref": "#/definitions/优惠项请求", "originalRef": "优惠项请求" } }, { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "delete": { "tags": [ "管理端订单接口" ], "summary": "删除优惠项", "description": "删除已添加的优惠项，删除后自动重算订单应付金额", "operationId": "removeDiscountUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "discountId", "in": "path", "description": "优惠项ID", "required": false, "type": "integer", "format": "int64" }, { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/hotel-assignment": { "put": { "tags": [ "管理端订单接口" ], "summary": "分配酒店信息", "description": "按家庭为订单分配具体的酒店房间（酒店名称、房型、入住/退房日期）。\n每个家庭对应一条分配记录，分配后信息将展示在订单详情和C端行程中", "operationId": "assignHotelUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/酒店分配请求", "originalRef": "酒店分配请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/add": { "post": { "tags": [ "管理端订单行程编辑" ], "summary": "新增节点", "description": "在某一天的行程中新增一个节点\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆", "operationId": "addNodeUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "新增节点请求", "required": false, "schema": { "$ref": "#/definitions/新增行程节点请求", "originalRef": "新增行程节点请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»", "originalRef": "统一响应结果«OrderItineraryEdit»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»", "originalRef": "统一响应结果«OrderItineraryEdit»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/add-day": { "post": { "tags": [ "管理端订单行程编辑" ], "summary": "新增整天行程", "description": "在订单行程中新增一整天（含多个节点）\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：ADD_DAY=新增整天\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆", "operationId": "addDayUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/新增行程天请求", "originalRef": "新增行程天请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«OrderItineraryEdit»»", "originalRef": "统一响应结果«List«OrderItineraryEdit»»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«OrderItineraryEdit»»", "originalRef": "统一响应结果«List«OrderItineraryEdit»»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/add/{editId}": { "delete": { "tags": [ "管理端订单行程编辑" ], "summary": "删除新增的节点", "description": "删除通过编辑新增的节点\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认", "operationId": "removeAddedNodeUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "editId", "in": "path", "description": "编辑记录ID", "required": false, "type": "integer", "format": "int64" }, { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "撤销原因", "required": false, "schema": { "$ref": "#/definitions/撤销行程编辑请求", "originalRef": "撤销行程编辑请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/balance-summary": { "get": { "tags": [ "管理端订单行程编辑" ], "summary": "获取尾款调整汇总", "description": "返回行程编辑产生的尾款调整明细和总额", "operationId": "getBalanceAdjustmentSummaryUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Map«string,object»»", "originalRef": "统一响应结果«Map«string,object»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Map«string,object»»", "originalRef": "统一响应结果«Map«string,object»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/confirm-all": { "post": { "tags": [ "管理端订单行程编辑" ], "summary": "批量确认所有待确认修改", "description": "确认该订单所有待确认的行程编辑\n\n**关联字典**：\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认", "operationId": "confirmAllPendingUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«int»", "originalRef": "统一响应结果«int»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«int»", "originalRef": "统一响应结果«int»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/confirm/{editId}": { "post": { "tags": [ "管理端订单行程编辑" ], "summary": "确认单条修改", "description": "确认一条待确认的行程编辑\n\n**关联字典**：\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认", "operationId": "confirmEditUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "editId", "in": "path", "description": "编辑记录ID", "required": false, "type": "integer", "format": "int64" }, { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/day/{editId}": { "delete": { "tags": [ "管理端订单行程编辑" ], "summary": "删除新增的整天行程", "description": "删除通过新增操作添加的整天行程及其所有子节点，已确认的天不允许删除\n\n**关联字典**：\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认", "operationId": "removeDayUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "editId", "in": "path", "description": "ADD_DAY编辑记录ID", "required": false, "type": "integer", "format": "int64" }, { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "删除原因", "required": false, "schema": { "$ref": "#/definitions/撤销行程编辑请求", "originalRef": "撤销行程编辑请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/edit/{editId}": { "put": { "tags": [ "管理端订单行程编辑" ], "summary": "修改编辑记录", "description": "修改待确认状态的编辑记录（如调整价格、名称等）\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆", "operationId": "updateEditUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "editId", "in": "path", "description": "编辑记录ID", "required": false, "type": "integer", "format": "int64" }, { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "updates", "description": "updates", "required": true, "schema": { "type": "object" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»", "originalRef": "统一响应结果«OrderItineraryEdit»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»", "originalRef": "统一响应结果«OrderItineraryEdit»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/edits": { "get": { "tags": [ "管理端订单行程编辑" ], "summary": "获取行程编辑记录列表", "description": "**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆", "operationId": "getEditListUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«OrderItineraryEdit»»", "originalRef": "统一响应结果«List«OrderItineraryEdit»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«OrderItineraryEdit»»", "originalRef": "统一响应结果«List«OrderItineraryEdit»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/merged": { "get": { "tags": [ "管理端订单行程编辑" ], "summary": "获取合并后的行程（原始+编辑）", "description": "**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆", "operationId": "getMergedItineraryUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«Map«string,object»»»", "originalRef": "统一响应结果«List«Map«string,object»»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«Map«string,object»»»", "originalRef": "统一响应结果«List«Map«string,object»»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/pending-count": { "get": { "tags": [ "管理端订单行程编辑" ], "summary": "获取待确认数量", "description": "返回该订单待确认的编辑数量", "operationId": "getPendingCountUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«long»", "originalRef": "统一响应结果«long»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«long»", "originalRef": "统一响应结果«long»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/pending/{editId}": { "delete": { "tags": [ "管理端订单行程编辑" ], "summary": "撤回待确认的修改", "description": "软删除一条待确认的编辑记录\n\n**关联字典**：\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认", "operationId": "withdrawPendingEditUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "editId", "in": "path", "description": "编辑记录ID", "required": false, "type": "integer", "format": "int64" }, { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": false, "schema": { "$ref": "#/definitions/撤销行程编辑请求", "originalRef": "撤销行程编辑请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/room-type-change": { "post": { "tags": [ "管理端订单行程编辑" ], "summary": "房型切换", "description": "执行房型切换，自动计算差价，创建待确认记录\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：ROOM_CHANGE=房型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：HOTEL=酒店", "operationId": "roomTypeChangeUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/房型变更请求", "originalRef": "房型变更请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»", "originalRef": "统一响应结果«OrderItineraryEdit»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»", "originalRef": "统一响应结果«OrderItineraryEdit»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/room-type-change/preview": { "post": { "tags": [ "管理端订单行程编辑" ], "summary": "房型切换差价预览", "description": "预览房型切换的差价，不创建记录\n\n**关联字典**：\n- resource_type（资源类型，返回字段resourceType）：HOTEL=酒店", "operationId": "previewRoomTypeChangeUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/房型变更请求", "originalRef": "房型变更请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«差价计算结果»", "originalRef": "统一响应结果«差价计算结果»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«差价计算结果»", "originalRef": "统一响应结果«差价计算结果»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/skip": { "post": { "tags": [ "管理端订单行程编辑" ], "summary": "跳过节点", "description": "将行程中的某个节点标记为跳过（客户不去）\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆", "operationId": "skipNodeUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "跳过节点请求", "required": false, "schema": { "$ref": "#/definitions/跳过行程节点请求", "originalRef": "跳过行程节点请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»", "originalRef": "统一响应结果«OrderItineraryEdit»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»", "originalRef": "统一响应结果«OrderItineraryEdit»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/skip/{editId}": { "delete": { "tags": [ "管理端订单行程编辑" ], "summary": "恢复跳过的节点", "description": "取消跳过，恢复为正常状态\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认", "operationId": "unskipNodeUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "editId", "in": "path", "description": "编辑记录ID", "required": false, "type": "integer", "format": "int64" }, { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "撤销原因", "required": false, "schema": { "$ref": "#/definitions/撤销行程编辑请求", "originalRef": "撤销行程编辑请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/vehicle-type-change": { "post": { "tags": [ "管理端订单行程编辑" ], "summary": "车型切换", "description": "执行车型切换，自动计算差价，创建待确认记录\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：VEHICLE=车辆", "operationId": "vehicleTypeChangeUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/车型变更请求", "originalRef": "车型变更请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»", "originalRef": "统一响应结果«OrderItineraryEdit»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»", "originalRef": "统一响应结果«OrderItineraryEdit»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/itinerary/vehicle-type-change/preview": { "post": { "tags": [ "管理端订单行程编辑" ], "summary": "车型切换差价预览", "description": "预览车型切换的差价，不创建记录\n\n**关联字典**：\n- resource_type（资源类型，返回字段resourceType）：VEHICLE=车辆", "operationId": "previewVehicleTypeChangeUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/车型变更请求", "originalRef": "车型变更请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«差价计算结果»", "originalRef": "统一响应结果«差价计算结果»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«差价计算结果»", "originalRef": "统一响应结果«差价计算结果»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/process-status": { "put": { "tags": [ "管理端订单接口" ], "summary": "推进内部流程", "description": "内部流程推进顺序：待配房(PENDING_ROOM) → 待配车(PENDING_VEHICLE) → 待核算(PENDING_FINANCE) → 就绪(READY)\n\n仅在订单状态为已确认(CONFIRMED)时有效，每次调用自动推进到下一步\n\n【关联字典】\n- 涉及字段 processStatus → 字典：order_process_status（订单内部流程状态）", "operationId": "advanceProcessStatusUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/record-balance": { "put": { "tags": [ "管理端订单接口" ], "summary": "记录尾款（线下收取）", "description": "管理员确认收到尾款 → 上传凭证。已确认(流程就绪)或待出行状态可操作", "operationId": "recordBalanceUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "body", "description": "尾款信息", "required": false, "schema": { "$ref": "#/definitions/记录尾款请求", "originalRef": "记录尾款请求" } }, { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/remark": { "post": { "tags": [ "管理端订单接口" ], "summary": "添加备注", "description": "向订单时间线添加一条管理员备注。备注会记录操作人和时间，可用于内部沟通和订单跟踪", "operationId": "addRemarkUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "remarkRequest", "description": "备注请求", "required": false, "schema": { "$ref": "#/definitions/管理员备注请求", "originalRef": "管理员备注请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/request-unlock": { "post": { "tags": [ "管理端订单接口" ], "summary": "申请修改（解锁已锁定订单）", "description": "清单确认后订单进入锁定状态，如需修改需先申请解锁\n\n解锁后可重新编辑订单信息并再次确认清单", "operationId": "requestUnlockUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "body", "description": "解锁原因", "required": false, "schema": { "$ref": "#/definitions/申请解锁订单请求", "originalRef": "申请解锁订单请求" } }, { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/room-info": { "put": { "tags": [ "管理端订单接口" ], "summary": "更新房间信息（仅房务管理员/超级管理员）", "description": "更新订单的房间分配信息（房型、房间号、入住安排等）。\n\n**权限**：仅ROOM_MANAGER（房务管理员）或SUPER_ADMIN（超级管理员）可操作。", "operationId": "updateRoomInfoUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "roomInfoRequest", "description": "房间信息请求", "required": false, "schema": { "$ref": "#/definitions/房间信息请求", "originalRef": "房间信息请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/room-info/check-diff": { "post": { "tags": [ "管理端订单接口" ], "summary": "检测房型一致性", "description": "检测当前房间配置是否与产品快照一致。返回 null 表示一致，否则返回不一致描述", "operationId": "checkRoomTypeDiffUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "roomInfoJson", "description": "roomInfoJson", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«string»", "originalRef": "统一响应结果«string»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«string»", "originalRef": "统一响应结果«string»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/status": { "put": { "tags": [ "管理端订单接口" ], "summary": "更新订单状态", "description": "合法状态流转：\n- 待支付 → 已付定金/已全额支付/已取消\n- 已付定金 → 已确认/已取消/售后中\n- 已全额支付 → 已确认/已取消/售后中\n- 已确认 → 待付尾款/待出行/已取消/售后中\n- 待付尾款 → 待出行/已取消/售后中\n- 待出行 → 旅行中/售后中\n- 旅行中 → 已完成\n- 已完成 → 售后中\n- 售后中 → 退款中\n- 退款中 → 已退款\n\n【关联字典】\n- 请求参数 status → 字典：order_status（订单状态）", "operationId": "updateStatusUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "statusRequest", "description": "更新订单状态请求", "required": false, "schema": { "$ref": "#/definitions/更新订单状态请求", "originalRef": "更新订单状态请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/todos": { "get": { "tags": [ "订单待办接口" ], "summary": "获取订单待办列表", "description": "返回指定订单的所有待办项（含已完成和未完成）。\n待办类型包括：配房、配车、签合同、购保险、核算等，随内部流程自动生成\n\n【关联字典】\n- 返回字段 todoType → 字典：order_todo_type（订单待办类型）", "operationId": "getOrderTodosUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«OrderTodo»»", "originalRef": "统一响应结果«List«OrderTodo»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«OrderTodo»»", "originalRef": "统一响应结果«List«OrderTodo»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/vehicle-assignment": { "put": { "tags": [ "管理端订单接口" ], "summary": "分配车辆信息", "description": "为订单分配具体的车辆和司机信息（车型、品牌、车牌号、司机姓名和电话）。\n分配后信息将展示在订单详情和C端行程中", "operationId": "assignVehicleUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/车辆分配请求", "originalRef": "车辆分配请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/vehicle-info": { "put": { "tags": [ "管理端订单接口" ], "summary": "更新车辆信息（仅车务管理员/超级管理员）", "description": "更新订单的车辆分配信息（车型、车牌号、司机等）。\n\n**权限**：仅VEHICLE_MANAGER（车务管理员）或SUPER_ADMIN（超级管理员）可操作。", "operationId": "updateVehicleInfoUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "vehicleInfoRequest", "description": "车辆信息请求", "required": false, "schema": { "$ref": "#/definitions/车辆信息请求", "originalRef": "车辆信息请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/{orderId}/vehicle-info/check-diff": { "post": { "tags": [ "管理端订单接口" ], "summary": "检测车型一致性", "description": "检测当前车辆配置是否与产品快照一致。返回 null 表示一致，否则返回不一致描述", "operationId": "checkVehicleTypeDiffUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "orderId", "in": "path", "description": "订单ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "vehicleInfoJson", "description": "vehicleInfoJson", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«string»", "originalRef": "统一响应结果«string»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«string»", "originalRef": "统一响应结果«string»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/refund-policy": { "post": { "tags": [ "退款政策管理" ], "summary": "创建退款政策", "description": "退款政策定义按产品类型和距出发天数的退款比例阶梯\n\n例如：出发前30天退90%，前15天退70%，前7天退50%，7天内不可退\n\n每种产品类型可配置独立的退款政策，用户申请退款时系统自动匹配\n\n【关联字典】\n- 请求参数 refundType → 字典：refund_type（退款类型）\n- 请求参数 productType → 字典：product_type（产品类型）", "operationId": "createUsingPOST_2", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "policyRequest", "description": "创建退款政策请求", "required": false, "schema": { "$ref": "#/definitions/退款政策请求", "originalRef": "退款政策请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款政策VO»", "originalRef": "统一响应结果«退款政策VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款政策VO»", "originalRef": "统一响应结果«退款政策VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/refund-policy/list": { "get": { "tags": [ "退款政策管理" ], "summary": "退款政策列表", "description": "【关联字典】\n- 返回字段 refundType → 字典：refund_type（退款类型）\n- 返回字段 productType → 字典：product_type（产品类型）", "operationId": "listUsingGET_2", "produces": [ "*/*" ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«退款政策VO»»", "originalRef": "统一响应结果«List«退款政策VO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«退款政策VO»»", "originalRef": "统一响应结果«List«退款政策VO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/refund-policy/{policyId}": { "get": { "tags": [ "退款政策管理" ], "summary": "退款政策详情", "description": "【关联字典】\n- 返回字段 refundType → 字典：refund_type（退款类型）\n- 返回字段 productType → 字典：product_type（产品类型）", "operationId": "detailUsingGET_1", "produces": [ "*/*" ], "parameters": [ { "name": "policyId", "in": "path", "description": "退款政策ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款政策VO»", "originalRef": "统一响应结果«退款政策VO»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款政策VO»", "originalRef": "统一响应结果«退款政策VO»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "put": { "tags": [ "退款政策管理" ], "summary": "修改退款政策", "description": "【关联字典】\n- 请求参数 refundType → 字典：refund_type（退款类型）\n- 请求参数 productType → 字典：product_type（产品类型）", "operationId": "updateUsingPUT_1", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "policyId", "in": "path", "description": "退款政策ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "policyRequest", "description": "修改退款政策请求", "required": false, "schema": { "$ref": "#/definitions/退款政策请求", "originalRef": "退款政策请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款政策VO»", "originalRef": "统一响应结果«退款政策VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款政策VO»", "originalRef": "统一响应结果«退款政策VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "delete": { "tags": [ "退款政策管理" ], "summary": "删除退款政策", "description": "软删除退款政策。删除后该产品类型将使用默认退款规则。不影响已使用该政策处理的历史退款申请。", "operationId": "deleteUsingDELETE_1", "produces": [ "*/*" ], "parameters": [ { "name": "policyId", "in": "path", "description": "退款政策ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/refund-policy/{policyId}/toggle": { "put": { "tags": [ "退款政策管理" ], "summary": "启用/禁用退款政策", "description": "禁用后该政策不再参与退款金额计算，对应产品类型将使用默认退款规则\n\n同一产品类型仅允许一个启用中的政策", "operationId": "toggleUsingPUT_1", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "enabled", "in": "query", "description": "是否启用", "required": false, "type": "boolean", "allowEmptyValue": false }, { "name": "policyId", "in": "path", "description": "退款政策ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/refund/list": { "get": { "tags": [ "退款管理" ], "summary": "退款申请列表", "description": "分页查询退款申请，支持按状态筛选。\n状态包括：PENDING(待审批)、APPROVED(已通过)、REJECTED(已拒绝)、REFUNDING(退款中)、REFUNDED(已退款)、CANCELLED(已撤回)、APPEAL(申诉中)\n\n【关联字典】\n- 筛选参数 status → 字典：refund_status（退款状态）\n- 返回字段 status → 字典：refund_status（退款状态）", "operationId": "listApplicationsUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "page", "in": "query", "description": "页码", "required": false, "type": "integer", "default": 1, "format": "int32", "allowEmptyValue": false }, { "name": "pageSize", "in": "query", "description": "每页条数", "required": false, "type": "integer", "default": 20, "format": "int32", "allowEmptyValue": false }, { "name": "status", "in": "query", "description": "状态", "required": false, "type": "string", "allowEmptyValue": false } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«退款申请VO»»", "originalRef": "统一响应结果«分页结果«退款申请VO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«退款申请VO»»", "originalRef": "统一响应结果«分页结果«退款申请VO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/refund/reason": { "post": { "tags": [ "退款管理" ], "summary": "创建退款原因", "description": "新增退款原因选项，C端用户申请退款时可选择。按sortOrder排序展示\n\n【关联字典】\n- 请求参数 category → 字典：refund_reason_category（退款原因分类）", "operationId": "createReasonUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "createRequest", "description": "创建退款原因请求", "required": false, "schema": { "$ref": "#/definitions/创建退款原因请求", "originalRef": "创建退款原因请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款原因VO»", "originalRef": "统一响应结果«退款原因VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款原因VO»", "originalRef": "统一响应结果«退款原因VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/refund/reason/list": { "get": { "tags": [ "退款管理" ], "summary": "退款原因列表", "description": "获取所有退款原因选项（含禁用的），用于退款原因管理页面\n\n【关联字典】\n- 返回字段 category → 字典：refund_reason_category（退款原因分类）", "operationId": "listReasonsUsingGET", "produces": [ "*/*" ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«退款原因VO»»", "originalRef": "统一响应结果«List«退款原因VO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«退款原因VO»»", "originalRef": "统一响应结果«List«退款原因VO»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/refund/reason/{reasonId}": { "put": { "tags": [ "退款管理" ], "summary": "修改退款原因", "description": "修改退款原因的文本、分类或排序，不影响已使用该原因的历史退款申请\n\n【关联字典】\n- 请求参数 category → 字典：refund_reason_category（退款原因分类）", "operationId": "updateReasonUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "reasonId", "in": "path", "description": "退款原因ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "updateRequest", "description": "修改退款原因请求", "required": false, "schema": { "$ref": "#/definitions/修改退款原因请求", "originalRef": "修改退款原因请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款原因VO»", "originalRef": "统一响应结果«退款原因VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款原因VO»", "originalRef": "统一响应结果«退款原因VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "delete": { "tags": [ "退款管理" ], "summary": "删除退款原因", "description": "软删除退款原因，删除后C端不再展示。不影响已使用该原因的历史退款申请", "operationId": "deleteReasonUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "reasonId", "in": "path", "description": "退款原因ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/refund/{applicationId}": { "get": { "tags": [ "退款管理" ], "summary": "退款申请详情", "description": "返回退款申请的完整信息，包括退款原因、申请金额、实退金额、审批记录、申诉信息等\n\n【关联字典】\n- 返回字段 status → 字典：refund_status（退款状态）", "operationId": "getDetailUsingGET_1", "produces": [ "*/*" ], "parameters": [ { "name": "applicationId", "in": "path", "description": "退款申请ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款申请VO»", "originalRef": "统一响应结果«退款申请VO»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款申请VO»", "originalRef": "统一响应结果«退款申请VO»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/refund/{applicationId}/complete": { "put": { "tags": [ "退款管理" ], "summary": "手动完成退款", "description": "用于测试订单或线下退款场景。将处于'退款中'状态的退款申请直接标记为'已退款'", "operationId": "manualCompleteUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "applicationId", "in": "path", "description": "退款申请ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款申请VO»", "originalRef": "统一响应结果«退款申请VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款申请VO»", "originalRef": "统一响应结果«退款申请VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/refund/{applicationId}/execute-appeal": { "put": { "tags": [ "退款管理" ], "summary": "申诉通过后执行退款", "description": "申诉退款流程：用户发起申诉 → 企微OA审批 → 审批通过后管理员确认实退金额 → 调起微信退款", "operationId": "executeAppealUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "appealRequest", "description": "申诉退款执行请求", "required": false, "schema": { "$ref": "#/definitions/申诉退款执行请求", "originalRef": "申诉退款执行请求" } }, { "name": "applicationId", "in": "path", "description": "退款申请ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款申请VO»", "originalRef": "统一响应结果«退款申请VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款申请VO»", "originalRef": "统一响应结果«退款申请VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/order/refund/{applicationId}/review": { "put": { "tags": [ "退款管理" ], "summary": "审批退款申请", "description": "退款审批流程：查看退款申请 → 决定通过/拒绝 → 通过时填写实退金额 → 系统自动调起微信退款\n\n拒绝后用户可发起申诉\n\n【关联字典】\n- 返回字段 status → 字典：refund_status（退款状态）", "operationId": "reviewUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "applicationId", "in": "path", "description": "退款申请ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "reviewRequest", "description": "审批退款请求", "required": false, "schema": { "$ref": "#/definitions/管理员退款审批请求", "originalRef": "管理员退款审批请求" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款申请VO»", "originalRef": "统一响应结果«退款申请VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«退款申请VO»", "originalRef": "统一响应结果«退款申请VO»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } } }, "definitions": { "AlbumFileAddRequest": { "type": "object", "properties": { "customLocation": { "type": "string", "description": "自定义地点文本（地点类型为CUSTOM时）" }, "description": { "type": "string", "description": "文件描述" }, "fileId": { "type": "integer", "format": "int64", "description": "文件ID（来自file_info）" }, "fileType": { "type": "string", "description": "文件类型: IMAGE/VIDEO" }, "locationType": { "type": "string", "description": "地点类型: RESOURCE/CUSTOM" }, "ossUrl": { "type": "string", "description": "文件访问URL" }, "resourceId": { "type": "integer", "format": "int64", "description": "资源ID（地点类型为RESOURCE时）" }, "resourceName": { "type": "string", "description": "资源名称（地点类型为RESOURCE时）" }, "resourceType": { "type": "string", "description": "资源类型（地点类型为RESOURCE时）" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序号" }, "thumbnailUrl": { "type": "string", "description": "缩略图URL" } }, "title": "AlbumFileAddRequest" }, "AlbumFileBatchAddRequest": { "type": "object", "properties": { "files": { "type": "array", "description": "文件列表", "items": { "$ref": "#/definitions/AlbumFileAddRequest", "originalRef": "AlbumFileAddRequest" } } }, "title": "AlbumFileBatchAddRequest" }, "AlbumFileUpdateRequest": { "type": "object", "properties": { "customLocation": { "type": "string", "description": "自定义地点文本" }, "description": { "type": "string", "description": "文件描述" }, "locationType": { "type": "string", "description": "地点类型: RESOURCE/CUSTOM" }, "resourceId": { "type": "integer", "format": "int64", "description": "资源ID" }, "resourceName": { "type": "string", "description": "资源名称" }, "resourceType": { "type": "string", "description": "资源类型" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序号" } }, "title": "AlbumFileUpdateRequest" }, "AlbumFileVO": { "type": "object", "properties": { "albumFileId": { "type": "integer", "format": "int64", "description": "相册文件ID" }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间" }, "createdBy": { "type": "integer", "format": "int64", "description": "上传人ID" }, "customLocation": { "type": "string", "description": "自定义地点文本" }, "description": { "type": "string", "description": "文件描述" }, "fileId": { "type": "integer", "format": "int64", "description": "文件ID" }, "fileType": { "type": "string", "description": "文件类型: IMAGE/VIDEO" }, "folderId": { "type": "integer", "format": "int64", "description": "所属文件夹ID" }, "locationText": { "type": "string", "description": "地点显示文本" }, "locationType": { "type": "string", "description": "地点类型: RESOURCE/CUSTOM" }, "ossUrl": { "type": "string", "description": "文件访问URL" }, "resourceId": { "type": "integer", "format": "int64", "description": "资源ID" }, "resourceName": { "type": "string", "description": "资源名称" }, "resourceType": { "type": "string", "description": "资源类型" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序号" }, "thumbnailUrl": { "type": "string", "description": "缩略图URL" } }, "title": "AlbumFileVO" }, "AlbumFolderRequest": { "type": "object", "properties": { "folderName": { "type": "string", "description": "文件夹名称" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序号" } }, "title": "AlbumFolderRequest" }, "AlbumFolderVO": { "type": "object", "properties": { "coverThumbnailUrl": { "type": "string", "description": "封面缩略图URL" }, "coverUrl": { "type": "string", "description": "封面文件URL" }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间" }, "createdBy": { "type": "integer", "format": "int64", "description": "创建人ID" }, "fileCount": { "type": "integer", "format": "int32", "description": "文件数量" }, "folderId": { "type": "integer", "format": "int64", "description": "文件夹ID" }, "folderName": { "type": "string", "description": "文件夹名称" }, "orderId": { "type": "integer", "format": "int64", "description": "关联订单ID" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序号" } }, "title": "AlbumFolderVO" }, "CreateWorkOrderRequest": { "type": "object", "required": [ "description", "orderId", "priority", "type" ], "properties": { "assigneeAdminId": { "type": "integer", "format": "int64", "description": "指定处理人ID" }, "assigneeName": { "type": "string", "description": "指定处理人姓名" }, "attachmentUrls": { "type": "string", "description": "附件URL(JSON数组)" }, "costDifference": { "type": "number", "description": "差价(正数=客户需补差价, 负数=需退费给客户)" }, "description": { "type": "string", "description": "问题描述" }, "orderId": { "type": "integer", "format": "int64", "description": "关联订单ID" }, "priority": { "type": "string", "description": "优先级: URGENT(紧急，如当天出发需处理)/NORMAL(普通)" }, "resourceDetail": { "type": "string", "description": "资源详情JSON(酒店/车辆/景点信息)" }, "type": { "type": "string", "description": "工单类型: ROOM_CHANGE(换房)/ROOM_ADD(加房)/CHECKOUT_CHANGE(改退房日期)/HOTEL_ISSUE(酒店问题)/VEHICLE_CHANGE(换车)/SCENIC_ADD(加景点)/SCENIC_REMOVE(减景点)/OTHER(其他)" } }, "title": "CreateWorkOrderRequest" }, "Map«string,object»": { "type": "object", "title": "Map«string,object»", "additionalProperties": { "type": "object" } }, "Map«string,object»_1": { "type": "object", "title": "Map«string,object»_1", "additionalProperties": { "type": "object" } }, "Map«string,object»_2": { "type": "object", "title": "Map«string,object»_2", "additionalProperties": { "type": "object" } }, "OrderDiscount": { "type": "object", "properties": { "createTime": { "type": "string", "format": "date-time", "description": "创建时间" }, "deletedAt": { "type": "string", "format": "date-time", "description": "删除时间（软删除）" }, "discountAmount": { "type": "number", "description": "优惠金额" }, "discountId": { "type": "integer", "format": "int64", "description": "优惠ID" }, "discountName": { "type": "string", "description": "优惠名称" }, "orderId": { "type": "integer", "format": "int64", "description": "订单ID" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间" } }, "title": "OrderDiscount" }, "OrderItineraryEdit": { "type": "object", "properties": { "action": { "type": "string", "description": "操作类型：SKIP/ADD" }, "balanceAdjustment": { "type": "number", "description": "尾款调整金额（正数=增加尾款，负数=减少尾款）" }, "changeDays": { "type": "integer", "format": "int32", "description": "变更天数" }, "changeReasonCode": { "type": "string", "description": "变更原因代码（字典项）" }, "changeReasonLabel": { "type": "string", "description": "变更原因标签" }, "confirmStatus": { "type": "string", "description": "确认状态：PENDING_CONFIRM/CONFIRMED" }, "confirmedAt": { "type": "string", "format": "date-time", "description": "确认时间" }, "confirmedBy": { "type": "integer", "format": "int64", "description": "确认人ID" }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间" }, "dayNumber": { "type": "integer", "format": "int32", "description": "行程天数编号" }, "deletedAt": { "type": "string", "format": "date-time", "description": "删除时间（软删除）" }, "description": { "type": "string", "description": "节点描述（ADD时）" }, "editId": { "type": "integer", "format": "int64", "description": "编辑ID" }, "newResourceName": { "type": "string", "description": "新资源名称（房型/车型）" }, "newUnitPrice": { "type": "number", "description": "新单价（日均）" }, "nodeId": { "type": "string", "description": "原节点ID（SKIP时必填）" }, "nodeName": { "type": "string", "description": "节点名称（ADD时）" }, "nodeType": { "type": "string", "description": "节点类型（ADD时）" }, "operatorId": { "type": "integer", "format": "int64", "description": "操作人ID" }, "operatorName": { "type": "string", "description": "操作人姓名" }, "orderId": { "type": "integer", "format": "int64", "description": "订单ID" }, "originalResourceName": { "type": "string", "description": "原资源名称（房型/车型）" }, "originalUnitPrice": { "type": "number", "description": "原单价（日均）" }, "reason": { "type": "string", "description": "修改原因" }, "resourceId": { "type": "integer", "format": "int64", "description": "关联资源ID" }, "resourceType": { "type": "string", "description": "关联资源类型：SCENIC_SPOT/ACTIVITY/RESTAURANT/HOTEL/VEHICLE" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序序号（ADD时）" }, "startTime": { "type": "string", "description": "开始时间（ADD时）" }, "suggestedAdjustment": { "type": "number", "description": "系统建议差价" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间" } }, "title": "OrderItineraryEdit" }, "OrderTimeline": { "type": "object", "properties": { "action": { "type": "string", "description": "操作动作" }, "content": { "type": "string", "description": "操作内容" }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间" }, "deletedAt": { "type": "string", "format": "date-time", "description": "删除时间（软删除）" }, "operatorId": { "type": "integer", "format": "int64", "description": "操作人ID" }, "operatorName": { "type": "string", "description": "操作人姓名" }, "operatorType": { "type": "string", "description": "操作人类型：USER=用户 ADMIN=管理员 SYSTEM=系统" }, "orderId": { "type": "integer", "format": "int64", "description": "订单ID" }, "timelineId": { "type": "integer", "format": "int64", "description": "时间线ID" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间" } }, "title": "OrderTimeline" }, "OrderTodo": { "type": "object", "properties": { "assigneeAdminId": { "type": "integer", "format": "int64", "description": "指派管理员ID" }, "assigneeRoleKey": { "type": "string", "description": "指派角色Key" }, "completedAt": { "type": "string", "format": "date-time", "description": "完成时间" }, "completedBy": { "type": "integer", "format": "int64", "description": "完成人ID" }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间" }, "deletedAt": { "type": "string", "format": "date-time", "description": "删除时间（软删除）" }, "lastNotifiedAt": { "type": "string", "format": "date-time", "description": "最后通知时间" }, "notificationCount": { "type": "integer", "format": "int32", "description": "通知次数" }, "orderId": { "type": "integer", "format": "int64", "description": "订单ID" }, "orderNo": { "type": "string", "description": "订单编号" }, "sequence": { "type": "integer", "format": "int32", "description": "排序序号" }, "status": { "type": "string", "description": "待办状态" }, "todoId": { "type": "integer", "format": "int64", "description": "待办ID" }, "todoLabel": { "type": "string", "description": "待办标签" }, "todoType": { "type": "string", "description": "待办类型" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间" } }, "title": "OrderTodo" }, "OrderTraveler": { "type": "object", "properties": { "birthday": { "type": "string", "format": "date", "description": "出生日期" }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间" }, "deletedAt": { "type": "string", "format": "date-time", "description": "删除时间（软删除）" }, "email": { "type": "string", "description": "邮箱地址" }, "emergencyContact": { "type": "string", "description": "紧急联系人姓名" }, "emergencyPhone": { "type": "string", "description": "紧急联系人电话（加密存储）" }, "gender": { "type": "integer", "format": "int32", "description": "性别（字典：gender）" }, "idCardNo": { "type": "string", "description": "证件号码（加密存储）" }, "idCardType": { "type": "string", "description": "证件类型（字典：id_card_type）" }, "name": { "type": "string", "description": "出行人姓名" }, "nationality": { "type": "string", "description": "国籍" }, "orderId": { "type": "integer", "format": "int64", "description": "订单ID" }, "orderTravelerId": { "type": "integer", "format": "int64", "description": "出行人记录ID" }, "phone": { "type": "string", "description": "手机号码（加密存储）" }, "travelerType": { "type": "string", "description": "出行人类型（字典：traveler_type）" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间" } }, "title": "OrderTraveler" }, "PrevDayHotel": { "type": "object", "properties": { "hotelId": { "type": "integer", "format": "int64", "description": "酒店ID" }, "hotelName": { "type": "string", "description": "酒店名称" }, "roomTypeId": { "type": "integer", "format": "int64", "description": "房型ID" }, "roomTypeName": { "type": "string", "description": "房型名称" } }, "title": "PrevDayHotel" }, "ProcessWorkOrderRequest": { "type": "object", "required": [ "action" ], "properties": { "action": { "type": "string", "description": "操作: RESOLVE(解决) / REJECT(驳回)" }, "costDifference": { "type": "number", "description": "调整后差价" }, "rejectReason": { "type": "string", "description": "驳回原因(驳回时填写)" }, "resolution": { "type": "string", "description": "处理结果(解决时填写)" } }, "title": "ProcessWorkOrderRequest" }, "WorkOrderVO": { "type": "object", "properties": { "assigneeAdminId": { "type": "string", "description": "处理人ID" }, "assigneeName": { "type": "string", "description": "处理人姓名" }, "attachmentUrls": { "type": "string", "description": "附件URL(JSON数组)" }, "costDifference": { "type": "number", "description": "差价" }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间" }, "creatorAdminId": { "type": "string", "description": "发起人ID" }, "creatorName": { "type": "string", "description": "发起人姓名" }, "description": { "type": "string", "description": "问题描述" }, "logs": { "type": "array", "description": "操作日志列表", "items": { "$ref": "#/definitions/工单操作日志VO", "originalRef": "工单操作日志VO" } }, "orderId": { "type": "string", "description": "关联订单ID" }, "orderNo": { "type": "string", "description": "关联订单编号" }, "priority": { "type": "string", "description": "优先级" }, "priorityLabel": { "type": "string", "description": "优先级标签" }, "rejectReason": { "type": "string", "description": "驳回原因" }, "resolution": { "type": "string", "description": "处理结果" }, "resolvedAt": { "type": "string", "format": "date-time", "description": "处理完成时间" }, "resourceDetail": { "type": "string", "description": "资源详情JSON" }, "status": { "type": "string", "description": "状态" }, "statusLabel": { "type": "string", "description": "状态标签" }, "type": { "type": "string", "description": "工单类型" }, "typeLabel": { "type": "string", "description": "工单类型标签" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间" }, "workOrderId": { "type": "string", "description": "工单ID" }, "workOrderNo": { "type": "string", "description": "工单编号" } }, "title": "WorkOrderVO" }, "优惠项请求": { "type": "object", "required": [ "discountAmount", "discountName" ], "properties": { "discountAmount": { "type": "number", "example": 100.0, "description": "优惠金额" }, "discountName": { "type": "string", "example": "会员折扣", "description": "优惠项目名称" } }, "title": "优惠项请求" }, "修改定金金额请求": { "type": "object", "required": [ "amount" ], "properties": { "amount": { "type": "number", "example": 500.0, "description": "定金金额" } }, "title": "修改定金金额请求" }, "修改订单过期时间请求": { "type": "object", "required": [ "minutes" ], "properties": { "minutes": { "type": "integer", "format": "int32", "example": 30, "description": "过期时间（分钟）" } }, "title": "修改订单过期时间请求" }, "出行人信息": { "type": "object", "required": [ "birthday", "name" ], "properties": { "birthday": { "type": "string", "format": "date", "example": "1990-01-01", "description": "出生日期（必填，后端根据此字段自动判断人员类型）" }, "email": { "type": "string", "example": "lisi@example.com", "description": "电子邮箱" }, "emergencyContact": { "type": "string", "example": "王五", "description": "紧急联系人" }, "emergencyPhone": { "type": "string", "example": 13800138002, "description": "紧急联系电话" }, "gender": { "type": "integer", "format": "int32", "example": 1, "description": "性别（字典：gender）" }, "idCardNo": { "type": "string", "example": 110101199001011234, "description": "证件号码" }, "idCardType": { "type": "string", "example": "ID_CARD", "description": "证件类型（字典：id_card_type）" }, "name": { "type": "string", "example": "李四", "description": "出行人姓名" }, "nationality": { "type": "string", "example": "中国", "description": "国籍" }, "phone": { "type": "string", "example": 13800138001, "description": "手机号" } }, "title": "出行人信息" }, "分页结果«AlbumFileVO»": { "type": "object", "properties": { "page": { "type": "integer", "format": "int32", "example": 1, "description": "当前页码" }, "pageSize": { "type": "integer", "format": "int32", "example": 20, "description": "每页条数" }, "records": { "type": "array", "description": "数据列表", "items": { "$ref": "#/definitions/AlbumFileVO", "originalRef": "AlbumFileVO" } }, "total": { "type": "integer", "format": "int32", "example": 100, "description": "总记录数" } }, "title": "分页结果«AlbumFileVO»" }, "分页结果«WorkOrderVO»": { "type": "object", "properties": { "page": { "type": "integer", "format": "int32", "example": 1, "description": "当前页码" }, "pageSize": { "type": "integer", "format": "int32", "example": 20, "description": "每页条数" }, "records": { "type": "array", "description": "数据列表", "items": { "$ref": "#/definitions/WorkOrderVO", "originalRef": "WorkOrderVO" } }, "total": { "type": "integer", "format": "int32", "example": 100, "description": "总记录数" } }, "title": "分页结果«WorkOrderVO»" }, "分页结果«早鸟优惠计划VO»": { "type": "object", "properties": { "page": { "type": "integer", "format": "int32", "example": 1, "description": "当前页码" }, "pageSize": { "type": "integer", "format": "int32", "example": 20, "description": "每页条数" }, "records": { "type": "array", "description": "数据列表", "items": { "$ref": "#/definitions/早鸟优惠计划VO", "originalRef": "早鸟优惠计划VO" } }, "total": { "type": "integer", "format": "int32", "example": 100, "description": "总记录数" } }, "title": "分页结果«早鸟优惠计划VO»" }, "分页结果«管理员订单列表VO»": { "type": "object", "properties": { "page": { "type": "integer", "format": "int32", "example": 1, "description": "当前页码" }, "pageSize": { "type": "integer", "format": "int32", "example": 20, "description": "每页条数" }, "records": { "type": "array", "description": "数据列表", "items": { "$ref": "#/definitions/管理员订单列表VO", "originalRef": "管理员订单列表VO" } }, "total": { "type": "integer", "format": "int32", "example": 100, "description": "总记录数" } }, "title": "分页结果«管理员订单列表VO»" }, "单项酒店分配": { "type": "object", "required": [ "checkInDate", "checkOutDate", "familyIndex", "hotelName", "roomType" ], "properties": { "checkInDate": { "type": "string", "description": "入住日期(yyyy-MM-dd)" }, "checkOutDate": { "type": "string", "description": "退房日期(yyyy-MM-dd)" }, "familyIndex": { "type": "integer", "format": "int32", "description": "家庭序号" }, "hotelName": { "type": "string", "description": "酒店名称" }, "roomType": { "type": "string", "description": "房型" } }, "title": "单项酒店分配" }, "工单操作日志VO": { "type": "object", "properties": { "action": { "type": "string", "description": "操作动作" }, "actionLabel": { "type": "string", "description": "操作动作标签" }, "content": { "type": "string", "description": "操作内容" }, "createdAt": { "type": "string", "format": "date-time", "description": "操作时间" }, "logId": { "type": "string", "description": "日志ID" }, "operatorName": { "type": "string", "description": "操作人姓名" } }, "title": "工单操作日志VO" }, "差价计算结果": { "type": "object", "properties": { "changeDays": { "type": "integer", "format": "int32", "description": "变更天数" }, "description": { "type": "string", "description": "差价描述（中文说明）" }, "direction": { "type": "string", "description": "差价方向：UPGRADE=升级加价, DOWNGRADE=降级减价, SAME=价格不变" }, "newName": { "type": "string", "description": "新资源名称" }, "newUnitPrice": { "type": "number", "description": "新单价（日均）" }, "originalName": { "type": "string", "description": "原资源名称" }, "originalUnitPrice": { "type": "number", "description": "原单价（日均）" }, "priceDiff": { "type": "number", "description": "差价金额（正数=需补款，负数=可退款）" } }, "title": "差价计算结果" }, "房型变更请求": { "type": "object", "required": [ "dayNumber", "newRoomTypeId", "originalRoomTypeId", "reason" ], "properties": { "balanceAdjustment": { "type": "number", "example": 200.0, "description": "尾款调整金额（可选，覆盖系统建议差价；正数=增加尾款，负数=减少尾款）" }, "changeReasonCode": { "type": "string", "description": "变更原因代码（字典项 order_change_reason）" }, "dayNumber": { "type": "integer", "format": "int32", "example": 1, "description": "行程天数编号" }, "newRoomTypeId": { "type": "integer", "format": "int64", "description": "新房型ID" }, "originalRoomTypeId": { "type": "integer", "format": "int64", "description": "原房型ID" }, "reason": { "type": "string", "example": "客户要求升级房型", "description": "变更原因" }, "roomCount": { "type": "integer", "format": "int32", "example": 2, "description": "房间数量" } }, "title": "房型变更请求" }, "房间信息请求": { "type": "object", "required": [ "roomInfo" ], "properties": { "roomInfo": { "type": "string", "example": "标准双人间2间，大床房1间", "description": "房间信息" } }, "title": "房间信息请求" }, "报价预览请求": { "type": "object", "required": [ "departureDate", "productId" ], "properties": { "adultCount": { "type": "integer", "format": "int32", "example": 2, "description": "成人数" }, "babyCount": { "type": "integer", "format": "int32", "example": 0, "description": "幼童数" }, "childCount": { "type": "integer", "format": "int32", "example": 0, "description": "儿童数" }, "childNeedBed": { "type": "boolean", "example": false, "description": "儿童是否需要床位" }, "departureDate": { "type": "string", "format": "date", "example": "2026-05-01", "description": "出发日期" }, "productId": { "type": "integer", "format": "int64", "example": 1760000000000001, "description": "产品ID" }, "youngChildCount": { "type": "integer", "format": "int32", "example": 0, "description": "小童数" } }, "title": "报价预览请求" }, "撤销行程编辑请求": { "type": "object", "required": [ "reason" ], "properties": { "reason": { "type": "string", "example": "客户改主意了", "description": "撤销原因" } }, "title": "撤销行程编辑请求" }, "新增行程天请求": { "type": "object", "required": [ "dayNumber", "dayTitle", "reason" ], "properties": { "dayNumber": { "type": "integer", "format": "int32", "example": 3, "description": "行程天数编号（插入位置，后续天数自动顺延）" }, "dayTitle": { "type": "string", "example": "第三天：丽江古城自由行", "description": "天标题" }, "nodes": { "type": "array", "description": "该天的行程节点列表", "items": { "$ref": "#/definitions/新增行程节点请求", "originalRef": "新增行程节点请求" } }, "prevDayHotel": { "description": "前一天住宿配置（原最后一天无住宿，新增天数后需配置）", "$ref": "#/definitions/PrevDayHotel", "originalRef": "PrevDayHotel" }, "reason": { "type": "string", "example": "客户要求增加一天自由行", "description": "变更原因" } }, "title": "新增行程天请求" }, "新增行程节点请求": { "type": "object", "required": [ "nodeName", "nodeType" ], "properties": { "balanceAdjustment": { "type": "number", "example": 200.0, "description": "尾款调整金额（正数=增加尾款，负数=减少尾款）" }, "dayNumber": { "type": "integer", "format": "int32", "example": 1, "description": "行程天数编号（独立调用时必填，addDay子节点时自动继承）" }, "description": { "type": "string", "description": "节点描述" }, "nodeName": { "type": "string", "description": "节点名称" }, "nodeType": { "type": "string", "description": "节点类型：SCENIC/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE/FREE/NOTE" }, "reason": { "type": "string", "example": "客户要求增加该景点", "description": "修改原因（独立调用时必填，addDay子节点时自动继承）" }, "resourceId": { "type": "integer", "format": "int64", "description": "关联资源ID" }, "resourceType": { "type": "string", "description": "关联资源类型：SCENIC_SPOT/ACTIVITY/RESTAURANT/HOTEL/VEHICLE" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序序号（插入位置，默认追加到末尾）" }, "startTime": { "type": "string", "description": "开始时间" } }, "title": "新增行程节点请求" }, "早鸟优惠计划VO": { "type": "object", "properties": { "createTime": { "type": "string", "format": "date-time", "description": "创建时间" }, "createdBy": { "type": "integer", "format": "int64", "description": "创建人ID" }, "discountAmount": { "type": "number", "description": "优惠金额" }, "enabled": { "type": "boolean", "description": "是否启用" }, "endDate": { "type": "string", "format": "date", "description": "生效结束日期" }, "minPeople": { "type": "integer", "format": "int32", "description": "最低人数" }, "planId": { "type": "integer", "format": "int64", "description": "计划ID" }, "planName": { "type": "string", "description": "计划名称" }, "remark": { "type": "string", "description": "备注" }, "startDate": { "type": "string", "format": "date", "description": "生效开始日期" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间" } }, "title": "早鸟优惠计划VO" }, "早鸟优惠计划请求": { "type": "object", "required": [ "discountAmount", "endDate", "minPeople", "planName", "startDate" ], "properties": { "discountAmount": { "type": "number", "example": 200.0, "description": "优惠金额（从订单总价中扣减的固定金额）" }, "endDate": { "type": "string", "format": "date", "example": "2026-04-15", "description": "生效结束日期" }, "minPeople": { "type": "integer", "format": "int32", "example": 2, "description": "最低出行人数（含成人+儿童），订单人数>=此值才能享受优惠" }, "planName": { "type": "string", "example": "五一早鸟优惠", "description": "计划名称" }, "remark": { "type": "string", "example": "仅限新用户", "description": "备注" }, "startDate": { "type": "string", "format": "date", "example": "2026-03-01", "description": "生效开始日期" } }, "title": "早鸟优惠计划请求" }, "更换定制师请求": { "type": "object", "required": [ "customizerId" ], "properties": { "customizerId": { "type": "integer", "format": "int64", "description": "定制师ID" } }, "title": "更换定制师请求" }, "更新订单状态请求": { "type": "object", "required": [ "status" ], "properties": { "status": { "type": "string", "example": "CONFIRMED", "description": "目标状态。可选值：PENDING_PAY(待支付)/DEPOSIT_PAID(已付定金)/PAID(已全额支付)/CONFIRMED(已确认)/PENDING_BALANCE(待付尾款)/PENDING_DEPARTURE(待出行)/TRAVELLING(旅行中)/COMPLETED(已完成)/AFTER_SALE(售后中)/REFUNDING(退款中)/REFUNDED(已退款)/CANCELLED(已取消)" } }, "title": "更新订单状态请求" }, "申请解锁订单请求": { "type": "object", "properties": { "reason": { "type": "string", "description": "解锁原因" } }, "title": "申请解锁订单请求" }, "管理员修改订单请求": { "type": "object", "properties": { "adultCount": { "type": "integer", "format": "int32", "example": 2, "description": "成人数" }, "babyCount": { "type": "integer", "format": "int32", "example": 0, "description": "幼童数" }, "childCount": { "type": "integer", "format": "int32", "example": 1, "description": "儿童数" }, "contactName": { "type": "string", "example": "张三", "description": "联系人姓名" }, "contactPhone": { "type": "string", "example": 13800138000, "description": "联系人电话" }, "departureDate": { "type": "string", "format": "date", "example": "2026-05-01", "description": "出发日期" }, "depositAmount": { "type": "number", "example": 2000.0, "description": "定金金额" }, "mchId": { "type": "string", "example": 1246532201, "description": "商户号（微信支付商户号，多商户场景使用）" }, "remark": { "type": "string", "example": "客户要求安排靠窗座位", "description": "备注" }, "totalCost": { "type": "number", "example": 5000.0, "description": "总成本" }, "totalPrice": { "type": "number", "example": 8000.0, "description": "总售价" }, "travelers": { "type": "array", "description": "出行人列表（如提供则替换全部出行人，不传则不修改出行人）", "items": { "$ref": "#/definitions/出行人信息", "originalRef": "出行人信息" } }, "youngChildCount": { "type": "integer", "format": "int32", "example": 0, "description": "小童数" } }, "title": "管理员修改订单请求" }, "管理员创建订单请求": { "type": "object", "required": [ "contactName", "contactPhone", "productId" ], "properties": { "adultCount": { "type": "integer", "format": "int32", "example": 2, "description": "成人数" }, "babyCount": { "type": "integer", "format": "int32", "example": 0, "description": "幼童数" }, "childCount": { "type": "integer", "format": "int32", "example": 0, "description": "儿童数" }, "childNeedBed": { "type": "boolean", "example": false, "description": "儿童是否需要床位（影响房间分配和报价计算）" }, "contactName": { "type": "string", "example": "张三", "description": "联系人姓名" }, "contactPhone": { "type": "string", "example": 13800138000, "description": "联系人电话" }, "customizerId": { "type": "integer", "format": "int64", "example": 1760000000000010, "description": "定制师ID（可选，默认为创建人）" }, "departureDate": { "type": "string", "format": "date", "example": "2026-05-01", "description": "出发日期(GROUP产品可不传，从团期获取)" }, "expiryMinutes": { "type": "integer", "format": "int32", "example": 30, "description": "支付时限（分钟），不传则使用全局默认值。超时未支付订单自动取消" }, "groupBatchId": { "type": "integer", "format": "int64", "description": "团期ID(GROUP产品必填)" }, "productId": { "type": "integer", "format": "int64", "example": 1760000000000001, "description": "产品ID" }, "remark": { "type": "string", "example": "客户VIP", "description": "备注" }, "roomCount": { "type": "integer", "format": "int32", "example": 1, "description": "房间数(GROUP产品，默认1)" }, "travelers": { "type": "array", "description": "出行人列表", "items": { "$ref": "#/definitions/出行人信息", "originalRef": "出行人信息" } }, "userPhone": { "type": "string", "example": 13800138000, "description": "用户手机号（可选，用于关联C端用户）。如匹配到已注册用户则自动绑定订单" }, "youngChildCount": { "type": "integer", "format": "int32", "example": 0, "description": "小童数" } }, "title": "管理员创建订单请求" }, "管理员取消订单请求": { "type": "object", "required": [ "reason" ], "properties": { "reason": { "type": "string", "example": "客户主动取消", "description": "取消原因" }, "refundAmount": { "type": "number", "example": 500.0, "description": "退款金额（可选，不传则按退款政策自动计算；传0表示不退款）" } }, "title": "管理员取消订单请求" }, "管理员基本信息": { "type": "object", "properties": { "adminId": { "type": "integer", "format": "int64", "description": "管理员ID" }, "avatarUrl": { "type": "string", "description": "头像URL" }, "username": { "type": "string", "description": "用户名" }, "wechatName": { "type": "string", "description": "企微用户名称" }, "wechatUserid": { "type": "string", "description": "企微用户ID" } }, "title": "管理员基本信息" }, "管理员备注请求": { "type": "object", "required": [ "content" ], "properties": { "content": { "type": "string", "example": "客户要求加急处理", "description": "备注内容" } }, "title": "管理员备注请求" }, "管理员订单列表VO": { "type": "object", "properties": { "adultCount": { "type": "integer", "format": "int32", "description": "成人数" }, "babyCount": { "type": "integer", "format": "int32", "description": "幼童数" }, "balanceAmount": { "type": "number", "description": "尾款金额（DEPOSIT模式：总售价-定金-优惠）" }, "childCount": { "type": "integer", "format": "int32", "description": "儿童数" }, "contactName": { "type": "string", "description": "联系人姓名" }, "contactPhone": { "type": "string", "description": "联系人电话" }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间" }, "creatorAdminId": { "type": "integer", "format": "int64", "description": "创建人管理员ID" }, "customizerName": { "type": "string", "description": "定制师名称" }, "daysUntilDeparture": { "type": "integer", "format": "int32", "description": "距出发天数（负数表示已出发）" }, "departureDate": { "type": "string", "format": "date", "description": "出发日期" }, "depositAmount": { "type": "number", "description": "定金金额" }, "discountAmount": { "type": "number", "description": "优惠金额" }, "mchId": { "type": "string", "description": "商户号" }, "orderId": { "type": "integer", "format": "int64", "description": "订单ID" }, "orderNo": { "type": "string", "description": "订单号" }, "paidAmount": { "type": "number", "description": "已付金额" }, "paymentMode": { "type": "string", "description": "支付模式（字典：payment_mode）" }, "processStatus": { "type": "string", "description": "内部流程状态（字典：order_process_status）" }, "processStatusLabel": { "type": "string", "description": "内部流程状态标签（字典：order_process_status 翻译）" }, "productCoverUrl": { "type": "string", "description": "产品封面图URL" }, "productId": { "type": "integer", "format": "int64", "description": "产品ID" }, "productName": { "type": "string", "description": "产品名称" }, "productType": { "type": "string", "description": "产品类型（字典：product_type）" }, "status": { "type": "string", "description": "订单状态（字典：order_status）" }, "statusLabel": { "type": "string", "description": "订单状态标签（字典：order_status 翻译）" }, "totalPrice": { "type": "number", "description": "总售价" }, "tripDays": { "type": "integer", "format": "int32", "description": "行程天数" }, "tripNights": { "type": "integer", "format": "int32", "description": "行程晚数" }, "userId": { "type": "integer", "format": "int64", "description": "用户ID" }, "youngChildCount": { "type": "integer", "format": "int32", "description": "小童数" } }, "title": "管理员订单列表VO" }, "统一响应结果«AlbumFileVO»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/AlbumFileVO", "originalRef": "AlbumFileVO" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«AlbumFileVO»" }, "统一响应结果«AlbumFolderVO»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/AlbumFolderVO", "originalRef": "AlbumFolderVO" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«AlbumFolderVO»" }, "统一响应结果«List«AlbumFileVO»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "type": "array", "description": "响应数据", "items": { "$ref": "#/definitions/AlbumFileVO", "originalRef": "AlbumFileVO" } }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«List«AlbumFileVO»»" }, "统一响应结果«List«AlbumFolderVO»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "type": "array", "description": "响应数据", "items": { "$ref": "#/definitions/AlbumFolderVO", "originalRef": "AlbumFolderVO" } }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«List«AlbumFolderVO»»" }, "统一响应结果«List«Map«string,object»»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "type": "array", "description": "响应数据", "items": { "$ref": "#/definitions/Map«string,object»", "originalRef": "Map«string,object»" } }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«List«Map«string,object»»»" }, "统一响应结果«List«OrderItineraryEdit»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "type": "array", "description": "响应数据", "items": { "$ref": "#/definitions/OrderItineraryEdit", "originalRef": "OrderItineraryEdit" } }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«List«OrderItineraryEdit»»" }, "统一响应结果«List«OrderTodo»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "type": "array", "description": "响应数据", "items": { "$ref": "#/definitions/OrderTodo", "originalRef": "OrderTodo" } }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«List«OrderTodo»»" }, "统一响应结果«List«管理员基本信息»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "type": "array", "description": "响应数据", "items": { "$ref": "#/definitions/管理员基本信息", "originalRef": "管理员基本信息" } }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«List«管理员基本信息»»" }, "统一响应结果«List«订单待办VO»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "type": "array", "description": "响应数据", "items": { "$ref": "#/definitions/订单待办VO", "originalRef": "订单待办VO" } }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«List«订单待办VO»»" }, "统一响应结果«Map«string,object»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "type": "object", "description": "响应数据" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«Map«string,object»»" }, "统一响应结果«OrderDiscount»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/OrderDiscount", "originalRef": "OrderDiscount" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«OrderDiscount»" }, "统一响应结果«OrderItineraryEdit»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/OrderItineraryEdit", "originalRef": "OrderItineraryEdit" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«OrderItineraryEdit»" }, "统一响应结果«Void»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«Void»" }, "统一响应结果«WorkOrderVO»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/WorkOrderVO", "originalRef": "WorkOrderVO" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«WorkOrderVO»" }, "统一响应结果«int»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "type": "integer", "format": "int32", "description": "响应数据" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«int»" }, "统一响应结果«long»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "type": "integer", "format": "int64", "description": "响应数据" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«long»" }, "统一响应结果«string»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "type": "string", "description": "响应数据" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«string»" }, "统一响应结果«分页结果«AlbumFileVO»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/分页结果«AlbumFileVO»", "originalRef": "分页结果«AlbumFileVO»" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«分页结果«AlbumFileVO»»" }, "统一响应结果«分页结果«WorkOrderVO»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/分页结果«WorkOrderVO»", "originalRef": "分页结果«WorkOrderVO»" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«分页结果«WorkOrderVO»»" }, "统一响应结果«分页结果«早鸟优惠计划VO»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/分页结果«早鸟优惠计划VO»", "originalRef": "分页结果«早鸟优惠计划VO»" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«分页结果«早鸟优惠计划VO»»" }, "统一响应结果«分页结果«管理员订单列表VO»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/分页结果«管理员订单列表VO»", "originalRef": "分页结果«管理员订单列表VO»" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«分页结果«管理员订单列表VO»»" }, "统一响应结果«差价计算结果»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/差价计算结果", "originalRef": "差价计算结果" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«差价计算结果»" }, "统一响应结果«早鸟优惠计划VO»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/早鸟优惠计划VO", "originalRef": "早鸟优惠计划VO" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«早鸟优惠计划VO»" }, "统一响应结果«订单详情VO»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/订单详情VO", "originalRef": "订单详情VO" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«订单详情VO»" }, "订单待办VO": { "type": "object", "properties": { "assigneeAdminId": { "type": "integer", "format": "int64", "description": "负责管理员ID" }, "assigneeRoleKey": { "type": "string", "description": "负责角色标识" }, "blocked": { "type": "boolean", "description": "是否阻塞" }, "blockedReason": { "type": "string", "description": "阻塞原因" }, "completedAt": { "type": "string", "format": "date-time", "description": "完成时间" }, "completedBy": { "type": "integer", "format": "int64", "description": "完成人ID" }, "contactName": { "type": "string", "description": "联系人姓名（关联查询）" }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间" }, "departureDate": { "type": "string", "format": "date", "description": "出发日期（关联查询）" }, "orderId": { "type": "integer", "format": "int64", "description": "订单ID" }, "orderNo": { "type": "string", "description": "订单号" }, "orderStatus": { "type": "string", "description": "订单状态（关联查询）" }, "productName": { "type": "string", "description": "产品名称（关联查询）" }, "sequence": { "type": "integer", "format": "int32", "description": "排序序号" }, "status": { "type": "string", "description": "待办状态" }, "todoId": { "type": "integer", "format": "int64", "description": "待办ID" }, "todoLabel": { "type": "string", "description": "待办名称" }, "todoType": { "type": "string", "description": "待办类型" } }, "title": "订单待办VO" }, "订单详情VO": { "type": "object", "properties": { "adultCount": { "type": "integer", "format": "int32", "description": "成人数" }, "babyCount": { "type": "integer", "format": "int32", "description": "幼童数" }, "balanceAmount": { "type": "number", "description": "尾款金额（总售价-定金）" }, "balancePayMethod": { "type": "string", "description": "尾款支付方式: ONLINE=线上微信支付 OFFLINE=线下转账" }, "balanceProofUrl": { "type": "string", "description": "尾款凭证URL" }, "cancelReason": { "type": "string", "description": "取消原因" }, "cancelledAt": { "type": "string", "format": "date-time", "description": "取消时间" }, "checklistConfirmed": { "type": "boolean", "description": "清单确认状态" }, "childCount": { "type": "integer", "format": "int32", "description": "儿童数" }, "completedAt": { "type": "string", "format": "date-time", "description": "完成时间" }, "confirmedAt": { "type": "string", "format": "date-time", "description": "确认时间" }, "contactName": { "type": "string", "description": "联系人姓名" }, "contactPhone": { "type": "string", "description": "联系人电话" }, "contracts": { "type": "array", "description": "合同列表（含signUrl/fileUrl/status等）", "items": { "$ref": "#/definitions/Map«string,object»", "originalRef": "Map«string,object»" } }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间" }, "creatorAdminId": { "type": "integer", "format": "int64", "description": "创建人管理员ID" }, "creatorName": { "type": "string", "description": "创建人姓名" }, "customizerId": { "type": "integer", "format": "int64", "description": "定制师ID" }, "customizerName": { "type": "string", "description": "定制师姓名" }, "departureDate": { "type": "string", "format": "date", "description": "出发日期" }, "depositAmount": { "type": "number", "description": "定金金额" }, "depositRatio": { "type": "integer", "format": "int32", "description": "定金比例" }, "discountAmount": { "type": "number", "description": "优惠金额" }, "discountReason": { "type": "string", "description": "优惠原因" }, "discounts": { "type": "array", "description": "优惠列表", "items": { "$ref": "#/definitions/OrderDiscount", "originalRef": "OrderDiscount" } }, "displayStatus": { "type": "string", "description": "前端显示状态（字典：order_display_status）" }, "displayStatusLabel": { "type": "string", "description": "前端显示状态标签（字典：order_display_status 翻译）" }, "expiryMinutes": { "type": "integer", "format": "int32", "description": "支付时限（分钟）" }, "expiryTime": { "type": "string", "format": "date-time", "description": "支付截止时间" }, "hotelAssignments": { "type": "string", "description": "酒店分配信息JSON" }, "insurances": { "type": "array", "description": "保险订单列表（含productName/extPolicyNo/status/startDate/endDate等）", "items": { "$ref": "#/definitions/Map«string,object»", "originalRef": "Map«string,object»" } }, "mchId": { "type": "string", "description": "商户号" }, "orderId": { "type": "integer", "format": "int64", "description": "订单ID" }, "orderNo": { "type": "string", "description": "订单号" }, "paidAmount": { "type": "number", "description": "已付金额" }, "paidAt": { "type": "string", "format": "date-time", "description": "支付时间" }, "payMethodLabel": { "type": "string", "description": "支付方式标签（如：微信支付、定金微信+尾款线下）" }, "paymentMode": { "type": "string", "description": "支付模式（字典：payment_mode）" }, "processStatus": { "type": "string", "description": "内部流程状态（字典：order_process_status）" }, "processStatusLabel": { "type": "string", "description": "内部流程状态标签（字典：order_process_status 翻译）" }, "productCoverUrl": { "type": "string", "description": "产品封面图URL" }, "productId": { "type": "integer", "format": "int64", "description": "产品ID" }, "productName": { "type": "string", "description": "产品名称" }, "productSnapshot": { "type": "string", "description": "产品快照JSON" }, "productType": { "type": "string", "description": "产品类型（字典：product_type）" }, "readyAt": { "type": "string", "format": "date-time", "description": "就绪时间" }, "refundAmount": { "type": "number", "description": "退款金额（实退金额）" }, "remark": { "type": "string", "description": "备注" }, "returnDate": { "type": "string", "format": "date", "description": "返程日期（出发日期 + 行程天数 - 1）" }, "reviewed": { "type": "boolean", "description": "是否已评价" }, "roomInfo": { "type": "string", "description": "房间信息" }, "sharerOpenid": { "type": "string", "description": "分享人微信openid" }, "status": { "type": "string", "description": "订单状态（字典：order_status）" }, "statusLabel": { "type": "string", "description": "订单状态标签（字典：order_status 翻译）" }, "timeline": { "type": "array", "description": "时间线列表", "items": { "$ref": "#/definitions/OrderTimeline", "originalRef": "OrderTimeline" } }, "todos": { "type": "array", "description": "待办列表", "items": { "$ref": "#/definitions/OrderTodo", "originalRef": "OrderTodo" } }, "totalCost": { "type": "number", "description": "总成本（仅管理员可见）" }, "totalPrice": { "type": "number", "description": "总售价" }, "travelers": { "type": "array", "description": "出行人列表", "items": { "$ref": "#/definitions/OrderTraveler", "originalRef": "OrderTraveler" } }, "tripDays": { "type": "integer", "format": "int32", "description": "行程天数" }, "tripNights": { "type": "integer", "format": "int32", "description": "行程晚数" }, "unlockRequestedAt": { "type": "string", "format": "date-time", "description": "解锁请求时间" }, "userId": { "type": "integer", "format": "int64", "description": "用户ID" }, "vehicleInfo": { "type": "string", "description": "车辆信息" }, "youngChildCount": { "type": "integer", "format": "int32", "description": "小童数" } }, "title": "订单详情VO" }, "记录尾款请求": { "type": "object", "properties": { "proofUrl": { "type": "string", "description": "支付凭证URL" }, "remark": { "type": "string", "description": "备注" } }, "title": "记录尾款请求" }, "跳过行程节点请求": { "type": "object", "required": [ "dayNumber", "nodeId", "reason" ], "properties": { "balanceAdjustment": { "type": "number", "example": -120.0, "description": "尾款调整金额（正数=增加尾款，负数=减少尾款）" }, "dayNumber": { "type": "integer", "format": "int32", "example": 1, "description": "行程天数编号" }, "nodeId": { "type": "string", "description": "节点ID" }, "nodeName": { "type": "string", "example": "蒙古族小型冰雪那达慕", "description": "节点名称" }, "reason": { "type": "string", "example": "客户不想去该景点", "description": "修改原因" } }, "title": "跳过行程节点请求" }, "车型变更请求": { "type": "object", "required": [ "newVehicleId", "originalVehicleId", "reason" ], "properties": { "balanceAdjustment": { "type": "number", "example": 300.0, "description": "尾款调整金额（可选，覆盖系统建议差价；正数=增加尾款，负数=减少尾款）" }, "changeReasonCode": { "type": "string", "description": "变更原因代码（字典项 order_change_reason）" }, "newVehicleId": { "type": "integer", "format": "int64", "description": "新车辆ID" }, "originalVehicleId": { "type": "integer", "format": "int64", "description": "原车辆ID" }, "reason": { "type": "string", "example": "原车辆已被预订", "description": "变更原因" } }, "title": "车型变更请求" }, "车辆信息请求": { "type": "object", "required": [ "vehicleInfo" ], "properties": { "vehicleInfo": { "type": "string", "example": "7座商务车1辆，司机张师傅", "description": "车辆信息" } }, "title": "车辆信息请求" }, "车辆分配请求": { "type": "object", "required": [ "vehicleBrand", "vehicleModel" ], "properties": { "driverName": { "type": "string", "description": "司机姓名" }, "driverPhone": { "type": "string", "description": "司机电话" }, "plateNumber": { "type": "string", "description": "车牌号" }, "vehicleBrand": { "type": "string", "description": "品牌" }, "vehicleModel": { "type": "string", "description": "车型" } }, "title": "车辆分配请求" }, "酒店分配请求": { "type": "object", "required": [ "assignments" ], "properties": { "assignments": { "type": "array", "description": "酒店分配列表", "items": { "$ref": "#/definitions/单项酒店分配", "originalRef": "单项酒店分配" } } }, "title": "酒店分配请求" }, "修改退款原因请求": { "type": "object", "properties": { "category": { "type": "string", "example": "用户原因", "description": "分类" }, "reasonText": { "type": "string", "example": "行程有变", "description": "退款原因文本" }, "sortOrder": { "type": "integer", "format": "int32", "example": 1, "description": "排序号" } }, "title": "修改退款原因请求" }, "分页结果«退款申请VO»": { "type": "object", "properties": { "page": { "type": "integer", "format": "int32", "example": 1, "description": "当前页码" }, "pageSize": { "type": "integer", "format": "int32", "example": 20, "description": "每页条数" }, "records": { "type": "array", "description": "数据列表", "items": { "$ref": "#/definitions/退款申请VO", "originalRef": "退款申请VO" } }, "total": { "type": "integer", "format": "int32", "example": 100, "description": "总记录数" } }, "title": "分页结果«退款申请VO»" }, "创建退款原因请求": { "type": "object", "required": [ "reasonText" ], "properties": { "category": { "type": "string", "example": "用户原因", "description": "分类" }, "reasonText": { "type": "string", "example": "行程有变", "description": "退款原因文本" }, "sortOrder": { "type": "integer", "format": "int32", "example": 1, "description": "排序号" } }, "title": "创建退款原因请求" }, "申诉退款执行请求": { "type": "object", "required": [ "actualAmount" ], "properties": { "actualAmount": { "type": "number", "example": 1500.0, "description": "实际退款金额" }, "remark": { "type": "string", "example": "申诉通过，按协商金额退款", "description": "备注" } }, "title": "申诉退款执行请求" }, "管理员退款审批请求": { "type": "object", "required": [ "action" ], "properties": { "action": { "type": "string", "example": "APPROVE", "description": "审批结果：APPROVE=通过（自动调起微信退款）、REJECT=拒绝（用户可发起申诉）" }, "actualAmount": { "type": "number", "example": 1500.0, "description": "实际退款金额（审批通过时可调整，不传则使用申请金额）。不能超过订单已付金额" }, "remark": { "type": "string", "example": "同意全额退款", "description": "审批备注" } }, "title": "管理员退款审批请求" }, "统一响应结果«List«退款原因VO»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "type": "array", "description": "响应数据", "items": { "$ref": "#/definitions/退款原因VO", "originalRef": "退款原因VO" } }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«List«退款原因VO»»" }, "统一响应结果«List«退款政策VO»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "type": "array", "description": "响应数据", "items": { "$ref": "#/definitions/退款政策VO", "originalRef": "退款政策VO" } }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«List«退款政策VO»»" }, "统一响应结果«分页结果«退款申请VO»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/分页结果«退款申请VO»", "originalRef": "分页结果«退款申请VO»" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«分页结果«退款申请VO»»" }, "统一响应结果«退款原因VO»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/退款原因VO", "originalRef": "退款原因VO" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«退款原因VO»" }, "统一响应结果«退款政策VO»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/退款政策VO", "originalRef": "退款政策VO" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«退款政策VO»" }, "统一响应结果«退款申请VO»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/退款申请VO", "originalRef": "退款申请VO" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«退款申请VO»" }, "退款原因VO": { "type": "object", "properties": { "category": { "type": "string", "description": "原因分类" }, "enabled": { "type": "boolean", "description": "是否启用" }, "reasonId": { "type": "integer", "format": "int64", "description": "原因ID" }, "reasonText": { "type": "string", "description": "原因描述" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序序号" } }, "title": "退款原因VO" }, "退款政策VO": { "type": "object", "properties": { "createTime": { "type": "string", "format": "date-time", "description": "创建时间" }, "createdBy": { "type": "integer", "format": "int64", "description": "创建人ID" }, "enabled": { "type": "boolean", "description": "是否启用" }, "endDate": { "type": "string", "format": "date", "description": "生效结束日期" }, "isDefault": { "type": "boolean", "description": "是否为默认政策" }, "policyId": { "type": "integer", "format": "int64", "description": "政策ID" }, "policyName": { "type": "string", "description": "政策名称" }, "refundType": { "type": "string", "description": "退款类型" }, "remark": { "type": "string", "description": "备注" }, "rules": { "type": "array", "description": "退款规则列表", "items": { "$ref": "#/definitions/退款规则VO", "originalRef": "退款规则VO" } }, "startDate": { "type": "string", "format": "date", "description": "生效开始日期" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间" } }, "title": "退款政策VO" }, "退款政策请求": { "type": "object", "required": [ "policyName", "refundType", "rules" ], "properties": { "endDate": { "type": "string", "format": "date", "example": "2026-12-31", "description": "生效结束日期" }, "isDefault": { "type": "boolean", "example": false, "description": "是否为默认政策" }, "policyName": { "type": "string", "example": "国内游退款政策", "description": "政策名称" }, "refundType": { "type": "string", "example": "FULL_REFUND", "description": "退款类型" }, "remark": { "type": "string", "example": "适用于所有国内游产品", "description": "备注" }, "rules": { "type": "array", "description": "退款规则列表", "items": { "$ref": "#/definitions/退款规则项", "originalRef": "退款规则项" } }, "startDate": { "type": "string", "format": "date", "example": "2026-01-01", "description": "生效开始日期" } }, "title": "退款政策请求" }, "退款申请VO": { "type": "object", "properties": { "actualAmount": { "type": "number", "description": "实际退款金额" }, "appealAmount": { "type": "number", "description": "申诉退款金额" }, "appealReason": { "type": "string", "description": "申诉原因" }, "appealStatus": { "type": "integer", "format": "int32", "description": "申诉状态: 1-处理中 2-通过 3-驳回" }, "appealStatusLabel": { "type": "string", "description": "申诉状态标签" }, "appealedAt": { "type": "string", "format": "date-time", "description": "申诉时间" }, "applicantId": { "type": "integer", "format": "int64", "description": "申请人ID" }, "applicantName": { "type": "string", "description": "申请人姓名" }, "applicantType": { "type": "string", "description": "申请人类型（USER/ADMIN）" }, "applicationId": { "type": "integer", "format": "int64", "description": "申请ID" }, "approvalNo": { "type": "string", "description": "审批编号" }, "calculatedAmount": { "type": "number", "description": "计算退款金额" }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间" }, "daysBeforeDept": { "type": "integer", "format": "int32", "description": "距出发天数" }, "departureDate": { "type": "string", "format": "date", "description": "出发日期" }, "orderId": { "type": "integer", "format": "int64", "description": "订单ID" }, "orderNo": { "type": "string", "description": "订单号" }, "paidAmount": { "type": "number", "description": "已付金额" }, "policyId": { "type": "integer", "format": "int64", "description": "退款政策ID" }, "policyName": { "type": "string", "description": "退款政策名称" }, "productName": { "type": "string", "description": "产品名称" }, "reasonDetail": { "type": "string", "description": "补充说明" }, "reasonId": { "type": "integer", "format": "int64", "description": "退款原因ID" }, "reasonText": { "type": "string", "description": "退款原因" }, "refundRatio": { "type": "integer", "format": "int32", "description": "退款比例（百分比）" }, "refundType": { "type": "string", "description": "退款类型（字典：refund_type）" }, "refundTypeLabel": { "type": "string", "description": "退款类型标签（字典：refund_type 翻译）" }, "refundedAt": { "type": "string", "format": "date-time", "description": "退款完成时间" }, "reviewAdminId": { "type": "integer", "format": "int64", "description": "审批管理员ID" }, "reviewAdminName": { "type": "string", "description": "审批管理员姓名" }, "reviewRemark": { "type": "string", "description": "审批备注" }, "reviewedAt": { "type": "string", "format": "date-time", "description": "审批时间" }, "status": { "type": "string", "description": "退款状态（字典：refund_status）" }, "statusLabel": { "type": "string", "description": "退款状态标签（字典：refund_status 翻译）" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间" } }, "title": "退款申请VO" }, "退款规则VO": { "type": "object", "properties": { "minDays": { "type": "integer", "format": "int32", "description": "距出发最少天数" }, "refundRatio": { "type": "integer", "format": "int32", "description": "退款比例（百分比）" }, "ruleId": { "type": "integer", "format": "int64", "description": "规则ID" } }, "title": "退款规则VO" }, "退款规则项": { "type": "object", "required": [ "minDays", "refundRatio" ], "properties": { "minDays": { "type": "integer", "format": "int32", "example": 7, "description": "距出发最少天数（含当天）。例如：minDays=7表示出发前7天及以上适用此规则" }, "refundRatio": { "type": "integer", "format": "int32", "example": 80, "description": "退款比例（百分比，0-100）。例如：80表示退已付金额的80%" } }, "title": "退款规则项" } } }