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

54 行
1.7 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# fix(contract): 12301 申报合同硬编码两个投诉电话字段
**日期**: 2026-04-28
**PR**: #1537 (commit 4e63f5d53a)
**工单**: #1536
**影响端**: 后端内部12301 平台必填字段补全)
---
## 背景
12301 申报合同 API 的 `travelAgency` 块两个必填投诉电话字段当前**完全没拼装到 JSON**,触发青岛文旅局案例文1-2 ¥10万 + 停业3月 P0 红线。
## 后端改动
`TourageRequestBuilder.buildTravelAgency` 末尾追加 2 行:
```java
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. 必须包含:
```json
"travelAgency": {
...
"localComplaintPhone": "12301",
"complaintPhone": "470-8222122",
...
}
```
4. 12301 平台返回 success 不再因投诉电话字段缺失拒签