跳到主要内容

设置 QRLOCK 数字钥匙

快速设置

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

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

快速参考​

任务所需信息操作位置
连接 QRLOCKQR Master SID、Auth Token 和社区编号Settings → Room Access
映射客房准确的 PMS 客房 ID 和 QRLOCK 客房QRLOCK Room Mapping
选择发送方式托管链接或直接 QR 图片Guest key delivery
测试出入测试预订和可连接的 QRLOCK 读卡器入住或预订详情
管理出入权限当前钥匙、宾客邮箱或员工操作预订或 Access Codes
替换丢失的钥匙整个客房的确认信息和当前预订数据Reissue

开始前确认​

请确认以下要求：

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

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 型号系列暂不可用。

选择宾客钥匙发送方式​

连接 QRLOCK 后，选择宾客接收 QR 钥匙的方式。

  1. 在 QRLOCK 设置中找到 Guest key delivery。

  2. 选择 QR Master page (link) 以保留托管式 QRLOCK 页面。

  3. 选择 QR image (direct image)，直接在 AVA 和宾客邮件中显示 QR。

  4. 选择 Connect to QR Master 以保存更改。

    ✓ 现有 QRLOCK 凭据、客房映射和出入历史记录保持不变。

直接图片模式会将现有 QR Master 卡片作为 PNG 获取。 它不会发放替代卡片。 AVA 使用 QR Master 的结账截止时间，并将图片有效期限制在 30 天以内。

对于现有配置和新配置，托管链接仍是默认方式。

将 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 指引的客房信息邮件。

自动发放或员工发放后，请确认同一把钥匙出现在出入历史记录中。 然后测试在 Guest key delivery 中选择的发送方式。

对于 QR Master page (link)，打开宾客链接并确认托管页面可以加载。 对于 QR image (direct image)，打开客房信息并确认 QR 图片出现。

在直接图片模式下，客房卡会在图片加载期间保留 Open QR as a link。 如果图片获取失败，该选项仍然可用，因此宾客无需等待另一把钥匙即可使用获授权的宾客链接。

邮件可以将当前 QR 作为带有效期的内嵌 PNG，并保留宾客链接作为备用。AVA 会在发送前立即检查当前钥匙，因此在撤回、过期或替换后会停止发送，避免发送过时的 QR 内容。

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

如果员工发放尝试在 QRLOCK 创建钥匙后失败，当当前预订仍与该钥匙匹配时，重试可以恢复已保存的钥匙。AVA 会清除过时的错误，但不会创建另一张卡片或自动发送邮件。

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

链接或图片遵循预订有效期窗口。 AVA 将 QRLOCK 发送与 PIN 出入代码分开处理。

在完成页面交接 QR 钥匙​

入住完成后，AVA 会显示一个本地生成、仅供扫描的 QR 代码。 其中包含已发放客房钥匙的完整 AVA 宾客钥匙链接。

  1. 请宾客打开手机上的相机。

  2. 请宾客扫描完成页面上的 QR 代码。

  3. 请宾客打开检测到的链接。

    ✓ 宾客的手机会打开已发放的 AVA 客房钥匙页面。

AVA 会以全部七种受支持的语言显示扫描说明。 对于 QR Master page (link) 和 QR image (direct image) 发送方式，此交接流程相同。 QR 中包含宾客钥匙令牌，因此宾客无需输入代码。 自助终端不会在新标签页中打开链接，也不会将链接复制到剪贴板。

如果 QR 未在 CCI 或 ACI 中呈现，请选择 Retry QR。 重试会在不调用 API、不重新发放且不写入剪贴板的情况下重新绘制同一个钥匙 URL。 在没有自助终端身份的个人 Pre-arrival 会话中，可能会显示 Copy guest link。 其他所有场景均禁用复制。

如果 AVA 显示“请重试。如果仍然失败，请联系前台”，请重试一次。 如果钥匙已过期或不可用，AVA 会提示宾客联系前台。

预览当前 QR 图片​

使用员工预览检查当前 QR，而不会发放另一张卡片。

  1. 打开 QRLOCK 预订的 Manage digital key。

  2. 查看当前 QR 图片及其显示的有效期。

  3. 选择 Open QR image in new tab，打开同一张 PNG。

    ✓ AVA 获取已保存的卡片图片，并保留现有宾客链接。

预览、打开或刷新图片不会发放或替换卡片。 如果客房、钥匙或状态发生变化，请关闭模态框并重新打开。 AVA 随后会为当前钥匙请求图片。

再次发送客房信息​

当宾客再次需要当前详情时，使用 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 会在发放前检查当前客房、日期、电话号码和客房映射。

如果 QR 钥匙已经存在，即使当前电话号码缺失或已无法使用，AVA 也可以恢复该钥匙。 在返回现有钥匙前，AVA 会验证已保存的持有者、客房映射、入住期间、有效期和撤回状态。

PMS 同步后，AVA 还会检查当前客房、入住期间和预订引用。如果这些详情发生变化，请先刷新预订，再重试。

此恢复操作不会创建第二张 QRLOCK 卡片，也不会更新宾客或 PMS 中的电话号码。

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

撤回或重新发放 QR 钥匙​

当宾客提前退房或失去出入权限时，撤回出入权限。 如果 QR 钥匙丢失，请使用下面确认过的 Reissue 流程。 只有 QR Master page (link) 发送方式提供独立的 Withdraw 操作。

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

  2. 如果提前离店，为当前 QR 钥匙选择 Withdraw。

  3. 确认撤回。

  4. 如果取消仍在处理中，请在可以操作后选择 Retry cancellation。

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

  6. 刷新状态并选择 Reissue。

  7. 阅读整个客房的警告，并确认当前客房和钥匙版本。

  8. 确认生成新钥匙。

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

为整个客房替换丢失的 QR 钥匙​

如果宾客丢失 QR 钥匙，或有人可能仍持有其图片，请直接使用 Reissue。 此替换操作使用 QR Master 的整个客房丢失报告。

丢失钥匙时，不要先选择独立的 Withdraw。 在直接图片模式下，Reissue 会替代独立的撤回操作。 在 QR Master 页面模式下，Withdraw 仍会与 Reissue 并列提供。 客房调换清理遵循单独的客房调换流程。

替换前，AVA 会检查以下所有详情：

  • 你已确认替换会影响配置的供应商客房。
  • 钥匙版本仍然是最新版本。
  • 所选客房位于 PMS 分配的客房列表中。
  • 客房映射和预订详情仍然匹配。

确认替换前，请核对显示的钥匙版本。

如果任一检查失败，AVA 会阻止取消和重新发放。 在你修正或刷新预订前，当前钥匙保持不变。

整个客房都会受影响

扫描替换钥匙会使该配置供应商客房的早期 QR 钥匙失效。 其中可能包括同一客房内其他宾客持有的钥匙。 继续前请确认客房无误。

替换流程同时适用于 QR Master page (link) 和 QR image (direct image) 发送方式。 它不会自动通过邮件发送新钥匙。 替换后请使用 Send、Copy guest link 或 Email room information。

AVA 会在出入历史记录中记录已取消的发放操作。 旧的 AVA 链接仍保持撤回状态，即使旧 QR 图片仍然存在。

三种不同的结果
  • AVA retrieval 会显示或下载已保存的 QR 图片。
  • Vendor cancellation 会撤回已保存的 QR 发放操作。
  • Physical invalidation 会在 QR Master 接受整个客房的丢失报告后发生。

API 成功或 AVA 记录已取消，并不能证明实体门锁拒绝了旧 QR。 共享门规则和后续钥匙顺序仍需由硬件检查。

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

如果 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. 仅分享新生成的链接。

客房或预订变更后无法替换​

你看到的情况： AVA 要求重新确认，或阻止 Reissue。

解决方法：

  1. PMS 更新完成后刷新预订。

  2. 确认所选客房仍分配给此预订。

  3. 检查 QRLOCK 映射仍与实体客房匹配。

  4. 再次打开 Manage digital key。

  5. 确认整个客房的警告和当前钥匙版本。

    ✓ 当客房上下文过时或不完整时，AVA 会保留当前钥匙。

取消状态不明确时，不要反复重试。 如果供应商明确拒绝取消，请联系支持团队。

未收到 QR 钥匙邮件​

你看到的情况： 客房卡显示邮件待发送或发送失败状态。

解决方法：

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

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

  3. 等待发送重试完成。

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

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

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

直接 QR 图片不可用​

你看到的情况： QR 图片不可用、已过期或无法打开。

解决方法：

  1. 确认预订仍有有效的 QRLOCK 钥匙。

  2. 刷新预订，再次打开客房信息。

  3. 如果页面显示 Try again，选择一次。

  4. 如果钥匙已撤回或过期，请遵循确认过的撤回和重新发放步骤。

    ✓ 临时故障会保留重试操作。

不要仅因为图片获取失败就发放替换钥匙。 只要预订详情仍匹配，直接图片模式就会重复使用现有 QRLOCK 卡片。

完成页面上的 QR 未出现​

你看到的情况： 完成页面上的 QR 为空，或 AVA 显示重试消息。

解决方法：

  1. 选择一次 Retry QR。

  2. QR 重新绘制后，请宾客扫描 QR。

  3. 如果 QR 仍未出现，请联系前台。

    ✓ 重试会重新绘制当前已发放的钥匙，不会创建另一把钥匙。

不要期待在 CCI、ACI 或已注册的自助终端屏幕上出现复制操作。

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 供应商保留自己的映射。

如果保存仍然失败，请刷新页面并重试一次。 不要为了处理 QRLOCK 冲突而重置 PIN 供应商的映射。

客房调换阻止替换钥匙​

你看到的情况： AVA 表示在发放钥匙前需要员工恢复处理。

解决方法：

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

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

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

  4. 检查目标客房映射。

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

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

电话号码变更或员工发放失败后找不到现有 QR 钥匙​

你看到的情况： 宾客电话号码缺失或已变更，或员工发放尝试失败。AVA 不显示已发放的 QR 钥匙。

解决方法：

  1. PMS 更新完成后刷新预订。

  2. 确认所选客房和入住日期与已发放钥匙匹配。

  3. 再次打开 Manage digital key。

  4. 将员工操作重试一次。

  5. AVA 显示恢复的钥匙后，使用 Copy guest link 或 Send。

  6. 宾客需要客房详情时，选择 Email room information。

  7. 恢复仍在处理时，不要反复选择 Issue。

    ✓ 当客房、入住期间和映射仍匹配时，AVA 会重复使用已保存的 QR 钥匙。

重试会清除过时的发放错误，但不会自动发送邮件。 如果客房、入住期间、预订引用、映射、有效期或撤回状态发生变化，AVA 会继续隐藏钥匙，直到你刷新并解决不匹配问题。 旧钥匙可能仍然有效时，请在发放替换钥匙前联系支持团队。

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

你看到的情况： 某个客房无法使用 Issue、Reissue 或 Send。

解决方法：

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

QR 可以扫描但门打不开​

你看到的情况： 托管页面或直接图片显示 QR 代码，但读卡器拒绝它。

解决方法：

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

如果你最近替换了丢失的钥匙，请等待供应商和门锁接受整个客房的丢失报告。 旧 QR 图片可能仍然可见，但实体失效后不应再授予出入权限。

仍然无法解决？​

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

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

建议提供：

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