12836 行
364 KiB
JSON
12836 行
364 KiB
JSON
{
|
||
"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": "contactPhone",
|
||
"in": "query",
|
||
"description": "联系电话",
|
||
"required": false,
|
||
"type": "string",
|
||
"x-example": "13800138000"
|
||
},
|
||
{
|
||
"name": "createTimeEnd",
|
||
"in": "query",
|
||
"description": "下单时间结束（yyyy-MM-dd HH:mm:ss）",
|
||
"required": false,
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"x-example": "2026-03-31 23:59:59"
|
||
},
|
||
{
|
||
"name": "createTimeStart",
|
||
"in": "query",
|
||
"description": "下单时间起始（yyyy-MM-dd HH:mm:ss）",
|
||
"required": false,
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"x-example": "2026-03-01 00:00:00"
|
||
},
|
||
{
|
||
"name": "customizerName",
|
||
"in": "query",
|
||
"description": "定制师名称（模糊搜索）",
|
||
"required": false,
|
||
"type": "string",
|
||
"x-example": "王骁"
|
||
},
|
||
{
|
||
"name": "departureDateEnd",
|
||
"in": "query",
|
||
"description": "出发日期结束（yyyy-MM-dd）",
|
||
"required": false,
|
||
"type": "string",
|
||
"format": "date",
|
||
"x-example": "2026-03-31"
|
||
},
|
||
{
|
||
"name": "departureDateStart",
|
||
"in": "query",
|
||
"description": "出发日期起始（yyyy-MM-dd）",
|
||
"required": false,
|
||
"type": "string",
|
||
"format": "date",
|
||
"x-example": "2026-03-01"
|
||
},
|
||
{
|
||
"name": "keyword",
|
||
"in": "query",
|
||
"description": "搜索关键词（订单号/联系人姓名/产品名称）",
|
||
"required": false,
|
||
"type": "string",
|
||
"x-example": "HL2026"
|
||
},
|
||
{
|
||
"name": "mchId",
|
||
"in": "query",
|
||
"description": "商户号（字典：mch_id）",
|
||
"required": false,
|
||
"type": "string",
|
||
"x-example": "shanhe"
|
||
},
|
||
{
|
||
"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}/available-hotels": {
|
||
"get": {
|
||
"tags": [
|
||
"管理端订单接口"
|
||
],
|
||
"summary": "配房可选酒店列表",
|
||
"description": "返回所有启用酒店列表，标注该订单产品快照中指定行程天包含的酒店（inSnapshot=true），并将快照酒店排在最前面。\n用于管理员配房时选择酒店，快照中的酒店是产品行程已安排的住宿，应优先选择。\n\n**必须传 dayIndex 参数**（行程第几天，从1开始），因为每天的酒店可能不同。\n\n返回字段说明：\n- hotelId：酒店ID\n- hotelName：酒店名称\n- inSnapshot：是否在该天产品快照中（true=该天行程已安排的酒店）",
|
||
"operationId": "getAvailableHotelsUsingGET",
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "dayIndex",
|
||
"in": "query",
|
||
"description": "行程第几天（从1开始）",
|
||
"required": true,
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"allowEmptyValue": false
|
||
},
|
||
{
|
||
"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}/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每天每个家庭一条记录，包含酒店ID、房型ID、日期和备注。\n\n**房型升级自动处理**：如果分配的房型与产品默认房型不同，系统自动计算差价并创建升级记录。\n- 定制师操作：自动确认，差价直接计入总售价\n- 其他角色操作：创建待确认记录（临时计入尾款），通知定制师确认\n- 可通过 upgradePrice 字段手动覆盖系统计算的差价",
|
||
"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}/hotel-assignment/preview": {
|
||
"post": {
|
||
"tags": [
|
||
"管理端订单接口"
|
||
],
|
||
"summary": "配房升级差价预览",
|
||
"description": "预览配房时的房型升级差价（不创建记录）。\n逐天比较分配房型与产品默认房型（CORE产品默认标间），返回每天差价明细和汇总。\n前端可据此展示差价信息，用户确认后再调用分配接口。",
|
||
"operationId": "previewHotelAssignmentUsingPOST",
|
||
"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/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}/surcharge": {
|
||
"post": {
|
||
"tags": [
|
||
"管理端订单接口"
|
||
],
|
||
"summary": "添加费用增加项",
|
||
"description": "为订单添加费用增加项（如升级房型补差价、加座费等）。\n添加后系统自动重算订单尾款金额。\n\n**权限**：仅该订单的定制师或超级管理员(SUPER_ADMIN)可操作",
|
||
"operationId": "addSurchargeUsingPOST",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "orderId",
|
||
"in": "path",
|
||
"description": "订单ID",
|
||
"required": false,
|
||
"type": "integer",
|
||
"format": "int64"
|
||
},
|
||
{
|
||
"in": "body",
|
||
"name": "surchargeRequest",
|
||
"description": "费用增加项请求",
|
||
"required": false,
|
||
"schema": {
|
||
"$ref": "#/definitions/费用增加项请求",
|
||
"originalRef": "费用增加项请求"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/统一响应结果«OrderSurcharge»",
|
||
"originalRef": "统一响应结果«OrderSurcharge»"
|
||
}
|
||
},
|
||
"201": {
|
||
"description": "Created"
|
||
},
|
||
"401": {
|
||
"description": "Unauthorized"
|
||
},
|
||
"403": {
|
||
"description": "Forbidden"
|
||
},
|
||
"404": {
|
||
"description": "Not Found"
|
||
}
|
||
},
|
||
"responsesObject": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/统一响应结果«OrderSurcharge»",
|
||
"originalRef": "统一响应结果«OrderSurcharge»"
|
||
}
|
||
},
|
||
"201": {
|
||
"description": "Created"
|
||
},
|
||
"401": {
|
||
"description": "Unauthorized"
|
||
},
|
||
"403": {
|
||
"description": "Forbidden"
|
||
},
|
||
"404": {
|
||
"description": "Not Found"
|
||
}
|
||
},
|
||
"deprecated": false,
|
||
"x-order": "2147483647"
|
||
}
|
||
},
|
||
"/admin/order/{orderId}/surcharge/{surchargeId}": {
|
||
"put": {
|
||
"tags": [
|
||
"管理端订单接口"
|
||
],
|
||
"summary": "修改费用增加项",
|
||
"description": "修改已添加的费用增加项名称或金额，修改后自动重算订单尾款金额。\n\n**权限**：仅该订单的定制师或超级管理员(SUPER_ADMIN)可操作",
|
||
"operationId": "updateSurchargeUsingPUT",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "orderId",
|
||
"in": "path",
|
||
"description": "订单ID",
|
||
"required": false,
|
||
"type": "integer",
|
||
"format": "int64"
|
||
},
|
||
{
|
||
"name": "surchargeId",
|
||
"in": "path",
|
||
"description": "费用增加项ID",
|
||
"required": false,
|
||
"type": "integer",
|
||
"format": "int64"
|
||
},
|
||
{
|
||
"in": "body",
|
||
"name": "surchargeRequest",
|
||
"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": "删除已添加的费用增加项，删除后自动重算订单尾款金额。\n\n**权限**：仅该订单的定制师或超级管理员(SUPER_ADMIN)可操作",
|
||
"operationId": "removeSurchargeUsingDELETE",
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "orderId",
|
||
"in": "path",
|
||
"description": "订单ID",
|
||
"required": false,
|
||
"type": "integer",
|
||
"format": "int64"
|
||
},
|
||
{
|
||
"name": "surchargeId",
|
||
"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}/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}/transport": {
|
||
"get": {
|
||
"tags": [
|
||
"管理端订单接口"
|
||
],
|
||
"summary": "查询交通信息",
|
||
"description": "查询订单的所有交通信息（航班/车次），按排序序号和出发时间升序排列",
|
||
"operationId": "getTransportUsingGET",
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "orderId",
|
||
"in": "path",
|
||
"description": "订单ID",
|
||
"required": false,
|
||
"type": "integer",
|
||
"format": "int64"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/统一响应结果«List«OrderTransportSegment»»",
|
||
"originalRef": "统一响应结果«List«OrderTransportSegment»»"
|
||
}
|
||
},
|
||
"401": {
|
||
"description": "Unauthorized"
|
||
},
|
||
"403": {
|
||
"description": "Forbidden"
|
||
},
|
||
"404": {
|
||
"description": "Not Found"
|
||
}
|
||
},
|
||
"responsesObject": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/统一响应结果«List«OrderTransportSegment»»",
|
||
"originalRef": "统一响应结果«List«OrderTransportSegment»»"
|
||
}
|
||
},
|
||
"401": {
|
||
"description": "Unauthorized"
|
||
},
|
||
"403": {
|
||
"description": "Forbidden"
|
||
},
|
||
"404": {
|
||
"description": "Not Found"
|
||
}
|
||
},
|
||
"deprecated": false,
|
||
"x-order": "2147483647"
|
||
},
|
||
"put": {
|
||
"tags": [
|
||
"管理端订单接口"
|
||
],
|
||
"summary": "保存交通信息（航班/车次）",
|
||
"description": "为订单保存交通信息，支持多条航班和车次。每次提交为全量替换（先删后增）。\n\n**使用场景**：管理员为订单录入去程/回程的航班号或车次号、出发/到达站点和时间。\n一个订单可以有多条交通记录（如：去程航班+回程航班+市内火车等）。\n\n【关联字典】\n- 请求参数 segments[].transportType → 字典：transport_type（交通类型：FLIGHT-航班, TRAIN-火车）",
|
||
"operationId": "saveTransportUsingPUT",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "orderId",
|
||
"in": "path",
|
||
"description": "订单ID",
|
||
"required": false,
|
||
"type": "integer",
|
||
"format": "int64"
|
||
},
|
||
{
|
||
"in": "body",
|
||
"name": "transportRequest",
|
||
"description": "交通信息请求",
|
||
"required": false,
|
||
"schema": {
|
||
"$ref": "#/definitions/交通信息请求（批量保存）",
|
||
"originalRef": "交通信息请求（批量保存）"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/统一响应结果«List«OrderTransportSegment»»",
|
||
"originalRef": "统一响应结果«List«OrderTransportSegment»»"
|
||
}
|
||
},
|
||
"201": {
|
||
"description": "Created"
|
||
},
|
||
"401": {
|
||
"description": "Unauthorized"
|
||
},
|
||
"403": {
|
||
"description": "Forbidden"
|
||
},
|
||
"404": {
|
||
"description": "Not Found"
|
||
}
|
||
},
|
||
"responsesObject": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/统一响应结果«List«OrderTransportSegment»»",
|
||
"originalRef": "统一响应结果«List«OrderTransportSegment»»"
|
||
}
|
||
},
|
||
"201": {
|
||
"description": "Created"
|
||
},
|
||
"401": {
|
||
"description": "Unauthorized"
|
||
},
|
||
"403": {
|
||
"description": "Forbidden"
|
||
},
|
||
"404": {
|
||
"description": "Not Found"
|
||
}
|
||
},
|
||
"deprecated": false,
|
||
"x-order": "2147483647"
|
||
}
|
||
},
|
||
"/admin/order/{orderId}/travelers": {
|
||
"get": {
|
||
"tags": [
|
||
"管理端订单接口"
|
||
],
|
||
"summary": "获取订单出行人列表",
|
||
"description": "返回指定订单的所有出行人信息，用于保险投保时自动填充被保人。\n\n**权限**：需管理员登录\n\n**关联字典**：\n- 返回字段 travelerType → 字典：traveler_type（出行人类型）\n- 返回字段 idCardType → 字典：id_card_type（证件类型）\n- 返回字段 gender → 字典：gender（性别）",
|
||
"operationId": "getOrderTravelersUsingGET",
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "orderId",
|
||
"in": "path",
|
||
"description": "订单ID",
|
||
"required": false,
|
||
"type": "integer",
|
||
"format": "int64"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/统一响应结果«List«OrderTraveler»»",
|
||
"originalRef": "统一响应结果«List«OrderTraveler»»"
|
||
}
|
||
},
|
||
"401": {
|
||
"description": "Unauthorized"
|
||
},
|
||
"403": {
|
||
"description": "Forbidden"
|
||
},
|
||
"404": {
|
||
"description": "Not Found"
|
||
}
|
||
},
|
||
"responsesObject": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/统一响应结果«List«OrderTraveler»»",
|
||
"originalRef": "统一响应结果«List«OrderTraveler»»"
|
||
}
|
||
},
|
||
"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创建后需在产品设计时绑定，产品未绑定退款政策时使用默认政策",
|
||
"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/enabled": {
|
||
"get": {
|
||
"tags": [
|
||
"退款政策管理"
|
||
],
|
||
"summary": "启用的退款政策列表",
|
||
"description": "仅返回启用状态的政策，供产品设计时选择绑定",
|
||
"operationId": "listEnabledUsingGET",
|
||
"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/list": {
|
||
"get": {
|
||
"tags": [
|
||
"退款政策管理"
|
||
],
|
||
"summary": "退款政策列表",
|
||
"description": "返回所有退款政策（含禁用），按默认→创建时间倒序",
|
||
"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": "退款政策详情",
|
||
"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": "修改退款政策",
|
||
"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": "禁用后不再出现在产品设计的可选列表中，已绑定的产品申请退款时降级使用默认政策",
|
||
"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"
|
||
}
|
||
},
|
||
"/admin/invoice/page": {
|
||
"get": {
|
||
"tags": [
|
||
"发票管理"
|
||
],
|
||
"summary": "发票分页列表",
|
||
"description": "分页查询发票申请列表，支持按状态、订单号、用户ID筛选。\n\n【关联字典】\n- 筛选参数 status → 字典：invoice_status（发票状态）：PENDING=待开票, ISSUED=已开票, FAILED=开票失败, VOIDED=已作废\n- 返回字段 titleType → 字典：invoice_title_type（抬头类型）：PERSONAL=个人, COMPANY=企业\n- 返回字段 status → 字典：invoice_status（发票状态）",
|
||
"operationId": "pageInvoicesUsingGET",
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "orderNo",
|
||
"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": "status",
|
||
"in": "query",
|
||
"description": "发票状态（字典：invoice_status）",
|
||
"required": false,
|
||
"type": "string",
|
||
"x-example": "PENDING"
|
||
},
|
||
{
|
||
"name": "userId",
|
||
"in": "query",
|
||
"description": "用户ID",
|
||
"required": false,
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"x-example": 1760000000000001
|
||
}
|
||
],
|
||
"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/invoice/upload": {
|
||
"post": {
|
||
"tags": [
|
||
"发票管理"
|
||
],
|
||
"summary": "上传发票文件",
|
||
"description": "上传发票PDF/图片文件，返回文件访问URL。\n上传成功后，将返回的fileUrl传给「开票完成」接口即可。\n\n【支持格式】PDF、JPG、PNG\n【大小限制】10MB",
|
||
"operationId": "uploadInvoiceFileUsingPOST",
|
||
"consumes": [
|
||
"multipart/form-data"
|
||
],
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "file",
|
||
"in": "formData",
|
||
"description": "发票文件（PDF/JPG/PNG）",
|
||
"required": false,
|
||
"type": "file"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/统一响应结果«Map«string,string»»",
|
||
"originalRef": "统一响应结果«Map«string,string»»"
|
||
}
|
||
},
|
||
"201": {
|
||
"description": "Created"
|
||
},
|
||
"401": {
|
||
"description": "Unauthorized"
|
||
},
|
||
"403": {
|
||
"description": "Forbidden"
|
||
},
|
||
"404": {
|
||
"description": "Not Found"
|
||
}
|
||
},
|
||
"responsesObject": {
|
||
"200": {
|
||
"description": "OK",
|
||
"schema": {
|
||
"$ref": "#/definitions/统一响应结果«Map«string,string»»",
|
||
"originalRef": "统一响应结果«Map«string,string»»"
|
||
}
|
||
},
|
||
"201": {
|
||
"description": "Created"
|
||
},
|
||
"401": {
|
||
"description": "Unauthorized"
|
||
},
|
||
"403": {
|
||
"description": "Forbidden"
|
||
},
|
||
"404": {
|
||
"description": "Not Found"
|
||
}
|
||
},
|
||
"deprecated": false,
|
||
"x-order": "2147483647"
|
||
}
|
||
},
|
||
"/admin/invoice/{id}": {
|
||
"get": {
|
||
"tags": [
|
||
"发票管理"
|
||
],
|
||
"summary": "发票详情",
|
||
"description": "获取发票的完整信息，包含开票信息、用户信息、企业信息等。\n\n【关联字典】\n- 返回字段 titleType → 字典：invoice_title_type（抬头类型）\n- 返回字段 status → 字典：invoice_status（发票状态）",
|
||
"operationId": "getInvoiceDetailUsingGET",
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"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/invoice/{id}/fail": {
|
||
"put": {
|
||
"tags": [
|
||
"发票管理"
|
||
],
|
||
"summary": "开票失败",
|
||
"description": "标记发票开票失败，需填写失败原因。用户可根据原因修正后重新申请。\n只有待开票(PENDING)状态的发票可以操作。",
|
||
"operationId": "failInvoiceUsingPUT",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "发票ID",
|
||
"required": false,
|
||
"type": "integer",
|
||
"format": "int64"
|
||
},
|
||
{
|
||
"in": "body",
|
||
"name": "failRequest",
|
||
"description": "failRequest",
|
||
"required": true,
|
||
"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/invoice/{id}/issue": {
|
||
"put": {
|
||
"tags": [
|
||
"发票管理"
|
||
],
|
||
"summary": "开票完成",
|
||
"description": "管理员上传发票文件并填写发票号码后，将发票状态改为已开票。\n只有待开票(PENDING)或开票失败(FAILED)状态的发票可以操作。",
|
||
"operationId": "issueInvoiceUsingPUT",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "发票ID",
|
||
"required": false,
|
||
"type": "integer",
|
||
"format": "int64"
|
||
},
|
||
{
|
||
"in": "body",
|
||
"name": "issueRequest",
|
||
"description": "issueRequest",
|
||
"required": true,
|
||
"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/invoice/{id}/void": {
|
||
"put": {
|
||
"tags": [
|
||
"发票管理"
|
||
],
|
||
"summary": "作废发票",
|
||
"description": "将发票标记为已作废。已作废的发票不可重复作废。",
|
||
"operationId": "voidInvoiceUsingPUT",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"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/customize/page": {
|
||
"get": {
|
||
"tags": [
|
||
"私人定制管理"
|
||
],
|
||
"summary": "定制请求列表",
|
||
"description": "分页查询定制请求，支持关键词搜索、状态筛选、定制师筛选\n\n【关联字典】\n- 筛选参数 status → 字典：customize_request_status（定制请求状态）\n- 返回字段 status → 字典：customize_request_status（定制请求状态）\n- 返回字段 travelPurpose → 字典：travel_purpose（旅游目的）\n- 返回字段 requestType → 字典：customize_request_type（需求类型）\n- 返回字段 budget → 字典：customize_budget（预算范围）",
|
||
"operationId": "pageUsingGET",
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "designerId",
|
||
"in": "query",
|
||
"description": "定制师ID",
|
||
"required": false,
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"x-example": 1234567890
|
||
},
|
||
{
|
||
"name": "keyword",
|
||
"in": "query",
|
||
"description": "搜索关键词（联系人/目标地区/需求描述）",
|
||
"required": false,
|
||
"type": "string",
|
||
"x-example": "云南"
|
||
},
|
||
{
|
||
"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": "sortBy",
|
||
"in": "query",
|
||
"description": "排序字段（createTime/startDate）",
|
||
"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": "状态（字典：customize_request_status）",
|
||
"required": false,
|
||
"type": "string",
|
||
"x-example": "PENDING"
|
||
}
|
||
],
|
||
"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/customize/{requestId}": {
|
||
"get": {
|
||
"tags": [
|
||
"私人定制管理"
|
||
],
|
||
"summary": "定制请求详情",
|
||
"description": "查看定制请求完整信息\n\n【关联字典】\n- 返回字段 status → 字典：customize_request_status（定制请求状态）\n- 返回字段 travelPurpose → 字典：travel_purpose（旅游目的）\n- 返回字段 requestType → 字典：customize_request_type（需求类型）\n- 返回字段 budget → 字典：customize_budget（预算范围）",
|
||
"operationId": "detailUsingGET_2",
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "requestId",
|
||
"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/customize/{requestId}/accept": {
|
||
"put": {
|
||
"tags": [
|
||
"私人定制管理"
|
||
],
|
||
"summary": "接受定制请求",
|
||
"description": "定制师接受定制请求，状态从待处理变为已接受。如果用户未指定定制师，系统将自动分配当前操作人为定制师",
|
||
"operationId": "acceptUsingPUT",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "requestId",
|
||
"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/customize/{requestId}/complete": {
|
||
"put": {
|
||
"tags": [
|
||
"私人定制管理"
|
||
],
|
||
"summary": "标记完成",
|
||
"description": "将已报价的定制请求标记为已完成（用户已确认方案或已下单）",
|
||
"operationId": "completeUsingPUT",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "requestId",
|
||
"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/customize/{requestId}/reply": {
|
||
"put": {
|
||
"tags": [
|
||
"私人定制管理"
|
||
],
|
||
"summary": "回复/报价",
|
||
"description": "定制师回复定制请求或提交报价方案。\n- 仅填写回复内容：状态变为「设计中」\n- 同时关联产品ID：状态变为「已报价」\n\n只有已接受或设计中状态可以回复",
|
||
"operationId": "replyUsingPUT",
|
||
"consumes": [
|
||
"application/json"
|
||
],
|
||
"produces": [
|
||
"*/*"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "requestId",
|
||
"in": "path",
|
||
"description": "定制请求ID",
|
||
"required": false,
|
||
"type": "integer",
|
||
"format": "int64"
|
||
},
|
||
{
|
||
"in": "body",
|
||
"name": "replyRequest",
|
||
"description": "replyRequest",
|
||
"required": true,
|
||
"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"
|
||
}
|
||
},
|
||
"Map«string,object»_3": {
|
||
"type": "object",
|
||
"title": "Map«string,object»_3",
|
||
"additionalProperties": {
|
||
"type": "object"
|
||
}
|
||
},
|
||
"Map«string,object»_4": {
|
||
"type": "object",
|
||
"title": "Map«string,object»_4",
|
||
"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"
|
||
},
|
||
"OrderSurcharge": {
|
||
"type": "object",
|
||
"properties": {
|
||
"createTime": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "创建时间"
|
||
},
|
||
"deletedAt": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "删除时间（软删除）"
|
||
},
|
||
"orderId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "订单ID"
|
||
},
|
||
"surchargeAmount": {
|
||
"type": "number",
|
||
"description": "费用增加金额"
|
||
},
|
||
"surchargeId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "费用增加项ID"
|
||
},
|
||
"surchargeName": {
|
||
"type": "string",
|
||
"description": "费用增加项名称"
|
||
},
|
||
"updateTime": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "更新时间"
|
||
}
|
||
},
|
||
"title": "OrderSurcharge"
|
||
},
|
||
"OrderTimeline": {
|
||
"type": "object",
|
||
"properties": {
|
||
"action": {
|
||
"type": "string",
|
||
"description": "操作动作"
|
||
},
|
||
"actionLabel": {
|
||
"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=系统"
|
||
},
|
||
"operatorTypeLabel": {
|
||
"type": "string",
|
||
"description": "操作人类型中文标签"
|
||
},
|
||
"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"
|
||
},
|
||
"assigneeRoleLabel": {
|
||
"type": "string",
|
||
"description": "指派角色中文标签"
|
||
},
|
||
"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": "待办类型"
|
||
},
|
||
"todoTypeLabel": {
|
||
"type": "string",
|
||
"description": "待办类型中文标签"
|
||
},
|
||
"updateTime": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "更新时间"
|
||
}
|
||
},
|
||
"title": "OrderTodo"
|
||
},
|
||
"OrderTransportSegment": {
|
||
"type": "object",
|
||
"properties": {
|
||
"arriveStation": {
|
||
"type": "string",
|
||
"description": "到达站/到达机场"
|
||
},
|
||
"arriveTime": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "到达时间"
|
||
},
|
||
"createTime": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "创建时间"
|
||
},
|
||
"deletedAt": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "删除时间（软删除）"
|
||
},
|
||
"departStation": {
|
||
"type": "string",
|
||
"description": "出发站/出发机场"
|
||
},
|
||
"departTime": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "出发时间"
|
||
},
|
||
"orderId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "订单ID"
|
||
},
|
||
"remark": {
|
||
"type": "string",
|
||
"description": "备注"
|
||
},
|
||
"segmentId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "分段ID"
|
||
},
|
||
"sortOrder": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"description": "排序序号"
|
||
},
|
||
"transportNo": {
|
||
"type": "string",
|
||
"description": "航班号/车次号"
|
||
},
|
||
"transportType": {
|
||
"type": "string",
|
||
"description": "交通类型（字典：transport_type）: FLIGHT-航班, TRAIN-火车"
|
||
},
|
||
"updateTime": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "更新时间"
|
||
}
|
||
},
|
||
"title": "OrderTransportSegment"
|
||
},
|
||
"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": "string",
|
||
"description": "性别（字典：gender）"
|
||
},
|
||
"idCardNo": {
|
||
"type": "string",
|
||
"description": "证件号码（加密存储）"
|
||
},
|
||
"idCardType": {
|
||
"type": "string",
|
||
"description": "证件类型（字典：id_card_type）"
|
||
},
|
||
"idCardTypeLabel": {
|
||
"type": "string",
|
||
"description": "证件类型中文标签"
|
||
},
|
||
"insurancePolicies": {
|
||
"type": "array",
|
||
"description": "该出行人的保险保单列表（按人合并，含保障期间和保单号）",
|
||
"items": {
|
||
"$ref": "#/definitions/Map«string,object»",
|
||
"originalRef": "Map«string,object»"
|
||
}
|
||
},
|
||
"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）"
|
||
},
|
||
"travelerTypeLabel": {
|
||
"type": "string",
|
||
"description": "出行人类型中文标签"
|
||
},
|
||
"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": [
|
||
"segments"
|
||
],
|
||
"properties": {
|
||
"segments": {
|
||
"type": "array",
|
||
"description": "交通分段列表",
|
||
"items": {
|
||
"$ref": "#/definitions/交通分段项",
|
||
"originalRef": "交通分段项"
|
||
}
|
||
}
|
||
},
|
||
"title": "交通信息请求（批量保存）"
|
||
},
|
||
"交通分段项": {
|
||
"type": "object",
|
||
"required": [
|
||
"transportType"
|
||
],
|
||
"properties": {
|
||
"arriveStation": {
|
||
"type": "string",
|
||
"example": "广州白云T2",
|
||
"description": "到达站/到达机场"
|
||
},
|
||
"arriveTime": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"example": "2026-04-01T11:45:00",
|
||
"description": "到达时间"
|
||
},
|
||
"departStation": {
|
||
"type": "string",
|
||
"example": "北京首都T3",
|
||
"description": "出发站/出发机场"
|
||
},
|
||
"departTime": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"example": "2026-04-01T08:30:00",
|
||
"description": "出发时间"
|
||
},
|
||
"remark": {
|
||
"type": "string",
|
||
"example": "请提前2小时到达机场",
|
||
"description": "备注"
|
||
},
|
||
"transportNo": {
|
||
"type": "string",
|
||
"example": "CA1234",
|
||
"description": "航班号/车次号"
|
||
},
|
||
"transportType": {
|
||
"type": "string",
|
||
"example": "FLIGHT",
|
||
"description": "交通类型（字典：transport_type）: FLIGHT-航班, TRAIN-火车"
|
||
}
|
||
},
|
||
"title": "交通分段项"
|
||
},
|
||
"优惠项请求": {
|
||
"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": [
|
||
"name"
|
||
],
|
||
"properties": {
|
||
"birthday": {
|
||
"type": "string",
|
||
"format": "date",
|
||
"example": "1990-01-01",
|
||
"description": "出生日期（后端根据此字段自动判断人员类型，未传则默认ADULT）"
|
||
},
|
||
"email": {
|
||
"type": "string",
|
||
"example": "lisi@example.com",
|
||
"description": "电子邮箱"
|
||
},
|
||
"emergencyContact": {
|
||
"type": "string",
|
||
"example": "王五",
|
||
"description": "紧急联系人"
|
||
},
|
||
"emergencyPhone": {
|
||
"type": "string",
|
||
"example": 13800138002,
|
||
"description": "紧急联系电话"
|
||
},
|
||
"gender": {
|
||
"type": "string",
|
||
"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",
|
||
"properties": {
|
||
"date": {
|
||
"type": "string",
|
||
"description": "日期（yyyy-MM-dd）"
|
||
},
|
||
"hotelCoverUrl": {
|
||
"type": "string",
|
||
"description": "酒店封面图URL（从产品快照提取，可能为空）"
|
||
},
|
||
"hotelId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "酒店ID"
|
||
},
|
||
"hotelName": {
|
||
"type": "string",
|
||
"description": "酒店名称"
|
||
},
|
||
"remark": {
|
||
"type": "string",
|
||
"description": "备注"
|
||
},
|
||
"roomCount": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"description": "房间数量"
|
||
},
|
||
"roomType": {
|
||
"type": "string",
|
||
"description": "房型名称"
|
||
},
|
||
"roomTypeCoverUrl": {
|
||
"type": "string",
|
||
"description": "房型封面图URL（从产品快照提取，可能为空）"
|
||
},
|
||
"roomTypeId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "房型ID"
|
||
}
|
||
},
|
||
"title": "单天住宿分配"
|
||
},
|
||
"单天升级差价明细": {
|
||
"type": "object",
|
||
"properties": {
|
||
"assignedPrice": {
|
||
"type": "number",
|
||
"description": "实际房型当天单价"
|
||
},
|
||
"assignedRoomTypeId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "实际分配房型ID"
|
||
},
|
||
"assignedRoomTypeName": {
|
||
"type": "string",
|
||
"description": "实际分配房型名称"
|
||
},
|
||
"date": {
|
||
"type": "string",
|
||
"description": "日期"
|
||
},
|
||
"dayDiff": {
|
||
"type": "number",
|
||
"description": "当天差价"
|
||
},
|
||
"defaultPrice": {
|
||
"type": "number",
|
||
"description": "默认房型当天单价"
|
||
},
|
||
"defaultRoomTypeId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "产品默认房型ID"
|
||
},
|
||
"defaultRoomTypeName": {
|
||
"type": "string",
|
||
"description": "产品默认房型名称"
|
||
},
|
||
"direction": {
|
||
"type": "string",
|
||
"description": "差价方向"
|
||
},
|
||
"familyIndex": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"description": "家庭序号"
|
||
},
|
||
"remark": {
|
||
"type": "string",
|
||
"description": "备注"
|
||
}
|
||
},
|
||
"title": "单天升级差价明细"
|
||
},
|
||
"单天单家庭酒店分配": {
|
||
"type": "object",
|
||
"required": [
|
||
"date",
|
||
"familyIndex",
|
||
"hotelId",
|
||
"hotelName",
|
||
"roomType",
|
||
"roomTypeId"
|
||
],
|
||
"properties": {
|
||
"date": {
|
||
"type": "string",
|
||
"description": "日期(yyyy-MM-dd)，单天"
|
||
},
|
||
"familyIndex": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"description": "家庭序号"
|
||
},
|
||
"hotelId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "酒店ID"
|
||
},
|
||
"hotelName": {
|
||
"type": "string",
|
||
"description": "酒店名称"
|
||
},
|
||
"remark": {
|
||
"type": "string",
|
||
"description": "当天备注"
|
||
},
|
||
"roomType": {
|
||
"type": "string",
|
||
"description": "房型名称"
|
||
},
|
||
"roomTypeId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "房型ID"
|
||
},
|
||
"upgradePrice": {
|
||
"type": "number",
|
||
"description": "手动覆盖升级差价（null=使用系统计算值，仅当房型与产品默认不同时有效）"
|
||
}
|
||
},
|
||
"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": "计划名称"
|
||
},
|
||
"productIds": {
|
||
"type": "array",
|
||
"description": "适用产品ID列表（空表示适用全部CORE/GROUP产品）",
|
||
"items": {
|
||
"type": "integer",
|
||
"format": "int64"
|
||
}
|
||
},
|
||
"productNames": {
|
||
"type": "array",
|
||
"description": "适用产品名称列表（空表示适用全部）",
|
||
"items": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"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": "计划名称"
|
||
},
|
||
"productIds": {
|
||
"type": "array",
|
||
"example": [
|
||
"1760000000000001",
|
||
"1760000000000002"
|
||
],
|
||
"description": "适用产品ID列表（仅CORE/GROUP类型），为空或null表示适用全部核心产品和小蒙马",
|
||
"items": {
|
||
"type": "integer",
|
||
"format": "int64"
|
||
}
|
||
},
|
||
"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": "联系人电话"
|
||
},
|
||
"customizerId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"example": 123456,
|
||
"description": "定制师ID（切换定制师）"
|
||
},
|
||
"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模式：总售价-定金-优惠）"
|
||
},
|
||
"checklistConfirmed": {
|
||
"type": "boolean",
|
||
"description": "是否已锁单（清单确认后锁定）"
|
||
},
|
||
"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": "商户号"
|
||
},
|
||
"mchName": {
|
||
"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 翻译）"
|
||
},
|
||
"surchargeAmount": {
|
||
"type": "number",
|
||
"description": "费用增加总额"
|
||
},
|
||
"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«OrderTransportSegment»»": {
|
||
"type": "object",
|
||
"properties": {
|
||
"code": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"example": 200,
|
||
"description": "状态码"
|
||
},
|
||
"data": {
|
||
"type": "array",
|
||
"description": "响应数据",
|
||
"items": {
|
||
"$ref": "#/definitions/OrderTransportSegment",
|
||
"originalRef": "OrderTransportSegment"
|
||
}
|
||
},
|
||
"message": {
|
||
"type": "string",
|
||
"example": "成功",
|
||
"description": "响应消息"
|
||
}
|
||
},
|
||
"title": "统一响应结果«List«OrderTransportSegment»»"
|
||
},
|
||
"统一响应结果«List«OrderTraveler»»": {
|
||
"type": "object",
|
||
"properties": {
|
||
"code": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"example": 200,
|
||
"description": "状态码"
|
||
},
|
||
"data": {
|
||
"type": "array",
|
||
"description": "响应数据",
|
||
"items": {
|
||
"$ref": "#/definitions/OrderTraveler",
|
||
"originalRef": "OrderTraveler"
|
||
}
|
||
},
|
||
"message": {
|
||
"type": "string",
|
||
"example": "成功",
|
||
"description": "响应消息"
|
||
}
|
||
},
|
||
"title": "统一响应结果«List«OrderTraveler»»"
|
||
},
|
||
"统一响应结果«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»"
|
||
},
|
||
"统一响应结果«OrderSurcharge»": {
|
||
"type": "object",
|
||
"properties": {
|
||
"code": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"example": 200,
|
||
"description": "状态码"
|
||
},
|
||
"data": {
|
||
"description": "响应数据",
|
||
"$ref": "#/definitions/OrderSurcharge",
|
||
"originalRef": "OrderSurcharge"
|
||
},
|
||
"message": {
|
||
"type": "string",
|
||
"example": "成功",
|
||
"description": "响应消息"
|
||
}
|
||
},
|
||
"title": "统一响应结果«OrderSurcharge»"
|
||
},
|
||
"统一响应结果«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»"
|
||
},
|
||
"统一响应结果«配房升级差价预览»": {
|
||
"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": {
|
||
"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": "支付截止时间"
|
||
},
|
||
"hotelAssignmentDetails": {
|
||
"type": "array",
|
||
"description": "酒店分配详情（按家庭分组，含封面图）",
|
||
"items": {
|
||
"$ref": "#/definitions/酒店分配详情（按家庭分组）",
|
||
"originalRef": "酒店分配详情（按家庭分组）"
|
||
}
|
||
},
|
||
"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": "商户号"
|
||
},
|
||
"mchName": {
|
||
"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）"
|
||
},
|
||
"paymentModeLabel": {
|
||
"type": "string",
|
||
"description": "支付模式中文标签（DEPOSIT=定金+尾款, FULL=全款）"
|
||
},
|
||
"pendingUpgradeAmount": {
|
||
"type": "number",
|
||
"description": "待确认差价总额（配房/配车升级未确认的差价）"
|
||
},
|
||
"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）"
|
||
},
|
||
"productTypeLabel": {
|
||
"type": "string",
|
||
"description": "产品类型中文标签（CORE=核心产品, CUSTOM=私人定制, GROUP=小蒙马, ROUTE=路书产品）"
|
||
},
|
||
"readyAt": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "就绪时间"
|
||
},
|
||
"refundAmount": {
|
||
"type": "number",
|
||
"description": "退款金额（实退金额）"
|
||
},
|
||
"refundPolicy": {
|
||
"description": "退款政策（含政策名称和退款规则列表）",
|
||
"$ref": "#/definitions/退款政策VO",
|
||
"originalRef": "退款政策VO"
|
||
},
|
||
"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 翻译）"
|
||
},
|
||
"surchargeAmount": {
|
||
"type": "number",
|
||
"description": "费用增加总额"
|
||
},
|
||
"surcharges": {
|
||
"type": "array",
|
||
"description": "费用增加项列表",
|
||
"items": {
|
||
"$ref": "#/definitions/OrderSurcharge",
|
||
"originalRef": "OrderSurcharge"
|
||
}
|
||
},
|
||
"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": "总售价"
|
||
},
|
||
"transportSegments": {
|
||
"type": "array",
|
||
"description": "交通信息列表（航班/车次，含transportType/transportNo/departStation/arriveStation/departTime/arriveTime等）",
|
||
"items": {
|
||
"$ref": "#/definitions/OrderTransportSegment",
|
||
"originalRef": "OrderTransportSegment"
|
||
}
|
||
},
|
||
"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": [
|
||
"surchargeAmount",
|
||
"surchargeName"
|
||
],
|
||
"properties": {
|
||
"surchargeAmount": {
|
||
"type": "number",
|
||
"example": 200.0,
|
||
"description": "费用增加金额"
|
||
},
|
||
"surchargeName": {
|
||
"type": "string",
|
||
"example": "升级房型补差价",
|
||
"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": [
|
||
"vehicleModel"
|
||
],
|
||
"properties": {
|
||
"driverName": {
|
||
"type": "string",
|
||
"description": "司机姓名"
|
||
},
|
||
"driverPhone": {
|
||
"type": "string",
|
||
"description": "司机电话"
|
||
},
|
||
"plateNumber": {
|
||
"type": "string",
|
||
"description": "车牌号"
|
||
},
|
||
"vehicleBrand": {
|
||
"type": "string",
|
||
"description": "品牌（选填，不传则从车型名称中提取）"
|
||
},
|
||
"vehicleModel": {
|
||
"type": "string",
|
||
"description": "车型"
|
||
}
|
||
},
|
||
"title": "车辆分配请求"
|
||
},
|
||
"退款政策VO": {
|
||
"type": "object",
|
||
"properties": {
|
||
"createTime": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "创建时间"
|
||
},
|
||
"createdBy": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "创建人ID"
|
||
},
|
||
"enabled": {
|
||
"type": "boolean",
|
||
"description": "是否启用"
|
||
},
|
||
"policyId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "政策ID"
|
||
},
|
||
"policyName": {
|
||
"type": "string",
|
||
"description": "政策名称"
|
||
},
|
||
"remark": {
|
||
"type": "string",
|
||
"description": "备注"
|
||
},
|
||
"rules": {
|
||
"type": "array",
|
||
"description": "退款规则列表",
|
||
"items": {
|
||
"$ref": "#/definitions/退款规则VO",
|
||
"originalRef": "退款规则VO"
|
||
}
|
||
},
|
||
"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",
|
||
"properties": {
|
||
"description": {
|
||
"type": "string",
|
||
"description": "描述"
|
||
},
|
||
"details": {
|
||
"type": "array",
|
||
"description": "各天差价明细",
|
||
"items": {
|
||
"$ref": "#/definitions/单天升级差价明细",
|
||
"originalRef": "单天升级差价明细"
|
||
}
|
||
},
|
||
"direction": {
|
||
"type": "string",
|
||
"description": "差价方向：UPGRADE=升级加价, DOWNGRADE=降级减价, SAME=价格不变, MIXED=部分升级部分降级"
|
||
},
|
||
"totalDiff": {
|
||
"type": "number",
|
||
"description": "差价合计（正数=需补款，负数=可退款）"
|
||
}
|
||
},
|
||
"title": "配房升级差价预览"
|
||
},
|
||
"酒店分配详情（按家庭分组）": {
|
||
"type": "object",
|
||
"properties": {
|
||
"days": {
|
||
"type": "array",
|
||
"description": "每天的住宿分配列表",
|
||
"items": {
|
||
"$ref": "#/definitions/单天住宿分配",
|
||
"originalRef": "单天住宿分配"
|
||
}
|
||
},
|
||
"familyIndex": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"description": "家庭序号（从1开始）"
|
||
},
|
||
"familyLabel": {
|
||
"type": "string",
|
||
"description": "家庭标签（如：家庭1、家庭2）"
|
||
}
|
||
},
|
||
"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"
|
||
},
|
||
"退款政策请求": {
|
||
"type": "object",
|
||
"required": [
|
||
"policyName",
|
||
"rules"
|
||
],
|
||
"properties": {
|
||
"policyName": {
|
||
"type": "string",
|
||
"example": "国内游退款政策",
|
||
"description": "政策名称"
|
||
},
|
||
"remark": {
|
||
"type": "string",
|
||
"example": "适用于所有国内游产品",
|
||
"description": "备注"
|
||
},
|
||
"rules": {
|
||
"type": "array",
|
||
"description": "退款规则列表",
|
||
"items": {
|
||
"$ref": "#/definitions/退款规则项",
|
||
"originalRef": "退款规则项"
|
||
}
|
||
}
|
||
},
|
||
"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"
|
||
},
|
||
"退款规则项": {
|
||
"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": "退款规则项"
|
||
},
|
||
"Map«string,string»": {
|
||
"type": "object",
|
||
"title": "Map«string,string»",
|
||
"additionalProperties": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"分页结果«发票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": {
|
||
"amount": {
|
||
"type": "string",
|
||
"description": "金额"
|
||
},
|
||
"bankAccount": {
|
||
"type": "string",
|
||
"description": "银行账号（企业发票）"
|
||
},
|
||
"bankName": {
|
||
"type": "string",
|
||
"description": "开户行（企业发票）"
|
||
},
|
||
"companyAddress": {
|
||
"type": "string",
|
||
"description": "企业地址（企业发票）"
|
||
},
|
||
"companyPhone": {
|
||
"type": "string",
|
||
"description": "企业电话（企业发票）"
|
||
},
|
||
"contactPhone": {
|
||
"type": "string",
|
||
"description": "联系电话"
|
||
},
|
||
"createdAt": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "创建时间"
|
||
},
|
||
"email": {
|
||
"type": "string",
|
||
"description": "接收邮箱"
|
||
},
|
||
"failReason": {
|
||
"type": "string",
|
||
"description": "失败原因"
|
||
},
|
||
"fileUrl": {
|
||
"type": "string",
|
||
"description": "发票文件URL"
|
||
},
|
||
"id": {
|
||
"type": "string",
|
||
"description": "发票ID"
|
||
},
|
||
"invoiceContent": {
|
||
"type": "string",
|
||
"description": "发票内容"
|
||
},
|
||
"invoiceNo": {
|
||
"type": "string",
|
||
"description": "发票号码"
|
||
},
|
||
"invoiceTitle": {
|
||
"type": "string",
|
||
"description": "发票抬头"
|
||
},
|
||
"invoiceType": {
|
||
"type": "string",
|
||
"description": "发票类型"
|
||
},
|
||
"issuedAt": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "开票时间"
|
||
},
|
||
"issuedBy": {
|
||
"type": "string",
|
||
"description": "开票操作人ID"
|
||
},
|
||
"orderId": {
|
||
"type": "string",
|
||
"description": "订单ID"
|
||
},
|
||
"orderNo": {
|
||
"type": "string",
|
||
"description": "订单号"
|
||
},
|
||
"originalInvoiceId": {
|
||
"type": "string",
|
||
"description": "原发票ID(换开时关联)"
|
||
},
|
||
"reissueCount": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"description": "换开次数"
|
||
},
|
||
"remark": {
|
||
"type": "string",
|
||
"description": "备注信息"
|
||
},
|
||
"status": {
|
||
"type": "string",
|
||
"description": "发票状态"
|
||
},
|
||
"taxNumber": {
|
||
"type": "string",
|
||
"description": "税号"
|
||
},
|
||
"titleType": {
|
||
"type": "string",
|
||
"description": "抬头类型（personal=个人/company=企业）"
|
||
},
|
||
"updatedAt": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "更新时间"
|
||
},
|
||
"userId": {
|
||
"type": "string",
|
||
"description": "用户ID"
|
||
}
|
||
},
|
||
"title": "发票VO"
|
||
},
|
||
"管理员开票失败请求": {
|
||
"type": "object",
|
||
"required": [
|
||
"failReason"
|
||
],
|
||
"properties": {
|
||
"failReason": {
|
||
"type": "string",
|
||
"example": "发票信息有误，请核实后重新申请",
|
||
"description": "失败原因"
|
||
}
|
||
},
|
||
"title": "管理员开票失败请求"
|
||
},
|
||
"管理员开票请求": {
|
||
"type": "object",
|
||
"required": [
|
||
"fileUrl",
|
||
"invoiceNo"
|
||
],
|
||
"properties": {
|
||
"fileUrl": {
|
||
"type": "string",
|
||
"example": "https://oss.example.com/invoice/xxx.pdf",
|
||
"description": "发票文件URL"
|
||
},
|
||
"invoiceNo": {
|
||
"type": "string",
|
||
"example": "012345678901",
|
||
"description": "发票号码"
|
||
}
|
||
},
|
||
"title": "管理员开票请求"
|
||
},
|
||
"统一响应结果«Map«string,string»»": {
|
||
"type": "object",
|
||
"properties": {
|
||
"code": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"example": 200,
|
||
"description": "状态码"
|
||
},
|
||
"data": {
|
||
"type": "object",
|
||
"description": "响应数据",
|
||
"additionalProperties": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"message": {
|
||
"type": "string",
|
||
"example": "成功",
|
||
"description": "响应消息"
|
||
}
|
||
},
|
||
"title": "统一响应结果«Map«string,string»»"
|
||
},
|
||
"统一响应结果«分页结果«发票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": {
|
||
"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": [
|
||
"reply"
|
||
],
|
||
"properties": {
|
||
"productId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"example": 1234567890,
|
||
"description": "关联产品ID（定制产品已创建时传入）"
|
||
},
|
||
"reply": {
|
||
"type": "string",
|
||
"example": "已为您设计3天2晚大理深度游方案",
|
||
"description": "回复内容"
|
||
}
|
||
},
|
||
"title": "定制师回复/报价请求"
|
||
},
|
||
"定制请求列表VO": {
|
||
"type": "object",
|
||
"properties": {
|
||
"adultCount": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"description": "成人数"
|
||
},
|
||
"budget": {
|
||
"type": "string",
|
||
"description": "预算范围（字典：customize_budget）"
|
||
},
|
||
"childCount": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"description": "儿童数"
|
||
},
|
||
"createTime": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "创建时间"
|
||
},
|
||
"days": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"description": "期望天数"
|
||
},
|
||
"designerAvatar": {
|
||
"type": "string",
|
||
"description": "定制师头像"
|
||
},
|
||
"designerName": {
|
||
"type": "string",
|
||
"description": "定制师姓名"
|
||
},
|
||
"destination": {
|
||
"type": "string",
|
||
"description": "目标地区"
|
||
},
|
||
"requestId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "请求ID"
|
||
},
|
||
"requestType": {
|
||
"type": "string",
|
||
"description": "需求类型（字典：customize_request_type）"
|
||
},
|
||
"startDate": {
|
||
"type": "string",
|
||
"format": "date",
|
||
"description": "期望出发日期"
|
||
},
|
||
"status": {
|
||
"type": "string",
|
||
"description": "状态（字典：customize_request_status）"
|
||
},
|
||
"statusLabel": {
|
||
"type": "string",
|
||
"description": "状态标签"
|
||
},
|
||
"travelPurpose": {
|
||
"type": "string",
|
||
"description": "旅游目的（字典：travel_purpose）"
|
||
},
|
||
"userId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "用户ID"
|
||
}
|
||
},
|
||
"title": "定制请求列表VO"
|
||
},
|
||
"定制请求详情VO": {
|
||
"type": "object",
|
||
"properties": {
|
||
"adultCount": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"description": "成人数"
|
||
},
|
||
"budget": {
|
||
"type": "string",
|
||
"description": "预算范围（字典：customize_budget）"
|
||
},
|
||
"childCount": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"description": "儿童数"
|
||
},
|
||
"contactName": {
|
||
"type": "string",
|
||
"description": "联系人"
|
||
},
|
||
"contactPhone": {
|
||
"type": "string",
|
||
"description": "联系电话"
|
||
},
|
||
"createTime": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "创建时间"
|
||
},
|
||
"days": {
|
||
"type": "integer",
|
||
"format": "int32",
|
||
"description": "期望天数"
|
||
},
|
||
"designerAvatar": {
|
||
"type": "string",
|
||
"description": "定制师头像"
|
||
},
|
||
"designerId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "指定定制师ID"
|
||
},
|
||
"designerName": {
|
||
"type": "string",
|
||
"description": "定制师姓名"
|
||
},
|
||
"destination": {
|
||
"type": "string",
|
||
"description": "目标地区"
|
||
},
|
||
"endDate": {
|
||
"type": "string",
|
||
"format": "date",
|
||
"description": "期望结束日期"
|
||
},
|
||
"productId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "关联产品ID"
|
||
},
|
||
"repliedAt": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "回复时间"
|
||
},
|
||
"reply": {
|
||
"type": "string",
|
||
"description": "定制师回复"
|
||
},
|
||
"requestId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "请求ID"
|
||
},
|
||
"requestType": {
|
||
"type": "string",
|
||
"description": "需求类型（字典：customize_request_type）"
|
||
},
|
||
"requirements": {
|
||
"type": "string",
|
||
"description": "详细需求描述"
|
||
},
|
||
"startDate": {
|
||
"type": "string",
|
||
"format": "date",
|
||
"description": "期望出发日期"
|
||
},
|
||
"status": {
|
||
"type": "string",
|
||
"description": "状态（字典：customize_request_status）"
|
||
},
|
||
"statusLabel": {
|
||
"type": "string",
|
||
"description": "状态标签"
|
||
},
|
||
"travelPurpose": {
|
||
"type": "string",
|
||
"description": "旅游目的（字典：travel_purpose）"
|
||
},
|
||
"updateTime": {
|
||
"type": "string",
|
||
"format": "date-time",
|
||
"description": "更新时间"
|
||
},
|
||
"userId": {
|
||
"type": "integer",
|
||
"format": "int64",
|
||
"description": "用户ID"
|
||
}
|
||
},
|
||
"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»"
|
||
}
|
||
}
|
||
} |