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: "修改接口"
|
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": {
|
||||||
|
|||||||
在新工单中引用
屏蔽一个用户