Opera PMS 集成 (OHIP)
通过 OHIP (Oracle Hospitality Integration Platform) 将 AVA 连接到 Oracle 的 Opera Cloud 物业管理系统。配置完成后，AVA 会直接从 Opera 同步预订、房态和住客信息。
入口位置
Settings → Essentials → Property Management System (PMS) Integration开始之前
请从你的 IT 团队或 Oracle/Opera 管理员处获取以下凭据：
| 凭据 | 说明 |
|---|---|
| OHIP Host Name | API 基础 URL，例如 ohip.oraclecloud.com |
| OHIP Application Key | 用于 API 访问的应用密钥 |
| OHIP Hotel ID | 你在 Opera 中的物业标识符 |
| OHIP Client ID | OAuth 客户端标识符 |
| OHIP Client Secret | OAuth 客户端密钥 |
注意
Opera OHIP 集成需要由 Oracle 或你的 IT 团队完成技术设置。在为你的物业启用 OHIP 访问后，他们会提供 API 凭据。
配置步骤
第 1 步：将 Opera 选为 PMS
- 前往 Settings → Essentials
- 滚动到 PMS Integration
- 点击 Opera 卡片
- 出现复选标记 (✓) 表示已选中
第 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 步：保存并验证
- 点击 Save
- 查看状态指示：
- 🟢 "Opera Integration Configured" = 已填写所有必填字段
- 🟡 "Opera Integration Not Configured" = 仍缺少必填字段
从 Opera 同步的内容
连接后，AVA 会接收：
- ✅ 客人预订和账单
- ✅ 房间可用性和状态
- ✅ 客人资料信息
- ✅ 入住/退房交易
- ✅ 房间封锁信息
对客人和员工的影响
- 客人表单会适配 Opera 规则。 必填字段和隐藏字段会随 Opera 配置变化，因此客人只会看到需要填写的内容。
- 预订查找依赖 Opera。 如果没有配置 Opera，客人查找步骤会失败。
- 活跃预订默认显示。 取消的预订不会出现在常规查找结果中，除非某个流程明确要求包含它们。
- 多房预订会把主客人保留在正确的房卡上。 AVA 会按确认号匹配房间，因此即使 Opera 使用不同的内部 ID，客人关系也能保持正确。
- 协助入住时可显示房价代码。 当 Opera 传入房价代码时，AVA 会在员工协助入住期间把它显示在所选预订卡片上。
- 支付入账可追加备注。 当 Opera 支付或押金成功入账后，AVA 会在 Opera 中添加一条预订备注。
故障排查
显示 "Integration Not Configured"
说明缺少必填字段。请确认你已填写：
- OHIP Host Name
- OHIP Application Key
- OHIP Hotel ID
- OHIP Client ID
API 连接错误
- 确认 OHIP Host Name 正确
- 检查你的 OHIP 订阅是否仍然有效
- 联系 IT 确认防火墙/网络访问
- 与 Oracle 支持核实凭据
预订没有出现
- 等待 15 到 30 分钟完成初始同步
- 检查 Opera 中的 OHIP 用户权限
- 确认 Opera 中确实存在这些预订
- 联系支持并提供错误日志
多房房卡看起来是空的
你会看到： 打开了某张房卡，但主客人不见了。
解决方法：
- 确认你是通过确认号加载的预订。
- 刷新入住界面并重新打开该房间。
- 如果主客人仍然缺失，请联系支持，并附上确认号和到店日期。
安全最佳实践
- 🔒 安全保存凭据（AVA 中已加密）
- 🔒 尽可能使用 OCIM，以获得更好的安全性
- 🔒 定期轮换客户端密钥
- 🔒 将 OHIP 用户权限限制在最低必要范围
获取 OHIP 凭据
如果你还没有凭据：
- 联系 Oracle Hospitality 支持或你的 Opera 系统管理员
- 申请用于 AVA 集成的 OHIP API 访问
- 他们会提供：
- OHIP Host Name
- Application Key
- Client ID 和 Secret
- Hotel ID
- 将收到的凭据妥善记录并安全保存
需要帮助？
- Oracle 支持： support.oracle.com
- AVA 支持： success@vouch-technologies.com
- 你的 IT 部门： 负责凭据和网络访问