PMS 连接错误
物业管理系统 (PMS) 连接问题的故障排除指南。
常见错误消息
| 错误 | 含义 |
|---|---|
| "Please fill all required PMS fields" | 缺少所需的凭据 |
| "Failed to save PMS Integration" | 连接或身份验证错误 |
| "Unable to communicate with the property management system" | 网络或 API 问题 |
连接失败
您看到的： 点击连接时出现错误消息
首先检查这些
-
验证凭据是否正确
- 仔细检查您的 API 密钥或客户端凭据
- 确保凭据前后没有多余的空格
- 确认凭据未过期
-
确认 API 权限
- 登录到您的 PMS 管理门户
- 验证您的帐户已启用 API 访问
- 检查是否已授予集成权限
-
检查互联网连接
- 尝试刷新页面
- 测试 AVA 的其他部分以确认连接
尝试这个
- 转到 设置 → 基本信息
- 点击 断开连接（如果已连接）
- 等待 30 秒
- 重新输入您的凭据
- 再次点击 连接
预订未同步
您看到的： 连接后未显示预订，或预订丢失
快速修复
- 在 运营视图 中点击 刷新
- 等待 5-10 分钟以完成初始同步
- 验证 PMS 中是否存在今天的预订
检查 PMS 设置
- 转到 设置 → 基本信息
- 滚动到 PMS 集成 部分
- 验证连接状态显示为“已连接”
- 检查同步设置是否配置正确
仍然无法工作？
- 确认预订日期与您在 AVA 中查看的日期匹配
- 检查 PMS 中的预订状态是否允许同步（已确认，未取消）
- 验证客人数量大于 0
同步延迟
您看到的： 预订显示有延迟
正常行为
大多数 PMS 系统每 5-15 分钟同步一次。实时同步可用性取决于：
- 您的 PMS 计划级别
- 特定的 PMS 提供商
减少延迟
- 需要时使用手动刷新
- 联系您的 PMS 提供商了解实时 API 访问
- 在活动较少的时段安排同步
身份验证错误
您看到的： “无效凭据”或“身份验证失败”
对于 Cloudbeds
- 登录 Cloudbeds
- 转到 设置 → 集成 → API
- 生成新的 API 凭据
- 准确复制凭据（如果有复制按钮，请使用它）
- 粘贴到 AVA 中，不要修改
对于 Opera Cloud
- 联系您的 Oracle 代表
- 请求刷新 API 凭据
- 验证环境 URL 是否正确（测试 vs 生产）
对于 Mews
- 登录 Mews Commander
- 转到 Settings → Integrations
- 找到 Vouch AVA 并重新生成访问令牌
- 在 AVA 设置中更新令牌
何时联系支持
如果出现以下情况，请联系支持：
- 您已尝试所有故障排除步骤
- 错误消息引用系统错误或技术问题
- 30 分钟后未反映 PMS 更改
电子邮件： success@vouch-technologies.com
包括：
- 错误消息的屏幕截图
- PMS 类型 (Cloudbeds/Opera/Mews)
- 问题开始时间
- 您已尝试的步骤