补充核单付款方式取值约定(settlement_payment_method 字典,单体/团期一致)及与 settleType 区分说明(#8818)

这个提交包含在:
yaosutu
2026-10-10 10:04:11 +08:00
父节点 aeb5106d90
当前提交 12d25a7f35
@@ -318,6 +318,24 @@ Authorization: Bearer {admin-token}
- 所有 `hotelId`/`roomTypeId`/`protoPriceRoomTypeId`/`coverMaterialId` 为 String(Long 序列化),所有金额字段为 String(BigDecimal 序列化),前端按字符串接收即可。 - 所有 `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. 关联 / 联系人
### 13.1 链接 ### 13.1 链接