59 行
2.8 KiB
Markdown
59 行
2.8 KiB
Markdown
# 订单详情「服务标准」Tab 退费说明（refundNotes）修复——现可正确返回数据
|
||
|
||
- **端类型**：管理后台
|
||
- **变更类型**：缺陷修复（接口结构不变，仅恢复数据流）
|
||
- **日期**：2026-06-02
|
||
- **Issue**：[#3354](https://git.1814.love:8443/wx/HL/issues/3354)
|
||
- **PR**：[#3355](https://git.1814.love:8443/wx/HL/pulls/3355)
|
||
- **Commit**：[db61c2d](https://git.1814.love:8443/wx/HL/commit/db61c2da1193be0e0954dacdfd8f154e3ba5d912)
|
||
- **后端负责人**：wx
|
||
|
||
---
|
||
|
||
## ① 背景
|
||
|
||
订单详情「服务标准」Tab 接口（`GET /v3/admin/order/{id}/service-standard`，#3340 已上线的聚合结构）中，`refundNotes`（退费说明）字段此前一直返回空数组，即使绑定资源已配置退费说明。
|
||
|
||
根因是**资源退费说明根本存不进库**：资源服务自定义的字段自动填充处理器只填一期命名字段（createdAt/updatedAt），漏填二期命名字段（createTime），导致退费说明保存接口报错（create_time 不能为空），全表 0 条存活记录 → 下单冻快照时节点 `refundNote` 恒 null → 服务标准 Tab 退费说明永远为空。
|
||
|
||
本次修复后端自动填充处理器，退费说明可正常保存并随订单快照冻结。
|
||
|
||
---
|
||
|
||
## ② 变更清单
|
||
|
||
**接口结构无任何变化**（`refundNotes` 字段在 #3340 已定义）。修复后行为：
|
||
|
||
| 接口 | 方法 | 路径 | 变更内容 |
|
||
|------|------|------|----------|
|
||
| 订单服务标准 | GET | `/v3/admin/order/{id}/service-standard` | `refundNotes` 现对「绑定了退费说明的 SCENIC/ACTIVITY 行程节点」正确返回数据（修复前恒为空） |
|
||
|
||
`refundNotes[]` 结构（不变，复述）：
|
||
|
||
```
|
||
refundNotes: [
|
||
{
|
||
sourceName, // 来源点位名称，如「呼和诺尔草原旅游区」
|
||
intro, // 退费说明备注
|
||
items: [
|
||
{ title, amount, unitLabel, settleScope, settleScopeLabel, remark, effectiveFrom, effectiveTo }
|
||
]
|
||
}
|
||
]
|
||
```
|
||
|
||
测试服实测（订单 2061673442020651009）：`refundNotes` = 呼和诺尔草原旅游区 → [成人未参加 ¥44 /人（按人）, 整团未到 ¥100 /团（按团）]，`settleScopeLabel` 字典中文已正确解析。
|
||
|
||
---
|
||
|
||
## ③ 前端动作
|
||
|
||
**无需改动**。#3340 前端已对接 `refundNotes` 结构，仅需知悉：之前看到的退费说明为空是后端缺陷，现已修复，对已配置退费说明的资源会正常返回。
|
||
|
||
---
|
||
|
||
## ④ 备注
|
||
|
||
- 同一 Tab 的「出团注意事项」（`notices`）能否有数据，取决于**产品是否配置了「服务标准模板」**（产品域 Step5 补充信息配置项）。当前测试库暂无产品配置该模板，故 `notices` 仍为空；这属于数据配置，非接口缺陷，与本次修复无关。
|
||
- 「行程」（`itinerary`）一直正常。
|