diff --git a/changelogs-v2/2026-09/16_7767_团车户与免车团户可终止行程-修改接口-管理后台.md b/changelogs-v2/2026-09/16_7767_团车户与免车团户可终止行程-修改接口-管理后台.md index 0bc494f0..b70c3a7e 100644 --- a/changelogs-v2/2026-09/16_7767_团车户与免车团户可终止行程-修改接口-管理后台.md +++ b/changelogs-v2/2026-09/16_7767_团车户与免车团户可终止行程-修改接口-管理后台.md @@ -7,11 +7,11 @@ author: "wx(GIT)" change_type: "修改接口" backend_status: "deployed" gateway_status: "verified" -frontend_status: "verified" -frontend_owner: "mmg" -frontend_ref: "a2a4e2ddae0508de89e941e308ffde5b1d9944c5" +frontend_status: "pending" +frontend_owner: "" +frontend_ref: "" target_release: "" -verified_at: "2026-09-16" +verified_at: "" status_note: "仅后端交付。新增错误码 584132 与修改的 584100 文案在源码与 API-SPEC 已核对;测试服验证见工单 #7767 验收评论。前端需补错误码 584132 的提示文案映射,误将两码混用则会给出不恰当的稍后重试建议。;前端 hl-admin a2a4e2dd 已实现:terminateRefund.js 补 584132 提示(等车务配车完成后再试)与 584100(稍后重试)语义区分,api docstring 同步,spec +1,checkpoint 全绿。" updated_at: "2026-09-16" base: "dev-v3" @@ -48,14 +48,14 @@ base: "dev-v3" | # | 接口 | 方法 | 路径 | 变更类型 | 说明 | |---|------|------|------|----------|------| -| 1 | 终止行程·退款预览 | POST | `/v3/admin/order/{orderId}/terminate-refund/preview` | 修改 | 新增错误码 584132;修改 584100 文案与适用范围 | -| 2 | 终止行程 | POST | `/v3/admin/order/{orderId}/terminate` | 修改 | 新增错误码 584132;修改 584100 文案与适用范围 | +| 1 | 终止行程·退款预览 | POST | `/v3/admin/order/{id}/terminate/refund-preview` | 修改 | 新增错误码 584132;修改 584100 文案与适用范围 | +| 2 | 终止行程 | POST | `/v3/admin/order/{id}/terminate` | 修改 | 新增错误码 584132;修改 584100 文案与适用范围 | --- ## 三、接口详情 -### 1. 终止行程·退款预览 `POST /v3/admin/order/{orderId}/terminate-refund/preview` +### 1. 终止行程·退款预览 `POST /v3/admin/order/{id}/terminate/refund-preview` **VO**: `(路径参数 → OrderTerminateRefundPreviewRespVO)` @@ -67,13 +67,13 @@ base: "dev-v3" | 字段 | 位置 | 类型 | 必填 | 约束 | 说明 | |------|------|------|------|------|------| -| orderId | Path | Long | 是 | - | 订单 ID | +| id | Path | Long | 是 | - | 订单 ID | #### 出参字段表 | 字段 | 类型 | 说明 | |------|------|------| -| orderId | Long | 订单 ID | +| id | Long | 订单 ID | | orderNo | String | 订单号 | | usedDays | Integer | 已用天数(截至今日) | | remainingDays | Integer | 剩余天数(今日之后) | @@ -94,7 +94,7 @@ GET /v3/admin/order/1934567890123456789/terminate-refund/preview "code": 200, "message": "成功", "data": { - "orderId": 1934567890123456789, + "id": 1934567890123456789, "orderNo": "26-0503", "usedDays": 2, "remainingDays": 4, @@ -160,7 +160,7 @@ GET /v3/admin/order/1934567890123456789/terminate-refund/preview --- -### 2. 终止行程 `POST /v3/admin/order/{orderId}/terminate` +### 2. 终止行程 `POST /v3/admin/order/{id}/terminate` **VO**: `OrderTerminateTripReqVO → OrderTerminateTripRespVO` @@ -172,7 +172,7 @@ GET /v3/admin/order/1934567890123456789/terminate-refund/preview | 字段 | 位置 | 类型 | 必填 | 约束 | 说明 | |------|------|------|------|------|------| -| orderId | Path | Long | 是 | - | 订单 ID | +| id | Path | Long | 是 | - | 订单 ID | | cancelReason | Body | String | 是 | ≤500 字符 | 终止原因(运营内部备注) | | endDayNumber | Body | Integer | 是 | 1 ≤ dayNumber ≤ 行程天数 | 终止日在行程中的序号(Day 1、Day 2 等) | | vehicles | Body | List | 否 | - | 旧客户端兼容字段,新客户端可不传 | @@ -181,7 +181,7 @@ GET /v3/admin/order/1934567890123456789/terminate-refund/preview | 字段 | 类型 | 说明 | |------|------|------| -| orderId | Long | 订单 ID | +| id | Long | 订单 ID | | orderNo | String | 订单号 | | status | String | 订单状态(转移为 COMPLETED) | | terminateRefundRecord | Object | 退款记录快照 | @@ -204,7 +204,7 @@ GET /v3/admin/order/1934567890123456789/terminate-refund/preview "code": 200, "message": "成功", "data": { - "orderId": 1934567890123456789, + "id": 1934567890123456789, "orderNo": "26-0503", "status": "COMPLETED", "terminateRefundRecord": {