查询住客权益
选择编码器后，一分钟内即可扫描一张卡片。
当你需要通过扫描房卡查看住客包含的权益时，请使用本指南。 本指南也介绍手动查找，以及页面上会显示的扫描状态。
前往： Entitlements
| 任务 | 点击位置 | 结果 |
|---|---|---|
| 开始扫描 | Start scanning | 读卡器开始等待房卡 |
| 停止扫描 | Stop | 扫描循环停止，冷却也会取消 |
| 查看匹配结果 | Scan 标签页 | 显示住客详情和可用额度 |
| 按房号查找住客 | Look up by room | 无需刷卡即可打开匹配的预订 |
| 按预订查找住客 | Look up by confirmation number | 无需刷卡即可打开匹配的预订 |
| 查看消费历史 | Activity 标签页 | 显示今日的兑换记录 |
| 管理权益设置 | Benefits 标签页 | 如果系统支持，会显示权益定义 |
| 控制 PMS 消费同步 | Settings 标签页 | 选择是否将符合条件的兑换写回 PMS |
开始扫描
-
前往 Entitlements。
-
选择正确的 encoder。
-
点击 Start scanning。
-
在读卡器上轻触住客的房卡。
✓ 会显示住客姓名、房间和包含的权益。
如果移开房卡，AVA 会继续显示最后匹配到的住客。 这样你就有时间完成当前兑换。
理解扫描状态
| 状态 | 你会看到什么 | 含义 | 该怎么做 |
|---|---|---|---|
| Ready | Ready — tap the next card at any time | 读卡器正在等待房卡 | 扫描下一位住客 |
| Cooldown | Card scanned — ready for the next card in a moment | AVA 在匹配成功后短暂暂停 | 等待约 2 秒 |
| Paused | Scanning paused | 你停止了扫描，或清除了匹配结果 | 再次点击 Start scanning |
| Auto-paused | Scanning paused after 3 reads without a card | AVA 连续检测到多次无卡读取 | 重新放好房卡，然后重新开始扫描 |
| Multiple matches | Multiple reservations matched — pick the guest | 这张卡匹配到多个预订 | 选择正确的住客 |
| Error | 出现红色错误消息 | 扫描请求失败 | 检查读卡器后重试 |
一次成功扫描后，下一张房卡不会立即开始读取。 请等到显示就绪状态后，再扫描下一位住客。
手动查找住客
当房卡无法读取时，请使用手动查找。
-
先尝试 Look up by room。
-
输入或选择房号。
-
点击 Look up。
-
如有需要，使用 Look up by confirmation number。
-
输入确认号或预订 ID。
-
点击 Look up。
✓ 无需刷卡即可打开匹配的预订。
开始手动查找前，系统会先停止任何正在进行的读卡操作。 查找运行期间，Start scanning、编码器和候选项控件会保持不可用。 如果有多个预订匹配，选择其中一个不会重新启动读卡扫描。
如果有多个预订匹配，请从列表中选择正确的住客。
如果某个预订未出现在每日快照中，AVA 会实时检查 PMS。 这样，新创建或最近更新的预订无需手动刷新也能显示。
每日快照中没有结果时，手动查找可以实时检查 PMS。 高频房卡扫描会继续使用每日快照，以保持稳定性能。
回答住客的权益问题
已验证身份的住客可以向聊天机器人或语音助手询问包含的权益。 例如，他们可以询问今天是否包含早餐。
助手可以说明某项权益是否：
| 住客询问 | 助手可以说明 |
|---|---|
| 包含早餐吗？ | 该权益是否包含在内 |
| 今天可以使用吗？ | 今天是否可用 |
| 什么时候可以使用？ | PMS 提供时，说明下一可用日期 |
权益结果为空本身就是完整的回答。 助手会告诉住客该权益不包含在内。 它不会把空列表视为信息缺失。
助手会自动使用住客已验证的住宿信息。 住客无需在问题中提供预订号或房号。 回答会显示权益详情，不会显示仅供员工查看的兑换或账单信息。
检查分组预订
AVA 会将同一房间的关联预订合并为一个结果。 如果 PMS 提供了预订入住人数，结果中会显示该人数。 系统还会将住客标记为 Primary、Sharer、Accompany 或 Guest。 对于 Opera 的共享住客组合，AVA 会将两位住客保留在同一个房间结果中。 即使 PMS 将他们返回在不同的预订列表页面中，这一行为也同样有效。
AVA 会选择关联预订中额度最高的一项。 如果额度相同，则以 Primary 预订为准。 关联额度不会相加。
记录兑换前，请使用住客名册确认住客身份。 兑换会继续关联到提供该额度的预订。
如果 PMS 未提供预订入住人数，AVA 不会显示为零。
使用权益
Benefits 标签页会显示已连接 PMS 的权益定义。 只要权限允许，你就可以搜索目录并管理项目。
- Per guest 和 Per room 表示谁可以获得该额度。
- Every night 和 Once per stay 表示添加频率。
- The following day 和 The same day / night 表示住客何时可以使用。
查看活动记录
Activity 标签页显示今天的消费历史。
新的兑换和撤销记录可能会显示已登录员工的个人资料名称。 AVA 不会使用电子邮件地址作为显示名称。 较早的记录保持不变，不会回填名称。 如果无法获取个人资料，记录可能会显示通用的员工标签。
- Saved in Streamliner 表示兑换已在本地记录。
- PMS sync pending 或 PMS sync retrying 表示 AVA 仍在同步。
- PMS synced 表示 PMS 已收到更新。
- Ledger only 表示 PMS 不支持同步此项目。
- PMS sync failed 表示如果你有权限，可以重试。
打开 Settings 来控制 PMS 消费同步。 该开关默认关闭。 即使关闭同步，Vouch 仍会记录并报告每一笔兑换。 启用同步时，之前仅保存在本地的兑换不会补写回 PMS。
撤销操作会直接更新页面上显示的权益计数。 它不需要后续刷新，因此不会中断正在进行的读卡扫描。
故障排查
下一次扫描开始得太快
你会看到： 下一位住客刷卡后，当前结果立即被替换。
解决方法：
- 等待冷却消息消失。
- 不要在短暂停顿期间刷下一张卡。
- 如有需要，点击 Stop，然后再次点击 Start scanning。
空读几次后扫描暂停
你会看到： 页面显示 Scanning paused after 3 reads without a card。
解决方法：
- 确认房卡已放在读卡器上。
- 检查所选编码器。
- 再次点击 Start scanning。
找不到房卡
你会看到： 房卡没有产生住客匹配结果。
解决方法：
- 使用 Look up by room 或 Look up by confirmation number。
- 确认预订仍然有效。
- 如果仍然找不到住客，请检查 PMS 连接。
手动查找显示旧结果
你会看到： 开始新的查找后，页面显示之前的查找或扫描结果。
解决方法：
-
等待当前查找完成。
-
在查找完成前，不要选择其他候选项。
-
使用正确的房号或确认号开始新的查找。
✓ AVA 会保留最新的查找结果，并忽略较早的响应。
新预订在手动查找中缺失
你会看到： 新建或最近更新的预订没有返回任何权益。
解决方法：
-
在 PMS 中确认预订有效且住客已入住。
-
再次使用 Look up by room 或 Look up by confirmation number。
-
等待实时查找完成。
-
再次检查权益。
✓ 当预订未出现在每日快照中时，AVA 会实时检查 PMS。
如果 PMS 中没有匹配的有效预订，AVA 将不返回任何权益。
权益或活动记录为空
你会看到： Benefits 或 Activity 标签页几乎没有数据。
解决方法：
- 确认该物业已启用 PMS 权益功能。
- 检查该预订是否确实包含权益。
- 保存 PMS 更改后刷新页面。
仍然无法解决？
如果出现以下情况，请联系 success@vouch-technologies.com：
- ❌ 编码器始终无法进入就绪状态
- ❌ 重新开始扫描后仍不断暂停
- ❌ 屏幕上一直显示错误的住客
建议附上：
- 预订 ID 或房号
- 编码器名称
- 扫描横幅截图