跳到主要内容

PMS 连接错误

快速检查

大多数连接问题需要 5-10 分钟确认。 如果看到 429，请等待重试时间后再试。

当 AVA 无法连接、显示临时限流或报告 PMS 拒绝时，请使用本指南。

自动重试

AVA 现在会自动重试某些短暂的 PMS 读取请求，包括一次短暂的预订查询限流。 返回 408 的 Mews 读取请求也会使用读取重试路径。 Mews 请求使用有上限的重试窗口，因此缓慢的 PMS 不会让 Housekeeping 无限期等待。 Opera OAuth 也会自动重试一次临时超时或网关错误。 办理入住期间，AVA 会在查询预订、分配房间和最终办理入住时重试临时预订冲突和 PMS 限流。 Opera 住客更新也会重试临时预订锁定。 Mews 恢复请求会自动重试一次临时操作冲突 403。 这些重试可能会让 AVA 在显示错误前多等待几秒。 你可能不会看到一次性网络错误。 Cloudbeds webhook 凭据失败不会自动重试。

保留 PMS 信息

如果 AVA 在刷新时显示具体的 PMS 错误，请使用该信息。 Streamliner 会保留原始 PMS 响应，而不是将其替换为通用技术错误。

常见错误信息​

错误含义处理方式
"Please fill all required PMS fields"所选 PMS 缺少必填字段填写该提供商显示的必填字段
"Failed to save PMS Integration"连接或身份验证错误重新检查 PMS 账号和权限
"Failed to save settings before connecting"OAuth 开始前另一个 Essentials 设置保存失败阅读完整信息，修复该设置，然后重新连接
"Unable to communicate with the property management system"网络或 API 问题刷新一次，然后再次测试连接
PMS_TEMPORARILY_UNAVAILABLE分配房间期间 PMS 未响应检查 PMS，短暂等待，然后只重试一次房间分配
PMS_ROOM_UNAVAILABLE所选房间在此次入住期间不可用选择其他房间或日期，刷新 AVA，然后只重试一次
PMS_RESERVATION_NO_AVAILABILITY此次入住没有所选房型的可用房间选择其他房型或日期，刷新 AVA，然后只重试一次
"Self check-in is not available at this property right now"该酒店尚未配置住客自助办理入住请管理员连接 PMS 或完成 AVA PMS 设置
"429" 或 "rate limited"PMS 或 AVA 自身的请求预算要求稍后重试等待 AVA 重试入住操作，或按照显示的重试时间操作
"409" 或 "Conflict"PMS 因预订状态或请求不被允许而拒绝操作阅读 PMS 原因，修正预订，然后重试一次
"403" 与 "Conflicting operation is being performed"Mews 正在暂时处理另一项操作短暂等待 AVA 自动重试，然后根据需要重试受影响的步骤
PMS_RESERVATION_MUTATION_IN_PROGRESS短暂的 PMS 预订更新与房间分配或最终办理入住重叠短暂等待，刷新预订，然后只重试受影响的步骤一次
PMS_ROOM_ASSIGNMENT_OUTCOME_UNKNOWNPMS 可能已更改房间，但 AVA 无法验证最终分配结果不要重试；在 PMS 中核实房间和费率，然后在交接钥匙前使用明确的房间刷新
"Cannot check in reservation because assigned space is blocked"Mews 已封锁分配的空间在 Mews 中分配可用空间，然后重试办理入住
"Assigned space is not available for check-in"Mews 要求在办理入住前使用已检查的空间在 Mews 中分配已检查的空间，然后重试办理入住
"502" 或 "Bad Gateway"Cloudbeds、Opera 或其他 PMS 在读取或写入期间失败阅读原因，刷新一次，然后重试操作
"ava-pms returned 500 with an HTML error page"上游网关返回了临时网页，而不是 PMS 响应刷新一次，然后检查 PMS；如果再次出现，请联系支持
"503" 或 "Service Unavailable"PMS 或网络服务暂时无法完成请求检查 PMS 状态，刷新一次，然后重试操作
Mews API Error: Transaction has timed out.Mews 未能在重试窗口结束前完成库存读取检查 Mews，刷新 Housekeeping；如果持续出现，请联系支持
504 Mews view-billing deadline exceededMews 未能在 AVA 的账单读取限制前返回账单详情查看已存储的余额，与 Mews 对比，然后刷新一次
"non-reservations payload"eZee 返回了网站或其他响应，而不是预订数据检查 eZee Base URL；标准 API 应留空
"Unsupported Cloudbeds version"请求选择了已停用的 Cloudbeds v1 或 v2移除版本固定，然后开始新的连接
"You don't have access to property ID"Cloudbeds 阻止了该酒店确认正确的 Cloudbeds 酒店，恢复访问后再重试
"success:false" without an app-disconnected messageCloudbeds 返回了提供商特定的失败阅读完整信息，然后按照相关的 Cloudbeds 恢复步骤操作
"Application is not available to be connected"该酒店已在 Cloudbeds 中断开 AVA 应用为该酒店重新授权 Cloudbeds，然后重试
"webhook credentials rejected"Cloudbeds 接受了登录，但拒绝了 webhook 设置重新连接 Cloudbeds，再次保存设置
"PMS cache unavailable" 或缓存失效错误AVA 无法确认各服务中的新 PMS 设置等待一分钟，然后再次保存；若重复出现，请联系支持
设置保存在部分工作完成后失败下游步骤或缓存刷新在另一项写入完成后失败重试前检查 PMS，然后刷新 AVA
"Configuration is temporarily unavailable"Command Center 无法获取完整酒店配置刷新；如有要求则重新登录，然后请管理员检查访问权限
611 或 "Invalid Auth Code or Hotel Code"更改凭据后，eZee 拒绝了较旧的凭据快照保存匹配的 Hotel Code 和 Auth Code，然后重试一次
"reservationOverlapTo must be greater than reservationOverlapFrom"PMS 拒绝了住店重叠时间窗口在 PMS 中更新重叠值，然后刷新

临时连接故障​

你会看到： 一次性的连接错误、超时或空响应。

原因： AVA 会自动重试某些短暂的 PMS 读取请求。 它也会重试一次临时的 Opera OAuth 失败。 超时或网关错误可能需要一些时间，AVA 会在显示错误前进行重试。 Mews 的重试会在有上限的窗口内停止，不会沿着很长的重试阶梯继续。 在 Opera 上，中断的客房清洁读取或写入可能显示为 502。

处理方法：

  1. 刷新页面一次。

  2. 再次尝试该操作。

  3. 如果持续失败，检查 PMS 连接。

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

    ✓ 一次性故障通常无需更改设置就会消失。

Command Center 无法验证配置​

你会看到： Command Center 显示 Configuration is temporarily unavailable。

原因： AVA 无法获取酒店的完整配置。 原因可能是缺少访问权限，或上游配置服务暂时中断。 AVA 不会将此失败视为 PMS 设置不完整。

处理方法：

  1. 刷新 Command Center 一次。

  2. 如果 AVA 要求，请重新登录。

  3. 请管理员确认你有权访问酒店配置。

  4. 如果服务暂时不可用，请稍后再试。

  5. 如果提示持续出现，请联系支持。

    ✓ 只有在 AVA 获取完整配置后，才会显示 PMS 设置消息。

分配房间期间 PMS 暂时不可用​

你会看到： 分配房间时显示 PMS 暂时不可用的信息。

原因： PMS 未能及时响应房间分配请求。 对于 Cloudbeds，AVA 还会验证每个匹配房间和入住日期区段的实时入住率。 AVA 会将此次尝试记录为可重试，但不会自动重放该变更。

处理方法：

  1. 检查 PMS 状态，并在其中打开预订。

  2. 确认房间分配尚未完成，再进行重试。

  3. 在 AVA 中刷新预订。

  4. 只重试一次房间分配。

    ✓ AVA 应分配房间，或显示具体的房间准备状态原因。

对于 Cloudbeds 多房间预订，临时错误后仅当预订和房间状态看起来正确时才重试。 随后，AVA 会在分配房间前评估受影响的房间和入住日期。

AVA 不会因这次中断发送房间未准备好的电子邮件。 如果之后的检查确认房间未准备好，通知名额仍然可用。

不要重复执行结果不明确的写入

重试结果不明确的操作前，先在 PMS 中检查预订。

PMS 请求耗时过长​

你会看到： PMS 操作等待一段时间后显示超时或连接错误。

原因： 对于没有更短限制的请求，AVA 会在等待 60 秒后停止等待。 某些预订和能力读取使用更短的限制。 Mews 账单读取限制为 40 秒，且每次尝试时间更短。 这样可以防止一个缓慢的 PMS 响应让预订操作无限期保持打开。

处理方法：

  1. 等待超时信息出现。

  2. 再次尝试前刷新预订或页面。

  3. 重复写入操作前，先在 PMS 中检查预订。

  4. 只重试该操作一次。

  5. 如果超时再次出现，请联系支持。

    ✓ PMS 操作应在约一分钟内完成，或返回清晰的错误。

重试前先检查

结果不明确时，不要重复预订更新。 先在 PMS 中确认预订状态，然后只重试一次。

Mews 账单刷新达到限制​

你会看到： 在自助办理入住或刷新账单时，AVA 显示 504 Mews view-billing deadline exceeded。

原因： Mews 未能在账单读取限制前返回最新账单详情。 AVA 可以显示已存储的账单快照，避免入住流程无限期等待。

处理方法：

  1. 将显示的余额与 Mews 中的完整发票进行比较。

  2. 在 AVA 中刷新预订一次。

  3. 不要收取 Mews 未确认的金额。

  4. 如果余额仍不明确，请前台员工完成办理入住。

  5. 如果超时持续出现，请联系支持。

    ✓ 临时的 Mews 账单延迟应返回清晰结果，而不会让入住流程一直等待。

Mews 客房清洁读取超时​

你会看到： Housekeeping 显示 Mews 超时，例如 Transaction has timed out.。

原因： Mews 未能在 AVA 的有上限重试窗口结束前完成库存读取。 AVA 现在会显示 Mews 的原因，而不是返回空的或误导性的房间列表。

处理方法：

  1. 检查 Mews Commander 是否存在正在进行的中断或响应缓慢。

  2. Mews 恢复正常响应后，刷新 Housekeeping。

  3. 不要将空房间列表视为房间不可用的证明。

  4. 如果 Mews 恢复后超时仍持续，请联系支持。

    ✓ Mews 读取成功后，Housekeeping 应加载最新的房间库存。

直接销售付款入账结果不明确​

你会看到： 直接销售付款超时，或 AVA 无法确认 PMS 是否已入账。

原因： 超时出现前，PMS 可能已经收到请求。 AVA 会保护已发送和结果不明确的付款，避免重复入账。

处理方法：

  1. 在 PMS 中打开预订。

  2. 检查付款是否已出现在正确的账单中。

  3. 结果不明确时，不要再次提交付款。

  4. 确认 PMS 结果后刷新 AVA。

  5. 如果付款缺失或结果不明确，请联系支持进行对账。

    ✓ 调度前的已确认准备失败可从之后的已付款通知中恢复。

不要手动入账第二笔付款

PMS 响应不明确并不表示付款失败。 等待对账后再尝试。

PMS 读取使用备用路径​

你会看到： PMS 读取耗时过长后，AVA 以较少的详细信息继续运行。

原因： 某些读取失败时会放行，以便住客或员工流程继续进行。 备用结果可能显示未补充详细信息的预订或更简单的搜索结果。 能力读取可能会暂时报告功能不可用。

你会看到的内容原因处理方式
预订详情不完整房型详情未能及时返回刷新预订后重试
员工搜索显示较少的住客详情个人资料搜索使用了预订姓名备用路径刷新页面后再次搜索
依赖日期的流程显示错误日期PMS 营业日期未能及时返回刷新，然后在 PMS 中确认营业日期
缺少 Group Checkout读取期间能力数据不可用刷新，然后检查 PMS 连接
支持的换房被拒绝AVA 无法确认所需能力刷新，然后只重试一次
重复写入前先检查 PMS

这些备用路径适用于读取。 如果写入超时，请先检查 PMS，再重试。

Opera 错误显示上游原因​

你会看到： Opera 操作显示 "Bad Gateway" 或 "Service Unavailable (503)"。

原因： Opera 或其网关返回了非 JSON 错误响应。 如果有可用的简短响应文本，AVA 会显示该文本；为空时则显示 HTTP 状态。

处理方法：

  1. 阅读完整错误信息并记下状态码。
  2. 如果正在添加共享住客，重试前检查 Opera。
  3. 对于其他操作，先刷新 AVA 一次，然后重试。
  4. 如果同样的错误再次出现，请检查 Opera 和 AVA。
  5. 如果错误持续，请联系支持。
重试前检查共享住客

AVA 会记录 Opera 共享住客创建进度。当所有住客都已办理入住且没有待处理的换房时，AVA 会返回结果，不再进行另一次 Opera 更新。 待处理的换房仍可进行协调。 短暂等待，刷新 AVA，并在重试前检查 Opera。 结果不明确时，不要手动创建另一个共享住客。

Opera 共享住客的付款方式复制结果不明确​

你会看到： 共享住客已存在，但 AVA 无法确认其已复制付款方式。

原因： Opera 的付款方式复制请求会追加到共享住客预订中。 请求可能已在超时或网络错误出现前到达 Opera。 AVA 只会重新打开已确认的调度前失败和 Opera 明确拒绝的请求。 结果不明确的请求会被隔离，以防止重复添加付款方式。

处理方法：

  1. 刷新 AVA 一次。

  2. 在 Opera 中打开共享住客预订。

  3. 确认是否存在已复制的付款方式。

  4. 当 Opera 的结果不明确时，不要重复复制付款方式。

  5. 联系支持，并提供预订详情和完整错误信息。

    ✓ 已确认的失败可在之后的共享住客操作中安全重试。

重试前检查 Opera

超时后不要手动追加付款方式。 Opera 可能已经接受了原始请求。

AVA-PMS 显示 HTML 错误摘要​

你会看到： AVA 显示类似 ava-pms returned 500 with an HTML error page: 502 Bad Gateway 的信息。

原因： 上游网关在 PMS 请求期间返回了 HTML 错误页面。 AVA 会保留页面标题，但会从错误中移除网页标记。

处理方法：

  1. 刷新 AVA 一次。

  2. 重复预订更新前，检查预订和 PMS。

  3. 确认 PMS 状态后，只重试该操作一次。

  4. 如果信息再次出现，请联系支持。

    ✓ 错误应显示简短摘要，而不是网页。

PMS 拒绝显示为冲突​

你会看到： 操作显示 409、"Conflict" 或具体的 PMS 拒绝信息。 它不再显示为通用服务器错误。

原因： 你的 PMS 因预订规则失败而拒绝了操作。 AVA 会保留上游状态和信息，以便你修正原因。 大多数 409 响应对该请求来说是永久性的。 PMS_RESERVATION_MUTATION_IN_PROGRESS 是住客更新、房间分配或最终办理入住期间的临时例外。

处理方法：

  1. 阅读完整的 PMS 信息。

  2. 在 PMS 中打开预订。

  3. 修正信息指出的问题。

  4. 对于取消拒绝，检查住客是否已入住、应退房或已退房。

  5. 在 PMS 中完成必要的退房步骤，然后再重试在住取消。

  6. 刷新 AVA。

  7. 只重试该操作一次。

  8. 如果 PMS 仍然拒绝，请在 PMS 中完成该操作并联系支持。

    ✓ PMS 接受操作后，AVA 应显示更新后的预订状态。

PMS 拒绝提供可用性​

你会看到： 换房或编辑预订时提示房间或房型不可用。 信息可能包含 PMS_ROOM_UNAVAILABLE 或 PMS_RESERVATION_NO_AVAILABILITY。

原因： PMS 发现了实时可用性冲突。 其他预订、停用房间或正在进行的预订可能占用了该房间。 整个入住期间的房型也可能没有剩余库存。

处理方法：

  1. 在 PMS 中打开预订。

  2. 检查入住日期、已分配房间和房型。

  3. 如有需要，选择可用房间或房型。

  4. 刷新 Streamliner。

  5. 只重试一次换房或编辑预订。

    ✓ PMS 拒绝目标房间时，AVA 会保留原来的分配。

AVA 会在换房窗口、预订详情和入住日志中显示本地化说明。 对于交换房间，AVA 会先将目标预订移回，然后恢复源预订。 这样，失败的交换不会让任一预订留在错误的房间中。

不要重复提交不可用的更改

反复发送相同的不可用日期或房间可能会产生相同的拒绝。 先在 PMS 中修正可用性，然后只重试一次。

Cloudbeds 分配结果不明确​

你会看到： Cloudbeds 中的换房或升级显示分配结果不明确。

原因： Cloudbeds 可能接受了换房，但没有返回完整响应。 AVA 会清除未经验证的房间和访问状态，而不是显示旧的分配结果。 在明确刷新验证 PMS 结果之前，AVA 会暂停后台读取。

处理方法：

  1. 不要再次选择同一房间或交换方案。

  2. 在 Cloudbeds 中打开每个受影响的预订。

  3. 核实房间号、房型、日期、每晚费率和入住总额。

  4. 在 AVA 中使用明确的房间刷新。

  5. 在 AVA 显示 PMS 确认的房间前，不要交接钥匙。

  6. 如果任何房间或金额仍不明确，请联系支持。

    ✓ PMS 状态确认后，AVA 可以清除过时的分配。

不要重试结果不明确的操作

重试可能会在第一次换房仍未解决时再次创建换房操作。 先核实 Cloudbeds，然后使用明确的房间刷新。

预订更新仍在进行中​

你会看到： 住客更新、房间分配或最终办理入住显示 PMS_RESERVATION_MUTATION_IN_PROGRESS。

原因： PMS 预订更新暂时占用了该预订。 住客验证、上传护照、上传证件或其他预订更新后可能发生这种情况。 对于 Opera 的最终办理入住，锁定出现前房间分配可能已经成功。 AVA 会以短暂退避最多自动重试这一确切冲突四次。

处理方法：

  1. 短暂等待 PMS 更新完成。

  2. 在 AVA 中刷新预订。

  3. 只重试受影响的步骤一次。

    ✓ 预订更新完成后，受影响的步骤应会继续。

如果四次尝试后代码仍然存在，AVA 会停止写入并返回可重试冲突。 再次尝试前，请在 PMS 中检查预订。 如果冲突持续，请联系支持。 请附上预订编号、PMS 提供商和完整错误信息。

Mews 操作冲突正在重试​

你会看到： Mews 返回 403，并显示 "Conflicting operation is being performed at this time."。

原因： Mews 在执行另一项操作期间会短暂锁定预订。 此响应不表示 Mews 已应用被拒绝的操作。 AVA 会短暂等待，然后自动重试恢复请求。

处理方法：

  1. 等待当前 AVA 操作完成。

  2. 如果操作仍显示错误，请在 Mews 中检查预订。

  3. 刷新 AVA，然后只重试一次受影响的入住步骤。

    ✓ Mews 释放锁定后，住客换房或入住恢复流程应会继续。

如果重试后仍持续显示相同信息，请联系支持。

Mews 入住状态已改变​

你会看到： Mews 因预订不再是 Confirmed 而拒绝办理入住。

原因： AVA 开始办理入住时，另一次 Mews 更新更改了预订。 AVA 会在判断操作失败前准确检查一次预订。

处理方法：

  1. 等待当前 AVA 操作完成。

  2. 如果预订为 Started 且已分配房间，请继续使用显示的房间。

  3. 如果预订不是 Started，请刷新 AVA 并在 Mews 中检查预订。

  4. 仅当 Mews 显示预订已准备好时才重试办理入住。

    ✓ 如果 Mews 已开始该预订，AVA 不会重复办理入住。

如果预订已分配房间但 AVA 仍报告错误，请联系支持。

Mews 拒绝分配的空间​

你会看到： Mews 表示分配的空间已封锁，或无法用于办理入住。

原因： Mews 会在办理入住期间应用房间准备状态规则。 分配的空间可能已被封锁，或尚未完成检查。

处理方法：

  1. 在 Mews 中打开预订。

  2. 分配可用空间。

  3. 在 Mews 要求时，确认该空间已完成检查。

  4. 在 AVA 中刷新预订。

  5. 只重试一次办理入住。

    ✓ Mews 接受分配的空间后，AVA 应完成办理入住。

如果 Mews 显示空间可用且已完成检查，但仍拒绝办理入住，请联系支持。

Opera 拒绝未知的性别值​

你会看到： Opera 之前显示 Value N/A for field Gender exceeds the maximum length allowed.

原因： Opera 的性别代码因酒店而异。 对于某些酒店，N/A 等值不是有效代码。

处理方法：

  1. 在 AVA 中重试住客更新。

  2. AVA 会在发送更新前移除未知的占位值。

  3. 当新值未知或缺失时，AVA 会保留已存储的有效性别。

  4. 如果 Opera 仍拒绝住客更新，请联系支持。

    ✓ 除非你提供真实代码，否则已存储的有效 Opera 性别应保持不变。

刷新期间出现 PMS 校验错误​

你会看到： 住店刷新期间出现 PMS 信息，例如 reservationOverlapTo must be greater than reservationOverlapFrom。

原因： PMS 因某项校验规则失败而拒绝了请求。

处理方法：

  1. 阅读准确的 PMS 信息。

  2. 在 PMS 中检查相关设置。

  3. 修正未通过校验的值。

  4. 刷新 AVA 一次。

    ✓ 只有在 PMS 数据修正前，你才会看到原始 PMS 信息。

连接失败​

你会看到： 点击 Connect 时出现错误信息

先检查这些​

  1. 确认凭据正确

    • 仔细检查 API key 或客户端凭据
    • 确认凭据前后没有多余空格
    • 确认凭据没有过期

  2. 确认 API 权限

    • 登录 PMS 管理门户
    • 确认你的账号已启用 API 访问
    • 检查是否已授予集成权限

  3. 检查网络连接

    • 尝试刷新页面
    • 测试 AVA 的其他部分以确认连接正常

尝试这样操作​

  1. 前往 Settings → Essentials
  2. 如果已连接，点击 Disconnect
  3. 等待 30 秒
  4. 重新输入凭据
  5. 再次点击 Connect

Cloudbeds 在 OAuth 前保存失败​

你会看到： "Failed to save settings before connecting: ..."

原因： AVA 会在开始 Cloudbeds OAuth 前保存其他未保存的 Essentials 更改。 详细信息会指出保存失败的设置。

处理方法：

  1. 阅读完整的错误横幅。

  2. 修正信息中指出的设置。

  3. 如果 AVA 显示保存操作，请保存该设置。

  4. 再次选择 Connect to Cloudbeds。

    ✓ 预连接保存成功后，Cloudbeds 应会打开。

Cloudbeds OAuth 交换失败​

你会看到： 连接显示 Version is required，或拒绝授权码交换。

原因： Cloudbeds 授权码只能使用一次。 失败的回调无法重放。 AVA 现在会将省略的 Cloudbeds OAuth 版本默认为 v3。

处理方法：

  1. 前往 Settings → Essentials。

  2. 选择 Connect to Cloudbeds。

  3. 登录 Cloudbeds，然后选择 Authorize 或 Allow。

  4. 完成连接。Cloudbeds 会生成新的授权码。

  5. 如果新连接再次失败，请联系支持。

    ✓ Cloudbeds 连接应会完成，无需你输入版本。

Cloudbeds v1 或 v2 被拒绝​

你会看到： AVA 显示不支持的 Cloudbeds 版本错误。

原因： Cloudbeds v1 和 v2 适配器已停用。 不指定版本的 Cloudbeds 路由使用 v3。

处理方法：

  1. 清除任何明确的 Cloudbeds 版本设置或固定值。

  2. 请集成管理员移除 v1 或 v2 调用方固定值。

  3. 前往 Settings → Essentials。

  4. 选择 Connect to Cloudbeds，再次完成授权。

    ✓ 新连接使用 Cloudbeds v3。

PMS 设置保存未完成​

你会看到： AVA 接受 PMS 详情后显示缓存或服务错误。

原因： AVA 会分步骤保存相关设置。 某个步骤可能已完成，但另一个步骤或缓存刷新失败。 即使 AVA 报告错误，PMS 也可能已经接受了写入。

处理方法：

  1. 打开 PMS，检查更改后的凭据或提供商设置是否已被接受。

  2. 等待一分钟后再试。

  3. 刷新 Settings → Essentials → PMS Integration。

  4. 除非要替换凭据，否则不要修改已遮罩的凭据。

  5. 仅当 PMS 仍需要该更改时，再次点击 Save。

  6. 确认成功信息后，再使用依赖 PMS 的流程。

    ✓ 保存成功后，新凭据应可在 AVA 的各服务器上正常工作。

重试前先检查

AVA 不会自动回滚或重试每一次设置写入。 未检查 PMS 就重复保存，可能会重复已被上游接受的更改。

如果三次尝试后仍出现相同错误，请联系支持。 请提供完整错误信息、PMS 提供商、保存失败的时间，以及 PMS 中显示的内容。

重试前先检查

AVA 不会自动回滚或重试每一项设置写入。 未检查 PMS 就重复保存，可能会重复已被上游接受的更改。

如果尝试三次后仍显示相同错误，请联系支持。 请附上完整错误信息、PMS 提供商、保存失败的时间，以及 PMS 中显示的内容。

更改凭据后出现 eZee 代码 611​

你会看到： 更新 PMS 凭据后，eZee 返回 611、"Invalid Auth Code or Hotel Code"。

原因： 较早的 PMS 请求可能仍在使用旧凭据快照完成。 保存后，AVA 会将该快照标记为过期。

处理方法：

  1. 确认 Hotel Code 和 Auth Code 属于同一个 eZee 酒店。

  2. 前往 Settings → Essentials → PMS Integration。

  3. 保存更新后的凭据。

  4. 等待成功信息。

  5. 只重试一次 PMS 操作。

    ✓ 下一次 PMS 操作应使用新凭据。

如果保存成功后代码 611 仍存在，请联系支持。

达到速率限制​

你会看到： 429 错误、限流信息，或包含重试时间的请求。

原因： Cloudbeds 或 AVA 自身的请求预算暂时限制了请求。 如果可用，AVA 会保留任一来源的重试时间。 AVA 还会为不同功能区域保留独立的请求预算，因此一个繁忙页面不太可能拖慢另一个页面。 查询预订、分配房间和最终办理入住会自动重试临时的 PMS 429。 这些操作在继续或显示错误前可能需要多等待几秒。 当 AVA 自身请求桶为空时，其他一些面向住客的调用也会短暂等待。 这只适用于本地短促突发，不适用于供应商冷却时间。 如果 Cloudbeds 多次返回相同的访问错误，AVA 会短暂暂停下一次重试。

限流隔离

如果某个页面持续显示 429，问题通常只限于该页面或功能区域。 等待期间，AVA 的其他部分可能仍正常工作。

预订查询重试

在查询预订期间，如果重试时间不超过 5 秒，AVA 会自动重试一次 429。 更长的冷却时间和终止性响应仍需按照下面的常规刷新和重试步骤处理。

处理方法：

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

  2. 刷新页面一次。

  3. 再次尝试该操作。

  4. 如果问题重复出现，等待几分钟后再重试。

  5. 如果没有显示重试时间，将其视为短暂限流，稍后再试。

    ✓ 重试时间过后且请求预算可用时，请求应会成功。

在分配房间或最终办理入住期间

先让当前操作完成，再选择 Retry。 如果 AVA 仍显示友好的房间分配错误，请在 PMS 中检查预订。 然后刷新 AVA，只重试受影响的步骤一次。

Cloudbeds 访问错误​

你会看到： Cloudbeds 访问信息持续返回。 示例包括 You don't have access to property ID 和 Application is not available to be connected。

原因： 缺少酒店访问权限，或该酒店已断开 AVA 应用。 AVA 会暂停重复重试，避免相同失败不断请求 Cloudbeds。

处理方法：

  1. 确认你登录的是正确的 Cloudbeds 酒店。

  2. 请 Cloudbeds 管理员核实酒店访问权限和权限设置。

  3. 如果 Cloudbeds 表示应用已断开，请重新授权 AVA。

  4. 等一分钟后再试。

  5. 修复访问问题后刷新一次。

    ✓ Cloudbeds 接受请求后，下一次连接尝试应会成功。

你会看到 → 处理方式

你看到的内容处理方式
错误出现一次等待重试时间，然后再试
错误持续出现暂停几分钟，然后重试
预订仍未加载查看 同步问题

Cloudbeds Webhook 凭据被拒绝​

你会看到： Cloudbeds 持续接受连接，但保存设置后 webhook 修复失败。

原因： Cloudbeds 接受了登录，但没有接受 AVA 所需的 webhook 权限。

处理方法：

  1. 从 Settings → Essentials 重新连接 Cloudbeds。

  2. 再次完成 Cloudbeds 授权提示。

  3. 再次保存已启用的到店前设置。

  4. 如果仍失败，请 Cloudbeds 管理员检查应用权限。

    ✓ 权限刷新后，webhook 修复应会正常完成。

预订未同步​

你会看到： 连接后没有预订出现，或预订缺失

快速修复​

  1. 在 Operations View 中点击 Refresh
  2. 等待 5-10 分钟完成初次同步
  3. 确认 PMS 中今天有预订

检查 PMS 设置​

  1. 前往 Settings → Essentials
  2. 滚动到 PMS Integration 区域
  3. 确认连接状态显示 "Connected"
  4. 检查同步设置配置正确

仍未解决？​

  • 确认 AVA 中查看的预订日期与 PMS 中的日期一致
  • 检查 PMS 中的预订状态是否允许同步（confirmed，而不是 cancelled）
  • 确认住客人数大于 0

同步延迟​

你会看到： 预订延迟出现

正常情况​

大多数 PMS 系统每 5-15 分钟同步一次。是否支持实时同步取决于：

  • 你的 PMS 套餐等级
  • 具体 PMS 提供商

减少延迟​

  1. 需要时使用手动刷新
  2. 联系 PMS 提供商确认是否支持实时 API
  3. 在低活跃时段安排同步

身份验证错误​

你会看到： "Invalid credentials" 或 "Authentication failed"

Cloudbeds​

  1. 登录 Cloudbeds
  2. 前往 Settings → Integrations → API
  3. 生成新的 API 凭据
  4. 准确复制凭据（如有复制按钮，请使用该按钮）
  5. 不做修改，直接粘贴到 AVA

Opera Cloud​

  1. 等待最多 30 秒，让 AVA 完成自动重试。 这包括一次临时 OAuth 超时或网关错误。

  2. 只有错误仍存在时才重试操作。

  3. 确认环境 URL 正确（test 或 production）。

  4. 确认 client ID、client secret、hotel ID 和 enterpriseId。

  5. 在 Settings → Essentials → PMS Integration 中重新输入凭据，然后点击 Save。

  6. 如果错误仍显示，请联系 Oracle 代表。

    ✓ 一次性临时错误或缓存凭据失败可能无需断开 Opera 就能恢复。

Mews​

  1. 登录 Mews Commander
  2. 前往 Settings → Integrations
  3. 找到 Vouch AVA 并重新生成 access token
  4. 在 AVA 设置中更新 token

何时联系支持​

Cloudbeds 费率或费率计划不可用​

你会看到： Cloudbeds 已连接，但日历或费率计划操作缺失。

原因： 日历读取和费率计划变更使用不同的功能权限。

处理方法：

  1. 刷新 Operations → Rates & Availability。

  2. 确认 Cloudbeds 酒店仍是当前使用的 PMS。

  3. 询问 AVA 管理员是否已启用所需的 Cloudbeds 功能权限。

  4. 在 Cloudbeds 中创建新的可售费率计划，不要在 AVA 中创建。

    ✓ Cloudbeds 目录可见并不保证每项操作都可用。

Cloudbeds ARI 保存仍在等待中​

你会看到： AVA 接受了费率或限制更改，但日历仍显示旧值。

处理方法：

  1. 等待 Cloudbeds 作业状态完成。

  2. 刷新日历一次。

  3. 检查相同日期和费率行。

  4. 等待期间不要反复提交相同更改。

  5. 如果已发布的值仍未改变，请联系支持。

    ✓ AVA 只有在 Cloudbeds 日历中验证该值后才会显示成功。

如果满足以下情况，请联系支持：

  • 你已经尝试了所有排错步骤
  • 错误信息提到系统错误或技术问题
  • PMS 更改超过 30 分钟仍未反映

邮箱： success@vouch-technologies.com

请附上：

  • 错误信息截图
  • PMS 类型（Cloudbeds/Opera/Mews）
  • 问题开始时间
  • 你已经尝试过的步骤