跳到主要内容

扫描住客权益

快速检查

大多数扫描不到 1 分钟。 增量刷新通常比完整重建更快。

当你需要扫描住客卡、刷新预订数据，或使用手动查找时，请使用本指南。 正常刷新会复用未变更的预订。 这样大多数更新更快，也能减少 PMS 读取次数。

区域作用你的预期
Scan将住客房卡与当天快照比对匹配到的预订会在屏幕上打开
Refresh重建当天的预订快照横幅会显示进度、数量和就绪状态
Manual lookup通过房号或确认号查找预订即使卡片无法读取，你仍然可以继续工作
Benefits管理权益定义和房价计划分配只显示 PMS 支持的操作
Activity显示当天消耗和同步状态你可以撤销或重试失败的同步

打开页面​

  1. 打开 Entitlements。

  2. 先停留在 Scan 标签页。

  3. 如果需要刷卡，选择一个已连接的编码器。

    ✓ 当快照就绪后，Start scanning 按钮会可用。

PMS 支持的房卡读卡器

当连接声明支持房卡读取时，AVA 可以通过 PMS 支持的读卡器扫描。 该读卡器会与其他符合条件的编码器一起显示。

刷新预订数据​

该页面会保留当前营业日期的本地快照。 正常刷新是增量刷新。 它会复用 PMS 修订版本没有变化的最新条目。

  1. 点击 Refresh 执行普通更新。

  2. 当快照看起来过旧，或你需要完整重建时，点击 Force full。

  3. 等待状态横幅变为就绪状态。

    ✓ 现在可以再次扫描房卡。

自动刷新

如果不存在活动快照，AVA 会自动开始第一次刷新。 如果刷新只返回当天的部分数据，AVA 会保留仍可用的行。 当刷新在后台运行时，现有的仅快照扫描仍然可用。

读取刷新次数​

状态横幅现在会显示刷新进度计数。

计数含义重要原因
Fetched从 PMS 新读取的预订数量越高，说明新增或变更的行越多
Reused从上一份快照沿用的预订复用越高，通常说明刷新越快
Pages本次刷新读取的已入住 PMS 列表页有助于发现缓慢或异常深入的列表扫描

使用这些计数来确认刷新是以复用为主，还是以完整重建为主。

扫描房卡​

  1. 打开 Entitlements。
  2. 保持在 Scan。
  3. 选择一个在线编码器。
  4. 点击 Start scanning。
  5. 刷住客房卡。
  6. 查看匹配到的预订。
  7. 当住客使用了该权益时，点击 Consume 1。
  8. 只有在管理人员批准例外时，才点击 Manager override。
  9. 完成该住客后，点击 Done。

✓ 横幅会短暂显示 Card scanned — ready for the next card in a moment。 ✓ 随后扫描会回到 Ready — tap the next card at any time。

使用手动查找​

当房卡无法读取，或你需要按房间号搜索时，请使用手动查找。 AVA 会先检查入住日期，再触发付费权益读取。 如果日期缺失或无效，请先修正预订。

  1. 已知房号时，使用 Look up by room。
  2. 已知预订号时，使用 Look up by confirmation number。
  3. 等待预订卡片出现。
  4. 以与扫描结果相同的方式使用权益卡片。
实时回退

当手动查找未命中缓存时，AVA 可能会实时查询 PMS。 该结果会带有备注显示，直到下一次刷新把它纳入快照。

读取快照状态​

横幅文本含义你要做什么
in-house reservations ready快照已就绪，可用于扫描开始扫描
Refreshing PMS reservations…AVA 正在重建快照等待刷新完成
using earlier same-day data当天刷新失败，但仍保留可用数据方便时再刷新一次
unavailable until the next refresh该预订暂时不可用刷新或使用手动查找
Reservation data must be refreshed before scanning还没有可用快照点击 Refresh
页面出现警告时

当 PMS 访问缺失、不受支持或不可用时，页面也会发出警告。 在这些情况下，现有快照可能仍然可见。

Benefits 和 Activity​

其他标签页的工作方式保持不变。

  • Benefits 会显示你的 PMS 暴露出来的权益目录。
  • Activity 会显示当天的消耗、撤销操作和重试操作。
  • 当 PMS 允许时，Rate plan assignments 仍然保留在 Benefits 中。

故障排查​

看到“Reservation data must be refreshed before scanning”​

解决方法：

  1. 点击 Refresh。
  2. 等待就绪状态。
  3. 如有需要，点击 Force full。
  4. 如果横幅没有更新，重新打开 Entitlements。

看到 PMS 警告​

解决方法：

  1. 如果当前快照仍可用，先继续使用它。
  2. 请管理员重新连接 PMS 或恢复功能访问。
  3. PMS 问题修复后，再刷新一次。

手动查找没有返回可用结果​

解决方法：

  1. 确认预订具有有效的入住日期。
  2. 核对房号或确认号是否正确。
  3. 在 PMS 中刷新该预订后再试一次。
  4. 如果快照仍然过旧，请使用 Force full。

扫描显示多个预订或没有匹配​

解决方法：

  1. 如果有多个预订匹配，请选择正确的住客。
  2. 检查所选编码器是否在线。
  3. 使用 Look up by room 或 Look up by confirmation number。
  4. 如果房卡仍然无法匹配，请让支持团队检查预订映射。

未启用实体房卡读取​

解决方法：

  1. 使用 Look up by room 或 Look up by confirmation number。
  2. 请管理员检查物业的房间访问能力。
  3. 确认已在 Settings → Room Access 中配置读卡器。
  4. 更新连接后重新加载 Entitlements。
手动查找仍然可用

连接无法读取房卡时，AVA 会停用刷卡。 房间和确认号查找仍然可用。

结果显示已在 PMS 实时检查​

解决方法：

  1. 直接将该结果用于当前住客。
  2. 点击 Refresh，让后续扫描使用更新后的快照。
  3. 如果实时结果仍然不对，请重新检查该预订。

仍然卡住？​

如果出现以下情况，请联系 success@vouch-technologies.com：

  • ❌ 快照始终不就绪
  • ❌ 扫描卡片时总是漏掉有效预订
  • ❌ 刷新后仍反复出现实时回退

建议附上：

  • 预订 ID 或确认号
  • 房号
  • 状态横幅截图
  • 问题开始的时间