跳到主要内容

PMS 连接错误

当 AVA 无法连接到你的 PMS，或者显示临时限流错误时，请使用本指南。它会先帮你判断是凭据、权限还是限流问题。

快速检查

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

自动重试

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

保留 PMS 消息

如果 AVA 在刷新时显示了特定的 PMS 错误，请直接使用该消息。 Streamliner 会保留原始 PMS 响应，而不是替换成通用技术错误。

常见错误消息​

错误含义处理方式
"Please fill all required PMS fields"缺少必填凭据补上缺失的 PMS 凭据
"Failed to save PMS Integration"连接或身份验证错误重新检查 PMS 账号和权限
"Unable to communicate with the property management system"网络或 API 问题刷新一次，然后再次测试连接
"429" 或 "rate limited"PMS 要求 AVA 降速并稍后重试，若可用则会显示重试时间等到重试时间后再试
"reservationOverlapTo must be greater than reservationOverlapFrom"PMS 拒绝了 stayover 重叠窗口在 PMS 中更新重叠值，然后刷新

临时连接异常​

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

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

解决方法：

  1. 刷新页面一次。

  2. 再试一次操作。

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

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

    ✓ 这类偶发问题通常不需要改设置就能自行恢复。

刷新时出现 PMS 校验错误​

你会看到： 在 stayover 刷新过程中出现 PMS 消息，例如 reservationOverlapTo must be greater than reservationOverlapFrom。

原因： PMS 因为某项校验规则未通过而拒绝了请求。

解决方法：

  1. 读取准确的 PMS 消息。

  2. 检查 PMS 中对应的设置。

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

  4. 刷新 AVA 一次。

    ✓ 在 PMS 数据修正前，你应该只会看到原始 PMS 消息。

连接失败​

你会看到： 点击连接时出现错误消息。

先检查这些​

  1. 确认凭据正确

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

  2. 确认 API 权限

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

  3. 检查网络连接

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

试试这个​

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

达到限流​

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

原因： 你的 PMS 暂时限制了请求。 当 PMS 提供重试时间时，AVA 会保留该时间。

解决方法：

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

  2. 刷新页面一次。

  3. 再试一次操作。

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

  5. 如果没有显示重试时间，可以把它视为短暂的临时限制，稍后再试。

    ✓ 一旦 PMS 允许新请求，你应该会看到请求成功。

你会看到 → 处理方式

你会看到处理方式
错误只出现一次等到重试时间后再试
错误不断回来先暂停几分钟，再重试
预订仍然没有加载检查 同步问题

预订未同步​

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

快速修复​

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

检查 PMS 设置​

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

还是不行？​

  • 确认预订日期与你在 AVA 中查看的日期一致
  • 检查 PMS 中的预订状态是否允许同步（已确认，未取消）
  • 确认客人数大于 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. 联系你的 Oracle 代表
  2. 请求刷新 API 凭据
  3. 确认环境 URL 正确（测试环境与生产环境）

Mews​

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

何时联系支持​

如果出现以下情况，请联系支持：

  • 你已经尝试了所有故障排查步骤
  • 错误消息指向系统错误或技术问题
  • 30 分钟后 PMS 变更仍未反映

电子邮件： success@vouch-technologies.com

请附上：

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

相关指南​