docs: #7767 补齐接口路径与前端pending状态

更正两个接口路径为 /terminate/refund-preview 与 /terminate(原误写 /terminate-refund/preview)
参数名统一为 {id}(原误写 {orderId})
变更前端状态为 pending(原误标为 verified)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
这个提交包含在:
API Changelog Bot
2026-09-16 23:07:30 +08:00
共同撰写人 Claude Haiku 4.5
父节点 46909eba8d
当前提交 5997bc722e
@@ -7,11 +7,11 @@ author: "wx(GIT)"
change_type: "修改接口" change_type: "修改接口"
backend_status: "deployed" backend_status: "deployed"
gateway_status: "verified" gateway_status: "verified"
frontend_status: "verified" frontend_status: "pending"
frontend_owner: "mmg" frontend_owner: ""
frontend_ref: "a2a4e2ddae0508de89e941e308ffde5b1d9944c5" frontend_ref: ""
target_release: "" 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 全绿。" 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" updated_at: "2026-09-16"
base: "dev-v3" base: "dev-v3"
@@ -48,14 +48,14 @@ base: "dev-v3"
| # | 接口 | 方法 | 路径 | 变更类型 | 说明 | | # | 接口 | 方法 | 路径 | 变更类型 | 说明 |
|---|------|------|------|----------|------| |---|------|------|------|----------|------|
| 1 | 终止行程·退款预览 | POST | `/v3/admin/order/{orderId}/terminate-refund/preview` | 修改 | 新增错误码 584132;修改 584100 文案与适用范围 | | 1 | 终止行程·退款预览 | POST | `/v3/admin/order/{id}/terminate/refund-preview` | 修改 | 新增错误码 584132;修改 584100 文案与适用范围 |
| 2 | 终止行程 | POST | `/v3/admin/order/{orderId}/terminate` | 修改 | 新增错误码 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)` **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 | 订单号 | | orderNo | String | 订单号 |
| usedDays | Integer | 已用天数(截至今日) | | usedDays | Integer | 已用天数(截至今日) |
| remainingDays | Integer | 剩余天数(今日之后) | | remainingDays | Integer | 剩余天数(今日之后) |
@@ -94,7 +94,7 @@ GET /v3/admin/order/1934567890123456789/terminate-refund/preview
"code": 200, "code": 200,
"message": "成功", "message": "成功",
"data": { "data": {
"orderId": 1934567890123456789, "id": 1934567890123456789,
"orderNo": "26-0503", "orderNo": "26-0503",
"usedDays": 2, "usedDays": 2,
"remainingDays": 4, "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` **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 字符 | 终止原因(运营内部备注) | | cancelReason | Body | String | 是 | ≤500 字符 | 终止原因(运营内部备注) |
| endDayNumber | Body | Integer | 是 | 1 ≤ dayNumber ≤ 行程天数 | 终止日在行程中的序号(Day 1、Day 2 等) | | endDayNumber | Body | Integer | 是 | 1 ≤ dayNumber ≤ 行程天数 | 终止日在行程中的序号(Day 1、Day 2 等) |
| vehicles | Body | List | 否 | - | 旧客户端兼容字段,新客户端可不传 | | vehicles | Body | List | 否 | - | 旧客户端兼容字段,新客户端可不传 |
@@ -181,7 +181,7 @@ GET /v3/admin/order/1934567890123456789/terminate-refund/preview
| 字段 | 类型 | 说明 | | 字段 | 类型 | 说明 |
|------|------|------| |------|------|------|
| orderId | Long | 订单 ID | | id | Long | 订单 ID |
| orderNo | String | 订单号 | | orderNo | String | 订单号 |
| status | String | 订单状态(转移为 COMPLETED) | | status | String | 订单状态(转移为 COMPLETED) |
| terminateRefundRecord | Object | 退款记录快照 | | terminateRefundRecord | Object | 退款记录快照 |
@@ -204,7 +204,7 @@ GET /v3/admin/order/1934567890123456789/terminate-refund/preview
"code": 200, "code": 200,
"message": "成功", "message": "成功",
"data": { "data": {
"orderId": 1934567890123456789, "id": 1934567890123456789,
"orderNo": "26-0503", "orderNo": "26-0503",
"status": "COMPLETED", "status": "COMPLETED",
"terminateRefundRecord": { "terminateRefundRecord": {