临时到店预订
在 Settings → Check-In 中启用临时到店预订，并连接支付网关。之后，客人可在 5 分钟内直接从自助终端预订房间。
本指南介绍如何启用临时到店预订，以及客人在自助终端上的体验流程。
快速参考
| 步骤 | 客人操作 | 结果 |
|---|---|---|
| 搜索房间 | 输入日期和住客人数 | 显示可报价的可用房型和房价 |
| 选择房间 | 选择房型和费率 | 计算入住总额 |
| 输入信息 | 填写姓名、邮箱、电话、国家 | 采集客人信息用于预订 |
| 支付 | 扫描 QR 码或打开支付页面 | 安全处理付款 |
| 确认 | 屏幕显示预订 ID | 在 PMS 中创建预订并发送确认邮件 |
开始前
请确认以下要求：
- 你的 PMS 已在 Settings → Essentials → PMS Connection 中连接并处于激活状态
- 支付网关已在 Settings → Payment 中连接
- 已在 Settings → Check-In 中启用临时到店预订（见下一节）
如果你使用 Cloudbeds
连接 Cloudbeds 时，需要授予以下 API 权限：
- Room: Read - 用于查询可用房型
- Rate: Read - 用于获取房价和定价
- Payment: Read - 用于在预订上记录付款
如果缺少任何权限，AVA 在你尝试启用临时到店预订时会显示错误。请使用所需权限重新连接 Cloudbeds，然后重试。
临时到店预订要求在创建预订前完成在线支付。如果没有连接支付网关，客人将无法完成预订。请先在 Payment Gateway Integration 中连接一个网关。
启用临时到店预订
-
前往 Settings → Check-In
-
滚动到 Walk-In Booking 区域
-
勾选 Enable Walk-In Reservation Booking
-
点击 Save
✓ 自助终端欢迎界面现在会显示 Book Reservation 按钮。
如果你在没有支付网关的情况下启用临时到店预订，AVA 会显示警告。该功能会启用，但在你连接网关之前，客人无法完成预订。
客人如何使用临时到店预订
当没有预订的客人到达时，他们可以直接从自助终端预订房间。
第 1 步：开始预订
客人在自助终端欢迎界面点击 Book Reservation。
第 2 步：搜索可用房间
-
客人输入入住信息：
- Check-in Date
- Check-out Date
- Adults（至少 1 位）
- Children
-
他们点击 Search Available Rooms
✓ 会显示一个可用房型列表，包含照片、描述和房价。
系统会显示在所选日期有已发布费率且有可用房间的房型。可用性会根据你输入的日期和住客人数，直接从 PMS 获取。
Rooms 页面可能会先显示完整的 PMS 目录。 临时到店预订只会显示你能够针对所选入住条件报价的房型。 如果 PMS 提供物业币种，AVA 会将其用于每晚房价和总价。
如果没有结果，说明这些日期没有已发布费率的房间。请让客人尝试其他日期，或者在 PMS 中检查房间可用性。
第 3 步：选择房间
- 客人点击某个房型查看完整详情：
- 房间照片（可滑动浏览的图库）
- 描述和设施
- 床型、房间面积、吸烟偏好
- 每晚房价和预估总价（含税费）
- 他们点击 Continue with this room
第 4 步：输入客人详情
客人填写个人信息：
| 字段 | 必填 | 说明 |
|---|---|---|
| First Name | 是 | |
| Last Name | 是 | |
| 是 | 确认邮件会发送到这里 | |
| Phone Number | 否 | 建议填写，便于联系 |
| Country | 视情况而定 | Cloudbeds 必填；所有系统都建议填写 |
填写表单后，客人点击 Continue to Payment。
第 5 步：支付
客人选择一种支付方式：
- Pay on your device - 屏幕上会出现 QR 码。客人用手机扫码即可打开安全支付页面。
- Pay on this device - 直接在自助终端屏幕上打开支付页面。
屏幕会显示 "Waiting for payment confirmation..."，直到支付完成。
第 6 步：确认
支付成功后：
- 会出现 Booking Confirmed 页面，并显示预订 ID
- 会向客人的邮箱发送确认邮件
- 预订会自动创建到你的 PMS 中
- 付款会记录到 PMS 中该预订上
预订完成后
- 新预订会出现在你的 PMS 和 AVA 的预订列表中
- 如果你的物业支持自助入住，客人可以继续办理
- 你可以像处理其他预订一样查看和管理该预订
临时到店预订只会创建预订并处理付款。它不会分配具体房间，也不会授予钥匙权限。客人必须先完成单独的自助入住流程（证件扫描、住客验证、房间分配、钥匙权限），之后才能进入房间。
如果客人希望在预订后立即入住，他们可以返回自助终端欢迎界面，并使用新预订开始常规入住流程。
故障排查
"Walk-in booking feature is disabled"
你会看到： 客人点击 Book Reservation 后出现错误。
解决方法：
- 前往 Settings → Check-In
- 启用 Walk-In Reservation Booking
- 点击 Save
"No room rates are available for the selected dates"
你会看到： 客人搜索房间，但什么都没有显示。
检查：
- 这些日期在 PMS 中存在房间
- 房价已在 PMS 中发布并处于激活状态
- Settings → Essentials → PMS Connection 中的 PMS 连接处于激活状态
房型在 Rooms 中可见，但在临时到店预订中不可见
你会看到： 房型在 Rooms 中可见，但自助终端将其隐藏。
解决方法：
- 检查该房型在所选日期是否有已发布费率。
- 使用正确的住客人数重新搜索一次。
- 确认你的 PMS 可以为该房型报价。
- 如果同步后该房型仍未出现，请在 PMS 同步完成后刷新页面。
"Selected room is being booked by another guest"
你会看到： 客人尝试为某个房型付款时出现错误。
原因： 另一位客人正在预订该房型最后一间可用房间。
解决方法：
- 请客人选择其他房型
- 或等待几分钟后重试 - 另一笔预订可能会超时
"Payment integration is not configured"
你会看到： 生成支付时出现错误。
解决方法：
- 前往 Settings → Payment
- 连接受支持的支付网关（Stripe 或 Red Dot）
- 返回自助终端后重试
支付失败或超时
你会看到： 支付页面显示错误，或者自助终端一直停留在 "Waiting for payment confirmation..."。
解决方法：
- 请客人重新尝试支付
- 如果仍然失败，请在 Settings → Payment 中检查支付网关状态
- 确认支付网关账户处于激活状态且没有任何限制
启用时出现权限错误（Cloudbeds）
你会看到： 错误信息列出了缺失的 Cloudbeds 权限。
解决方法：
- 前往 Settings → Essentials → PMS Connection
- 断开并重新连接 Cloudbeds
- 授予所有必需权限：Room: Read、Rate: Read、Payment: Read
- 返回 Settings → Check-In 并再次启用临时到店预订
"Selected room type is sold out"
你会看到： 选择房间时出现错误信息。
解决方法： 该房型已售罄。请选择其他日期或其他房型。
费率币种看起来不正确
你会看到： 每晚房价或总价显示的币种与预期不同。
解决方法：
- 检查你的 PMS 是否提供物业币种。
- 如果提供，AVA 会在临时到店报价中使用该币种。
- 否则，请检查 Settings → Essentials → Hotel Basic Details。
- 在 PMS 同步后刷新自助终端页面。
仍然卡住？
如果出现以下情况，请联系 success@vouch-technologies.com：
- ❌ 在 PMS 同步后，临时到店搜索仍然隐藏房型
- ❌ 刷新后费率币种仍然不正确
- ❌ 支付成功，但预订没有创建
- ❌ 客人在搜索房间时反复看到错误
建议附上：
- 入住日期和退房日期
- 住客人数
- 预订尝试的时间