From 12d25a7f35c7fb452721d9ed2e11ded0a72a1e63 Mon Sep 17 00:00:00 2001 From: yaosutu <770858045@qq.com> Date: Sat, 10 Oct 2026 10:04:11 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=E6=A0=B8=E5=8D=95=E4=BB=98?= =?UTF-8?q?=E6=AC=BE=E6=96=B9=E5=BC=8F=E5=8F=96=E5=80=BC=E7=BA=A6=E5=AE=9A?= =?UTF-8?q?=EF=BC=88settlement=5Fpayment=5Fmethod=20=E5=AD=97=E5=85=B8?= =?UTF-8?q?=EF=BC=8C=E5=8D=95=E4=BD=93/=E5=9B=A2=E6=9C=9F=E4=B8=80?= =?UTF-8?q?=E8=87=B4=EF=BC=89=E5=8F=8A=E4=B8=8E=20settleType=20=E5=8C=BA?= =?UTF-8?q?=E5=88=86=E8=AF=B4=E6=98=8E=EF=BC=88#8818=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...8_团期核单酒店候选查询-新增接口-管理后台.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/changelogs-v2/2026-10/10_8818_团期核单酒店候选查询-新增接口-管理后台.md b/changelogs-v2/2026-10/10_8818_团期核单酒店候选查询-新增接口-管理后台.md index 024d9127..27c49664 100644 --- a/changelogs-v2/2026-10/10_8818_团期核单酒店候选查询-新增接口-管理后台.md +++ b/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 链接