跳到主要内容

Opera PMS 集成 (OHIP)

通过 OHIP（Oracle Hospitality Integration Platform）将 AVA 连接到 Oracle 的 Opera Cloud 物业管理系统。配置完成后，AVA 会直接从 Opera 同步预订、房态和住客信息。 住客档案现在会在 AVA 的共享档案布局中打开。

快速设置

大多数酒店可在 10 到 15 分钟内完成。如果你使用 OCIM，请先向 Oracle 申请 enterpriseId。

在哪里找到它​

Settings → Essentials → Property Management System (PMS) Integration

开始之前​

请从你的 IT 团队或 Oracle/Opera 管理员处获取这些凭据：

凭据说明
OHIP Host NameAPI 基础 URL（例如 ohip.oraclecloud.com）
OHIP Application Key用于 API 访问的应用密钥
OHIP Hotel ID你在 Opera 中的物业标识
OHIP Client IDOAuth 客户端标识
OHIP Client SecretOAuth 客户端密钥
enterpriseIdOracle 的 OCIM enterprise 标识。当 OHIP Identity Management 为 OCIM 时必需。
注意

Opera OHIP 集成需要由 Oracle 或你的 IT 团队进行技术配置。启用你物业的 OHIP 访问后，他们会提供 API 凭据。

OCIM 需要额外一个值

如果你选择 OCIM，AVA 现在需要 enterpriseId 才能请求 token。 请将这个值与其他 OHIP 凭据一并保存。

配置步骤​

第 1 步：将 Opera 选为你的 PMS​

  1. 前往 Settings → Essentials。
  2. 滚动到 PMS Integration。
  3. 点击 Opera 卡片。
  4. 会出现一个对勾 (✓) 以确认已选中。

第 2 步：输入 OHIP 配置​

填写每个字段：

  • OHIP Host Name：你的 OHIP API 实例基础 URL，例如 ohip.oraclecloud.com
  • OHIP Application Key：用于 API 访问的应用密钥（点击 Edit Secret 可更新）
  • OHIP Hotel ID：你物业在 Opera 中的酒店代码
  • OHIP Identity Management：选择 OCIM（Oracle Cloud Identity）或 SSD（Direct Credentials）
  • OHIP Client ID：OAuth 客户端标识
  • OHIP Client Secret：OAuth 密钥（点击 Edit Secret 可更新）
  • enterpriseId：Oracle 的 OCIM enterprise 标识。仅当 OHIP Identity Management 为 OCIM 时使用。

如果你为身份管理选择了 SSD，还需要输入：

  • OHIP Username：直接登录用户名
  • OHIP Password：直接登录密码

第 3 步：保存并验证​

  1. 点击 Save。
  2. 检查状态指示器：
    • 🟢 "Opera Integration Configured" = 已输入所有必填字段
    • 🟡 "Opera Integration Not Configured" = 缺少必填字段

从 Opera 会同步什么内容​

连接后，AVA 会接收：

  • ✅ 住客预订和 folio
  • ✅ 房态和可用性
  • ✅ 住客档案信息
  • ✅ 入住/退房交易
  • ✅ 房间阻挡信息
  • ✅ Do Not Move 房锁状态
  • ✅ 预订 ETA 更新

对客人与员工的影响​

  • 客人表单会根据 Opera 规则调整。 必填字段和隐藏字段会根据 Opera 配置变化，因此客人只会看到需要填写的内容。
  • 住客档案使用共享 AVA 布局。 Opera 的住客详情现在会以与 AVA v2 相同的字段结构打开。
  • 预订查找使用 Opera。 如果未配置 Opera，客人查找步骤会失败。
  • 活动预订默认会显示。 取消的预订不会出现在常规查找结果中，除非工作流明确请求它们。
  • 多房间预订会把搜索到的房间保留在正确的卡片上。 即使 Opera 将家庭预订标准化为主确认号，或使用不同的内部 ID，AVA 仍会保留你查找的确认号。
  • 收费房型会保持稳定。 当 AVA 在 Opera 中分配房间时，即使物理房间属于不同房型，收费房型也不会改变。
  • 向房间新增住客仍会同步。 如果员工在入住期间添加另一位住客，AVA 会更新 Opera，使额外住客继续附着在该房间上。
  • 人工协助入住可以显示 rate code。 当 Opera 返回 rate code 时，AVA 会在员工协助入住的所选预订卡上显示它。
  • 旅行社标签会保持可见。 Opera 可以把代理名称传入 sourceName。这样 waiver 匹配就能看到类似 Booking.com (VCC) 的标签。
  • 支付入账可以添加备注。 Opera 支付或押金成功后，AVA 会在 Opera 中添加一条预订备注。它使用你在 Settings → Payment 中配置的 Default Comment Type / Location。
  • 预订 ETA 会保持同步。 AVA 会把预计到达时间写回 Opera，并同步到 Streamliner。你可以在预订卡和列表中看到由 PMS 支持的 ETA。
  • 被锁定的房间在 AVA 中保持锁定。 如果 Opera 将预订标记为 Do Not Move，Streamliner 会在换房视图中显示锁定图标。

故障排查​

“Integration Not Configured” 状态​

缺少必填字段。请确认你已输入：

  1. OHIP Host Name
  2. OHIP Application Key
  3. OHIP Hotel ID
  4. OHIP Client ID
  5. 如果你选择了 OCIM，则还要输入 enterpriseId

API 连接错误​

  1. 确认 OHIP Host Name 正确。
  2. 检查你的 OHIP 订阅是否处于活动状态。
  3. 使用 OCIM 时确认 enterpriseId 已保存。
  4. 联系 IT 确认防火墙/网络访问。
  5. 向 Oracle 支持确认凭据。

一保存 OCIM 就失败​

你会看到： 当你选择 OCIM 时，AVA 会立刻拒绝连接。

解决方法：

  1. 向 Oracle 索取正确的 enterpriseId。
  2. 在 AVA 中重新输入 OCIM 凭据。
  3. 再次保存。
  4. 如果仍然失败，请与 Oracle 确认 client ID 和 client secret。

没有出现预订​

  1. 等待 15-30 分钟完成初始同步。
  2. 在 Opera 中确认 OHIP 用户权限。
  3. 检查预订是否确实存在于 Opera 中。
  4. 向支持提供错误日志。

多房间房卡看起来为空​

你会看到： 房间卡打开了，但主住客缺失。

解决方法：

  1. 确认你是按确认号加载的预订。
  2. 刷新入住页面并重新打开该房间。
  3. 如果主住客仍然缺失，请把确认号和到店日期发给支持。

某个房间没有出现在换房中​

你会看到： Allow move room 中缺少该房间。

解决方法：

  1. 在 Opera 中检查该预订。
  2. 如果该房间应该可移动，请移除 Do Not Move 锁定。
  3. 在 AVA 中刷新该预订。
  4. 再次尝试换房。

安全最佳实践​

  • 🔒 安全存储凭据（它们在 AVA 中会加密）
  • 🔒 如可能，优先使用 OCIM 以获得更好的安全性
  • 🔒 将 enterpriseId 与其他 OCIM 凭据一起保存
  • 🔒 定期轮换 client secret
  • 🔒 仅授予 OHIP 用户最小必需权限

获取 OHIP 凭据​

如果你还没有凭据：

  1. 联系 Oracle Hospitality Support 或你的 Opera 系统管理员。
  2. 请求为 AVA 集成开放 OHIP API 访问。
  3. 他们会提供：
    • OHIP Host Name
    • Application Key
    • Client ID 和 Secret
    • Hotel ID
    • 用于 OCIM 的 enterpriseId
  4. 安全记录收到的凭据。

仍然卡住？​

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

  • ❌ 添加 enterpriseId 后 OCIM 连接仍然失败
  • ❌ 首次同步窗口结束后仍没有预订出现
  • ❌ Oracle 说凭据有效，但 AVA 仍然拒绝

请附上：

  • 错误截图
  • 你的 Opera 身份管理模式
  • 问题开始的时间
  • 你已经尝试过的步骤