如何完成入住登记
当证件已准备好时，大多数入住只需 3-5 分钟。本指南介绍客人使用 AVA 自助终端或辅助入住设备的入住体验。
本指南帮助你理解并支持从预订查询到房间权限发放的客人入住流程。客人可通过 AVA 的入住终端（通过 QR 码或 URL 访问）完成入住，支持三种模式：自助服务（CCI）、员工协助（ACI）或抵达前办理。
客人如何进入入住：
- 扫描物业现场展示的 QR 码
- 访问你提供的入住 URL
- 员工可通过辅助入住（ACI）界面协助办理
要从员工仪表板管理预订和房间分配，请前往 Reservations 页面（主页）。本指南聚焦于面向客人的入住体验。
这段短视频从客人视角展示完整的多房间入住流程。
快速参考
| 步骤 | 完成者 | 显示位置 |
|---|---|---|
| Reservation Lookup | 客人或员工 | Check In、Reservation Lookup 或 Staff Access |
| Document Upload | 客人或员工 | 每张房卡上的 Guest Verification |
| Bulk Upload | 员工（团队） | 房卡上方的 Upload All Documents 按钮 |
| Guest Information | 客人或员工 | Guest Information → Fill |
| Signature | 客人（有时是所有客人） | Signature → Sign |
| Facial Verification | 客人（CCI 或 ACI，启用时） | Facial Verification → Verify 或配对的客人平板 |
| Deposit / Payment | 客人（仅自助入住，启用时） | Reservation Requirements |
| Check-In / Pre-Arrival | 客人或员工 | Proceed to Check-In 或 Complete Pre-Arrival |
| Room Access | 客人或员工 | Room Information |
入住模式
| 模式 | 适用场景 | 变化内容 |
|---|---|---|
| Pre-Arrival | 抵达前的客人 | 不进行面部验证。使用 Complete Pre-Arrival。AVA 会把第一位客人的预计到达时间发送给受支持的 PMS。房间权限会在抵达时发放。 |
| Self Check-In (CCI) | 终端上的客人 | 可能出现面部验证。押金或付款可能会阻止 Proceed to Check-In。 |
| Assisted Check-In (ACI) | 员工主导入住 | 单设备 ACI 在员工设备上运行；双设备 ACI 会将客人步骤发送到配对平板。两种模式都会显示员工设备就绪状态。 |
这段短视频从员工视角展示完整的协助入住（ACI）流程。
开始之前
请确认以下事项：
- 预订处于活动状态（未取消或未到店）
- 客人已准备好护照或身份证
- 房间已准备好或可以分配
- 你的房卡编码器或智能门锁系统已联机
如果 ACI 显示 Staff verification recommended，请选择 Verify Device 并扫描最新的一次性终端 QR 码。 完成验证前，员工搜索和活动预订列表均不可用。 包括办理入住在内的会改变状态的 ACI 操作，都要求使用已验证的员工设备。 演示模式无需设备验证即可使用。
分步入住登记
如果 Guest Step Auto-Advance 已开启，AVA 会在你保存后自动打开下一步必填客人步骤。 如果关闭，你需要手动选择下一步。
1. 查找预订
-
在 Check In 页面扫描客人的护照或身份证
-
如果无法扫描，选择 Use Confirmation Number Instead
-
输入确认号并选择 Continue
✓ 你应该会看到该预订的房卡
如果重复查询，AVA 会刷新当前的单设备 ACI 会话。 它会保留现有查询历史，并允许你继续在同一员工设备上操作。
在加载或刷新活动预订列表前验证员工设备。 验证后，AVA 会为当前浏览器和酒店加载新列表。 如果凭据被撤销或不可用，AVA 会清除列表并要求重新验证。
如果客人提供的是 OTA 或外部预订参考号，请在同一字段中输入。 AVA 会先检查确认号，再将外部参考号作为回退值。 对于 Opera 预订，AVA 会先验证完整记录再选择结果。 精确参考号查询无结果时，AVA 会再用大写参考号重试一次。 AVA 会在完整预订记录上忽略大小写差异进行比较。 如果详细信息不匹配或 Opera 返回不明确结果，AVA 不会选择预订。
扫描查询只匹配昨天和今天的到店。提前或未来到店请使用确认号。
Cloudbeds 预订查询超时
你会看到： 查询一直转圈，随后显示超时或服务不可用错误。
原因： 如果 Cloudbeds 没有响应，AVA 会在 20 秒后停止等待。
解决方法：
- 稍等几秒钟。
- 再试一次查询。
- 确认 Cloudbeds 可以访问，而且该预订确实存在。
- 如果超时持续发生，请联系支持。
如果扫描结果落在已取消或已退房的预订上，AVA 会刷新姓名查询并再次尝试活动匹配。 如果刷新后的结果仍不明确，AVA 会显示标准的 Multiple reservations found 流程。
在扫描查询、确认号查询或 Room List 文档上传重试后，你也可能看到 Verify Your Booking。 这使用同一套预订姓名验证流程。 当 AVA 需要额外预订确认时，也会出现该面板。请参见 部分匹配的预订姓名验证 和 姓名不一致 OTP 回退。 如果该预订已验证，重试时 AVA 会保留结果。 在 ACI 中，当物业启用该功能时，员工可以用人工确认替代客人 OTP。 请参见 ACI Staff Override for Name Mismatch。
如果你使用辅助入住（ACI）
- 在欢迎页选择 Check In
- 打开 Staff Access
- 按客人姓名、预订 ID 或外部预订 ID 搜索
- 选择正确的预订
✓ 你会看到房间列表
某些 Mews 预订会共享同一个外部预订 ID。 如果 Mews 发送了预订组 ID，AVA 会将每个预订组分开处理。
在 ACI 中合并分别预订的同名预订
当同一客人在同一次住宿中拥有多个独立的 OPERA 预订时，可使用此选项。 它只为当前 ACI 流程合并房间，不会改变 OPERA 中的预订关系，也无需手动输入其他确认号。
-
在 Staff Access 中选择主要预订。
-
查看 Other reservations with the same guest name (optional)。
-
选择属于同一到店的其他预订。
-
检查每个预订的编号和住宿日期。
-
选择 Proceed。
✓ AVA 会在一个辅助入住流程中打开合并后的房间。
只选择主客人相同且住宿日期重叠的预订。不要选择已取消、未到店、已退房或已办理入住的预订。
AVA 如何计算合并房间中的客人数
在每个追加房间中，AVA 会隐藏追加预订复制的主客人。 该复制档案不会占用客人名额，也不会增加 PMS 入住人数；你可以登记该房间实际预订的客人。
例如，为两位客人预订的房间可以登记两位客人；合并 ACI 入住后，PMS 入住人数仍为两人。 此行为仅适用于手动 ACI 合并所选的预订，普通 ACI 合并及无关的重复身份保持原有行为。
Staff Access 只显示 昨天和今天 的到店。要查找其他日期，请按确认号搜索。
如果 Opera 或其他 PMS 发送了历史业务日期，ACI 仍然可以完成入住。 AVA 会保留计算出的日期用于诊断，并显示手动房间访问说明。 此例外不适用于 Smart Locks、Keycards 或 Lockers。
如果客人已完成抵达前预登记
先按确认号找到预订，然后在客人到达时继续使用 Proceed to Check-In。
2. 检查房间和客人
确认每个房间都有正确的客人。★ 表示主客人。
如果预订有多个房间
- 选择 Set Your Rooms
- 将客人移动到正确房间
- 之后如需移动客人，请使用 Change Room
- 当所有客人都已分配后，选择 I'm Done
现在即使该客人还未上传证件，Change Room 也会保留你选择的客人。 这可以防止 AVA 在多房间预订中移动错人。
一旦客人状态为 Verified，AVA 会隐藏 Change Room。 请在最终验证步骤之前先移动客人。
如果你在入住完成前重新打开 Change Room，AVA 会显示 Room 1、Room 2 等。 你仍会在每个标签下看到房型。
如果你使用 Opera OHIP，AVA 会在查询后将你搜索的房间保留为主房卡。
即使 Opera 将该预订组归一到主确认号，这个行为也依然成立。
如果 Opera 在另一间房中重复相同的 nameId，AVA 会把后续房间的客人槽留空，供员工输入。
即使 OPERA 用不同的内部 ID 存储客人记录，这也有帮助。
如果你使用 Cloudbeds，AVA 会在房间分配后继续同步主预订。 这样 Cloudbeds 将一笔预订拆分为多个子预订时，房卡依然准确。
入住开始时，AVA 会重新检查每个已分配房间。 如果有一个房间未准备好，整个家庭都会被阻止。 对于 Opera，AVA 只接受已经分配给该预订的房间。 如果 Opera 为一个脏房预分配房间返回了另一个可用房间，AVA 会保留原始房间为阻止状态。
如果多房间预订中的某个房间被取消或已退房，AVA 会跳过该房间。 查询后你只会看到活动房卡。
AVA 会阻止你在入住期间把预订的主客人移动到其他房间。 如果需要移动主客人，请在入住开始前更新房间分配。
如果员工在 PMS 中更新了房间，AVA 会在打开房间分配前刷新当前房间。 你看到的是最新房号和房间 ID，而不是旧的入住记录。 如果 PMS 现在没有房间，AVA 会清除本地过期房间，并在该设置开启时使用无房间自动分配重试。
如果你使用 Opera OHIP，AVA 在分配新实体房间时会保持收费房型不变。 这样在更换房间时，folio 房型会保持稳定。
如果你需要补充缺失的客人
- 为该房间选择 Add Guest
- 上传客人的证件
- 完成客人信息
如果你使用 Opera OHIP，AVA 在你保存时也会更新 Opera 中的房间客人列表。 这样新增客人在入住后仍会与该房间关联。
如果某位客人不在场
- 在该客人下方选择 Check In Later
- 当他们到达时，选择 Check In Now 继续其步骤
✓ 该客人会被跳过，不会阻塞主客人
检查 ACI 房间状态
在双设备 Assisted Check-In (ACI) 中，查询预订后每张房卡都会显示 PMS 房间信息。 这些房间详情和房间操作仅在双设备 ACI 中可用；单设备 ACI 不会加载 PMS 运营房间数据。
| 字段 | 含义 | 应采取的操作 |
|---|---|---|
| Assigned room | PMS 当前分配的房间 | 确认与预订一致 |
| Room status | PMS 房态及状态代码 | 房间为 Clean 或 Inspected 时继续 |
| Occupancy | PMS 报告房间为 Vacant 或 Occupied | 入住前确认房间为空置 |
房态包括 Clean、Dirty、Inspected 和 Out of service。如果房间为 Dirty、Out of service 或 Occupied，AVA 会显示就绪警告。
-
选择 Find ready rooms。
-
查看同房型、空置且已准备好的房间。
-
选择房间，然后选择 Confirm。
✓ AVA 会更新 PMS 分配并刷新房间信息。
PMS 更改房间后，选择 Assigned room 旁的刷新图标。 只有 PMS 返回一个匹配房间时，AVA 才会保存新分配；若无房间或结果不明确，则保留已存分配，并将状态显示为 Unavailable。 对于 Opera，合法的空置且停用响应表示该条件没有阻塞房间；缺失或格式错误的响应仍显示 Unavailable，需要检查 PMS。
请在办理入住和发放房间权限之前重新分配房间。任一事件发生后，请员工在 PMS 中更新分配。
3. 上传证件
-
在客人的 Guest Verification 区域选择 Document Upload → Upload
-
扫描客人的护照或身份证
✓ 证件状态会切换为完成，并显示证件号码
如果 PMS 的客人数更新失败，AVA 仍会保留已上传的证件。 保存暂存证件时也是如此。 你不需要再次扫描证件。
提示： 如果有多位客人办理入住，请使用页面顶部的 Upload All Documents。详见下方章节。
如果客人在前后摄像头之间切换，AVA 会自动更新扫描提示。 这样屏幕上的指引会与当前活动摄像头保持一致。
需要确认允许哪些证件吗？请参见 Accepted Travel Documents。
如果你看到重复证件警告
你可能会看到 "Passport Already Uploaded" 或 "This passport is already registered to..."。
- 选择 Scan Another Guest's Passport 继续扫描
- 选择 Go to Existing Guest 查看原始客人
使用 Upload All Documents 处理多位客人
在团队入住时，Upload All Documents 允许你在保存前一次性扫描所有护照。
在 ACI 中扫描超出预订人数的客人
在 Assisted Check-In (ACI) 中，批量上传可以使用房间容量扫描原始预订之外的额外客人。 AVA 会先将已预订客人显示为必填名额；额外容量名额为可选，不会阻止完成。 扫描完所有已预订证件后，选择 Add extra guest，或在复核步骤选择 Add an extra guest's passport or ID。 房间容量必须大于当前客人数；CCI 和抵达前办理仍使用原有的已预订客人上限。
步骤 1：扫描所有护照
- 选择房间列表顶部的 Upload All Documents
- 逐一扫描每位客人的护照
- 进度追踪器会显示每本护照的上传状态
- 如果某次扫描失败，选择 Rescan passport 重试
步骤 2：查看并分配
扫描完成后，你会看到一份待分配的护照列表。
- 系统会根据姓名匹配建议每本护照对应的客人
- 如果建议正确，无需操作
- 如需分配给其他客人，请在列表中选择对应客人
- 如需新增客人，请选择 Create new guest
分配显示方式：
- 3 位或更少客人：卡片式选择按钮
- 超过 3 位客人：下拉菜单，便于紧凑显示
步骤 3：保存分配
- 检查所有护照与客人的对应关系
- 选择 Insert Guests 保存
- 任何错误都会显示在受影响的护照旁边
- 逐一修复问题，必要时重试
常见错误：
- "Document number not detected" → 在更好的光线下重新扫描
- "Already uploaded for [guest]" → 分配给其他客人
- "Guest limit reached" → 分配给现有客人，不要新建
步骤 4：验证预订（仅在姓名不一致时）
如果扫描文件上的姓名与预订不一致，AVA 会在 Insert Guests 处暂停，并显示 Verify Your Booking 面板。
-
阅读提示："The document name differs from this reservation."
-
在预订邮箱中查找 4 位验证码
-
输入验证码并选择 Verify Code
-
如果验证码未收到，请在短暂倒计时后选择 Resend Code
✓ 验证码通过后，AVA 会自动保存分配。无需再次选择 Insert Guests。
当 AVA 需要额外预订确认时，也会出现 Verify Your Booking 面板。请参见 部分匹配的预订姓名验证 和 姓名不一致 OTP 回退。 在 ACI 中，请检查你的物业是否启用了员工覆盖。 启用后，覆盖提示会替代客人 OTP。 请参见 ACI Staff Override for Name Mismatch。
4. 完成客人信息
-
选择 Guest Information → Fill
-
确认所有字段。必填字段会显示
* -
如有需要，更新 Document Number
-
选择 Save
✓ Guest Information 步骤会显示为完成
对于额外客人，Guest Information 卡片顶部会显示 Same contact details as [main guest name]。 开启后，会从主客人复制 Email、Phone 和 Address。 复制后的字段仍可见且可编辑。 如果主客人没有联系方式，AVA 会禁用该开关并显示手动输入提示。
如果客人没有电话号码，AVA 会使用护照国籍作为默认国家代码。 已有电话号码会保留其已保存的国家代码。
当客人输入地址或旅行字段时，AVA 会让 Google Places 更偏向客人的国籍。 如果国籍为空，AVA 会回退到酒店所在国家。
如果你在 Document Number 下方看到警告，请再次核对证件。警告不会阻止入住。
如果客人信息保存失败
你会看到： 选择 Save 后，Guest Information 卡片显示错误状态。
解决方法：
-
检查必填字段并纠正无效值。
-
再次打开 Guest Information → Fill。
-
选择 Save。
-
如果错误再次出现，请刷新页面后重试。
✓ 成功重试后，卡片应恢复为已保存状态。
5. 采集签名（如需要）
-
选择 Signature → Sign
-
采集客人签名
✓ Signature 步骤会显示为完成
说明： 默认情况下，主客人必须签名。某些酒店要求所有客人都签名。
员工设备上未显示客人信息变更
请让客人完成当前字段编辑并点按字段外，短暂等待草稿更新；同时在员工设备上保持匹配的 Guest Information 表单打开。确认刷新后的值后选择 Save。若没有刷新，请重新打开 Guest Information → Fill。
6. 进行面部验证（仅自助入住）
如果显示 Facial Verification：
-
选择 Facial Verification → Verify
-
按照屏幕提示操作摄像头
✓ Facial Verification 步骤会显示为完成
提示： 面部验证仅在 Self Check-In (CCI) 模式下出现。
说明： AVA 会优先比较证件上最清晰的面部。 这样可以减少护照淡水印的干扰。
如果面部验证失败
- 选择 Take another selfie 拍摄更清晰的照片
- 如果仍然失败，选择 Re-upload document 重新扫描
7. 收取押金或付款（仅自助入住）
如果 Reservation Requirements 显示 Deposit 或 Payment：
-
选择 Pay
-
完成支付步骤
✓ 支付要求会显示为完成
如果终端支付已经完成，AVA 在重试时会保持该要求为完成状态。 除非收据显示扣款失败，否则不要发起第二次支付。
说明： 只有所有显示的付款都成功后，入住才能完成。
8. 完成入住
-
选择 Proceed to Check-In
-
等待进度页面完成
✓ 房卡会显示入住完成状态
提示： 在入住过程中，系统会执行 Checking Availability → Assigning Room → Generating Keys → Finalizing。
如果这是抵达前预登记
- 完成上面的所有必需步骤
- 选择 Complete Pre-Arrival，而不是 Proceed to Check-In
✓ 房间会被标记为已完成抵达前预登记。客人到达时会发放房间访问权限。
如果你的 PMS 支持 ETA 更新，AVA 会在抵达前办理后把第一位客人的预计到达时间写回去。 如果你的 PMS 不支持，它仍会正常完成入住。 Opera/OHIP 预订现在支持这条更新路径。
如果房间已经办理入住
选择 Proceed to Check-In 可完成剩余客人的入住。这不会重新分配房间。
9. 提供房间访问权限
入住完成后，打开房卡上的 Room Information：
- Room Number 显示在顶部
- Room Access 取决于你的物业设置
如果你使用 Keycards：
如果你使用带有 PMS 集成编码器的 Opera，AVA 会先等待已确认的钥匙状态。 较旧的 Opera 响应可能不会返回该状态。 随后 AVA 会最多等待 30 秒，检查已保存的房间、钥匙数量和有效期。 如果请求仍然超时，请从同一房间重新尝试该卡。
-
如果你在 ACI 中，请先确认交接完成。
-
选择 Retrieve Keycard 现在编码卡片。
-
如果卡片已提前编码，选择 Already Encoded。
-
在提示时为每张卡片执行编码。
-
如果你需要更少的卡片，请在 keycard 弹窗中选择 Complete Check-In
✓ 如果只有一个编码器在线，AVA 会在开始编码前短暂显示 Preparing keycard encoding...。
AVA 会保持在当前房间，直到 keycard 成功完成编码。 当最后一次成功的编码响应把卡片标记为已领取后，下一个房间才会打开。
如果出现 Win A Complimentary 1-Night Stay 弹窗，请先关闭它。 然后选择 Complete Check-In。
如果你使用 Smart Locks：
-
选择 Show PIN
-
将 PIN 提供给客人
✓ 如果房卡仍显示 Pending 或 Partial success，请先等待状态变为就绪。
如果你使用 Lockers：
- 提供 Locker Number
- 选择 Show Code 并分享 locker code
如果你看到的是房间访问消息而不是 code，请按屏幕提示操作。
只有当 Settings → Room Access 设为 Locker Systems 时，Manage Locker Code 和 locker code 才会出现。 如果 AVA 仍在加载房间访问模式，请等待后从房卡重试。
提示： 如果配置了 WiFi，WiFi 区域会显示名称和密码。房间备注会显示在 General Information 下。
房卡消息会遵循客人语言，即使包含 ko-KR 这样的地区代码也是如此。
如果你使用辅助入住（ACI）
入住完成后，页面会显示 Check-In Complete 并要求客人归还设备。 如果房间使用 keycard，请先确认交接完成。 随后，keycard 控件会出现在房卡上。 新卡请选择 Retrieve Keycard，提前准备好的卡请选择 Already Encoded。 在演示模式下，keycard 按钮会在交接后出现。
故障排查
扫描后找不到预订
你会看到： "Reservation not found" 或者你被带到确认页面。
如果首个匹配项无效，AVA 会刷新姓名查询并再次尝试活动预订。 你可能无需再次搜索就会看到替代预订。
解决方法：
- 改为输入确认号，不要扫描
- 确认到店日期是今天或昨天
- 检查预订是否已取消或标记为未入住
找到多个预订
你会看到： "Multiple reservations found."
解决方法：
- 按确认号搜索
- 在 Staff Access 中按预订 ID 或外部预订 ID 搜索
入住按钮被禁用
你会看到： Proceed to Check-In 显示 "Complete all steps."
请检查：
- 所有客人的 Document Upload 都已完成
- 每位客人的 Guest Information 都已保存
- 需要签名的客人 Signature 已完成
- Facial Verification 已完成（仅自助入住）
- 显示的 Deposit 和 Payment 已完成
- 缺失客人已标记为 Check In Later 或已添加
房间未准备好或时间太早
你会看到： "Room not ready"、"No rooms available"，或者在 Proceed to Check-In 之后入住失败。
解决方法：
- 在 PMS 或 Room Status 中检查房态
- 如果允许，分配另一间房
- 如果客人还需要完成其他房间，选择 Continue registration
- 如果你想停止当前入住，选择 End session
- 遵循你的提前入住政策
当你选择 Continue registration 时，AVA 会让多房间客人继续留在当前 Room List 流程中。 这样你可以完成剩余房间，而无需把所有人送回主页。
End session 使用与顶部栏相同的终端退出行为。 它会关闭当前会话并把客人带回终端起始屏幕。
如果你使用 Opera，不允许的房态条件现在会使用同样的房间未准备好流程。
如果多房间预订中的某个房间仍未准备好，AVA 会阻止整个家庭。 在重试前，请在 Housekeeping 或 PMS 中检查每个已分配房间。
如果到达入住时间后仍没有可用房间，AVA 会把预订排队并发送房间未准备好邮件。 房间已准备好的邮件之后仍会发送。
可选优惠弹窗阻止完成
你会看到： Win A Complimentary 1-Night Stay 弹窗出现在 Complete Check-In 之前。
解决方法：
- 关闭弹窗
- 再次选择 Complete Check-In
文档上传失败
你会看到： "Document upload failed" 或上传停止。
解决方法：
- 用更好的光线再试一次扫描
- 选择 Upload Document 并改用清晰照片
- 如果问题持续，请使用 Use Confirmation Number Instead
本节只适用于文档没有保存的情况。 如果文档已经保存，只是 PMS 客人数同步失败，AVA 会保留上传结果。 如果客人数在 PMS 中看起来仍然不同，请稍后再检查预订。
批量上传错误
你会看到： 在 Upload All Documents 模式下，特定护照旁边出现错误，例如：
- "Document number not detected"
- "Already uploaded for [guest name]"
- "Guest limit reached"
解决方法：
- 对于检测错误，选择 Rescan passport 并在更好的光线下扫描
- 对于重复项，将护照分配给其他客人
- 对于客人数量限制，选择现有客人而不是创建新客人
- 如果错误持续，关闭弹窗并对有问题的护照使用单独上传
批量上传时请求验证码
你会看到： 选择 Insert Guests 后没有保存，而是打开 Verify Your Booking 面板。这通常发生在 AVA 发现边缘姓名不一致时。
解决方法：
-
打开预订邮件并找到 4-digit code
-
输入验证码并选择 Verify Code
-
如果邮件还没到，倒计时结束后选择 Resend Code
-
如果验证码一直失败，请再次确认你看的是最新邮件
✓ 一旦验证码被接受，AVA 会自动保存分配。
如果文档姓名不同但没有出现验证面板，姓名匹配可能太弱，无法触发此回退。 OTP Fallback for Name Mismatch 或 booking name verification for partial matches 也可能关闭了。 请参见 Document Checks。 在 ACI 中，请检查你的物业是否启用了员工覆盖。 启用后，覆盖提示会替代客人 OTP。
面部验证一直失败
你会看到： "Facial Verification Failed" 或不匹配屏幕。
解决方法：
- 在更明亮的光线下重新自拍
- 如果头像模糊，重新上传证件
- 如果客人仍然无法通过，请按你的人工复核流程处理
房间访问不显示
你会看到： 入住后没有代码或 keycard 选项。
解决方法：
- 刷新房卡并确认入住已完成
- 如果 Room Access 显示 Pending 或 Partial success，请等待完成。
- 前往 Settings → Room Access 并确认当前启用的房间访问方式
- 返回入住页面并重新打开 Room Information
- 查看是否有 Room Access 错误消息，并按说明操作
- 如果访问仍然不显示，请联系支持
如果 Room Access 返回结构化失败，AVA 现在会先显示上游消息。
这可能包括来自 Room Access 或 PMS 的嵌套 message 或 error.message 文本。
你不应再在这个流程中看到 [object Object]。
ACI 中隐藏 keycard 控件
你会看到： 入住后看不到 Retrieve Keycard 或 Already Encoded。
解决方法：
- 先确认员工交接完成。
- 等待房卡刷新。
- 按钮出现后再选择 Retrieve Keycard 或 Already Encoded。
ACI 操作需要验证员工设备
你会看到： 员工搜索、预订、退房或入住操作不可用，并显示 Staff verification recommended。
原因： 当前浏览器的 STAFF 凭据缺失、过期、被撤销，或属于其他设备或酒店。
解决方法： 确认使用正确的员工浏览器或终端设备；让管理员从 Settings → Kiosk 显示最新 ACI 验证 QR；选择 Verify Device，允许摄像头权限并扫描 QR，然后等待页面重新加载。
扫描器会将验证保留在当前浏览器环境中，QR 只能使用一次。请参见 验证 ACI 员工设备。
单设备 ACI 在重复查询后停止
如果看到 “Unable to bind the assisted check-in journey to this staff device”，请从同一 Staff Access 页面再次查询，等待房卡显示后继续；必要时按 ACI 操作需要验证员工设备 操作。一次重试后仍被阻止，请刷新 AVA 并联系支持。
找不到同名预订合并选项
确认使用 Assisted Check-In (ACI)，且终端员工设备已验证。只选择同一客人、日期重叠且仍有效的预订；移除已入住、待退房、已取消或已属于其他组的预订。手动合并要求 PMS 支持原子多房间入住，如仍失败请联系支持。
追加房间显示额外客人
确认选择了 Other reservations with the same guest name 中属于同一客人和到店的预订。退出后从 Staff Access 重新开始合并流程，并确认复制的档案已隐藏；追加房间应能接受已预订客人而不增加 PMS 入住人数。
付款步骤未打开
如果 Pay 保持禁用并显示 Processing，请等待 AVA 准备房价和符合条件的套餐，不要再次选择 Pay，以免重复发起付款。如仍未打开，请联系支持。
ACI 房间分配未刷新
如果房态显示 Unavailable 或 PMS 更新后房号未变，请在 PMS 确认分配；在双设备 ACI 中选择 Assigned room 旁的刷新图标，等待房态和入住人数更新。若出现多个房间，请先在 PMS 保留正确分配后再次刷新。
Cloudbeds 房间分配需要最新房态
在 Cloudbeds 中确认日期、房型及房间为 Vacant 且已准备好，解决尚未完成的房间或房务更新，然后刷新 AVA 并只重试一次。超时后 AVA 不会自动重放最终写入；重试前请先确认 Cloudbeds 中没有完成分配。
护照只显示出生年份
部分护照只公布出生年份。若机读区确认该部分日期，AVA 可接受并保持日期不完整；不要自行填写 1 月 1 日。若日期不可读或缺失，请在均匀光线下重新扫描整页。
Cloudbeds 入住人数不可预订
如果看到 PMS_OCCUPANCY_NOT_BOOKABLE，请检查 Adults、Children、出生日期、Child Maximum Age、房型、日期和 Cloudbeds 入住规则，修正预订或费率后刷新 AVA 并重试一次。不要重复提交相同的入住人数拆分。
Cloudbeds 在这些日期没有可用性
如果看到 PMS_OCCUPANCY_UNAVAILABLE_FOR_DATES，请在 Cloudbeds 检查日期、房型和可用房间，选择可用房间或日期，等可用性更新后刷新 AVA 并重试一次。
Cloudbeds 来源税设置需要审核
如果看到 PMS_RATE_PRESERVATION_SOURCE_TAX_UNSUPPORTED，请勿重复提交相同客人数变更。检查 Cloudbeds 的预订来源、房型及来源税费规则，并让管理员修正不支持的规则；之后刷新 AVA，重试 Registration 或最终入住一次。该错误发生前不会写入 PMS 入住人数。
需要协调客人数
如果看到 PMS_GUEST_COUNT_RECONCILIATION_REQUIRED，请选择 End session，在 PMS 中协调客人数和预订总额，确认记录正确后在 AVA 开始新的登记。不要选择 Continue registration 或重试被隔离的变更。
客人数同步已达到重试上限
出现 PMS_GUEST_COUNT_RETRY_EXHAUSTED 时，不要再让客人重试相同步骤。改用员工协助或人工入住流程，比较并修正 PMS 客人数，并在员工流程允许时恢复待处理变更。
扫描器操作位于屏幕下方
在扫描器弹窗内滚动到操作栏，保持浏览器窗口全高，使用固定操作栏中的 Proceed 或 Next。控件仍隐藏时，关闭弹窗并重新打开 Upload All Documents。
ACI 重新发送不会重新打开摄像头
从员工面板重新发送 Facial Verification，等待客人平板重新打开摄像头，并让客人再次完成步骤。若显示 Pair this tablet，先恢复双设备配对。请参见 辅助入住设置。
ACI 员工覆盖不可用
确认员工设备已为当前酒店验证、客人平板仍与当前预订配对，并重新发送 Facial Verification。保持当前面部验证失败状态可见，完成现场身份核验后选择 Staff override 并输入原因。请参见 设置面部验证。
签名或面部验证耗时过长
等待 AVA 保存结果；若步骤已完成则继续入住，稍后刷新客人或预订记录确认下游同步。连接服务响应慢时，AVA 会保留已保存的签名或面部验证结果，并在客人步骤返回后继续同步。
房卡房间无法确定
刷新房卡，在 PMS 中确认预订已分配房间，再打开 Room Information 并重试 Retrieve Keycard。AVA 接受有效的长型或内部格式 PMS 房间标识，不要手动修改房间标识。
仍然卡住？
如果出现以下情况，请联系 success@vouch-technologies.com：
- ❌ 扫描或输入确认号后仍找不到预订
- ❌ 完成所有步骤后入住仍被阻止
- ❌ 入住完成后房间访问仍不显示
建议附上：
- 错误截图
- 预订确认号
- 客人姓名和到店日期
- 问题开始时间