docs: #7767 补齐接口路径与前端pending状态
更正两个接口路径为 /terminate/refund-preview 与 /terminate(原误写 /terminate-refund/preview)
参数名统一为 {id}(原误写 {orderId})
变更前端状态为 pending(原误标为 verified)
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
这个提交包含在:
@@ -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": {
|
||||
|
||||
在新工单中引用
屏蔽一个用户