diff --git a/changelogs-v2/2026-06/42_4548_终止行程退款弹窗预览补字段与提交下界校验-修改接口-管理后台.md b/changelogs-v2/2026-06/42_4548_终止行程退款弹窗预览补字段与提交下界校验-修改接口-管理后台.md index a90e17e..ae4c138 100644 --- a/changelogs-v2/2026-06/42_4548_终止行程退款弹窗预览补字段与提交下界校验-修改接口-管理后台.md +++ b/changelogs-v2/2026-06/42_4548_终止行程退款弹窗预览补字段与提交下界校验-修改接口-管理后台.md @@ -13,8 +13,8 @@ | # | 接口 | 方法 | 路径 | 变更类型 | 说明 | |---|------|------|------|----------|------| -| 1 | 终止退款预览 | POST | `/v3/admin/order/{id}/terminate/refund-preview` | 修改接口 | 出参新增 `days` 数组 + 5 个订单基本信息字段 | -| 2 | 终止行程提交 | POST | `/v3/admin/order/{id}/terminate` | 修改接口 | 新增错误码 581044 + 入参约束「结束日前的资源必须标记已用」 | +| 1 | 终止退款预览 | POST | `/v3/admin/order/{id}/terminate/refund-preview` | 修改接口 | 出参新增 `days` 数组 + 5 个订单基本信息字段 + `outstandingBalance` 应收尾款 | +| 2 | 终止行程提交 | POST | `/v3/admin/order/{id}/terminate` | 修改接口 | 新增错误码 581044 + 入参约束「结束日前的资源必须标记已用」 + 新增必填入参 `onsiteBalance` 现场实收尾款 | > 两接口入参主体结构不变,均为出参/校验增量,向后兼容。 @@ -46,6 +46,7 @@ | `productName` | String | 产品名称 | | `batchNo` | String | 团号(团期订单有值;**核心订单为 `null`**) | | `consultantName` | String | 定制师 | +| `outstandingBalance` | String | 应收尾款(= 应收总额 − 净已付,clamp ≥ 0;已取消单为 0)。"该收多少",与提交时录入的现场实收 `onsiteBalance` 对照 | | `days` | Array | 结束日期选项(见下表),范围 `1..tripCurrentDay`,**不含「未出行」** | `days[]` 元素字段 @@ -72,6 +73,7 @@ "batchNo": "GB20260512-008", "consultantName": "李顾问", "paidAmount": "6000.00", + "outstandingBalance": "0.00", "tripDays": 6, "departDate": "2026-05-12", "tripCurrentDay": 3, @@ -124,6 +126,7 @@ | `tickets` | Array | ✅ | 门票已用判定 `[{refId, used}]` | | `vehicles` | Array | ✅ | 用车每天已用判定 `[{refId, dayNumber, used}]` | | `adjustAmount` | Decimal | ❌ | 人工调整额(默认 0,允许负) | +| `onsiteBalance` | Decimal | ✅ | **现场实收尾款**(定制师终止时现场实收的尾款,必填)。纯记录:不参与退款计算、不影响已付金额,仅留存供核单/财务对照(与预览的 `outstandingBalance` 应收尾款相对) | **错误码**