跳到主要内容

管理访问代码

快速查找

大多数团队可以在 1 分钟内通过 Reservation ID、Guest Name 或 Room 找到代码。

本指南帮助你查看 PIN、QR 密钥、钥匙卡和储物柜访问权限。 它还帮助你查看钥匙卡事件历史和 QR 密钥历史。

前往： Access Codes

快速参考​

任务点击位置结果
查找代码Reservation ID、Guest Name 或 Room显示匹配的代码
按状态或方式筛选More Filters列表随筛选条件更新
显示 PINEye icon显示 PIN
查看锁 IDKey icon锁 ID 会在提示框中显示
复制代码Copy icon代码被复制，并显示 Copied
翻页Previous 或 Next加载另一页
更改每页数量10 per page列表按新的数量刷新
检查有效日期Valid Period 列显示开始和结束时间
检查剩余时间Status 徽标对于有效代码，显示剩余时间
检查作业进度Operation Status 徽标显示每个智能锁 PIN 是 pending、partial、successful、failed 还是 timed out
查看失败详情Access Details此处显示通俗易懂的钥匙卡错误，以及 userMessage、errorCode、retriable、vendor 和可用时的安全上游详情
查看钥匙卡历史Events 视图每次钥匙卡编码尝试都会出现一行
清除筛选条件Clear All 或 Reset All返回默认视图

查找访问代码​

  1. 前往 Access Codes。

  2. 输入 Reservation ID、Guest Name 或 Room。

  3. 稍等片刻，让列表更新。

    ✓ 匹配的代码会显示在列表中。

筛选列表​

  1. 点击 More Filters。

  2. 选择一个或多个筛选条件：

    • Status：Active、Expired、Generation Pending、Partial Success、Generation Failed、Revoked、Superseded
    • Access Method：Smart Lock、Digital Key、Keycard、Locker、ACI
    • Date Range：开始和结束日期

  3. 点击 Reset All 清除该面板中的所有内容。

    ✓ 列表会按你的选择刷新。

翻页​

  1. 滚动到列表底部。

  2. 点击 Previous 或 Next。

  3. 打开 10 per page，然后选择 10、25、50 或 100。

    ✓ 列表会按新的每页数量刷新。

管理 QR 数字密钥​

  1. 找到 QRLOCK 行。

  2. 打开 Manage digital key。

  3. 选择 Issue、Copy guest link、Send 或 Withdraw。

  4. 撤回仍在处理时，使用 Retry cancellation。

  5. 对于丢失的密钥，直接选择 Reissue，并阅读适用于整个房间的警告。

  6. 对于提前离店，请在该操作可用时选择 Withdraw。

    ✓ 模态框会显示当前密钥状态和按预订筛选的历史记录。

对于直接图片交付，Reissue 会取代单独的撤回操作。 对于 QR Master 页面交付，Withdraw 仍会显示在 Reissue 旁边。

要管理替换密钥，你需要 Generate 和 Revoke 权限。 确认显示的密钥修订版本后，再确认替换操作。

对于多房间预订，AVA 会检查所选房间。 如果所选房间在 PMS 中已终止，Issue、Reissue 和 Send 将保持不可用。 该房间的历史记录和撤回控件仍然可用。

如果客人的电话号码缺失或已过时，AVA 可以使用已保存的持有人信息 核对现有 QR 密钥。AVA 会在返回该密钥前检查所选房间、入住信息、映射、过期状态 和撤回状态。

此恢复流程会重新使用现有密钥。它不会创建另一张 QRLOCK 卡，也不会更新客人的 PMS 电话号码。

替换房间的 QR 密钥​

当酒店确认必须替换该房间的所有 QR 密钥时，请使用工作人员替换操作。

对于丢失的 QR 密钥，直接选择 Reissue。不要先撤回该密钥。

AVA 会通过 Room Access 发送替换密钥，并从 PMS 检查当前房间和入住信息。开始前，AVA 要求你明确确认。

替换完成后，AVA 会再次读取密钥状态并返回当前控件。这样可以避免你对同时被更改的密钥执行操作。

替换操作不会启动客人的入住流程，也不会发送电子邮件。 它也不会更改客人的 PMS 联系信息。

更改密钥后刷新

如果其他工作人员先更改了密钥，AVA 会拒绝较早的替换请求。 请刷新预订并查看当前 QR 密钥状态，然后重试。

显示并复制 PIN​

  1. 找到你需要的那一行。

  2. 点击 eye icon 显示 PIN。

  3. 点击 copy icon。

    ✓ 图标会短暂变成 Copied。

查看锁 ID​

  1. 找到你需要的智能锁那一行。

  2. 点击 key icon。

    ✓ Lock ID 会在提示框中显示。

理解状态标签​

状态含义该怎么做
Active代码当前有效分享给客人
Expired有效期已结束如有需要，发放新代码
pending智能锁作业仍在处理中等待并刷新后再分享
partial部分智能锁步骤已完成，但作业尚未结束等待并刷新后再分享
Failed供应商创建代码失败重新检查锁设置并重试
Revoked代码被提前禁用重新发放前先向经理确认
Superseded新代码替换了旧代码使用最新代码

使用 More Filters → Status，即可将这些记录筛选为 Generation Pending 和 Partial Success。

新 PIN 先检查

AVA 会先检查较新的智能锁作业，再检查较旧的积压项。 新的客人 PIN 应该比旧的 pending 行更快完成。 AVA 会跳过已过期的历史 Active 记录，即使旧的桥接字段仍然存在。 当前的 Active 记录只要访问时间窗口仍然开放，就仍符合处理条件。 在入住和查找刷新期间，AVA 会在返回结果前重新检查 pending 智能锁作业。 AVA 还会在每次供应商检查之间至少等待 2 秒，因此可能仍需要再刷新一次。

最终入住前发放的凭据

AVA 可以在分配房间时发放 PIN、QR 密钥或储物柜凭据。 最终入住后，成功的凭据仍会关联到已确认到店的客人。 再次发放凭据前，请先刷新预订。

理解智能锁作业状态​

每个智能锁 PIN 行都会在表格和移动端卡片中显示自己的作业徽标。 当智能锁代码仍在供应商桥接服务中流转时，请使用此状态。

等待就绪状态

在 Operation Status 显示 Successful 之前，不要分享智能锁 PIN。 pending 和 partial 都表示访问还没有完全就绪。

状态含义该怎么做
PendingAVA 仍在等待供应商作业完成稍等片刻，然后刷新页面
SuccessfulAVA 已确认锁作业完成将 PIN 分享给客人
Failed供应商作业失败检查锁连接并重试
Timed outAVA 持续检查，但作业未能及时完成重试 PIN 创建并验证桥接服务

查看时间信息​

使用下表确认代码何时开始、结束以及创建。

项目查看位置含义
Time remainingActive 状态徽标下方代码过期前剩余的时间
Valid PeriodValid Period 列开始和结束日期/时间
CreatedCreated 列代码创建时间
Valid Period 列

如果列表只显示储物柜代码，则会隐藏 Valid Period 列。

物业日历日期

对于 PMS 预订，AVA 会将到店和离店日期保留为物业日历日期。 创建每个有效性窗口时，它会应用酒店所在时区。 这样可以让 Valid Period 与预订的本地日期保持一致。

查看钥匙卡事件历史​

当你需要钥匙卡编码尝试的审计轨迹时，使用 Events 视图。

显示状态你会看到含义
Encoded成功的卡片行AVA 已为此次尝试写入卡片
Failed行中的错误详情卡片未能编码
Expired已超过有效期的卡片卡片不再有效
Revoked已撤销的卡片行卡片被提前禁用
Superseded替换卡片行新卡片替换了这张卡片
CreatedCreated 列中的编码时间AVA 记录此次尝试的时间
仅限钥匙卡行

默认列表仍按预订对访问代码进行分组。 在 Events 视图中，钥匙卡行会展开为每次尝试一行。 智能锁和储物柜行仍按每个访问代码显示一条记录。

Opera 钥匙卡时间戳

对于 Opera 钥匙卡，Created 时间使用已确认的 PMS keyCreationTime。 该时间戳与实体钥匙成功确认的时间一致。 如果 Opera 返回酒店本地的有效性时间戳，AVA 会保留这些时间戳用于确认诊断。

标准化失败详情

失败的钥匙卡行现在会优先存储结构化消息。 如果编码器返回 false，AVA 会将 KEYCARD_ENCODE_FAILED 记录为类型化失败。 你还可能看到 userMessage、errorCode、retriable、vendor 以及安全的 upstream 详情，以便支持排查。 使用 retriable 判断重试是否可能有所帮助。 HTTP 504 房间访问超时仍会通过此路径处理，并使用 KEYCARD_VENDOR_TIMEOUT。 比较超时情况时，首先检查房间、钥匙数量和有效性窗口。 这有助于区分真实的不匹配和仅由时区造成的确认问题。

故障代码保持可见

AVA 会在事件消息中保留房间访问的 faultcode:<value> 值。 PII 脱敏仍适用于电话号码、电子邮件、卡片和令牌。 比较供应商事件时，请使用 faultcode。

数字密钥使用单独的控件

对于 QRLOCK 行，请使用 Manage digital key。 对于智能锁，请使用 Manage PIN；对于储物柜，请使用 Manage Locker Code。

PIN、钥匙卡和储物柜行在 Access Codes 中均为只读。 QRLOCK 行会打开专用的管理模态框。

提示​

  • 储物柜条目会显示 Locker # 和 Code，而不是 PIN。
  • ACI 会筛选协助入住的访问代码记录。
  • 所有时间都使用页面底部显示的时区。
  • 钥匙卡行使用 Created 列作为编码时间。
  • 对于 Opera 钥匙卡，Created 列使用已确认的 PMS 时间戳。
  • 如果房间名称看起来不对，请在 Rooms 中确认房间映射。
  • 当你需要通俗易懂的消息时，可以直接在表格中查看 Access Details。

故障排查​

多条钥匙卡记录​

你会看到： 同一预订在 Events 中出现多次。

解决方法：

  1. 查看 Display status 列。
  2. 使用最新的 Created 时间。
  3. 只有在需要审计轨迹时才保留较旧的记录。

找不到访问代码​

你会看到：“No access codes found”或列表为空。

解决方法：

  1. 清除所有筛选条件。
  2. 按 Reservation ID 或 Room 搜索。
  3. 刷新页面。

复制图标没有反应​

**你会看到：**复制图标没有变成 Copied。

解决方法：

  1. 先显示 PIN。
  2. 授予浏览器剪贴板访问权限后再试一次。

状态显示 Failed​

**你会看到：**状态为 Failed，并附带错误消息。

解决方法：

  1. 确认智能锁集成已连接。
  2. 从预订中重新尝试创建 PIN。

作业状态一直是 pending 或 partial​

**你会看到：**创建智能锁代码后，它显示 pending 或 partial。

解决方法：

  1. 等待最多 1 分钟，然后刷新预订或 Access Codes 页面。
  2. 新 PIN 会优先于较旧的积压记录进行检查，因此新的客人代码应最先完成。
  3. 如果你正在进行入住查找，AVA 会在显示结果前重新检查 pending 作业。
  4. 如果该记录已经过期，AVA 会有意跳过它。
  5. 如果状态变为 Successful，请分享 PIN。
  6. 如果当前住客的代码超过 1 分钟仍为 pending 或 partial，请从预订中重试 PIN 创建。
  7. 如果状态变为 Timed out 或 Failed，请在再次尝试前检查供应商连接和桥接服务状态。

钥匙卡失败消息使用通俗语言​

**你会看到：**钥匙卡行显示简短消息，而不是原始供应商字符串。 你还可能看到 userMessage、errorCode、retriable、vendor 或安全的 upstream 详情。

解决方法：

  1. 先阅读简短消息。
  2. 联系支持团队时，提供错误代码、可重试标志和供应商详情。
  3. 确认预订 ID、房间和入住日期正确。
  4. 如果房间映射或编码器会话不正确，先修复这些问题。
  5. 保存更改后，再重试钥匙卡操作。

缺少 Valid Period 列​

**你会看到：**未显示 Valid Period 列。

解决方法：

  1. 清除所有筛选条件。
  2. 确认你没有查看仅包含储物柜代码的列表。

QR 密钥操作不可用​

**你会看到：**Issue、Reissue 或 Send 不可用。

解决方法：

  1. 打开按预订筛选的 QR 密钥历史记录。
  2. 确认所选房间在 PMS 中未终止。
  3. 检查 PMS 房间是否保存了 QRLOCK 映射。
  4. 如果之前的撤回仍在处理，请使用 Retry cancellation。

客人电话号码变更后找不到已保存的 QR 密钥​

**你会看到：**客人的电话号码为空或已变更，但之前曾发放过 QR 密钥。

解决方法：

  1. 最新 PMS 数据到达后，刷新预订。

  2. 确认所选房间和入住日期与 QR 密钥历史记录一致。

  3. 重新打开 Manage digital key。

  4. 如果现有密钥出现，请使用 Copy guest link 或 Send。

  5. 状态仍在加载时，不要重复发放密钥。

    ✓ 当入住信息和房间映射仍然匹配时，AVA 可以重新使用已保存的密钥。

如果密钥仍不可用，请在重新发放前联系支持团队。房间、入住信息、映射、过期状态 或撤回状态发生变化时，可能需要工作人员恢复。

仍然无法解决？​

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

  • ❌ 入住后代码没有显示
  • ❌ 多次重试后状态仍为 Failed
  • ❌ 无法打开 Access Codes 页面

建议提供：

  • Reservation ID
  • 房间号
  • 状态行的截图