docs: #7767 补充第三件事——团车户成本扣减用 adjustAmount
changelog-filename-gate / validate (push) Failing after 1s

- 关键变化段新增:团车户车费按 0 计、调整用 adjustAmount
- 终止接口补 adjustAmount 入参说明与使用场景
- 业务边界详述:adjustAmount 参与 finalRefund 计算(负数表示减免)
- 补充实测数据:订单 2100132795681525761,finalRefund = max(0, 2000-176+0) = 1824

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
这个提交包含在:
API Changelog Bot
2026-09-16 23:13:00 +08:00
共同撰写人 Claude Haiku 4.5
父节点 35a67a6264
当前提交 c8f1f579b8
@@ -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`