跳到主要内容

设置门卡编码器

快速设置

选择编码器类型（如适用再选择连接方式），然后添加编码器。约 15 分钟。

本指南帮助你为自助机或前台配置门卡编码。

快速参考​

任务作用点击位置
选择方式启用门卡编码Room Access → Key Card Encoding (Kiosk)
选择编码器类型选择锁系统Encoder Type
选择连接方式直连 vs Windows Agent（Saflok/GreatLocks）Connection Method
配置编码器添加服务器或凭证信息类型对应字段
添加编码器注册物理设备（Saflok/PMS）Physical Encoder Devices
注册 Windows Agent连接本地编码器（动态）Register Windows Agent
设置编码默认值每次入住编码卡数 + 过期时间Encoding Options

位置​

Settings → Room Access → Key Card Encoding (Kiosk)

Step 1: 选择门卡方式​

  1. 前往 Settings → Room Access。
  2. 选择 Key Card Encoding (Kiosk) 作为客房出入方式。
  3. 点击 Save。

Step 2: 选择编码器类型​

  1. 滚动到 Keycard Encoder Settings。
  2. 选择 Saflok、GreatLocks 或 PMS Integration。

Step 3: 选择连接方式（仅 Saflok + GreatLocks）​

  1. 选择 Direct Connection 或 Via Windows Agent。
  2. 若选择 PMS Integration，则跳过此步骤。

Step 4: 配置编码器系统​

如果使用 Saflok
  • Direct Connection
    • 输入 PMSI Server URL、Username 和 Password。
    • 点击 Test Connection。
  • Via Windows Agent
    • 输入 Username 和 Password。
    • PMSI URL 与连接测试由代理处理。
  • 在 Physical Encoder Devices 中添加编码器设备（需要 Encoder ID）。
  • 可选：为每台编码器设置 Location。
  • 若多个自助机共享编码器，可添加 Kiosk to Encoder Routing 规则（Kiosk ID 来自 Kiosk Management）。
如果使用 GreatLocks
  • Direct Connection
    • 输入 Server Name（可选）、XHLSI Server IP Address 与 TCP Port。
    • 点击 Test Connection。
  • Via Windows Agent
    • 服务器信息由代理处理，无需填写 IP/端口。
如果使用 PMS Integration
  • 确保 PMS 集成已启用（Cloudbeds 或 Opera）。
  • 在 Physical Encoder Devices 中：
    • 点击 Load Encoders 并 Add Selected，或
    • 点击 Add Encoder，输入 Encoder ID 与 PMS Encoder ID。
  • 使用 Active 关闭不需要使用的编码器。

Step 5: 注册 Windows Agent（仅动态连接）​

若选择 Via Windows Agent，请注册代理：

  1. 前往 Register Windows Agent。

  2. 输入 Agent Name（可选）和它处理的 Kiosk IDs。

  3. 点击 Register Agent。

  4. 复制设备密钥并点击 Download Agent。

  5. 在连接编码器的 Windows 电脑上安装代理。

    ✓ 代理会显示在 Registered Agents 中并带有状态信息。

Step 6: 设置编码默认值​

  1. 设置 Number of Cards to Encode（通常 1–2 张）。
  2. 设置 Keycard Expiration Time（默认：上午 11:00）。

可选：展开 Advanced options 启用 Heartbeat Monitor。

可选：将 PMS 房间映射到编码器名称​

若编码器使用的房间名与 PMS 不一致：

问题排查​

如编码器无响应或写卡失败，请使用完整排查清单：

还需要帮助？​

以下情况请联系 success@vouch-technologies.com：

  • ❌ 编码器设置保存后设备仍离线
  • ❌ 所有房间都无法编码门卡
  • ❌ 代理始终未在 Registered Agents 中显示在线

建议提供：

  • 编码器类型与型号
  • Keycard Encoder Settings 截图
  • 问题发生的时间

相关指南​