跳到主要内容

手动编码门卡

快速编码

编码器在线后，大多数手动门卡约 2 分钟即可完成。

本指南帮助你无需打开预订，也能从 Operations View 手动编码门卡。

前往： Operations View → Encode Keycard

Operations View 标题栏中的 Encode Keycard 按钮

可用条件

只有当 Settings → Room Access 设置为 Key Card Encoding (Kiosk) 时，才会显示 Encode Keycard。

标题栏编码与预订级编码​

AVA 提供两种门卡编码方式。理解它们的区别，可以在不修改设置的情况下发放补卡或额外门卡。

方式位置门卡数量
标题栏级别（绿色按钮）Operations View 顶部，位于 Help 旁边始终可选 1 到 10，不受设置影响
预订级别预订卡片或行上的钥匙图标按钮受你的 Room Access 设置控制
  • 预订级别 按钮会遵循 Settings → Room Access 中配置的门卡数量。如果这里设为 1，你就不会看到重复门卡选项。
  • 顶部绿色 Encode Keycard 按钮可随时编码额外门卡，即使你的设置是 1 张也可以。
编码补卡或额外门卡

如果客人需要第二张门卡，而你的房间出入设置只允许 1 张，请使用 Operations View 顶部绿色 Encode Keycard 按钮。你无需修改设置。

快速参考​

字段必填默认值或说明
Select Keycard Encoder是如果只有一台编码器在线，AVA 会自动选中它。在线表示设备和隧道都正常。
Room Number是选择 PMS 房号。编码器房名会显示为辅助文字。
Guest Name否可选。
Valid From是默认当前时间。
Valid Until是默认到次日你配置的门卡过期时间；如果没有，则回退到 11:00 AM。
Number of Keycards否默认 2 张。可选 1 到 10 张。
房号显示

房间列表会先显示面向 PMS 的房号。 如果不同，AVA 会在括号中显示编码器房名。

Valid Until 默认值

AVA 会使用 Settings → Room Access → Keycard Expiration Time 作为 Valid Until 的默认时间。 如果该设置缺失或无效，AVA 会使用 11:00 AM。

手动编码门卡​

  1. 前往 Operations View。

  2. 选择 Encode Keycard。

    ✓ 会打开 Manual Keycard Encoding 弹窗。

  3. 如果只有一台编码器在线，AVA 会自动选中它。

  4. 如果有多台编码器在线，请选择状态为 Online 的那一台。 该状态取决于实时 agent 连接。

  5. 从下拉列表中选择 Room Number。

    ✓ 主标签会显示 PMS 房号。 如果已映射，还会显示 (Encoder: ...) 辅助文字。

  6. 可选：输入 Guest Name。

  7. 设置 Valid From 和 Valid Until。

  8. 选择 Number of Keycards。

  9. 点击 Encode Keycard。

    ✓ 门卡编码流程会打开。

故障排查​

预订级别没有重复卡选项​

你看到的情况： 你打开预订并点击钥匙图标编码门卡，但没有第二张或重复门卡选项。

原因： 你的 Room Access 设置为每次入住只编码 1 张门卡。预订级按钮会遵循这个限制。

解决方法：

  1. 改用 Operations View 顶部绿色 Encode Keycard 按钮。这个按钮始终允许选择 1 到 10 张。
  2. 如果你希望预订级别始终允许 2 张，请让 AVA 管理员在 Settings → Room Access 中把设置更新为 2 张门卡。

缺少 Encode Keycard 按钮​

你看到的情况： Operations View 中没有 Encode Keycard 按钮。

解决方法：

  1. 前往 Settings → Room Access。
  2. 将 Room Access Method 设为 Key Card Encoding (Kiosk)。
  3. 返回 Operations View。

Encode Keycard 按钮被禁用​

你看到的情况： 按钮是灰色的，或显示 “Missing merchant ID. Configure your account in Settings.”

解决方法：

  1. 在 Settings 中完成账号设置。
  2. 刷新页面。

“No encoders found”​

你看到的情况： 编码器列表显示 “No encoders found.”

解决方法：

  1. 前往 Settings → Room Access。
  2. 添加或启用编码器。
  3. 返回 Encode Keycard。

跳过编码器选择​

你看到的情况： AVA 直接打开编码页面，没有显示编码器选择。

解决方法：

  1. 确认当前只有一台编码器在线。
  2. 继续编码即可，这属于预期行为。
  3. 如果你需要手动选择，请让另一台编码器上线。

房号看起来正确，但编码使用了其他房间代码​

你看到的情况： 你选择了房间 101，但编码器日志显示的是其他房间值。

解决方法：

  1. 前往 Settings → Room Access → Keycard Encoder Room Mapping。
  2. 找到所选的 PMS 房间。
  3. 确认映射的 Encoder Room Name 正确。
  4. 保存映射后再次编码。

仍有问题？​

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

  • ❌ 无法打开手动编码弹窗
  • ❌ 每次编码都失败
  • ❌ 完成设置后仍未显示编码器

建议附上：

  • 编码器类型和位置
  • 使用的房号和日期
  • 错误截图

相关指南​