跳到主要内容

门卡房间映射

快速设置

先启用映射，选择一个 PMS 房间，再输入编码器房间名。大约 5 分钟即可完成。

本指南帮助你将 PMS 房间映射到编码器系统所使用的准确房间名称。 AVA 会本地化此映射页面，因此标签和提示会跟随你选择的语言显示。 当你的供应商支持库存同步时，你可以把房间、建筑和楼层数据拉入复核列表。 在 Room floor mapping 模式下，你选择的编码器可以复用已保存的建筑和楼层值用于门禁。 当 PMS 房间、映射或配置正在加载时，页面会先显示加载状态。 只有在加载完成后，才会显示空状态消息。

电梯权限支持

如果你选择的编码器支持电梯权限，请在 Settings → Room Access 中打开 Enable lift access。 然后选择 Lift access mode。

  • Room floor mapping 会使用你房间映射中的建筑和楼层值。
  • Access code groups 会使用 Common access codes 处理共享门或电梯分组。

AVA 一次只发送一种模式。 使用 Access code groups 时，AVA 会把单个数字保存为两位数代码。 你可以输入 1,2,3 或 01,02,03。 代码要保持在供应商支持的范围内。

ACSHotel 房号

如果你使用 ACSHotel，请输入来自 SDK 或房间映射的精确锁号。 AVA 接受 6 到 8 位的字母数字锁号，并会原样发送。 请保留前导零，不要手动补零。

合并房间是分开的

当编码器房间名与 PMS 房间名不同时，请使用本页面。 当一个 PMS 房间需要打开多个实体房间时，请使用 合并房间。 需要编辑别名时，请从页面标题打开 Combined Rooms。 合并房间会在房间列表中显示 Combined 徽章和 Opens N rooms 标签。 如果你选择的编码器不支持多房间门卡，且已经存在别名，Combined Rooms 可能会切换为 Reset only。 切换编码器后，你可以移除旧别名，但不能为不受支持的供应商添加新的别名。

快速参考​

任务作用点击位置
启用映射打开或关闭映射Keycard Encoder Room Mapping → Enabled/Disabled
选择房间选择要映射的 PMS 房间PMS Rooms 列表
输入编码器名称保存准确的编码器房间名Encoder Room Name 字段
从供应商同步将房间、建筑和楼层数据拉入复核模式Sync from vendor
编辑或移除更新或删除映射Edit 或 Remove 图标
合并房间让一个 PMS 房间打开多个实体房间设置合并房间

合并房间按钮状态​

状态你可以做什么出现条件
Full可添加、编辑和重置别名你选择的编码器支持多房间门卡
Reset only只能移除已有别名你选择的编码器不支持多房间门卡，但已有别名仍被保存
Disabled无法进行合并房间操作你选择的编码器不支持多房间门卡，且没有别名

入口位置​

Settings → Room Access → Keycard Encoder Room Mapping

需要 keycard:mapping 权限，并且房间访问方式必须是 Keycard Encoding。

第 1 步：启用房间映射​

  1. 打开 Keycard Encoder Room Mapping。

  2. 切换 Enabled。

    ✓ 房间列表会变得可用。

第 2 步：选择 PMS 房间​

  1. 如有需要，使用 Search rooms...。

  2. 在 PMS Rooms 列表中点击一个房间。

    ✓ 右侧面板会显示 Encoder Mapping for: [Room Name]。

第 3 步：输入编码器房间名​

  1. 在 Encoder Room Name 中输入编码器实际使用的名称（例如 101 或 SUITE-A）。

  2. 可选：添加 Building、Floor 和 Description。

  3. 打开或关闭 Active。

  4. 点击 Save Mapping。

    ✓ 该房间会在列表中显示为 Mapped。 ✓ 当你选择的编码器处于 Room floor mapping 模式时，请使用 Building 和 Floor。

如果你在设置像 306 → 306A, 306B 这样的合并房间，请映射实体目标房间。 通常不需要为 306 本身创建编码器映射。

从供应商同步​

何时会显示同步

只有在支持库存同步时，你才会看到 Sync from vendor。 当启用直接通信时，它会保持隐藏。

  1. 点击 Sync from vendor。

  2. 复核每一行建议内容。

  3. 更新任何房间、建筑、楼层、描述或 active 值。

  4. 点击 Confirm mapping。

    ✓ AVA 会把新增、更新和移除的映射一起保存。

第 4 步：编辑或移除映射​

  1. 选择一个已映射的房间。
  2. 点击 Edit 修改编码器名称，或点击 Remove 删除它。

故障排查​

房间映射已禁用​

你会看到： 房间列表是灰色的。

解决方法： 在页面顶部切换 Enabled。

没有房间显示​

你会看到： 列表为空。

解决方法： 确认 AVA 已加载 PMS 房间，然后刷新页面。

房间列表仍在加载​

你会看到： 房间列表处于加载状态。

解决方法： 等待 PMS 房间、映射和配置加载完成。 如果始终无法完成，请刷新页面并检查 PMS 连通性。

没有可用的 PMS 房间​

你会看到： 显示 "No PMS rooms available yet."

解决方法：

  1. 前往 Settings → Essentials。

  2. 打开你的 PMS Integration 设置。

  3. 连接 PMS，然后返回此页面。

    ✓ AVA 会显示 PMS 房间，供你映射编码器名称。

Combined Rooms 只显示 Reset only​

你会看到： Combined Rooms 按钮只显示 Reset only。

原因： 你选择的门卡编码器不支持多房间编码，但已有别名仍然被保存。

解决方法：

  1. 打开 Combined Rooms。
  2. 移除你不再需要的旧别名。
  3. 如果你需要新的合并房间，请在 Settings → Room Access 中切换到受支持的编码器。

GreatLocks 库存没有加载​

你会看到： Building、floor 或 room 列表在 GreatLocks 下始终为空。

解决方法：

  1. 前往 Settings → Room Access → Keycard Encoding。
  2. 确认 GreatLocks 服务器记录已保存。
  3. 检查 Windows Agent 或直接隧道是否在线。
  4. 再次点击 Test Connection。
  5. 在连接恢复正常后刷新此页面。

Access code groups 被拒绝​

你会看到： 输入电梯访问代码后保存失败。

解决方法：

  1. 将 Lift access mode 设置为 Common access。
  2. 只输入供应商支持的代码。
  3. 移除任何超出范围的代码。
  4. 再次保存。

缺少 Sync from vendor​

你会看到： 看不到 Sync from vendor。

原因： 你的编码器不支持库存同步，或者启用了直接通信。

解决方法：

  1. 前往 Settings → Room Access → Keycard Encoding。
  2. 确认你选择的是受支持的供应商。
  3. 如果你需要供应商库存同步，请关闭 Enable direct communication。
  4. 保存后重新加载此页面。

仍然卡住？​

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

  • ❌ 映射已保存，但没有生效
  • ❌ 映射列表始终加载不到房间

建议附上：

  • 映射页面截图
  • 编码器供应商和型号
  • 问题开始时间