hl-api-changelog/changelogs-v2/2026-06/02_3354_订单服务标准-退费说明修复.md

订单详情「服务标准」Tab 退费说明（refundNotes）修复——现可正确返回数据

• 端类型：管理后台
• 变更类型：缺陷修复（接口结构不变，仅恢复数据流）
• 日期：2026-06-02
• Issue：#3354
• PR：#3355
• Commit：db61c2d
• 后端负责人：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）一直正常。