From 59ea0634604faf8676d09eb0e4c27bf7e5ee24b1 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Mon, 23 Mar 2026 19:02:42 +0800 Subject: [PATCH] =?UTF-8?q?changelog:=208b444a8=20-=20fix:=20=E9=80=80?= =?UTF-8?q?=E6=AC=BE=E9=87=91=E9=A2=9D=E6=98=BE=E7=A4=BA+=E6=93=8D?= =?UTF-8?q?=E4=BD=9C=E8=AE=B0=E5=BD=95=E8=AF=A6=E7=BB=86=E5=8C=96+?= =?UTF-8?q?=E7=9B=B4=E6=8E=A5=E7=94=B3=E8=AF=89+=E7=94=B3=E8=AF=89?= =?UTF-8?q?=E9=87=91=E9=A2=9D=E6=A0=A1=E9=AA=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .swagger/dict_data.json | 2 +- .../2026-03/2026-03-23_1902_8b444a8_fix.md | 139 ++++++++++++++++++ 2 files changed, 140 insertions(+), 1 deletion(-) create mode 100644 changelogs/2026-03/2026-03-23_1902_8b444a8_fix.md diff --git a/.swagger/dict_data.json b/.swagger/dict_data.json index d979433..4ee46f8 100644 --- a/.swagger/dict_data.json +++ b/.swagger/dict_data.json @@ -3114,7 +3114,7 @@ }, { "value": "PENDING_FINANCE", - "label": "\u5f85\u6838\u7b97", + "label": "\u5f85\u786e\u8ba4\u6e05\u5355", "sort": 7, "status": "ACTIVE" }, diff --git a/changelogs/2026-03/2026-03-23_1902_8b444a8_fix.md b/changelogs/2026-03/2026-03-23_1902_8b444a8_fix.md new file mode 100644 index 0000000..ba2e0a5 --- /dev/null +++ b/changelogs/2026-03/2026-03-23_1902_8b444a8_fix.md @@ -0,0 +1,139 @@ +# 接口变更记录 — 2026-03-23 19:02 + +> **提交** `8b444a8` · **作者** wx · **时间** 2026-03-23 19:02:42 +0800 +> +> fix: 退款金额显示+操作记录详细化+直接申诉+申诉金额校验 + +## 变更总览 + +- **保险服务** + - InternalInsurance (+1) +- **小程序聚合服务** + - MpRefund (+1) + +--- + +## 保险服务 + +### InternalInsurance + +> 📖 **接口文档**: [http://192.168.100.236:8098/doc.html](http://192.168.100.236:8098/doc.html) → 标签 **「【内部接口】保险（Feign调用）」** + +### 🆕 `GET` /internal/insurance/coverage/{orderId} — 查询订单保险保障(含被保人详情,内部调用) + +> 内部服务间调用。返回订单维度的保险保障汇总信息，包含每份保单的被保人明细。用于小程序端按出行人展示保险信息。 + +**参数** + + - `{orderId}` (`Long`) — 路径参数：旅行订单ID + +**响应** `Result` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `orderId` | `Long` | 旅行订单ID | +| `orderCount` | `Integer` | 保险单数量 | +| `insuranceOrders` | `List` | 保险订单详情列表(含被保人) | + +--- + +## 小程序聚合服务 + +### MpRefund + +> 📖 **接口文档**: [http://192.168.100.236:8086/doc.html](http://192.168.100.236:8086/doc.html) → 标签 **「C端 - 退款接口」** + +### 🆕 `POST` /mp/order/refund/{orderId}/direct-appeal — 直接申诉退款 + +> 用户对退款政策计算的金额不满意，跳过退款申请直接发起申诉。 + +**参数** + + - `{orderId}` (`Long`) — 路径参数：订单ID + +**请求体** `MpRefundAppealRequest` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `appealReason` | `String` | 申诉原因 | +| `appealAmount` | `BigDecimal` | 申诉退款金额 | +| `evidence` | `List` | 申诉凭证图片URL列表 | + +**响应** `Result` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `applicationId` | `Long` | 退款申请ID | +| `orderId` | `Long` | 订单ID | +| `orderNo` | `String` | 订单号 | +| `productName` | `String` | 产品名称 | +| `refundType` | `String` | 退款类型: DEPOSIT(定金)/BALANCE(尾款)/FULL(全款) | +| `refundTypeLabel` | `String` | 退款类型中文标签 | +| `reasonId` | `Long` | 退款原因ID | +| `reasonText` | `String` | 退款原因 | +| `reasonDetail` | `String` | 补充说明 | +| `paidAmount` | `BigDecimal` | 已付金额 | +| `calculatedAmount` | `BigDecimal` | 计算退款金额 | +| `actualAmount` | `BigDecimal` | 实际退款金额（审核后确定） | +| `policyId` | `Long` | 退款政策ID | +| `policyName` | `String` | 退款政策名称 | +| `departureDate` | `LocalDate` | 出发日期 | +| `daysBeforeDept` | `Integer` | 距出发天数 | +| `refundRatio` | `Integer` | 退款比例（百分比） | +| `status` | `String` | 退款状态: PENDING(待审核)/APPROVED(已通过)/REJECTED(已拒绝)/REFUNDING(退款中)/REFUNDED(已退款)/CANCELLED(已撤回)/APPEALING(申诉中)/APPEAL_APPROVED(申诉通过)/APPEAL_REJECTED(申诉驳回) | +| `statusLabel` | `String` | 退款状态中文标签 | +| `reviewAdminId` | `Long` | 审批管理员ID | +| `reviewAdminName` | `String` | 审批管理员姓名 | +| `reviewRemark` | `String` | 审批备注 | +| `reviewedAt` | `LocalDateTime` | 审批时间 | +| `appealReason` | `String` | 申诉原因 | +| `appealAmount` | `BigDecimal` | 申诉退款金额 | +| `approvalNo` | `String` | 审批编号（企微OA审批编号） | +| `appealStatus` | `Integer` | 申诉状态: 1-处理中, 2-通过, 3-驳回 | +| `autoRefundDeadline` | `LocalDateTime` | 自动退款截止时间 | +| `appealStatusLabel` | `String` | 申诉状态中文标签 | +| `appealedAt` | `LocalDateTime` | 申诉时间 | +| `refundedAt` | `LocalDateTime` | 退款完成时间 | +| `applicantType` | `String` | 申请人类型: USER(用户)/ADMIN(管理员) | +| `applicantId` | `Long` | 申请人ID | +| `applicantName` | `String` | 申请人姓名 | +| `createTime` | `LocalDateTime` | 创建时间 | +| `updateTime` | `LocalDateTime` | 更新时间 | + +--- + +## 📦 其他数据对象变更 + +> 以下变更未直接关联到本次接口变更，但可能影响现有接口的请求/响应 + +### 小程序聚合服务 + +#### ✏️ MpOrderDetailVO + + - 🆕 `refundPolicy` (`Map`) — 退款政策（含政策名称和退款规则列表） + +#### ✏️ MpOrderListItemVO + + - 🆕 `refundAmount` (`BigDecimal`) — 实际退款金额 + +
+📁 全部变更文件 (点击展开) + +``` +M hl-insurance-service/src/main/java/com/hulalv/insurance/controller/InternalInsuranceController.java +M hl-mp-service/src/main/java/com/hulalv/mp/controller/MpRefundController.java +M hl-mp-service/src/main/java/com/hulalv/mp/dto/MpRefundAppealRequest.java +M hl-mp-service/src/main/java/com/hulalv/mp/feign/MpOrderFeignClient.java +M hl-mp-service/src/main/java/com/hulalv/mp/feign/MpOrderFeignFallbackFactory.java +M hl-mp-service/src/main/java/com/hulalv/mp/vo/MpOrderDetailVO.java +M hl-mp-service/src/main/java/com/hulalv/mp/vo/MpOrderListItemVO.java +M hl-order-service/src/main/java/com/hulalv/order/constant/OrderConstants.java +M hl-order-service/src/main/java/com/hulalv/order/entity/OrderTraveler.java +M hl-order-service/src/main/java/com/hulalv/order/feign/InsuranceFeignClient.java +M hl-order-service/src/main/java/com/hulalv/order/feign/InsuranceFeignFallbackFactory.java +M hl-order-service/src/main/java/com/hulalv/order/service/OrderPriceDiffService.java +M hl-order-service/src/main/java/com/hulalv/order/service/OrderService.java +M hl-payment-service/src/main/java/com/hulalv/payment/constant/PaymentConstants.java +M hl-user-service/src/main/java/com/hulalv/user/controller/InternalUserController.java +``` +
\ No newline at end of file