补充 changelog:终止退款弹窗加应收尾款 outstandingBalance + 现场实收尾款 onsiteBalance(管理后台 #4579 #4581)

预览出参增 outstandingBalance(应收尾款);提交入参增必填 onsiteBalance(现场实收尾款,纯记录不参与退款)。并入同弹窗已有 changelog(42_4548)。
这个提交包含在:
yaosutu 2026-06-28 17:30:50 +08:00
父节点 0b8d673b20
当前提交 8de86f6680

查看文件

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