跳到主要内容

Opera PMS 集成 ( OHIP)

通过 OHIP (Oracle Hospitality Integration Platform) 将 AVA 连接到 Oracle 的 Opera Cloud 物业管理系统。配置完成后,AVA 直接从 Opera 同步预订、房间库存和客人信息。

它的位置

设置 → 基本 → 物业管理系统 (PMS) 集成

开始之前

从您的 IT 团队或 Oracle/Opera 管理员处获取这些凭据:

凭据描述
OHIP Host NameAPI 基础 URL (例如 ohip.oraclecloud.com)
OHIP Application KeyAPI 访问的应用程序密钥
OHIP Hotel ID您在 Opera 中的店铺标识符
OHIP Client IDOAuth 客户端标识符
OHIP Client SecretOAuth 客户端密钥
注意

Opera OHIP 集成需要 Oracle 或您的 IT 团队进行技术设置。在为您的店铺启用 OHIP 访问后,他们将提供 API 凭据。

配置步骤

第 1 步:选择 Opera 作为您的 PMS

  1. 前往 设置 → 基本
  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 (直接凭据)
  • OHIP Client ID: OAuth 客户端标识符
  • OHIP Client Secret: OAuth 密钥(点击 Edit Secret 进行更新)

如果您选择 SSD 进行身份管理,还需要输入:

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

第 3 步:保存并验证

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

从 Opera 同步的内容

连接后,AVA 接收:

  • ✅ 客人预订和账单
  • ✅ 房间可用性和状态
  • ✅ 客人资料信息
  • ✅ 入住/退房交易
  • ✅ 房间封锁信息

对客人和员工的影响

  • 客人表单适应 Opera 规则。 必填字段和隐藏字段根据 Opera 配置而变化,因此客人只看到需要的内容。
  • 预订查找使用 Opera。 如果未配置 Opera,客人查找步骤将失败。

故障排除

"Integration Not Configured" 状态

缺少必填字段。确保您已输入:

  1. OHIP Host Name
  2. OHIP Application Key
  3. OHIP Hotel ID
  4. OHIP Client ID

API 连接错误

  1. 验证 OHIP Host Name 是否正确
  2. 检查您的 OHIP 订阅是否处于活动状态
  3. 联系 IT 确认防火墙/网络访问
  4. 与 Oracle 支持验证凭据

预订显示不出来

  1. 等待 15-30 分钟进行初始同步
  2. 验证 Opera 中的 OHIP 用户权限
  3. 检查预订在 Opera 中是否存在
  4. 联系支持并提供错误日志

安全最佳实践

  • 🔒 安全地存储凭据(它们在 AVA 中已加密)
  • 🔒 尽可能使用 OCIM 以获得更好的安全性
  • 🔒 定期轮换客户端密钥
  • 🔒 将 OHIP 用户权限限制为所需的最低限度

获取 OHIP 凭据

如果您没有凭据:

  1. 联系 Oracle Hospitality 支持或您的 Opera 系统管理员
  2. 请求 AVA 集成的 OHIP API 访问
  3. 他们将提供:
    • OHIP Host Name
    • Application Key
    • Client ID 和 Secret
    • Hotel ID
  4. 安全地记录收到的凭据

需要帮助?