diff --git a/.swagger/hl-contract-service.json b/.swagger/hl-contract-service.json index d33a48a..985987f 100644 --- a/.swagger/hl-contract-service.json +++ b/.swagger/hl-contract-service.json @@ -730,6 +730,57 @@ "x-order": "2147483647" } }, + "/admin/contract/platforms": { + "get": { + "tags": [ + "合同管理" + ], + "summary": "可用合同平台列表", + "description": "返回系统已对接的合同平台列表及可用状态。\n前端在合同配置页面据此展示可选平台(如12301/法大大/e签宝/腾讯电子签)\n\n【关联字典】\n- 返回字段 platformName → 字典:contract_platform(合同平台)", + "operationId": "listPlatformsUsingGET", + "produces": [ + "*/*" + ], + "responses": { + "200": { + "description": "OK", + "schema": { + "$ref": "#/definitions/统一响应结果«List«ContractPlatformInfo»»", + "originalRef": "统一响应结果«List«ContractPlatformInfo»»" + } + }, + "401": { + "description": "Unauthorized" + }, + "403": { + "description": "Forbidden" + }, + "404": { + "description": "Not Found" + } + }, + "responsesObject": { + "200": { + "description": "OK", + "schema": { + "$ref": "#/definitions/统一响应结果«List«ContractPlatformInfo»»", + "originalRef": "统一响应结果«List«ContractPlatformInfo»»" + } + }, + "401": { + "description": "Unauthorized" + }, + "403": { + "description": "Forbidden" + }, + "404": { + "description": "Not Found" + } + }, + "deprecated": false, + "x-order": "2147483647" + } + }, "/admin/contract/report": { "post": { "tags": [ @@ -1194,6 +1245,21 @@ } }, "definitions": { + "ContractPlatformInfo": { + "type": "object", + "properties": { + "available": { + "type": "boolean" + }, + "displayName": { + "type": "string" + }, + "platformName": { + "type": "string" + } + }, + "title": "ContractPlatformInfo" + }, "分页结果«合同信息»": { "type": "object", "properties": { @@ -1331,6 +1397,11 @@ "example": 2, "description": "付款方式: 1-现金 2-转账 3-在线" }, + "platform": { + "type": "string", + "example": 12301, + "description": "合同平台(字典:contract_platform): 12301-全国旅游监管平台, FADADA-法大大, ESIGN-e签宝, TENCENT_ESS-腾讯电子签。不传则根据模板自动确定" + }, "returnDate": { "type": "string", "format": "date", @@ -1904,6 +1975,11 @@ "example": 2, "description": "付款方式: 1-现金 2-转账 3-在线" }, + "platform": { + "type": "string", + "example": 12301, + "description": "合同平台(字典:contract_platform): 12301-全国旅游监管平台, FADADA-法大大, ESIGN-e签宝, TENCENT_ESS-腾讯电子签" + }, "returnDate": { "type": "string", "format": "date", @@ -2038,6 +2114,31 @@ }, "title": "旅行社信息" }, + "统一响应结果«List«ContractPlatformInfo»»": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32", + "example": 200, + "description": "状态码" + }, + "data": { + "type": "array", + "description": "响应数据", + "items": { + "$ref": "#/definitions/ContractPlatformInfo", + "originalRef": "ContractPlatformInfo" + } + }, + "message": { + "type": "string", + "example": "成功", + "description": "响应消息" + } + }, + "title": "统一响应结果«List«ContractPlatformInfo»»" + }, "统一响应结果«List«合同信息»»": { "type": "object", "properties": { diff --git a/changelogs/2026-03/19_1111_sync.md b/changelogs/2026-03/19_1111_sync.md new file mode 100644 index 0000000..015e1cd --- /dev/null +++ b/changelogs/2026-03/19_1111_sync.md @@ -0,0 +1,38 @@ +# API 变更通知 + +**更新时间**: 2026-03-19 11:11 + +## ⚠️ Breaking Changes (1) + +> **前端必须处理的变更,不处理会导致功能异常** + +### 字典变更 + +**字典项删除** + +| 字典 | 删除值 | 标签 | +| --- | --- | --- | +| `product_node_type`(行程节点类型) | ~~`DINING`~~ | 餐饮 | + +## ℹ️ 新增 (4) + +### 合同服务 + +**新增接口** + +- 🆕 `GET /admin/contract/platforms` + +**新增字段** + +| 数据对象 | 新增字段 | 类型 | +| --- | --- | --- | +| `创建合同请求` | `platform` | `string` | +| `报备合同请求(同步模式)` | `platform` | `string` | + +### 字典变更 + +**新增字典项** + +| 字典 | 新增值 | 标签 | +| --- | --- | --- | +| `product_node_type`(行程节点类型) | `RESTAURANT` | 餐厅 |