跳到主要内容

PMS 连接

将你的物业管理系统（PMS）连接到 AVA Streamliner，以自动同步预订。

快速设置

Opera Cloud 连接在 OCIM 和 SSD 模式下都需要 enterpriseId。请先向 Oracle 索取该值。

正在使用 AVA PMS？

如果你使用的是 AVA PMS，可以跳过本页，继续查看设置清单。

首先看到“AVA”？

在 Settings → Essentials → PMS Integration 中，Select PMS Provider 下方会首先显示 AVA 卡片。这是正常现象。请选择你的 PMS 进行连接。

提供商专属字段

每个 PMS 卡片都会显示适用于该提供商的字段。 某些值会通过 OAuth 或部署配置传入，而不是手动填写。

提供商专属字段​

设置页面和 Assisted Check-In Setup 使用相同的提供商字段规则。 选择卡片后，AVA 只会显示该 PMS 的字段。

提供商输入或确认重要行为
Cloudbeds连接你的 Cloudbeds 账户OAuth 会提供 Property ID 和 API key。
OperaOHIP 连接字段OHIP Enterprise ID 在 OCIM 和 SSD 下都是必填项。SSD 还需要用户名和密码。
MewsAccess TokenClient Token 和 Client ID 通常来自 AVA 部署设置。
Furama iPMSBase URL、Organisation Unit、User Code 和 API KeyControl Unit 和 Business User Code 为可选项。
eZeeHotel Code 和 Auth CodeBase URL 和 Use Demo Environment 为可选项。
AVA无AVA 使用你的物业设置。

安全保存凭据​

AVA 会遮罩已保存的机密值，而不会再次显示这些值。

  1. 保存其他设置时，保持遮罩值不变。

  2. 选择 Edit Secret 或 Edit Token 来替换已保存的凭据。

  3. 对于 Opera 的 OHIP Password，将字段留空即可保留现有密码。

    ✓ 除非你输入替换值，否则 AVA 会保留已存储的凭据。

自动修复 webhook

保存已启用的到店前设置时，AVA 会在后台检查 PMS webhook 订阅。 如果 Cloudbeds webhook 缺失或损坏，再次保存即可修复。 Mews webhook 订阅仍由集成层管理。

Cloudbeds webhook 凭据

如果 Cloudbeds 拒绝 webhook 凭据，AVA 会停止重试该修复。 请重新连接 Cloudbeds，然后再次保存已启用的到店前设置。

保存后的设置刷新

PMS 凭据或提供商更改成功后，AVA 会刷新所有活动服务器上的连接。 你无需等待自动缓存超时，也无需重启浏览器。 即使较早的刷新仍在运行，下一次 PMS 操作也会使用新设置。

支持的系统​

PMS同步类型设置时间
Cloudbeds实时10 分钟
Opera Cloud实时15 分钟
Mews实时10 分钟
eZee实时2 分钟
Furama iPMS实时10 分钟

开始前​

你需要：

  • PMS 的管理员权限
  • PMS 提供商已批准的集成权限
  • AVA Streamliner 的管理员权限
  • Oracle 为你的 Opera 物业提供的 enterpriseId

预计耗时： 10-15 分钟

Cloudbeds 连接​

第 1 步：在 AVA 中连接​

  1. 前往 Settings → Essentials
  2. 找到 PMS Integration 区域
  3. 在 Select PMS Provider 下点击 Cloudbeds
  4. 点击 Connect Cloudbeds Account
  5. 完成 Cloudbeds 授权流程
  6. 返回 AVA，确认状态显示 Cloudbeds Account Linked

第 2 步：验证连接​

  1. 等待 2-3 分钟以完成同步
  2. 前往 Operations View
  3. 检查是否显示预订

✅ 成功：你会看到 Cloudbeds 中当天的预订。

Opera Cloud 连接​

第 1 步：申请 OHIP 访问权限​

  1. 联系 Oracle OPERA 客户代表
  2. 申请用于 AVA 集成的 OHIP 凭据
  3. 你会收到：
    • OHIP Host Name
    • Application Key
    • Hotel ID
    • Identity Management 模式（OCIM 或 SSD）
    • Client ID
    • Client Secret
    • 适用于 OCIM 或 SSD 的 enterpriseId
    • 如果使用 SSD，还会收到 Username 和 Password

第 2 步：在 AVA 中连接​

  1. 前往 Settings → Essentials
  2. 找到 PMS Integration 区域
  3. 在 Select PMS Provider 下点击 Opera
  4. 输入你的 OHIP 凭据
    • 为任一身份模式填写 enterpriseId
  5. 点击 Save
  6. 确认状态显示 Opera Integration Configured

Mews 连接​

第 1 步：获取 Mews 凭据​

  1. 登录 Mews Commander
  2. 前往 Settings → Integrations
  3. 在市场中找到 Vouch AVA
  4. 复制 Access Token
遮罩值可以安全保留

如果你稍后返回时字段显示为遮罩状态，保留该值并再次保存即可。

第 2 步：在 AVA 中连接​

  1. 前往 Settings → Essentials
  2. 找到 PMS Integration 区域
  3. 在 Select PMS Provider 下点击 Mews
  4. 输入 Access Token
  5. 点击 Connect

eZee 连接​

第 1 步：获取你的 eZee 凭据​

  1. 向 eZee 支持团队申请 Hotel Code 和 Auth Code
  2. 如果你的物业使用自定义端点，请记下相应的 Base URL

第 2 步：在 AVA 中连接​

  1. 前往 Settings → Essentials
  2. 找到 PMS Integration 区域
  3. 在 Select PMS Provider 下点击 eZee
  4. 输入：
    • Hotel Code
    • Auth Code
    • Base URL（可选）
  5. 确认 Use Demo Environment 处于 OFF，以便进行正式操作
  6. 点击 Save

✅ 成功：状态会更新为“Connected”。

需要更多详细信息？请参阅 Connect eZee PMS。

Furama iPMS 连接​

Furama iPMS 使用 Furama 联系人提供的物业凭据。

  1. 前往 Settings → Essentials。

  2. 找到 PMS Integration。

  3. 在 Select PMS Provider 下点击 Furama iPMS。

  4. 输入必需的连接详细信息。

  5. 点击 Save PMS Settings。

    ✓ 状态会变为 Furama Integration Configured。

需要了解字段详细信息？请参阅 Connect Furama iPMS。

故障排查​

连接失败​

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

请尝试：

  1. 仔细核对凭据
  2. 确认 Oracle 已为你的身份模式提供 enterpriseId
  3. 确认你在 PMS 中拥有 API 权限
  4. 检查网络连接
  5. 几分钟后重试

预订未同步​

你会看到： 连接后没有显示预订

请尝试：

  1. 在 Operations View 中点击 Refresh
  2. 等待 5 分钟完成初始同步
  3. 检查 PMS 中是否存在预订
  4. 在 Settings 中确认连接状态

同步延迟​

你会看到： 预订出现延迟

说明： 初始同步可能会因 PMS 和 API 负载而需要几分钟。

仍然无法解决？​

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

  • ❌ 填写完成后，必填字段仍然反复出现
  • ❌ 保存后 PMS 仍处于断开状态
  • ❌ 首个同步窗口过后仍未显示预订