跳到主要内容

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 凭据一并保存。

房卡有效期使用本地时间

在 Settings → Essentials → Hotel Basic Details 中设置物业的 IANA 时区。 AVA 会使用该时区，以本地墙上时钟时间格式化 Opera 房卡有效期。

配置步骤​

第 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" = 缺少必填字段

第 4 步：配置 Sharer Payment​

当 AVA 为额外住客创建单独的 sharer 预订时，使用此设置。

  1. 前往 Settings → Check-In → Check-In Policy

  2. 在 Registration 中，将 Additional Guest Under 设置为 Sharer Reservation。

  3. 找到 Sharer payment method，然后点击 Configure。

  4. 选择 Opera 设置 sharer 付款和担保代码的方式：

    选项使用场景结果
    Same as main reservationsharer 应与主预订一致AVA 使用主预订的付款方式。
    Specific OPERA methodsharer 需要独立的付款方式AVA 使用你选择的付款和担保代码。

  5. 对于 Specific OPERA method，选择符合条件的 OPERA payment method 和 OPERA guarantee code。

  6. 点击 Apply，然后点击 Save Check-In Policy。

    ✓ 保存的配对会用于生成的 sharer 预订，即使请求没有覆盖值。

保存住客放置或 sharer 付款设置时，AVA 会将其同步到 Vouch Core，以用于 Opera。 这样，生成的 sharer 预订就会与保存的策略保持一致。

部署前确认 Opera 设置

AVA 不再应用特定物业的 sharer 付款代码。 部署 Opera 集成变更前，请确认目标设置已保存。 对于独立的现金 sharer，仅当 Opera 将 CA 和 NON 都列为符合条件的值时，才选择它们。

从 Opera 会同步什么内容​

连接后，AVA 会接收：

  • ✅ 住客预订和 folio
  • ✅ 房间可用性和状态
  • ✅ 共享 AVA 格式的住客档案信息
  • ✅ 入住/退房交易
  • ✅ 房间阻挡信息
  • ✅ Do Not Move 房锁状态
  • ✅ 通过标准预订流程更新预订 ETA
  • ✅ 关联预订的 Group Checkout 功能

对客人与员工的影响​

  • 住客表单会根据 Opera 规则调整。 必填字段和隐藏字段会随 Opera 配置变化，因此住客只会看到需要填写的内容。
  • 住客档案使用共享 AVA 布局。 Opera 的住客详情现在会以与 AVA v2 相同的字段结构打开。
  • 预订查找使用 Opera。 如果未配置 Opera，住客查找步骤会失败。
  • 外部参考查找会验证完整预订。 AVA 会先在完整的 Opera 记录上检查请求的外部参考和到店日期，然后再选择预订。如果值不匹配或结果不明确，AVA 不会选择预订。
  • OTA 参考号的字母大小写可能不同。 如果精确的外部参考查找没有结果，AVA 会将参考号转换为大写后重试一次，然后在完整预订记录上进行不区分大小写的比较。确认号查找行为不变。
  • 退房查找遵循 Opera 的 PMS 营业日期。 午夜后，AVA 会将退房查找限制为 Opera 当前 PMS 营业日应退房的预订。AVA 还会检查退房日期本身。按日历日期退房的预订可能要等 Night Audit 推进营业日期后才可用。
  • ACI 姓名搜索使用 Opera 档案。 Staff Access 会搜索 Opera 住客档案目录，然后显示与匹配档案关联的活动预订。
  • ACI 可以将同名预订分组。 需要经过验证的 kiosk 工作人员凭据。单设备 ACI 使用现有凭据，不会启动双设备运行时。
  • 主预订仍是主预订。 AVA 只会对选定的额外预订免除主住客登记。
  • 额外住客更新不会覆盖主住客。 带有姓名的更新会在选定预订上创建额外住客。
  • 陪同档案使用权威的主住客上下文。 创建陪同档案前，AVA 会刷新 Opera 预订，并要求恰好一个明确的主住客及可用的档案 ID。缺失、空白、不匹配或不明确的身份上下文会在创建档案前停止操作。
  • 手动分组只会改变 AVA 的 ACI 流程。 它不会在 Opera 中创建或更改预订组。
  • 活动预订默认会显示。 取消的预订不会出现在常规查找结果中，除非工作流明确要求它们。
  • 多房间预订会把搜索到的房间保留在正确的卡片上。 即使 Opera 将家庭预订规范化为主确认号，或使用不同的内部 ID，AVA 仍会保留你查找的确认号。
  • 双设备 ACI 支持在已验证员工设备上进行房间操作。 工作人员可以查看房间状况和入住率、刷新 Opera 分配，并选择准备就绪的替代房间。
  • 房间刷新失败时保持原状态。 如果 Opera 没有返回房间或返回含糊的多房间结果，AVA 会保留已存房间，而不是选择其他房间。
  • Opera 返回空的停用房间结果是有效的。 当 Opera 没有返回停用房间时，AVA 会将结果视为空，房间分配可以继续。缺失或格式错误的结果仍会显示 PMS 不可用错误。
  • 套房组件会检查每个关联房间。 如果 Opera 用组件房间表示套房，AVA 会在分配前检查每个成员的入住情况和准备状态。
  • 已入住的组件房间优先级更高。 如果一个成员已入住，AVA 会保留该已入住原因，而不是选择其他未准备状态。
  • 未经验证的自动选择套房会保持阻塞。 如果 AVA 无法验证自动选择的组件套房，就会阻止分配请求。
  • 普通房间保持现有路径。 这些额外的组件房间检查不适用于普通房间或无关的自动选择房间。
  • 单设备 ACI 不显示这些房间操作控件。 在单设备 ACI 中，请使用 PMS 更改房间。
  • Opera 报告支持时可使用 Group Checkout。 连接激活后，在 Settings → Check-In → Check-In Policy 中开启它。
  • 部分多房间入住在刷新后仍然有效。 注册的主房间入住后，重新获取的预订仍会让后续空房间保持可用。AVA 会将房间匹配到同一预订家庭，因此无关的已入住房间无法解锁它。
  • 后续空房间操作仍可用。 选择并办理后续空房间入住后，AVA 只会将该房间发送到 Opera。对于已入住但没有自身访问载荷的空房间，AVA 会检查商户的 Keycard 设置。若不可用，AVA 会检查同一预订中已入住兄弟房间的明确 Keycard 访问权限。随后会显示 Room Information 和 Create Keycard。
  • Sharer 预订保持分开。 如果 Opera 为多个预订 ID 使用一个确认号，AVA 仍会将每个预订作为独立的入住目标。
  • Sharer 付款设置控制生成的预订。 特定的付款和担保配对优先于 Opera 的现金方式查找。 如果没有特定配对，AVA 会使用 Opera 中符合条件的现金付款方式。
  • 住客放置设置会与 Vouch Core 同步。 保存 Additional Guest Under 或 sharer 付款设置后，保存的值会转发给未来的 Opera 住客操作。
  • 收费房型会保持稳定。 当 AVA 在 Opera 中分配房间时，即使实体房间属于不同房型，收费房型也不会改变。
  • 向房间新增住客仍会同步。 如果员工在入住期间添加另一位住客，AVA 会更新 Opera，使额外住客继续附着在该房间上。
  • 人工协助入住可以显示房价代码。 当 Opera 返回房价代码时，AVA 会在员工协助入住的所选预订卡上显示它。
  • 旅行社标签会保持可见。 Opera 可以把代理名称传入 sourceName。 这样 waiver 匹配就能看到类似 Booking.com (VCC) 的标签。
  • 支付入账可以添加备注。 Opera 支付或押金成功后，AVA 会在 Opera 中添加一条预订备注。 它使用你在 Settings → Payment 中配置的 Default Comment Type / Location。
  • 支付金额应与物业货币一致。 货币不匹配时，Opera 可能返回内部错误。
  • 上传的文件可能出现在 Opera 附件中。 同步后，你可以从预订中验证旅行证件和登记卡上传内容。
  • 预订 ETA 会保持同步。 AVA 会把预计到达时间写回 Opera，并读入 Streamliner。 你可以在预订卡和列表中看到由 PMS 支持的 ETA。
  • 特殊代码会在设置页之间保持一致。 AVA 会把平铺的 Opera special-code 字段视为 Settings → Essentials → PMS Integration 和 Settings → Check-In 中已保存的事实来源。 为兼容旧读取器，网络上传输时仍可能出现嵌套的 specialCode 和 specialCodes 对象，但 AVA 不会使用它们。 如果你在一个地方编辑了代码，刷新后另一个视图会显示相同的已保存平铺值。 如果你清空了某个代码，变更也会照样保存。
  • 可选的退房特殊代码会重试 Opera 的瞬时失败。 短暂的 OHIP 错误发生后，AVA 会重试一次。 重试前它会检查 Opera，因此不确定的响应不会创建重复代码。 即使可选更新失败，退房仍会完成。
  • Opera 账单策略会影响住客账单。 隐藏和免收规则的效果不同。
  • 付款策略控件显示在 Settings → Payment 中。 能力数据会控制你能看到哪些住宿和 Opera 专属控件。
  • 免收策略会减少房间套餐费用及已识别的房间套餐组件。 对于到店前预订，预计的 Opera rate-info 房费及其税费会一并免收。
  • 单独入账的额外项目及其税费仍可能需要支付。 它们不属于已预订的房费。
  • 隐藏策略会遮盖房费和税费行。 应付余额保持不变。
  • 评估后的应付账单控件会控制退房付款。 AVA 使用该金额，而不是显示摘要中的金额。
  • Opera 明确返回的零余额仍具有权威性。 AVA 不会根据可见的房费、税费或服务行重新构建正余额。 当转账或结算对应项不可见时同样适用。 只有当金额和货币与规范化的 Opera 账单一致时，AVA 才信任该零余额。不匹配的结果仍未确认。
  • 付款冲正会保留其符号。 Opera 的付款与等额负冲正会在 AVA 的 folio 和账单审核中净额为零。
  • 选择性账单保持在住客的 folio 窗口内。 其他窗口的转入费用不会增加余额。
  • 不完整的 folio 数据仍未确认。 当住客窗口不完整时，AVA 会避免显示错误的零余额。
  • 预计发票行可能仍会显示。 收款前，请将异常费用与 Opera 对照。
  • 如果没有匹配的策略，AVA 会使用收到的账单响应。
  • 锁定房间在 AVA 中保持锁定。 如果 Opera 将预订标记为 Do Not Move，Streamliner 会在换房视图中显示锁定图标。

故障排查​

未配置状态​

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

  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 支持确认凭据

操作期间 Opera 身份验证被拒绝​

你会看到： Opera 操作短暂暂停，或显示身份验证或超时错误。

原因： Opera 可能会拒绝缓存的凭据，或其 OAuth 服务可能短暂延迟。 AVA 会对每种情况自动重试一次。

解决方法：

  1. 等待最多 30 秒，让 AVA 完成自动重试。
  2. 只有错误仍然存在时，才再次尝试该操作。
  3. 如果错误再次出现，请验证 Opera 环境和凭据。
  4. 在 AVA 中重新输入凭据，然后点击 Save。
  5. 如果错误持续，请联系 Oracle 或 Vouch 支持。
一次自动重试

缓存凭据失败后，AVA 会刷新 Opera 配置。 它还会对一次瞬时 OAuth 超时或网关错误重试。 无效凭据和速率限制不会触发此重试。

一保存 OCIM 就失败​

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

解决方法：

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

没有出现预订​

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

退房完成，但 Opera 报告中缺少特殊代码​

你会看到： AVA 完成退房，但配置的退房特殊代码在 Opera 中缺失。

原因： 可选的 Opera 更新可能在退房后失败。AVA 会对瞬时 OHIP 错误重试一次。

解决方法：

  1. 稍等片刻，然后在 Opera 中刷新预订。
  2. 确认 Specials code for check-out 已保存在 Settings → Check-In 中。
  3. 再次检查 Opera 预订。
  4. 如果代码仍然缺失，请联系支持。
退房不会被阻止

失败的可选特殊代码更新不会撤销或阻止退房。 AVA 不会重试非瞬时错误。

住宿免收后额外项目仍需支付​

你会看到： 房间套餐行免收后，AVA 仍显示正余额。

到店前 Opera 税率

AVA 会将预计的 Opera rate-info 房费及其税费视为一个房间套餐金额。 匹配的 rate-code 免收不应留下仍需支付的预计房费税费。 只有单独入账的额外项目及其税费应继续收取。

解决方法：

  1. 在 Opera 中查看余额和额外 GST。
  2. 确认剩余费用正确。
  3. Opera 完成同步后，在 AVA 中刷新预订。
  4. 当正余额与 Opera 的未结余额一致时，选择 Pay。
  5. 如果 Opera 报告为零，请刷新 AVA 并确认余额为零。

Opera folio 数据不完整​

你会看到： Opera folio 更新后，AVA 无法确认余额。

解决方法：

  1. 确认 Opera 返回了住客的主 folio 窗口。
  2. 检查 folio 窗口是否包含余额或可用入账记录。
  3. 在 AVA 中刷新预订。
  4. 等待 Opera 完成 folio 更新。
  5. 如果余额仍未确认，请联系前台或支持团队。

ETA 不更新​

你会看到： 预订仍在 Streamliner 中显示旧的到达时间。

解决方法：

  1. 确认 ETA 已保存到 Opera 中的预订。
  2. 更新同步完成后刷新 Operations View。
  3. 如果仍然没有出现，请检查 Opera 连接，并在几分钟后重试。

多房间房卡看起来为空​

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

解决方法：

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

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

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

解决方法：

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

Opera 组件套房未准备就绪​

你会看到： Opera 套房未准备就绪，导致入住停止，或房间分配不可用。

原因： Opera 使用关联的组件房间表示套房。 AVA 会在分配套房前检查每个关联房间。

解决方法：

  1. 在 Opera 中打开套房。
  2. 检查每个组件房间的入住情况和准备状态。
  3. 在 Opera 或 Housekeeping 中处理任何已入住、脏房或不可用的组件房间。
  4. 确认套房的房间配置列出了准确的组件成员。
  5. 返回 AVA，点击 Refresh，然后重试入住。

如果 AVA 自动选择了套房但无法验证其准确配置，请让 Opera 管理员修正映射。

普通房间保持不变

AVA 对普通房间和无关的自动选择房间使用现有的房间分配路径。

安全最佳实践​

  • 🔒 安全存储凭据（它们在 AVA 中会加密）
  • 🔒 如可能，优先使用 OCIM 以获得更好的安全性
  • 🔒 将 enterpriseId 与其他 OCIM 凭据一起保存
  • 🔒 定期轮换客户端密钥
  • 🔒 仅授予 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 身份管理模式
  • 问题开始的时间
  • 你已经尝试过的步骤