跳到主要内容

智能锁故障排查

快速修复

先点击 Refresh Locks，然后针对一个房间运行 Test PIN Generation。通常只需 2 分钟。

本指南可帮助你解决 Igloohome、TTLock 和 Wishome 的常见智能锁问题。

房间专属 PIN

AVA 会将每个 PIN 绑定到预订中的 PMS 房间。 对于非 Opera PMS 配置，AVA 使用房间自己的确认号进行智能锁访问。 对于 Opera OHIP 多房间预订，AVA 创建智能锁访问时会使用每个子预订的房间号。 如果客人更换房间，请等待同步完成后再生成新的 PIN。 对于多房间预订，每个房间都使用自己的子预订或房间级 ID。 这样可以确保批量生成 PIN 时绑定到正确的房间。 重新打开查询时，AVA 还可以恢复同一预订家族中的关联房间。 混合日用和过夜预订会保持各自独立的房间时间窗口。 AVA 不再将一个房间的到期时间窗口复制到另一个房间。 对于 Mews，AVA 会先按酒店所在物业的时区读取入住日期，再构建 PIN 时间窗口。

酒店本地 PIN 到期时间

AVA 会将仅含日期的预订值视为酒店配置时区中的日历日期。 例如，新加坡的退房日期为 8 月 3 日时，到期日就是 8 月 3 日。 完整的日期时间值会先转换为酒店时区，然后 AVA 才会构建 PIN 时间窗口。 AVA 对生成的、自定义的和随机自定义 PIN 使用相同的时间窗口。

快速参考​

你看到的情况原因处理方式
"Failed to generate lock code"供应商连接问题或锁处于离线状态检查供应商和锁的状态
失败的 PIN 在刷新后开始生效AVA 在下一次预订拉取时重试生成，包括同一预订家族中的关联房间刷新预订
日用房间得到错误的到期时间混合预订日期或时区不匹配检查房间专属日期
PIN 在错误的日历日期结束酒店时区或旧的 PIN 时间窗口检查 PIN 到期日期
自定义 PIN 的长度与预期不同供应商支持的限制不同检查供应商 PIN 限制
Manage PIN 已禁用房间尚未分配、房间数据尚未同步，或房间未映射到锁打开 Room Access，然后刷新
PIN 已生成但无法在锁上使用PIN 尚未同步到锁，或桥接器处于离线状态在供应商应用中验证 PIN
Operation 状态一直是 pending 或显示 partial供应商桥接任务仍在处理等待并刷新
Smart Lock Setup 中显示 "PIN generation failed for all locks"供应商中断或所有锁都无法访问刷新后重新测试
Smart Lock Setup 中没有锁供应商未关联或没有同步锁刷新或重新连接
"Operation not supported" 或某个操作已禁用锁型号或供应商不支持该操作检查功能支持情况
客人收到错误的门码锁映射到了错误房间，或预订指向了错误的 PMS 房间检查房间映射和预订房间
Igloohome 在 OAuth 成功后显示 Not linked回调已返回，但状态尚未刷新刷新 Igloohome 状态

Manage PIN 已禁用​

你看到的情况： Manage PIN 按钮显示为灰色，或者无法为客人生成 PIN。

解决方法：

  1. 确认预订已分配房间。

  2. 如果房间为空，请在 PMS 中分配房间。

  3. 等待 1–2 分钟完成同步，然后刷新 AVA。

  4. 前往 Settings → Room Access，确认房间已在 Smart Lock Setup 中映射到一把锁。

  5. 如果提示中包含链接，请打开链接，直接跳转到 Settings → Room Access。

    ✓ 分配并映射房间后，Manage PIN 应该就可用了。

代码生成失败​

你看到的情况： 入住期间出现 "Failed to generate lock code"，或 PIN 无法使用。 如果 Access Details 显示 errorCode、retriable 或 vendor，也请结合这些信息判断。

解决方法：

  1. 刷新预订；如果客人已经入住，则从预订查询中重新打开。

    • 如果这是多房间预订，也请重新打开父确认号。

  2. 确认锁有电，并且能在供应商应用中响应。

  3. 在 AVA 中点击 Refresh Locks。

  4. 如果问题仍然存在，请在 Room Access 中重新连接供应商。

  5. 如果客人正在等待，请从供应商应用发放手动密码，或使用实体钥匙。

    ✓ 对于符合条件的在住预订，AVA 会在下一次获取预订时重试生成智能锁 PIN。

日用访问时间窗口不正确​

你看到的情况： 混合预订使某个房间获得错误的到期时间，或日用房间与过夜房间共用时间窗口。

解决方法：

  1. 在 AVA 中刷新预订。

  2. 确认 PMS 中每个房间都有正确的房间号和入住日期。

  3. 如果使用 Mews，请在 Settings → Essentials → Hotel Basic Details 中检查物业时区。

  4. 如果错误的时间窗口仍然显示，请重新创建 PIN。

    ✓ 每个房间都应显示自己的到期时间窗口。

PIN 到期日期不正确​

你看到的情况： PIN 比预订退房日期晚一个日历日才结束。

解决方法：

  1. 前往 Settings → Essentials → Hotel Basic Details。

  2. 确认酒店的 Timezone 与物业所在的本地时区一致。

  3. 确认 PMS 中的预订退房日期。

  4. 修正时区或预订后，从预订中生成新的 PIN。

  5. 如果旧 PIN 仍使用错误的有效时间窗口，请将其撤销。

    ✓ 新 PIN 会在酒店时区的退房日期结束。

现有 PIN 不会更改

更改此行为不会更新供应商已经创建的 PIN。 请单独撤销或重新生成这些 PIN。

自定义 PIN 长度不正确​

你看到的情况： 生成的自定义 PIN 长度与保存的设置不同。

解决方法：

  1. 检查供应商支持的范围：

    • Igloohome： 4–6 位
    • TTLock： 4–9 位
    • Wishome： 6–10 位

  2. 如果所选长度超出该范围，AVA 会自动调整生成的 PIN。

  3. 从预订中生成新的 PIN。

    ✓ 新的自定义 PIN 会使用供应商支持的长度。

Operation 状态一直是 pending 或 partial​

你看到的情况： 创建智能锁代码后，显示 pending 或 partial。

解决方法：

  1. 最多等待 1 分钟，然后刷新预订或 Access Codes 页面。
  2. AVA 会先检查较新的智能锁任务，再检查较旧的积压条目，因此新客人的 PIN 应先完成。
  3. 在刷新入住查询时，AVA 会在返回代码前重新检查待处理任务。
  4. AVA 会跳过已过期的历史 Active 行，即使旧的桥接字段仍然存在。
  5. AVA 会在后台继续检查供应商任务，因此当前住宿可能无需再次操作就变为 Successful。
  6. 等待入住期间，AVA 也会刷新待处理的智能锁任务，从而更快显示已准备好的 PIN。
  7. 如果看到 partial，请等待状态完成后再分享 PIN。
  8. 如果当前住宿的状态超过 1 分钟仍为 pending，请从预订中重试创建 PIN。
  9. 如果状态变为 Timed out 或 Failed，请检查供应商桥接器，并在需要时重新连接供应商。

生成的 PIN 无法在锁上使用​

你看到的情况： AVA 成功生成 PIN 码，但客人尝试开门时 PIN 无法使用。

解决方法：

  1. 在供应商应用中验证 PIN 码：

    • 打开供应商的智能锁应用（Igloohome、TTLock 或 Wishome）
    • 检查供应商应用中显示的 PIN 码是否与 AVA 生成的 PIN 一致
    • 查找相同的预订或时间段

  2. 如果 PIN 码不匹配，或未在供应商应用中显示：

    • 对于没有桥接器的锁： 取出并重新装入电池，为锁断电重启
    • 对于带桥接器/网关的锁：
      • 拔掉桥接器电源 30 秒，然后重新插回
      • 等待 2–3 分钟，让桥接器重新连接
      • 在供应商应用中确认桥接器显示为在线
    • 重置后，在 AVA 中点击 Refresh Locks
    • 尝试生成新的 PIN 码

  3. 如果问题仍然存在：

    • 在供应商应用中检查锁的电池电量（低电量可能导致同步问题）
    • 确保锁与桥接器之间的连接稳定（如适用）
    • 在供应商应用中确认锁的固件为最新版本

Smart Lock Setup 中的 PIN 测试失败​

你看到的情况： Smart Lock Setup 中显示 "PIN generation failed for all locks."。

解决方法：

  1. 点击 Refresh Locks。
  2. 使用 Test PIN Generation 再次测试单个房间。
  3. 如果所有测试都失败，请在 Room Access 中重新连接供应商。

Smart Lock Setup 中没有锁​

你看到的情况： Available Devices 为空。

解决方法：

  1. 确认供应商账号已关联。
  2. 点击 Refresh Locks。
  3. 确认锁在供应商应用中显示，并且与选定的供应商一致。

客人收到错误的门码​

你看到的情况： 换房或多房间预订后，客人收到错误房间的代码。

解决方法：

  1. 前往 Settings → Room Access。

  2. 滚动到 Smart Lock Setup。

  3. 确认预订显示正确的 PMS room。

  4. 如果这是 Opera OHIP 预订，请确认每个房间都有自己的子预订房号。

  5. 如果这是多房间预订，请确认每个房间都有自己的子预订 ID。

  6. 如果这是非 Opera 预订，请确认每个房间都有自己的房间专属确认号。

  7. 选择房间，并在需要时移除错误的锁。

  8. 分配正确的锁。

  9. 等待同步，然后再次运行 Refresh Locks 和 Test PIN Generation。

    ✓ 正确的锁会显示在 Assigned Devices 中。

不支持此操作​

你看到的情况： AVA 表示锁或供应商不支持你尝试的操作。

原因： 该锁型号不支持此功能，或供应商阻止了该操作。

解决方法：

  1. 前往 Settings → Room Access。

  2. 点击 Refresh Locks。

  3. 检查 Smart Lock Setup 中的功能标签。

  4. 如果该操作仍处于禁用状态，请使用其他锁型号或供应商。

    ✓ AVA 只会显示已连接的锁能够完成的操作。

Igloohome 专属问题​

Igloohome 在 OAuth 成功后显示 Not linked​

你看到的情况： OAuth 已完成，但 Igloohome Locks 仍显示 Not linked。

解决方法：

  1. OAuth 返回后，停留在 Settings → Room Access 页面。
  2. 等待几秒，让状态刷新。
  3. 如果状态没有变化，刷新页面一次。
  4. 如果仍显示 Not linked，请重新关联账号。

OAuth 连接已过期​

你看到的情况： 集成显示为已断开。

解决方法：

  1. 在 Igloohome Locks 中点击 Disconnect。
  2. 点击 Link Account。
  3. 完成 OAuth 授权。

锁未显示​

解决方法：

  1. 确认锁已在 Igloohome 中分配给该物业。
  2. 返回 AVA 并点击 Refresh Locks。

TTLock 专属问题​

登录失败​

你看到的情况： "Failed to connect TTLock account."

解决方法：

  1. 确认用户名和密码（区分大小写）。
  2. 在 TTLock 应用中确认账号处于启用状态。
  3. 30 秒后重试。

锁未同步​

解决方法：

  1. 打开 TTLock 移动应用。
  2. 站在每把锁附近，逐一同步锁。
  3. 返回 AVA 并点击 Refresh Locks。

Wishome 专属问题​

凭据不完整或令牌已过期​

你看到的情况： 显示 "Wishome credentials incomplete" 或令牌已过期警告。

解决方法：

  1. 重新输入 Wishome Account Name 和 Wishome Password。
  2. 确认 Offline Password Version 与 Wishome 设置一致。
  3. 点击 Connect Wishome Account。

仍然卡住？​

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

  • ❌ 在网络连接正常的情况下，所有锁仍显示离线
  • ❌ 供应商凭据正确，但连接失败
  • ❌ 多次重试后 PIN 仍然失败

建议附上：

  • 锁具供应商（Igloohome、TTLock 或 Wishome）
  • 受影响的锁具数量
  • 错误信息截图