跳到主要内容

数据未更新

快速修复

大多数情况只需要 2-5 分钟。先点 Refresh，如果列表仍然看起来为空，再检查 Settings。

当 AVA 中的预订、房间状态或住客详情看起来过时时，请使用本指南。

自动重试

AVA 现在会自动重试部分较短的 PMS 读取请求。 你可能不会看到一次性的网络错误。 在 Opera 入住期间，当 Opera 报告预订已锁定时，AVA 也会重试住客更新。 可安全重放的共享器检查点可防止重试创建重复预订。 共享器付款副本使用与共享完成不同的检查点。 已确认的失败可以恢复，但结果不明确的付款会保持暂停。

Cloudbeds 读取共享

如果多名员工同时请求同一份 Cloudbeds 数据，AVA 会共享一次读取请求。 如果同一个 Cloudbeds 访问错误反复出现，AVA 会在短时间内暂停下一次重试。 刷新在后台完成时，当前列表仍会保持可见。

共享预订缓存

预订列表、Calendar 以及入住/退房日志现在都会从同一个预订缓存刷新。 一次入住、退房或酒店切换后的刷新，会同步更新这三种视图。

你看到的内容原因处理方法
页面显示 Settings 或 Retry，而不是预订列表列表在加载前必须先完成 PMS 设置在 Settings → Essentials → PMS Integration 完成 PMS 设置
页面提示 PMS 凭据被拒绝AVA 无法使用已保存的 PMS 凭据在 Settings → Essentials → PMS Integration 中更新 PMS 凭据
页面显示 429 或限流消息PMS 正在限制请求等待消息中显示的重试时间，然后刷新并重试
在 429 期间分配房间或完成最终入住需要更长时间AVA 正在重试临时的 PMS 限流让操作完成。如果失败，请检查 PMS，刷新 AVA，然后重试一次
同一个 Cloudbeds 访问错误马上再次出现Cloudbeds 阻止了该物业或权限，AVA 正在减少重复重试确认 Cloudbeds 物业正确，然后等一分钟再刷新
页面先失败一次，刷新后又好了AVA 已重试一次短暂的 PMS 网络问题刷新一次即可
预订操作提示另一个更新正在进行同一预订正从另一个标签页、设备或员工流程中被修改等操作完成，刷新预订，然后重试一次
分配房间或完成最终入住时显示 PMS_RESERVATION_MUTATION_IN_PROGRESS短暂的 PMS 预订更新与入住操作重叠短暂等待，刷新预订，然后只重试受影响的步骤一次
上一位客人退房后，房间看起来仍然被占用Streamliner 还没有重新生成最新的预订快照再点一次 Refresh
已入住的房间显示 Unknown 占用状态，或房卡编码被阻止AVA 无法验证准确分配房间的占用状态在 PMS 中确认分配的房间，刷新 AVA，然后重试房卡编码一次
客人详情在换房后看起来不正确房间变更还没有完成同步等换房完成后刷新该预订，再重试客人更新
ACI 文档上传完成，但 Registration 或最终入住显示客人上限，或 Cloudbeds 多房间预订显示错误的客人数或丢失房间PMS 客人数仍然落后于本地房间总数，或 Cloudbeds 在父预订更新后仍需要一次新的刷新刷新预订，然后几分钟后再查看 PMS
Cloudbeds 住客同步要求进行身份审核订单存在重复的匹配姓名、相互冲突的身份详情或不完整的订单数据在 Cloudbeds 中检查住客，刷新 AVA，然后重试一次。不要手动创建另一个档案
Cloudbeds 入住或退房无法验证换房后的房间原生房间 ID 没有已确认的父级或当前房间详情在 Cloudbeds 中确认当前房间，刷新 AVA，然后重试一次
Cloudbeds 占用编辑或入住显示 PMS_RATE_PRESERVATION_SOURCE_TAX_UNSUPPORTEDAVA 无法安全模拟预订来源的税费规则，因此将该更改标记为终止在 Cloudbeds 中检查来源规则，刷新 AVA，修正后再重试一次
Cloudbeds 占用编辑或入住显示 PMS_OCCUPANCY_UNAVAILABLE_FOR_DATESCloudbeds 拒绝了所选日期或房间可用性，而不是成人或儿童拆分检查 Cloudbeds 可用性，改选可用选项，刷新 AVA，然后重试一次
Cloudbeds 预订备注显示小额舍入差异Cloudbeds 意外重新定价，AVA 验证了备用费率修正不要发布手动修正；如果反复发生，请通知 PMS 管理员
保存住客信息或最终入住显示永久性的 PMS 客人数拒绝PMS 拒绝了该成人或儿童数量，AVA 不会重放相同更改阅读 PMS 原因，选择 End session，修正预订或 PMS 设置，然后开始新的登记
客人数编辑不受支持，或 ACI 表示仅在本地更新了客人数Opera Cloud、Mews、eZee 或 Furama v1 无法通过 AVA 写入客人数在 PMS 中更新客人数，然后刷新 AVA 中的预订
客人数同步达到重试上限四次面向住客的尝试后，临时 PMS 失败仍在继续不要继续让住客重试；继续员工协助流程，并核对 PMS 客人数
Mews 住客换房报告同伴容量失败Mews 可能已在返回响应前应用了添加住客操作刷新预订，确认住客已附加到 Mews；只有在住客缺失时才重试
住客证件或自拍在 PMS 同步失败后停住AVA 会等待有效的 PMS 住客标识符，再继续后续上传先修复 PMS 同步错误，刷新页面，然后重试上传
住客验证后，Registration 一直处于待处理状态PMS 未确认该住客属于当前预订及预订范围在 PMS 中检查住客和确认号码，刷新 AVA，然后重试一次 Registration
登记卡在 AVA 中出现，但 PMS 中没有AVA 已在本地保存登记卡，正在异步传送打开 PMS 附件传送，然后在可用时刷新或使用 Retry
员工验证覆盖后登记卡缺失AVA 在传送登记卡前恢复了 PMS 住客同步打开 PMS 附件传送，等待住客同步，然后在可用时使用 Retry
共享器付款副本失败或显示结果不明确Opera 可能已在 AVA 收到响应前接受了追加操作在 Opera 中检查共享器，然后联系支持，不要重复复制
最近的 Opera 预订或账单变更尚不可见AVA 可能会在最多五秒内短暂重复使用相同的 Opera 读取结果等待五秒，刷新预订，然后在 Opera 中确认变更
再次点击 Refresh 后列表仍然看起来很旧上一次手动刷新还没有完全完成等待 5 秒，然后再次点击 Refresh
列表看起来过旧PMS 还没有返回最新数据点击 Refresh
日历或入住/退房日志看起来过旧共享预订缓存还没有刷新在受影响的页面点击 Refresh
客人或房间的变更没有出现PMS 同步延迟等几分钟后再刷新一次
两台设备上的 ACI 员工状态可能已过时住客平板在员工设备收到保存进度更新前完成了某一步在 AVA 重试期间保持预订打开；如果过时状态指示器仍在显示，则刷新员工页面一次
一切看起来都是空白页面没有完成加载刷新页面一次

预订更新已在进行中​

你会看到： 预订操作显示冲突，或提示另一个更新正在进行。 这可能发生在入住、住客更新、换房、付款或文档上传期间。

原因： 另一个标签页、设备或员工流程正在修改同一预订上下文。 AVA 一次只允许一个修改预订的操作。 这也包括一次入住或住客换房所使用的关联预订。 对于同一预订，AVA 也能识别别名。

解决方法：

  1. 停止再次点击相同操作。

  2. 检查是否有其他员工或设备正在处理该预订。

  3. 等待该操作完成。

  4. 在 AVA 中刷新预订。

  5. 在 PMS 中检查预订，然后重试该操作一次。

    ✓ 已完成的更改应该会出现，不会创建第二次 PMS 更新。

不要持续重试持久冲突

AVA 会一直保持此保护，直到首次变更完成协调。 如果没有正在进行的操作，刷新后冲突仍然存在，请联系支持。 支持人员可能需要确认 PMS 结果后，才能恢复预订流程。

房间分配冲突

入住期间，PMS 护照或住客更新可能会与房间分配或最终入住短暂重叠。 AVA 会自动重试确切的 PMS_RESERVATION_MUTATION_IN_PROGRESS 冲突。 如果重试窗口结束，AVA 会保留可重试的冲突，而不是将其视为永久失败。 短暂等待，刷新预订，然后只重试受影响的步骤一次。

Opera 住客更新冲突

在 Opera 入住期间，住客更新可能会与文档上传或其他预订变更重叠。 AVA 会在报告失败前自动重试临时的记录锁定。 此重试也会保护 Opera 共享器预订的预期时间更新。 如果更新仍然失败，请刷新 AVA，并在重试一次前检查 Opera 中的预订。

入住期间的 PMS 限流

AVA 会在分配房间和最终入住期间重试临时的 PMS 429。 PMS 恢复期间，操作可能需要多几秒。 如果重试额度用尽，AVA 会显示对住客安全的错误，而不会暴露 429。 让操作完成，然后检查 PMS，之后再重试一次。

Cloudbeds 多房间客人数

AVA 现在会更新父 Cloudbeds 预订，并保留完整房间列表。 这样可以防止在客人数变化时其他房间被移出。 如果 Cloudbeds 拒绝保存，AVA 会保留待重试的成人/儿童拆分。

ACI 客人数刷新

在 ACI 中，AVA 会在发送待处理住客前刷新 PMS 客人数。 这样可以减少多住客入住时过时的住客上限错误。

ACI 文档时机

文档扫描不会在 ACI 中更新 PMS 占用情况。 AVA 会在 Registration 期间创建或同步待处理住客时检查容量。 AVA 会在最终入住前再次检查。 如果扫描后出现容量或费率错误，文档仍会被保存。

客人数协调

临时 PMS 或传输失败可能会显示可重试的服务消息。 当 PMS 返回 PMS_RESERVATION_CONCURRENT_MODIFICATION 时，保存期间的预订变更冲突也可以重试。 对于同一次客人数更改，AVA 最多允许四次面向住客的尝试。 四次尝试都失败后，AVA 会停止重试循环并将流程交给员工。 特定的 PMS 拒绝或普通 409 对该变更来说是永久性的。 AVA 会保留 PMS 原因，并停止重放相同更改。 如果 AVA 显示客人数协调指导，请选择 End session。 修正预订或 PMS 设置，然后开始新的登记。

客人数更新需要人工检查​

你会看到： 保存住客信息或最终入住显示具体的 PMS 拒绝。

原因： PMS 拒绝了该预订的成人或儿童数量。

解决方法：

  1. 阅读 AVA 显示的 PMS 原因。

  2. 在 PMS 中打开预订。

  3. 根据该原因修正预订或 PMS 设置。

  4. 在 AVA 中选择 End session。

  5. 开始新的登记。

    ✓ 新登记会使用修正后的客人数。

不要持续重试相同的客人数更改。

客人数同步已达到重试上限​

你会看到： 多次客人数同步失败后，住客会看到员工协助指导。 员工可能会看到 PMS_GUEST_COUNT_RETRY_EXHAUSTED。

原因： 四次面向住客的尝试后，临时 PMS 或网络失败仍在继续。 这并不表示客人数一定错误。

解决方法：

  1. 不要继续让住客重试同一步骤。

  2. 继续使用员工协助或手动入住流程。

  3. 将登记的客人数与 PMS 中的预订进行比较。

  4. 如果数量不一致，修正 PMS 预订。

  5. 当员工流程允许时，恢复待处理的客人数更改。

    ✓ 住客流程不再因临时错误循环。

PMS 恢复后，如果员工流程无法恢复，请联系支持。

Cloudbeds 拒绝可用性，需要更换选项​

你会看到： Cloudbeds 占用编辑或入住显示 PMS_OCCUPANCY_UNAVAILABLE_FOR_DATES。 消息要求更改日期或选择较少的房间。

原因： Cloudbeds 无法满足所选日期或房间可用性。 住客人数仍可能是正确的。

解决方法：

  1. 停止重试相同请求。

  2. 在 Cloudbeds 中检查预订日期、房型和可用性。

  3. 如适用，在 Cloudbeds 中改选可用选项。

  4. 刷新 AVA，然后重试一次。

    ✓ Cloudbeds 接受可用选项后，占用变更应该会继续。

这不是临时连接错误

AVA 将此 Cloudbeds 拒绝与服务失败分开分类。 当 Cloudbeds 报告该住客拆分没有费率时，请使用 Cloudbeds 占用不可预订。

Mews 住客换房报告容量失败​

你会看到： Mews 住客换房报告同伴容量失败。

原因： Mews 可能会在返回响应前应用添加住客操作。 AVA 显示失败时，住客可能已经附加。

解决方法：

  1. 在 AVA 中刷新预订。

  2. 在 Mews 中检查预订。

  3. 如果住客已附加，请继续操作，不要再次添加。

  4. 如果住客缺失，重试换房一次。

  5. 如果一次重试后住客仍然缺失，请联系支持。

    ✓ 住客应该会出现在正确的 Mews 预订中，且不会出现重复同伴。

Cloudbeds 来源策略检查

AVA 会在占用变更期间向 Cloudbeds 发送按房间设置的不重新定价选项。 AVA 会在使用备用修正前检查预订的准确预订来源。 完全包含在内的百分比来源费用会使用准确的总价重定价差额，包括多项费用。 混合、固定、缺失或不可读取的来源规则仍会在占用变更前停止操作。 不支持的来源税费规则会在重新定价前停止编辑。 在 Cloudbeds 中检查来源，刷新 AVA，修正后重试一次。 AVA 会为此失败保存终止标记。 后续重试会保留相同指示，不会发送另一个占用请求。

Cloudbeds 舍入差异无需手动修正​

你会看到： Cloudbeds 预订备注说明存在小额舍入差异。 备注可能会说总额未变，或显示结算总额与预订相差不超过 5 分。

原因： Cloudbeds 意外重新定价，然后将税费计算舍入到整分。 这可能会在房间收入和税费之间移动几分钱，或留下少量总额残差。

解决方法：

  1. 阅读预订备注。

  2. 确认备用修正已结算预订总额。

  3. 不要发布手动修正。

  4. 如果重复发生，请通知 PMS 管理员。

    ✓ 确认差异属于舍入范围后，AVA 会接受该预订。

当备用修正保持面向住客的总额不变时，AVA 接受最多 10 分的拆分舍入。 经过最终验证重试后，来源感知更新可以接受最多 5 分且一致的总额残差。 更大或不一致的差异仍需要人工检查。

PMS 客人标识符保护

当客人尚未同步到 PMS 时，AVA 会暂停后续证件和照片上传。 这样可以防止文件被附加到错误的住客档案。

PMS 未确认住客登记​

你会看到： 住客验证后，Registration 一直处于待处理状态。 AVA 要求你重试，或要求前台在继续前进行检查。

原因： AVA 无法确认该住客属于当前活动预订。 PMS 可能没有返回确认、返回未确认结果，或返回了另一个住客档案。 AVA 还会拒绝缺少预订范围或确认号码详情的请求。

解决方法：

  1. 在 PMS 中打开预订。

  2. 确认住客已附加到正确的预订和房间。

  3. 确认预订确认号码与订单一致。

  4. 在 AVA 中刷新预订。

  5. 重试一次 Registration。

  6. 如果仍处于待处理状态，请让前台检查预订。

    ✓ 只有在 PMS 确认匹配的预订住客后，AVA 才会清除待处理状态。

不要绕过待处理状态

不要重复发送相同的登记请求，也不要手动继续后续上传。 此保护机制可防止住客文档附加到错误的 PMS 预订。

验证覆盖后登记卡缺失​

你会看到： 员工覆盖验证成功，但登记卡未出现在 PMS 中。

原因： AVA 在发送登记卡之前恢复了 PMS 住客同步。

解决方法：

  1. 为该预订打开 Command Center → Status → View Details。

  2. 检查 Registration Card 附件状态。

  3. 如果状态显示 Waiting 或 Processing，请等待。

  4. 修复附件消息中显示的任何 PMS 错误。

  5. Retry 可用后，选择它。

    ✓ PMS 确认住客状态已刷新后，登记卡就会上传。

此恢复流程适用于文档、住客登记和人脸验证覆盖。

本地保存与 PMS 传送是分开的

AVA 会在 PMS 传送完成前显示已保存的旅行证件、住客照片或登记卡。 使用 Command Center → View Details 中针对附件的状态。 仅重试可用操作所显示的附件类型。

ACI 入住期间达到住客上限​

你会看到： 在你新增住客或完成 ACI 流程时，出现“已达到住客上限”。

原因： PMS 预订中的客人数仍低于 AVA 中的数量。

解决方法：

  1. 等几秒钟，再重试一次该步骤。

  2. 如果 PMS 数量仍然落后，请刷新预订。

  3. 如果该房间已经达到 PMS 上限，请把文档分配给现有住客。

    ✓ 一旦 PMS 客人数与房间总数一致，客人上限就会消失。

从这里开始​

  1. 再打开一次页面。

  2. 点击 Refresh。

  3. 查看最新数据是否出现。

    ✓ 大多数轻微延迟在一次刷新后就会消失。

PMS 设置缺失或被拒绝​

当 AVA 显示设置提示而不是预订数据时，请使用此流程。

你看到的内容： Settings 按钮、Retry 按钮、设置必需提示，或提示已保存的 PMS 凭据被拒绝。 对于 Opera 物业，设置提示可能会显示“Opera 未针对该操作完成配置”。

原因： 你的酒店已经选择了 PMS，但 AVA 还无法使用其凭据。

解决方法：

  1. 前往 Settings → Essentials → PMS Integration。

  2. 确认所选 PMS 正确。

  3. 补上缺失凭据、更新被拒绝的凭据，或重新激活该 PMS。

  4. 保存更改。

  5. 返回预订页面。

  6. 点击一次 Retry 或 Refresh。

    ✓ PMS 设置完成后，页面应该会重新加载预订。

为什么会停止自动刷新

当需要完成 PMS 设置时，AVA 会停止自动刷新循环。 这样可以避免页面无限重载。

强制完整刷新​

当页面在普通刷新后仍然看起来过旧时，请使用此方法。

  1. 使用硬刷新。
    • Windows：Ctrl+F5
    • Mac：Cmd+Shift+R
  2. 等待页面完全加载。
  3. 再次检查数据。

检查你的连接​

  1. 打开一个新标签页。
  2. 访问另一个网站。
  3. 如果其他网站也很慢，请切换到更稳定的网络。

退出再登录​

当页面仍然没有更新时，请使用此方法。

  1. 从用户菜单退出登录。
  2. 关闭浏览器。
  3. 重新登录。
  4. 再次检查页面。

限流恢复​

你会看到： 刷新后出现 429 错误或限流消息。

原因： PMS 暂时限制了请求量。 当 PMS 提供重试时间时，AVA 会保留该时间。 在 Command Center 中，Status 同步会在页面、筛选器和搜索之间共享冷却时间。 如果你在冷却期间切换视图，AVA 会等待，并且只同步最新选择。 部分面向住客的入住、退房和客房清洁请求在本地短暂突增时会先等待几秒。 这只会在 AVA 自己的令牌桶暂时为空时发生。 Cloudbeds 的客房清洁读取在 PMS 变慢时大约等待 10 秒后会停止。 AVA 会先重试一次该读取，再显示错误。 如果 Cloudbeds 连续返回相同的访问错误，AVA 会短暂暂停下一次重试。 供应商级冷却仍然会快速失败。 繁忙的刷新工作不会阻塞入住或换房操作。

解决方法：

  1. 等待错误中显示的重试时间。

  2. 在该时间过后刷新页面。

  3. 再尝试一次。

  4. 如果错误再次出现，先等几分钟再重试。

  5. 如果没有显示重试时间，请先短暂等待，再稍后尝试。

    ✓ 当 PMS 接受新的请求后，AVA 应该会加载最新数据。

临时连接抖动​

你会看到： 一次性的连接错误、超时或空白状态，刷新后会消失。

原因： AVA 会自动重试部分较短的 PMS 读取请求。

解决方法：

  1. 刷新页面一次。

  2. 再试一次操作。

  3. 如果仍然失败，请检查 PMS 连接。

  4. 如果同样的错误持续出现，请联系支持。

    ✓ 这类偶发问题通常不需要修改设置就会消失。

房间仍然显示为已入住​

你会看到： 你已经为上一位客人退房，但房间仍显示为已占用。

原因： AVA 可能仍在显示旧的预订快照。

解决方法：

  1. 点击 Refresh。

  2. 等几秒钟，让最新 PMS 状态加载完成。

  3. 再查看一次该房间。

    ✓ 退房同步完成后，房间状态应该会更新。

分配房间的占用状态未知​

你会看到： 已入住的房间显示 Unknown 占用状态，或房卡编码被阻止。

原因： AVA 无法验证准确分配房间的占用状态。 AVA 不会从同一预订中的其他房间复制占用状态。

解决方法：

  1. 在 PMS 中打开预订。

  2. 确认分配的房间与预订相匹配。

  3. 在 AVA 中刷新预订或 Operations View。

  4. 房间状态可用后，重试房卡编码。

  5. 刷新一次后房间仍显示未知时，请联系支持。

    ✓ AVA 应使用已验证的分配房间状态来控制房间访问。

两台设备上的 ACI 进度看起来已过时​

你会看到： 住客平板已完成某一步，但员工屏幕显示的是较早的进度。 AVA 在协调会话时可能会显示过时状态指示器。

原因： 完成更新或保存进度的读取被延迟了。 住客的完成状态可能会先到达，而员工设备稍后才收到其快照。

解决方法：

  1. 在已验证的员工设备上保持同一预订处于打开状态。

  2. 等待 AVA 重试读取保存的进度。

  3. 确认住客平板仍已配对并保持连接。

  4. 不要重新发送住客已经完成的步骤。

  5. 如果指示器仍然存在，刷新员工页面一次。

  6. 如果进度仍未更新，请开始新的 ACI 会话。

    ✓ 员工屏幕应显示最新保存的住客进度。 ✓ AVA 会保留实时账单、房间访问权限、其他预订以及较新的员工编辑。

如果刷新一次并开始新会话后过时状态指示器仍然存在，请联系支持。

仍然卡住？​

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

  • ❌ 保存 PMS 凭据后，设置提示仍然存在
  • ❌ 刷新后仍然显示空预订
  • ❌ 同样的问题出现在多个标签页

建议附上：

  • PMS 提供商名称
  • 提示或空状态的截图
  • 你最后一次保存设置的时间