From 1f77becb704e2f43597bf739f7b734baa9ce9f05 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Fri, 10 Jul 2026 18:27:10 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E9=80=9A=E7=9F=A5=E5=89=8D=E7=AB=AF?=
 =?UTF-8?q?=E6=8E=A5=E5=85=A5=E9=85=92=E5=BA=97=E6=94=AF=E4=BB=98=E6=96=B9?=
 =?UTF-8?q?=E5=BC=8F=E4=B8=8E=E8=AF=A2=E6=88=BF=E8=AF=9D=E6=9C=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...˜æ–¹å¼�快照与订房确认è¯�术-å‰�端待处ç�†-管ç�†å�Žå�°.md | 248 ++++++++++++++++++
 1 file changed, 248 insertions(+)
 create mode 100644 changelogs-v2/2026-07/55_4893_酒店支付方�快照与订房确认�术-�端待处�-管���.md

diff --git a/changelogs-v2/2026-07/55_4893_酒店支付方�快照与订房确认�术-�端待处�-管���.md b/changelogs-v2/2026-07/55_4893_酒店支付方�快照与订房确认�术-�端待处�-管���.md
new file mode 100644
index 0000000..d4a496e
--- /dev/null
+++ b/changelogs-v2/2026-07/55_4893_酒店支付方�快照与订房确认�术-�端待处�-管���.md
@@ -0,0 +1,248 @@
+# 酒店支付方�快照与订房确认�术
+
+- 状�：frontend-todo
+- �端工�：[wx/HL#4893](https://git.1814.love:8443/wx/HL/issues/4893)
+- �务：`hl-resource-service`�`hl-order-service-v3`
+- 日期：2026-07-10
+- 影�端：管��� `hl-ui-v2.1` 酒店资��房务选酒店��房修改��制询房�术
+- �端代�状�：�端本次未修改 `hl-ui`，以下项目需由�端正�接入
+
+## 一�关键结论
+
+| 项目 | 最新�径 |
+| --- | --- |
+| �端显示� | 支付方� |
+| �端字段 | 统一�用 `settleType` |
+| å­—å…¸ | `resource_settle_type` |
+| 字典值 | `cash` / `sign` / `company` |
+| 删除字段 | 酒店�房务链路��使用 `paymentMode` |
+| �房�存 | `settleType` 与�议价�结算价一样�存到�房快照 |
+| 写回资� | �有显�传 `syncSettleType=true` �写回酒店资�，默认�写回 |
+| �制动作 | �是原“�制询房�术�，��新增第二个“订房确认书�按钮 |
+| 文案�� | 直接�制�端 `messageBody`，�端��二次拼接或补酒店� |
+
+支付方�文案映射：
+
+| `settleType` | �术第 1 行 |
+| --- | --- |
+| `cash` | `领队��现付，价格�密。` |
+| `sign` | `签�，价格�密。` |
+| `company` | `公�付款，价格�密。` |
+
+## 二�酒店资��置
+
+### 涉�接�
+
+| 接� | 方法 | �化 |
+| --- | --- | --- |
+| `/admin/hotel/item` | POST | 创建请求新增 3 个�置字段 |
+| `/admin/hotel/item/{hotelId}` | GET | 详情�应新增 3 个�置字段 |
+| `/admin/hotel/item/{hotelId}` | PUT | 更新请求新增 3 个�置字段 |
+
+### 新增字段
+
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `breakfastIncluded` | Boolean | � | 是��早�；新建未传时兼容从设施“早��推断 |
+| `canIssueInvoice` | Boolean | � | 是��开�票；默认 `false` |
+| `bookingReplyContacts` | String | � | 订房回��系人，�填写多人展示文本，最长 255 |
+
+示例：
+
+```json
+{
+  "settleType": "cash",
+  "breakfastIncluded": true,
+  "canIssueInvoice": true,
+  "bookingReplyContacts": "哈撒尔，原景销售�苗"
+}
+```
+
+�端�求：
+
+- 酒店资�表�继续用 `settleType`，资�管�页�显示����“结算方��。
+- 增加“�早��“�开�票�“订房回��系人�三个�置控件。
+- ��读���交或展示酒店 `paymentMode`。
+- 存�早�已由�端按设施包�“早��或酒店标签“�早��兼容；�票默认�；回��系人为空时�术回退 `contactPerson`。
+
+## 三�房务选酒店与�房快照
+
+### 候选与详情读�
+
+| 接� | �应字段 | �端处� |
+| --- | --- | --- |
+| `GET /v3/admin/hotel-candidates` | `items[].settleType` | 选酒店弹窗“支付方��默认值 |
+| `GET /v3/admin/house/hotels` | `records[].settleType` | 房务酒店列表展示/筛选 |
+| `GET /admin/house/orders/{orderId}` | `itinerary[].assignments[].settleType` | 已�存�房的支付方�快照 |
+
+候选�列表�详情中的 `paymentMode` 已删除，�端类型和兼容代��步删除。
+
+### �交或替��房
+
+接�：
+
+```http
+POST /v3/admin/order/hotel-requirements/{requirementId}/assignments
+```
+
+`items[]` 新增：
+
+```json
+{
+  "hotelId": "200001",
+  "roomTypeId": "300001",
+  "settleType": "cash",
+  "syncSettleType": false
+}
+```
+
+| 字段 | 类型 | 必填 | 约� | 说明 |
+| --- | --- | --- | --- | --- |
+| `settleType` | String | � | `cash/sign/company` | �传时�酒店资�当��置并冻结到快照 |
+| `syncSettleType` | Boolean | � | 默认 `false` | `true` �把本次支付方�写回酒店资� |
+
+### 修改���房
+
+接�：
+
+```http
+PUT /v3/admin/order/assignments/{assignmentId}
+```
+
+请求体�样支�：
+
+```json
+{
+  "settleType": "sign",
+  "syncSettleType": true
+}
+```
+
+交互�求：
+
+- `PickHotelModal.vue` 增加“支付方��，默认带出候选酒店的 `settleType`，�许修改。
+- 选中项必须�留 `settleType`，�交�房时�传，�能��留价格字段。
+- 与�议价�结算价一致，支付方�写回资�必须由用户显�确认；未确认传 `false`。
+- 编辑已�房记录时，默认使用 `assignments[].settleType`；旧快照为空时�回退当�候选酒店的 `settleType`。
+- 支付方���金�转�，也��使用 `Number()`。
+
+## 四��制询房�术
+
+接�：
+
+```http
+POST /v3/admin/order/inquiry/preview
+```
+
+### 已�房场景请求
+
+�制按钮当��在“已�房/询房中���用，因此必须把订�和�房 ID 传给�端：
+
+```json
+{
+  "hotelId": "200001",
+  "orderId": "30456",
+  "assignmentId": "99999"
+}
+```
+
+�端按以下优先级生�：
+
+| 内容 | 优先级 |
+| --- | --- |
+| 团� | `order.teamNo` → `order.orderNo` → `待补充` |
+| 日期�房型�间数 | �房快照 → 请求兜底字段 |
+| 支付方� | �房 `settleType` 快照 → 酒店资� `settleType` → `cash` |
+| 核房电� | `roomSharePhone` → `contactPhone` → `待补充` |
+| 回��系人 | `bookingReplyContacts` → `contactPerson` → `待补充` |
+| 备注 | 酒店标签用 `�` 连接；无标签为 `无` |
+
+### 未�存�房的兼容请求
+
+�有确实拿�到 `assignmentId` 时，�使用以下兼容�数：
+
+```json
+{
+  "hotelId": "200001",
+  "orderId": "30456",
+  "stayDate": "2026-08-11",
+  "roomCount": 2,
+  "roomCategory": "DOUBLE_BED"
+}
+```
+
+旧�数 `nights`�`messageBody` ���与新模�生�，�端应移除。
+
+### �应与精确文案
+
+```json
+{
+  "code": 200,
+  "success": true,
+  "data": {
+    "messageBody": "呼�旅行 - 订房确认书：\n团�：ZK-835-260808-3563\n日期：8.11\n房型：全景大床2间\n备注：�早���原景观\n1.领队��现付，价格�密。\n2.�早��票\n3.核房电�：0470-8290955\n辛苦确认�回� @哈撒尔，原景销售�苗",
+    "contactName": "王��",
+    "contactWechat": "hotel-wx"
+  }
+}
+```
+
+�制结果必须��为：
+
+```text
+呼�旅行 - 订房确认书：
+团�：ZK-835-260808-3563
+日期：8.11
+房型：全景大床2间
+备注：�早���原景观
+1.领队��现付，价格�密。
+2.�早��票
+3.核房电�：0470-8290955
+辛苦确认�回� @哈撒尔，原景销售�苗
+```
+
+### 当��端必须修改的兼容逻辑
+
+当� `useHousekeeperInquiryCopy.js` 会在�端文案��酒店�时调用 `buildInquiryPhrase()` �拼旧�术。新固定文案按需求本�就�包�酒店�，因此必须改为：
+
+- �功�应�直接�制 `res.messageBody`。
+- ��检查文案是�包�酒店�。
+- ��用 `buildInquiryPhrase()` 二次拼接。
+- �留现有剪贴�失败�的“手动�制询房�术�弹窗。
+- 按钮��“�制询房�术�，��增加第二个�制动作。
+
+## 五�删除 `paymentMode` 的影��
+
+以下酒店/房务契约��返回或接收 `paymentMode`：
+
+| 范围 | 处� |
+| --- | --- |
+| 房务酒店列表请求和�应 | 删除 `paymentMode` 筛选�展示 |
+| 酒店候选�应 | 删除 `paymentMode` |
+| 酒店基础信�/扩展信� | 删除 `paymentMode` |
+| 签�与打�行程�酒店� | 删除 `paymentMode`，�留 `settleType` 中文翻译 |
+
+注�：订�主�的 `order_main.paymentMode`（`DEPOSIT/FULL`）是订�收款模�，与本次酒店字段无关，�得删除或改�。
+
+## 六��端验收清�
+
+| # | 验收项 | 预期 |
+| --- | --- | --- |
+| 1 | 酒店资�编辑 | ��存�早���开�票�订房回��系人 |
+| 2 | 选酒店弹窗 | 支付方�默认等于候选酒店 `settleType`，�改 |
+| 3 | 默认�存 | �房详情回显修改�的 `settleType`，资�酒店�� |
+| 4 | 显��步 | `syncSettleType=true` �资�酒店 `settleType` �步�化 |
+| 5 | 现付文案 | 第 1 行为“领队��现付，价格�密。� |
+| 6 | 签�文案 | 第 1 行为“签�，价格�密。� |
+| 7 | 公�付款文案 | 第 1 行为“公�付款，价格�密。� |
+| 8 | 电�回退 | 核房电�为空时显示�系人电� |
+| 9 | �系人回退 | 订房回��系人为空时显示酒店�系人 |
+| 10 | �制实现 | �制内容与�端 `messageBody` �字一致，��拼旧�术 |
+| 11 | 删除旧字段 | 酒店/房务页���引用 `paymentMode` |
+| 12 | 订�收款模� | 订�主� `paymentMode=DEPOSIT/FULL` �正常 |
+
+## 七��影�范围
+
+- 现有报价�订�创建和价格固化�继续使用�议价 `protocolPrice/protoPrice`。
+- 结算价 `settlementPrice` 的既有逻辑��。
+- 本次�修改 `hl-ui` 代�；以上�为正��端交接内容。