跳到主要内容

管理访问代码

快速查找

大多数团队会使用 Reservation ID、Guest Name 或 Room 在 1 分钟内找到代码。

本指南帮助你查看并分享智能锁、门卡和储物柜的访问代码。 它还帮助你在 Events 视图中查看门卡事件历史，并追踪智能锁任务状态。

前往： Access Codes

快速参考​

任务点击位置结果
查找代码Reservation ID、Guest Name 或 Room显示匹配的代码
按状态或方式筛选More Filters列表按筛选条件更新
显示 PINEye iconPIN 被显示
查看 Lock IDKey icon工具提示中显示 Lock ID
复制代码Copy icon代码被复制并显示 Copied
翻页Previous 或 Next加载另一页
更改每页数量10 per page列表按新数量刷新
查看有效期Valid Period 列显示开始和结束时间
查看剩余时间Status 徽标活跃代码会显示剩余时间
查看任务进度Operation Status 徽标显示每个智能锁 PIN 是 pending、partial、successful、failed 还是 timed out
查看失败详情Access Details这里会显示易懂的门卡错误，较长信息会在表格中截断并支持悬停提示
查看门卡历史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、Keycard、Locker、ACI
    • Date Range：开始和结束日期

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

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

翻页​

  1. 滚动到列表底部。

  2. 点击 Previous 或 Next。

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

    ✓ 列表会按新的页大小刷新。

显示并复制 PIN​

  1. 找到需要的行。

  2. 点击 eye icon 显示 PIN。

  3. 点击 copy icon。

    ✓ 图标会短暂变成 Copied。

查看 Lock ID​

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

  2. 选择 key icon。

    ✓ Lock ID 会显示在工具提示中。

理解状态标签​

状态含义处理方式
Active代码当前有效分享给客人
Expired有效期已结束如有需要，发放新代码
pending智能锁任务仍在处理中先等待并刷新，再分享
partial部分智能锁步骤已完成，但任务尚未结束先等待并刷新，再分享
Failed供应商创建代码失败重新检查锁设置并重试
Revoked代码被提前禁用重新发码前先与管理人员确认
Superseded有更新的代码替换了它使用最新代码

使用 More Filters → Status 可以按 Generation Pending 和 Partial Success 找到这些记录。

先检查新生成的 PIN

AVA 会优先检查较新的智能锁任务，而不是较早的积压记录。 新的客人 PIN 应该比旧的待处理记录更快清除。 AVA 会跳过已过期的历史 Active 记录，即使旧的桥接字段仍然存在。 当前的 Active 记录只要访问窗口仍然打开，就会保持可用。 在入住和查找刷新期间，AVA 会在返回结果前重新检查待处理的智能锁任务。 AVA 也会在每次供应商检查之间至少等待 2 秒，因此可能还需要再刷新一次。

理解智能锁任务状态​

每条智能锁 PIN 记录在表格和移动端卡片中都有自己的任务状态标记。 当智能锁代码仍在通过供应商桥接流转时，可以使用这个状态来判断进度。

等待就绪状态

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

状态含义处理方式
PendingAVA 仍在等待供应商任务完成先等一下，然后刷新页面
SuccessfulAVA 已确认锁任务完成把 PIN 分享给客人
Failed供应商任务失败检查锁连接后重试
Timed outAVA 一直在检查，但任务始终没有按时完成重新创建 PIN，并检查桥接状态

查看时间细节​

使用表格确认代码的开始时间、结束时间和创建时间。

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

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

查看门卡事件历史​

当你需要查看门卡编码尝试的审计记录时，请使用 Events 视图。

显示状态你会看到什么含义
Encoded成功的门卡记录AVA 已为该次尝试写卡
Failed行内错误详情该门卡未成功编码
Expired超出有效期的门卡该卡已失效
Revoked被撤销的门卡记录该卡被提前禁用
Superseded替代记录有新的门卡替换了它
CreatedCreated 列中的编码时间AVA 记录该次尝试的时间
仅门卡记录

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

Access Codes 仅可查看

如果你需要设置或更改访问权限，请在预订中使用 Manage PIN（智能锁）或 Manage Locker Code（储物柜）。

小贴士​

  • 储物柜条目显示 Locker # 和 Code，而不是 PIN。
  • ACI 会筛选协助入住的访问代码记录。
  • 所有时间都使用页面底部显示的时区。
  • 门卡记录会使用 Created 列表示编码时间。
  • 如果房间名称看起来不对，请在 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 会在显示结果前重新检查待处理任务。
  4. 如果该记录已经过期，AVA 会有意跳过它。
  5. 如果状态变成 Successful，就可以分享 PIN。
  6. 如果当前住客的记录超过 1 分钟仍然是 pending 或 partial，请从预订中重新创建 PIN。
  7. 如果它变成 Timed out 或 Failed，请先检查供应商连接和桥接状态，再重试。

门卡失败信息看起来很技术化​

你会看到： 某条门卡记录提到了预订查找，或者提到了过去的退房日期。

解决方法：

  1. 确认预订 ID 和入住日期正确。
  2. 如果预订缺失，请在预订再次存在后重新创建门卡。
  3. 如果退房日期已经过去，请先更新预订日期。
  4. 保存更改后再次重试门卡操作。

Valid Period 列缺失​

你会看到： Valid Period 列没有显示。

解决方法：

  1. 清除所有筛选条件。
  2. 确认你不是只在查看储物柜代码。

仍然卡住？​

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

  • ❌ 入住后仍看不到代码
  • ❌ 多次重试后状态仍为 Failed
  • ❌ 无法打开 Access Codes 页面

建议附上：

  • 预订 ID
  • 房号
  • 状态行截图

相关指南​