PMS 连接
将你的物业管理系统（PMS）连接到 AVA Streamliner，以自动同步预订。
Opera Cloud 连接在 OCIM 和 SSD 模式下都需要 enterpriseId。请先向 Oracle 索取该值。
如果你使用的是 AVA PMS，可以跳过本页，继续查看设置清单。
在 Settings → Essentials → PMS Integration 中，Select PMS Provider 下方会首先显示 AVA 卡片。这是正常现象。请选择你的 PMS 进行连接。
每个 PMS 卡片都会显示适用于该提供商的字段。 某些值会通过 OAuth 或部署配置传入，而不是手动填写。
提供商专属字段
设置页面和 Assisted Check-In Setup 使用相同的提供商字段规则。 选择卡片后，AVA 只会显示该 PMS 的字段。
| 提供商 | 输入或确认 | 重要行为 |
|---|---|---|
| Cloudbeds | 连接你的 Cloudbeds 账户 | OAuth 会提供 Property ID 和 API key。 |
| Opera | OHIP 连接字段 | OHIP Enterprise ID 在 OCIM 和 SSD 下都是必填项。SSD 还需要用户名和密码。 |
| Mews | Access Token | Client Token 和 Client ID 通常来自 AVA 部署设置。 |
| Furama iPMS | Base URL、Organisation Unit、User Code 和 API Key | Control Unit 和 Business User Code 为可选项。 |
| eZee | Hotel Code 和 Auth Code | Base URL 和 Use Demo Environment 为可选项。 |
| AVA | 无 | AVA 使用你的物业设置。 |
安全保存凭据
AVA 会遮罩已保存的机密值，而不会再次显示这些值。
-
保存其他设置时，保持遮罩值不变。
-
选择 Edit Secret 或 Edit Token 来替换已保存的凭据。
-
对于 Opera 的 OHIP Password，将字段留空即可保留现有密码。
✓ 除非你输入替换值，否则 AVA 会保留已存储的凭据。
保存已启用的到店前设置时，AVA 会在后台检查 PMS webhook 订阅。 如果 Cloudbeds webhook 缺失或损坏，再次保存即可修复。 Mews webhook 订阅仍由集成层管理。
如果 Cloudbeds 拒绝 webhook 凭据，AVA 会停止重试该修复。 请重新连接 Cloudbeds，然后再次保存已启用的到店前设置。
PMS 凭据或提供商更改成功后，AVA 会刷新所有活动服务器上的连接。 你无需等待自动缓存超时，也无需重启浏览器。 即使较早的刷新仍在运行，下一次 PMS 操作也会使用新设置。
支持的系统
| PMS | 同步类型 | 设置时间 |
|---|---|---|
| Cloudbeds | 实时 | 10 分钟 |
| Opera Cloud | 实时 | 15 分钟 |
| Mews | 实时 | 10 分钟 |
| eZee | 实时 | 2 分钟 |
| Furama iPMS | 实时 | 10 分钟 |
添加宾客前检查客房容量
AVA 会在添加额外宾客前，检查 PMS 报告的客房容量。 某些 PMS 提供商也允许添加超过该报告容量的宾客。
| PMS | 添加超过报告容量的宾客 | 哪个系统中的入住人数保持最新 |
|---|---|---|
| AVA v2 | 支持 | AVA 和 PMS |
| Mews v2 | 支持 | 仅 AVA；Mews 不会修改宾客人数 |
| Opera v1 | 支持 | 仅 AVA；Opera 会添加同行人档案 |
| Cloudbeds v3 | 不支持 | 两个系统都不会更改入住人数 |
| eZee v1 | 不支持 | 两个系统都不会更改入住人数 |
| Furama v2 | 支持 | AVA 和 Furama iPMS |
如果你的 PMS 不支持此操作，请让工作人员在 PMS 中修正宾客人数或客房分配。 对于 Furama v2，AVA 会将已接受的宾客和更新后的入住人数发送到 Furama iPMS。
当 AVA 阻止添加额外宾客时，请在 PMS 中检查该房型的容量。 然后刷新预订，再重试。
开始前
你需要：
- PMS 的管理员权限
- PMS 提供商已批准的集成权限
- AVA Streamliner 的管理员权限
- Oracle 为你的 Opera 物业提供的
enterpriseId
预计耗时： 10-15 分钟
Cloudbeds 连接
第 1 步：在 AVA 中连接
- 前往 Settings → Essentials
- 找到 PMS Integration 区域
- 在 Select PMS Provider 下点击 Cloudbeds
- 点击 Connect Cloudbeds Account
- 完成 Cloudbeds 授权流程
- 返回 AVA，确认状态显示 Cloudbeds Account Linked
第 2 步：验证连接
- 等待 2-3 分钟以完成同步
- 前往 Operations View
- 检查是否显示预订
✅ 成功：你会看到 Cloudbeds 中当天的预订。
Opera Cloud 连接
第 1 步：申请 OHIP 访问权限
- 联系 Oracle OPERA 客户代表
- 申请用于 AVA 集成的 OHIP 凭据
- 你会收到：
- OHIP Host Name
- Application Key
- Hotel ID
- Identity Management 模式（OCIM 或 SSD）
- Client ID
- Client Secret
- 适用于 OCIM 或 SSD 的
enterpriseId - 如果使用 SSD，还会收到 Username 和 Password
第 2 步：在 AVA 中连接
- 前往 Settings → Essentials
- 找到 PMS Integration 区域
- 在 Select PMS Provider 下点击 Opera
- 输入你的 OHIP 凭据
- 为任一身份模式填写
enterpriseId
- 为任一身份模式填写
- 点击 Save
- 确认状态显示 Opera Integration Configured
Mews 连接
第 1 步：获取 Mews 凭据
- 登录 Mews Commander
- 前往 Settings → Integrations
- 在市场中找到 Vouch AVA
- 复制 Access Token
如果你稍后返回时字段显示为遮罩状态，保留该值并再次保存即可。
第 2 步：在 AVA 中连接
- 前往 Settings → Essentials
- 找到 PMS Integration 区域
- 在 Select PMS Provider 下点击 Mews
- 输入 Access Token
- 点击 Connect
eZee 连接
第 1 步：获取你的 eZee 凭据
- 向 eZee 支持团队申请 Hotel Code 和 Auth Code
- 如果你的物业使用自定义端点，请记下相应的 Base URL
第 2 步：在 AVA 中连接
- 前往 Settings → Essentials
- 找到 PMS Integration 区域
- 在 Select PMS Provider 下点击 eZee
- 输入：
- Hotel Code
- Auth Code
- Base URL（可选）
- 确认 Use Demo Environment 处于 OFF，以便进行正式操作
- 点击 Save
✅ 成功：状态会更新为“Connected”。
需要更多详细信息？请参阅连接 eZee PMS。
Furama iPMS 连接
Furama iPMS 使用 Furama 联系人提供的物业凭据。
-
找到 PMS Integration。
-
在 Select PMS Provider 下点击 Furama iPMS。
-
输入必需的连接详细信息。
-
点击 Save PMS Settings。
✓ 状态会变为 Furama Integration Configured。
需要了解字段详细信息？请参阅连接 Furama iPMS。
故障排查
连接失败
你会看到： 点击 Connect 时出现错误消息
请尝试：
- 仔细核对凭据
- 确认 Oracle 已为你的身份模式提供
enterpriseId - 确认你在 PMS 中拥有 API 权限
- 检查网络连接
- 几分钟后重试
预订未同步
你会看到： 连接后没有显示预订
请尝试：
- 在 Operations View 中点击 Refresh
- 等待 5 分钟完成初始同步
- 检查 PMS 中是否存在预订
- 在 Settings 中确认连接状态
同步延迟
你会看到： 预订出现延迟
说明： 初始同步可能会因 PMS 和 API 负载而需要几分钟。
仍然无法解决？
如果出现以下情况，请联系 success@vouch-technologies.com：
- ❌ 填写完成后，必填字段仍然反复出现
- ❌ 保存后 PMS 仍处于断开状态
- ❌ 首个同步窗口过后仍未显示预订