补充 changelog:终止退款弹窗加应收尾款 outstandingBalance + 现场实收尾款 onsiteBalance(管理后台 #4579 #4581)
预览出参增 outstandingBalance(应收尾款);提交入参增必填 onsiteBalance(现场实收尾款,纯记录不参与退款)。并入同弹窗已有 changelog(42_4548)。
这个提交包含在:
父节点
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` 应收尾款相对) |
|
||||||
|
|
||||||
**错误码**
|
**错误码**
|
||||||
|
|
||||||
|
|||||||
正在加载...
x
在新工单中引用
屏蔽一个用户