数据未更新

快速修复

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

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

自动重试

AVA 现在会自动重试部分较短的 PMS 读取请求。 你可能不会看到一次性的网络错误。

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
客人详情在换房后看起来不正确	房间变更还没有完成同步	等换房完成后刷新该预订，再重试客人更新
ACI 文档上传完成，但 Registration 或最终入住显示客人上限，或 Cloudbeds 多房间预订显示错误的客人数或丢失房间	PMS 客人数仍然落后于本地房间总数，或 Cloudbeds 在父预订更新后仍需要一次新的刷新	刷新预订，然后几分钟后再查看 PMS
Cloudbeds 占用编辑或入住显示 PMS_RATE_PRESERVATION_SOURCE_TAX_UNSUPPORTED	AVA 无法安全模拟预订来源的税费规则，因此将该更改标记为终止	在 Cloudbeds 中检查来源规则，刷新 AVA，修正后再重试一次
Cloudbeds 占用编辑或入住显示 PMS_OCCUPANCY_UNAVAILABLE_FOR_DATES	Cloudbeds 拒绝了所选日期或房间可用性，而不是成人或儿童拆分	检查 Cloudbeds 可用性，改选可用选项，刷新 AVA，然后重试一次
Cloudbeds 预订备注显示小额舍入差异	Cloudbeds 意外重新定价，AVA 验证了备用费率修正	不要发布手动修正；如果反复发生，请通知 PMS 管理员
保存住客信息或最终入住显示永久性的 PMS 客人数拒绝	PMS 拒绝了该成人或儿童数量，AVA 不会重放相同更改	阅读 PMS 原因，选择 End session，修正预订或 PMS 设置，然后开始新的登记
客人数同步达到重试上限	四次面向住客的尝试后，临时 PMS 失败仍在继续	不要继续让住客重试；继续员工协助流程，并核对 PMS 客人数
Mews 住客换房报告同伴容量失败	Mews 可能已在返回响应前应用了添加住客操作	刷新预订，确认住客已附加到 Mews；只有在住客缺失时才重试
客人证件或自拍在 PMS 同步失败后停住	AVA 会等待有效的 PMS 客人标识符，再继续后续上传	先修复 PMS 同步错误，刷新页面，然后重试上传
登记卡在 AVA 中出现，但 PMS 中没有	AVA 已在本地保存登记卡，正在异步传送	打开 PMS 附件传送，然后在可用时刷新或使用 Retry
再次点击 Refresh 后列表仍然看起来很旧	上一次手动刷新还没有完全完成	等待 5 秒，然后再次点击 Refresh
列表看起来过旧	PMS 还没有返回最新数据	点击 Refresh
日历或入住/退房日志看起来过旧	共享预订缓存还没有刷新	在受影响的页面点击 Refresh
客人或房间的变更没有出现	PMS 同步延迟	等几分钟后再刷新一次
一切看起来都是空白	页面没有完成加载	刷新页面一次

预订更新已在进行中

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

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

解决方法：

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

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

3. 等待该操作完成。

4. 在 AVA 中刷新预订。

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

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

不要持续重试持久冲突

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

房间分配冲突

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

入住期间的 PMS 限流

AVA 会在分配房间和最终入住期间重试临时的 PMS 429。 PMS 恢复期间，操作可能需要多几秒。 如果重试额度用尽，AVA 会显示对住客安全的错误，而不会暴露 429。 让操作完成，然后检查 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 可能已经显示已保存的旅行证件、住客照片或登记卡。 使用 Command Center → View Details 中针对附件的状态。 仅重试可用操作所显示的附件类型。

Cloudbeds 多房间客人数

AVA 现在会更新父 Cloudbeds 预订，并保留完整房间列表。 这样可防止在客人数变化时其他房间被移出。

ACI 客人数刷新

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

PMS 客人标识符保护

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

ACI 入住期间达到客人上限

你会看到： 在你新增住客或完成 ACI 流程时，出现 "Guest limit reached"。

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

解决方法：

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

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

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

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

从这里开始

1. 再打开一次页面。

2. 点击 Refresh。

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

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

PMS 设置缺失或被拒绝

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

你看到的内容： Settings 按钮、Retry 按钮、设置必需提示，或提示已保存的 PMS 凭据被拒绝。

原因： 你的酒店已经选择了 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 会保留该时间。 部分面向住客的入住、退房和客房清洁请求在本地短暂突增时会先等待几秒。 这只会在 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. 再查看一次该房间。

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

仍然卡住？

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

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

建议附上：

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

相关指南

• PMS 连接
• PMS 连接错误
• 查看预订详情