管理访问代码
大多数团队可以在 1 分钟内通过 Reservation ID、Guest Name 或 Room 找到代码。
本指南帮助你查看 PIN、QR 密钥、钥匙卡和储物柜访问权限。 它还帮助你查看钥匙卡事件历史和 QR 密钥历史。
前往： Access Codes
快速参考
| 任务 | 点击位置 | 结果 |
|---|---|---|
| 查找代码 | Reservation ID、Guest Name 或 Room | 显示匹配的代码 |
| 按状态或方式筛选 | More Filters | 列表随筛选条件更新 |
| 显示 PIN | Eye icon | 显示 PIN |
| 查看锁 ID | Key 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 | 返回默认视图 |
查找访问代码
-
前往 Access Codes。
-
输入 Reservation ID、Guest Name 或 Room。
-
稍等片刻，让列表更新。
✓ 匹配的代码会显示在列表中。
筛选列表
-
点击 More Filters。
-
选择一个或多个筛选条件：
- Status：Active、Expired、Generation Pending、Partial Success、Generation Failed、Revoked、Superseded
- Access Method：Smart Lock、Digital Key、Keycard、Locker、ACI
- Date Range：开始和结束日期
-
点击 Reset All 清除该面板中的所有内容。
✓ 列表会按你的选择刷新。
翻页
-
滚动到列表底部。
-
点击 Previous 或 Next。
-
打开 10 per page，然后选择 10、25、50 或 100。
✓ 列表会按新的每页数量刷新。
管理 QR 数字密钥
-
找到 QRLOCK 行。
-
打开 Manage digital key。
-
选择 Issue、Copy guest link、Send 或 Withdraw。
-
撤回仍在处理时，使用 Retry cancellation。
-
只有在确认撤回后，才能选择 Reissue。
✓ 模态框会显示当前密钥状态和按预订筛选的历史记录。
对于多房间预订，AVA 会检查所选房间。 如果所选房间在 PMS 中已终止，Issue、Reissue 和 Send 将保持不可用。 该房间的历史记录和撤回控件仍然可用。
如果客人的电话号码缺失或已过时，AVA 可以使用已保存的持有人信息 核对现有 QR 密钥。AVA 会在返回该密钥前检查所选房间、入住信息、映射、过期状态 和撤回状态。
此恢复流程会重新使用现有密钥。它不会创建另一张 QRLOCK 卡，也不会更新客人的 PMS 电话号码。
显示并复制 PIN
-
找到你需要的那一行。
-
点击 eye icon 显示 PIN。
-
点击 copy icon。
✓ 图标会短暂变成 Copied。
查看锁 ID
-
找到你需要的智能锁那一行。
-
点击 key icon。
✓ Lock ID 会在提示框中显示。
理解状态标签
| 状态 | 含义 | 该怎么做 |
|---|---|---|
| Active | 代码当前有效 | 分享给客人 |
| Expired | 有效期已结束 | 如有需要，发放新代码 |
| pending | 智能锁作业仍在处理中 | 等待并刷新后再分享 |
| partial | 部分智能锁步骤已完成，但作业尚未结束 | 等待并刷新后再分享 |
| Failed | 供应商创建代码失败 | 重新检查锁设置并重试 |
| Revoked | 代码被提前禁用 | 重新发放前先向经理确认 |
| Superseded | 新代码替换了旧代码 | 使用最新代码 |
使用 More Filters → Status，即可将这些记录筛选为 Generation Pending 和 Partial Success。
AVA 会先检查较新的智能锁作业，再检查较旧的积压项。 新的客人 PIN 应该比旧的 pending 行更快完成。 AVA 会跳过已过期的历史 Active 记录，即使旧的桥接字段仍然存在。 当前的 Active 记录只要访问时间窗口仍然开放，就仍符合处理条件。 在入住和查找刷新期间，AVA 会在返回结果前重新检查 pending 智能锁作业。 AVA 还会在每次供应商检查之间至少等待 2 秒，因此可能仍需要再刷新一次。
AVA 可以在分配房间时发放 PIN、QR 密钥或储物柜凭据。 最终入住后，成功的凭据仍会关联到已确认到店的客人。 再次发放凭据前，请先刷新预订。
理解智能锁作业状态
每个智能锁 PIN 行都会在表格和移动端卡片中显示自己的作业徽标。 当智能锁代码仍在供应商桥接服务中流转时，请使用此状态。
在 Operation Status 显示 Successful 之前，不要分享智能锁 PIN。 pending 和 partial 都表示访问还没有完全就绪。
| 状态 | 含义 | 该怎么做 |
|---|---|---|
| Pending | AVA 仍在等待供应商作业完成 | 稍等片刻，然后刷新页面 |
| Successful | AVA 已确认锁作业完成 | 将 PIN 分享给客人 |
| Failed | 供应商作业失败 | 检查锁连接并重试 |
| Timed out | AVA 持续检查，但作业未能及时完成 | 重试 PIN 创建并验证桥接服务 |
查看时间信息
使用下表确认代码何时开始、结束以及创建。
| 项目 | 查看位置 | 含义 |
|---|---|---|
| Time remaining | Active 状态徽标下方 | 代码过期前剩余的时间 |
| Valid Period | Valid Period 列 | 开始和结束日期/时间 |
| Created | Created 列 | 代码创建时间 |
如果列表只显示储物柜代码，则会隐藏 Valid Period 列。
对于 PMS 预订，AVA 会将到店和离店日期保留为物业日历日期。 创建每个有效性窗口时，它会应用酒店所在时区。 这样可以让 Valid Period 与预订的本地日期保持一致。
查看钥匙卡事件历史
当你需要钥匙卡编码尝试的审计轨迹时，使用 Events 视图。
| 显示状态 | 你会看到 | 含义 |
|---|---|---|
| Encoded | 成功的卡片行 | AVA 已为此次尝试写入卡片 |
| Failed | 行中的错误详情 | 卡片未能编码 |
| Expired | 已超过有效期的卡片 | 卡片不再有效 |
| Revoked | 已撤销的卡片行 | 卡片被提前禁用 |
| Superseded | 替换卡片行 | 新卡片替换了这张卡片 |
| Created | Created 列中的编码时间 | AVA 记录此次尝试的时间 |
默认列表仍按预订对访问代码进行分组。 在 Events 视图中，钥匙卡行会展开为每次尝试一行。 智能锁和储物柜行仍按每个访问代码显示一条记录。
对于 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 中出现多次。
解决方法：
- 查看 Display status 列。
- 使用最新的 Created 时间。
- 只有在需要审计轨迹时才保留较旧的记录。
找不到访问代码
你会看到：“No access codes found”或列表为空。
解决方法：
- 清除所有筛选条件。
- 按 Reservation ID 或 Room 搜索。
- 刷新页面。
复制图标没有反应
**你会看到：**复制图标没有变成 Copied。
解决方法：
- 先显示 PIN。
- 授予浏览器剪贴板访问权限后再试一次。
状态显示 Failed
**你会看到：**状态为 Failed，并附带错误消息。
解决方法：
- 确认智能锁集成已连接。
- 从预订中重新尝试创建 PIN。
作业状态一直是 pending 或 partial
**你会看到：**创建智能锁代码后，它显示 pending 或 partial。
解决方法：
- 等待最多 1 分钟，然后刷新预订或 Access Codes 页面。
- 新 PIN 会优先于较旧的积压记录进行检查，因此新的客人代码应最先完成。
- 如果你正在进行入住查找，AVA 会在显示结果前重新检查 pending 作业。
- 如果该记录已经过期，AVA 会有意跳过它。
- 如果状态变为 Successful，请分享 PIN。
- 如果当前住客的代码超过 1 分钟仍为 pending 或 partial，请从预订中重试 PIN 创建。
- 如果状态变为 Timed out 或 Failed，请在再次尝试前检查供应商连接和桥接服务状态。
钥匙卡失败消息使用通俗语言
**你会看到：**钥匙卡行显示简短消息，而不是原始供应商字符串。
你还可能看到 userMessage、errorCode、retriable、vendor 或安全的 upstream 详情。
解决方法：
- 先阅读简短消息。
- 联系支持团队时，提供错误代码、可重试标志和供应商详情。
- 确认预订 ID、房间和入住日期正确。
- 如果房间映射或编码器会话不正确，先修复这些问题。
- 保存更改后，再重试钥匙卡操作。
缺少 Valid Period 列
**你会看到：**未显示 Valid Period 列。
解决方法：
- 清除所有筛选条件。
- 确认你没有查看仅包含储物柜代码的列表。
QR 密钥操作不可用
**你会看到：**Issue、Reissue 或 Send 不可用。
解决方法：
- 打开按预订筛选的 QR 密钥历史记录。
- 确认所选房间在 PMS 中未终止。
- 检查 PMS 房间是否保存了 QRLOCK 映射。
- 如果之前的撤回仍在处理，请使用 Retry cancellation。
客人电话号码变更后找不到已保存的 QR 密钥
**你会看到：**客人的电话号码为空或已变更，但之前曾发放过 QR 密钥。
解决方法：
-
最新 PMS 数据到达后，刷新预订。
-
确认所选房间和入住日期与 QR 密钥历史记录一致。
-
重新打开 Manage digital key。
-
如果现有密钥出现，请使用 Copy guest link 或 Send。
-
状态仍在加载时，不要重复发放密钥。
✓ 当入住信息和房间映射仍然匹配时，AVA 可以重新使用已保存的密钥。
如果密钥仍不可用，请在重新发放前联系支持团队。房间、入住信息、映射、过期状态 或撤回状态发生变化时，可能需要工作人员恢复。
仍然无法解决？
如果出现以下情况，请联系 success@vouch-technologies.com：
- ❌ 入住后代码没有显示
- ❌ 多次重试后状态仍为 Failed
- ❌ 无法打开 Access Codes 页面
建议提供：
- Reservation ID
- 房间号
- 状态行的截图