From 8de86f6680207be2bd3ee2c0cea1b2717f191974 Mon Sep 17 00:00:00 2001 From: yaosutu <770858045@qq.com> Date: Sun, 28 Jun 2026 17:30:50 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=20changelog=EF=BC=9A?= =?UTF-8?q?=E7=BB=88=E6=AD=A2=E9=80=80=E6=AC=BE=E5=BC=B9=E7=AA=97=E5=8A=A0?= =?UTF-8?q?=E5=BA=94=E6=94=B6=E5=B0=BE=E6=AC=BE=20outstandingBalance=20+?= =?UTF-8?q?=20=E7=8E=B0=E5=9C=BA=E5=AE=9E=E6=94=B6=E5=B0=BE=E6=AC=BE=20ons?= =?UTF-8?q?iteBalance=EF=BC=88=E7=AE=A1=E7=90=86=E5=90=8E=E5=8F=B0=20#4579?= =?UTF-8?q?=20#4581=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 预览出参增 outstandingBalance(应收尾款)；提交入参增必填 onsiteBalance(现场实收尾款,纯记录不参与退款)。并入同弹窗已有 changelog（42_4548）。 --- ...行程退款弹窗预览补字段与提交下界校验-修改接口-管理后台.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) 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` 应收尾款相对） | **错误码**