hl-api-changelog/changelogs/2026-04/28_fix_contract_hardcode-complaint-phones.md

fix(contract): 12301 申报合同硬编码两个投诉电话字段

日期: 2026-04-28 PR: #1537 (commit 4e63f5d53a) 工单: #1536 影响端: 后端内部（12301 平台必填字段补全）

---

背景

12301 申报合同 API 的 travelAgency 块两个必填投诉电话字段当前完全没拼装到 JSON，触发青岛文旅局案例文1-2 ¥10万 + 停业3月 P0 红线。

后端改动

TourageRequestBuilder.buildTravelAgency 末尾追加 2 行：

agency.put("localComplaintPhone", "12301");        // 全国旅游服务热线 (固定)
agency.put("complaintPhone", "470-8222122");       // 呼伦贝尔本地投诉电话 (固定)

设计决策

字段	值	为什么硬编码不读 Nacos
localComplaintPhone	"12301"	国家文旅部全国统一旅游投诉热线，全国所有旅行社都填这个，不会变
complaintPhone	"470-8222122"	呼伦贝尔本地投诉电话，跟 Nacos agencies[].complaint-phone=4000881814 是不同语义（4000881814 是呼籁客服热线，470-8222122 是文旅监管投诉热线）

影响

• 12301 申报合同 API 调用即生效，避免被 12301 平台拒签
• 前端无感知

部署状态

⏸ 待手动触发 Deploy Panel 部署 hl-order-service-v2 到测试服。

部署后验证

1. 测试服跑一单 12301 标准模式合同（产品场景：境内游 7 日）
2. 查 hl-order-service-v2 日志找到 12301 标准接口请求 body
3. 必须包含：

   "travelAgency": {
     ...
     "localComplaintPhone": "12301",
     "complaintPhone": "470-8222122",
     ...
   }
   

4. 12301 平台返回 success 不再因投诉电话字段缺失拒签