diff --git a/changelogs-v2/2026-09/16_7767_团车户与免车团户可终止行程-修改接口-管理后台.md b/changelogs-v2/2026-09/16_7767_团车户与免车团户可终止行程-修改接口-管理后台.md index b584d45d..f4cfa2db 100644 --- a/changelogs-v2/2026-09/16_7767_团车户与免车团户可终止行程-修改接口-管理后台.md +++ b/changelogs-v2/2026-09/16_7767_团车户与免车团户可终止行程-修改接口-管理后台.md @@ -35,6 +35,7 @@ base: "dev-v3" 2. **新增错误码 584132**:用于"用车需求未完成"场景,与 584100"车费暂时不可用"语义分开。前端**必须区别对待**两个错误码: - `584132` → "等车务配车完成后再试"(需催车务处理) - `584100` → "暂时不可用,请稍后重试"(快照异常,应自己好转) +3. **团车户车费按 0 计、调整用 adjustAmount**:团车户(GROUP_VEHICLE)用车由团级承担,在该户的终止预览中 vehicles=[],退款明细中无 VEHICLE 行。若运营需向该户扣回团车成本,通过 `POST /terminate` 的 `adjustAmount` 参数调整(负数表示减免)。实测:订单 `2100132795681525761` 团车户,`finalRefund = max(0, 2000 − 176 + 0) = 1824` --- @@ -176,6 +177,7 @@ GET /v3/admin/order/1934567890123456789/terminate-refund/preview | id | Path | Long | 是 | - | 订单 ID | | cancelReason | Body | String | 是 | ≤500 字符 | 终止原因(运营内部备注) | | endDayNumber | Body | Integer | 是 | 1 ≤ dayNumber ≤ 行程天数 | 终止日在行程中的序号(Day 1、Day 2 等) | +| adjustAmount | Body | BigDecimal | 否 | 任意 | 人工调整额(默认 0,负数表示减免;用于团车户向其扣回团车成本) | | vehicles | Body | List | 否 | - | 旧客户端兼容字段,新客户端可不传 | #### 出参字段表 @@ -247,6 +249,8 @@ GET /v3/admin/order/1934567890123456789/terminate-refund/preview - **状态机**: 仅 TRAVELLING 状态可终止 - **幂等**: 同一订单同一 endDayNumber 重复终止返 581049(已终止) - **团车户与免车户放行**: 现已支持,按 DAILY_V3 规则正常处理 +- **adjustAmount 用途**:系统计算 baselineRefund 后,运营可通过该参数人工调整;finalRefund = max(0, baselineRefund + adjustAmount)。团车户成本扣减常用负值,如 adjustAmount = -300 表示减免 300 元 +- **团车户退款细节**:用车行置空(vehicles=[]),退款明细无 VEHICLE 行,但其他资源行(房费、保险等)仍正常计算 ### 3. 状态变更·通用 `POST /v3/admin/order/{id}/transition`