Merge branch 'main' of https://git.1814.love/wx/hl-api-changelog

changelogs-v2/2026-10/10_8818_团期核单酒店候选查询-新增接口-管理后台.md

@@ -318,6 +318,24 @@ Authorization: Bearer {admin-token}
 - 所有 `hotelId`/`roomTypeId`/`protoPriceRoomTypeId`/`coverMaterialId` 为 String（Long 序列化），所有金额字段为 String（BigDecimal 序列化），前端按字符串接收即可。
 - 本接口只读、幂等，可在下拉搜索框高频调用（建议前端做防抖）。
 
+### 12.1 核单行「付款方式」取值约定（关联提示）
+
+选中酒店后，核单住宿行保存时需填「付款方式」`paymentMethod`（保存走核单明细接口，不在本候选接口范围）。该字段约定如下，**单体核单与团期核单完全同一套**：
+
+- **走数据字典取值**：字典类型 `settlement_payment_method`，前端调字典接口取下拉选项（**不要前端硬编码三个值**）。
+- **提交**：把字典的 `value` 填进 `paymentMethod`。
+- **展示**：列表/详情用后端带回的 `paymentMethodName`（中文名后端已拼好，前端不必再翻译）。
+
+字典 `settlement_payment_method` 标准值（3 个）：
+
+| value | 中文 | 说明 |
+|-------|------|------|
+| `CASH_PAID` | 现金已付 | 已现金/即时付掉 |
+| `COMPANY_PAID` | 公司支付 | 已对公转账付掉 |
+| `SIGNED` | 签单 | 挂账，周期与酒店/供应商结算 |
+
+**⚠️ 与候选接口 `settleType` 的区别（勿混用）**：本候选接口带回的 `settleType`（值域 `cash`/`sign`/`company`，字典 `resource_settle_type`）是**酒店主数据上的习惯结算方式**，与核单行 `paymentMethod`（本次实际付款动作）是**两个字典、两套值**。前端可用 `settleType` 给 `paymentMethod` 做**默认推荐**（如酒店 `settleType=sign` 默认选中 `SIGNED`），但**必须把值做映射后再填，不能直接拿 `settleType` 的值塞进 `paymentMethod`**（`cash`≠`CASH_PAID`，值域不同）。
+
 ## 13. 关联 / 联系人
 
 ### 13.1 链接