跳到主要内容

设置 QRLOCK 数字钥匙

快速设置

准备 QR Master 详细信息，映射客房，然后测试一个宾客链接。预计用时约 15 分钟。

本指南帮助你将 QRLOCK 连接到 AVA，并通过 AVA 发放托管式客房数字钥匙。

快速参考​

任务所需信息操作位置
连接 QRLOCKQR Master SID、Auth Token 和社区编号Settings → Room Access
映射客房准确的 PMS 客房 ID 和 QRLOCK 客房QRLOCK Room Mapping
测试出入测试预订和可连接的 QRLOCK 读卡器入住或预订详情
管理出入权限当前钥匙、宾客邮箱或员工操作预订或 Access Codes

开始前确认​

请确认以下要求：

  • 你的 QRLOCK 账号提供 QR Master SID。
  • 你拥有匹配的 Auth Token。
  • 你知道 QRLOCK Community Number。
  • QRLOCK 客房已在供应商系统中创建并可用。
  • PMS 客房 ID 是稳定且唯一的字符串。
  • 生产环境中的 AVA 使用公开的 HTTPS 宾客钥匙来源地址。
请妥善保管凭据

AVA 会加密 QRLOCK 凭据和宾客链接。 请勿将令牌粘贴到截图、支持消息或共享笔记中。

确认宾客钥匙服务 URL​

你的部署管理员必须为宾客链接使用现有的 Room Access Service URL。 仅当未配置 Room Access URL 时，AVA 才会使用应用 URL。

设置用途
Room Access Service URL (ROOM_ACCESS_BASE_URL)/guest-key 和 /guest-key/client.js 的主要来源地址
Application URL (APP_BASE_URL)未设置 Room Access URL 时使用的备用来源地址

生产环境中选择的 URL 必须是公开的 HTTPS 来源地址。 其中不得包含路径、查询参数、片段或登录凭据。 请勿添加单独的宾客来源地址设置。

请让部署管理员在测试发放前确认两个宾客路由均可加载。

连接 QRLOCK​

  1. 前往 Settings → Room Access。

  2. 选择 QR 数字钥匙连接选项。

  3. 将 QRLOCK 选为供应商。

  4. 输入 QR Master SID、Auth Token 和 Community Number。

  5. 选择 Test Connection。

  6. 测试成功后保存连接。

    ✓ AVA 显示 Connected，隐藏已保存的令牌，并加载 QRLOCK 客房清单。

支持的 QR 读卡器

AVA 通过此数字钥匙流程支持 QRALOCK 和 QRLOCK 读卡器客房。 其他 QR 型号系列暂不可用。

将 PMS 客房映射到 QRLOCK 客房​

  1. 在 QR 数字钥匙设置中打开 QRLOCK Room Mapping。

  2. 选择一个 PMS 客房。

  3. 从清单中选择匹配的 QRLOCK 客房。

  4. 保存待处理的映射。

  5. 对每个应接收 QR 钥匙的客房重复上述操作。

    ✓ AVA 显示该客房已映射，可以发放钥匙。

QRLOCK 可以共享一个 PMS 客房

你可以为同一个 PMS 客房保留 PIN 供应商映射。 QRLOCK 只保存和更改 QRLOCK 映射。 其他供应商映射仍可用于各自的出入流程。

请明确映射每个客房

AVA 不会根据相似名称猜测 QRLOCK 客房。 未映射或存在歧义的客房无法接收 QR 钥匙。

发放宾客 QR 钥匙​

对于符合条件的 QRLOCK 客房分配，AVA 会在分配客房后发放一把钥匙。 AVA 会先保存钥匙，再开始发送邮件。

  1. 完成宾客入住。

  2. 打开已入住客房的 Room Information。

  3. 查看 QR 钥匙发送状态。

  4. 需要时使用宾客链接操作复制链接。

    ✓ 宾客会收到包含 QR 指引的客房信息邮件。

自动发放或员工发放后，请确认同一把钥匙出现在出入历史记录中。 然后打开宾客链接，确认托管式 QR 页面可以加载。

邮件重试会重复使用同一把钥匙。 它们不会创建另一张供应商卡片。

客房卡可能显示 Pending、Sent 或 Staff assistance required。 邮件接收并不能证明宾客已经打开房门。

链接遵循预订有效期窗口。 AVA 将宾客链接与 PIN 出入代码分开保存。

再次发送客房信息​

当宾客再次需要当前详情时，使用 Email room information。

  1. 打开已入住的预订或客房卡。

  2. 选择 Email room information。

  3. 确认宾客个人邮箱。

    ✓ AVA 会重新发送现有的 QR 钥匙和客房详情。

邮件操作不会发放新钥匙。 请使用个人邮箱地址，而不是 OTA 代理地址。

如果暂时无法发送，AVA 会重试同一发送意图。

以员工身份发放或重新发放出入权限​

当自动发放未发生，或需要替换钥匙时，使用员工控制项。

  1. 在 Reservations 或 Access Codes 中打开预订。
  2. 打开 Manage digital key。
  3. 仅当不存在当前钥匙时选择 Issue。
  4. 钥匙准备好后选择 Send。
  5. 选择 Copy guest link，直接分享当前宾客链接。

员工发放和邮件发送是两个独立操作。 AVA 会在发放前检查当前客房、日期、电话号码和客房映射。

对于多客房预订，AVA 会检查所选客房。 已终止状态的客房无法发放、重新发放或发送钥匙。 预订历史记录和撤回控制项仍然可用。

撤回或重新发放 QR 钥匙​

当宾客提前退房或失去出入权限时，撤回出入权限。

  1. 打开预订的客房出入详情。

  2. 为当前 QR 钥匙选择 Withdraw。

  3. 确认撤回。

  4. 如果取消仍在处理中，请在重试可用后选择 Retry cancellation。

  5. 等待供应商确认取消。

  6. 刷新状态并选择 Reissue。

  7. 确认新生成。

    ✓ AVA 会创建新的供应商卡片和宾客链接。

不要盲目重试不确定的发放操作

如果 AVA 显示未解决或已撤回的钥匙，请等待员工恢复处理。 未经明确操作，自动发送不会替换该钥匙。

重新发放后，旧的 AVA 链接仍保持撤回状态。 只使用最新的宾客链接。

退房行为

退房会保留现有的 QR 钥匙行为。 提前离店时，员工必须撤回出入权限。 保存的有效期窗口仍控制正常过期时间。

将宾客移至另一间客房​

AVA 会将 QR 钥匙生成与客房分配关联起来。

  1. 完成 PMS 客房调换。
  2. 在 AVA 中刷新预订。
  3. 等待 AVA 确认目标客房。
  4. 查看原钥匙的取消状态。
  5. 仅在取消成功后为目标客房发放出入权限。

如果宾客返回原客房，请使用经过版本检查的 Reissue 操作。 取消失败后不要重复执行 PMS 客房调换。

现象 → 解决方法​

QRLOCK 连接测试失败​

现象： Test Connection 失败，或未加载 QRLOCK 客房清单。

解决方法：

  1. 检查 QR Master SID 和 Community Number。
  2. 重新粘贴 Auth Token，确保没有多余空格。
  3. 确认你的 QRLOCK 账号可以查看该社区和客房。
  4. 保存凭据，然后再次运行 Test Connection。

客房无法接收 QR 钥匙​

现象： 预订中无法使用 QR 数字钥匙操作。

解决方法：

  1. 确认预订已分配客房。
  2. 打开 QRLOCK Room Mapping。
  3. 将准确的 PMS 客房映射到一间 QRLOCK 客房。
  4. 刷新预订并重试。

现象： 旧链接提示出入不可用，或缺少替换链接。

解决方法：

  1. 在预订中确认最新 QR 钥匙状态。
  2. 撤回或重新发放后不要重复使用旧链接。
  3. 如果取消已确认，请选择 Reissue。
  4. 只分享新生成的链接。

QR 钥匙邮件未收到​

现象： 客房卡显示邮件待处理或失败状态。

解决方法：

  1. 确认宾客拥有个人邮箱地址。

  2. 确认该地址不是 OTA 代理地址。

  3. 等待发送重试完成。

  4. 状态刷新后选择 Email room information。

  5. 如果宾客需要立即出入，请使用 Copy guest link。

    ✓ 邮件重试期间，当前 QR 钥匙保持不变。

QR 钥匙发放返回服务错误​

现象： 自动或员工发放返回 503，且未出现历史记录行或邮件链接。

解决方法：

  1. 请让部署管理员确认已配置 Room Access Service URL。

  2. 确认 /guest-key 和 /guest-key/client.js 可从该公开 URL 加载。

  3. 确认 URL 不含路径、查询参数、片段或凭据。

  4. Room Access Service 发布恢复正常后重试发放。

  5. 确认新的出入历史记录行、宾客链接和邮件发送均已出现。

    ✓ AVA 会在创建供应商钥匙前验证宾客路由。

QRLOCK 映射与其他供应商冲突​

现象： 另一家旧智能锁供应商已经使用同一 PMS 客房。

解决方法：

  1. 在 QR 数字钥匙设置中打开 QRLOCK Room Mapping。

  2. 选择准确的 PMS 客房和 QRLOCK 客房。

  3. 保存 QRLOCK 映射，不要删除 PIN 供应商映射。

  4. 确认两个供应商映射仍分别显示在各自的设置区域中。

    ✓ QRLOCK 使用自己的映射，PIN 供应商保留自己的映射。

如果仍然无法保存，请刷新页面并重试一次。 不要重置 PIN 供应商映射来解决 QRLOCK 冲突。

客房调换阻止替换钥匙​

现象： AVA 提示发放钥匙前需要员工恢复处理。

解决方法：

  1. PMS 确认目标客房后刷新预订。

  2. 打开原客房的 QR 钥匙状态。

  3. 确认供应商取消成功。

  4. 检查目标客房映射。

  5. 仅在 AVA 启用 Reissue 后选择该操作。

    ✓ AVA 会为已确认的目标状态创建一个替换钥匙。

所选客房无法使用数字钥匙操作​

现象： 某间客房无法使用 Issue、Reissue 或 Send。

解决方法：

  1. 确认所选客房在 PMS 中不是终止状态。
  2. 适用时，从预订中选择活动客房。
  3. 查看终止客房的现有状态和历史记录。
  4. 仅当宾客不应再进入时撤回出入权限。

QR 可以扫描但房门无法打开​

现象： 托管页面显示 QR 码，但读卡器拒绝该二维码。

解决方法：

  1. 确认宾客使用的是最新链接。
  2. 检查预订有效期窗口和当前时间。
  3. 确认 QRLOCK 客房映射与实体客房匹配。
  4. 使用 QRLOCK 应用或供应商工具测试读卡器。
  5. 调查期间使用酒店的备用出入方式。

仍无法解决？​

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

  • ❌ 核实凭据后仍然失败
  • ❌ 已映射客房仍无法发放 QR 钥匙
  • ❌ 取消或重新发放仍未解决

建议提供：

  • 酒店名称和客房号
  • QRLOCK 型号和社区编号
  • 不含凭据的状态截图
  • 预订 ID 和问题开始时间