跳到主要内容

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 企业标识。当 OHIP Identity Management 为 OCIM 时必需。
注意

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

OCIM 需要额外一个值

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

房卡有效期使用本地时间

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

泰国合规报告必需设置

请让 Opera 管理员在 Global Administration 中启用 Module Level Access Control。 他们还必须向 AVA OHIP 客户端授予 Sensitive Data Access。 没有这些权限，Opera 会在 TM30 和 RR4 报告中遮蔽部分护照号码和出生日期。

配置步骤​

第 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 企业标识。仅当 OHIP Identity Management 为 OCIM 时使用。

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

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

第 3 步：保存并验证​

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

设置预订备注默认值​

员工从 AVA 添加预订备注时，可以使用这些可选字段。 Reservation Notes 面板会在员工添加备注前显示备案值。 AVA 会从 Opera 加载备注类型和位置。 每个列表都有独立的共享缓存，最长保存 30 天。 需要最新选项时，点击字段旁的 Refresh from PMS。 使用该列表的所有字段会一起更新，包括其他设置页面上的字段。 如果某个列表不可用，AVA 仍会保留其他列表，字段也仍可编辑。

设置控制内容空值
Reservation Note Comment Type员工备注使用的 Opera 备注类型GEN
Reservation Note Comment Location员工备注使用的 Opera 位置RESERVATION
  1. 打开 Opera 集成的 Advanced 设置。
  2. 选择酒店使用的 Opera 备注类型和位置。
  3. 任一字段留空即可使用其显示的默认值。
  4. 点击 Save。

当两个字段都使用默认值时，AVA 会将备案摘要显示为 GEN · RESERVATION。 有权限的员工可以从 Reservation Notes 选择 Configure in Settings。

员工备注与付款备注相互独立

这些设置仅适用于从 Reservation Notes 添加的备注。 它们不会更改付款或预授权备注。 这些备注继续使用 Settings → Payment 中的 Default Comment Type / Location。

与 Opera 管理员确认备注类型

Opera 备注类型代码由酒店配置。 员工添加备注前，请确认所选代码有效。

可用的备注位置包括 CASHIER、GENERAL、IN HOUSE 和 RESERVATION。 备注类型列表来自你的 Opera 预订备注配置。 如果已保存的代码在 Opera 中不再可用，AVA 会继续显示并标记它。 员工添加预订备注前，请替换已标记的代码。

入住政策位置

在 Settings → Check-In → Check-In Policy → Guest registration 下配置 Match and merge guest profiles。 请参阅匹配并合并住客档案。

主住客稍后到达时提醒前台​

当额外住客可能早于主住客入住时，使用此设置。 AVA 会在 Opera 主预订中添加提醒。 该设置默认关闭。

  1. 前往 Settings → Check-In → Check-in essentials。
  2. 找到 Alert the front desk when the main guest is arriving later。
  3. 开启此设置。
  4. 选择 Choose alert。
  5. 选择一个酒店配置的 OPERA alert code。
  6. 选择 Opera 显示提醒的位置。
  7. 选择提醒代码说明或 Custom text。
  8. 需要时输入自定义文本，然后选择 Apply。
  9. 选择 Save Check-In Policy。

提醒区域和文本选项来自你的 Opera 连接。 使用自定义文本时，AVA 要求消息不能为空。

设置控制内容
OPERA alert code标识 Opera 中的提醒
Show the alert in选择 Opera 中的提醒区域
Alert text使用代码说明或你的自定义消息

在辅助入住中，启用提醒后，AVA 会询问员工主住客的情况。 当主预订尚未入住时会显示该问题。 这包括陪同到达和混合到达。 员工可以选择 Yes, arriving later 或 No, not staying。 在自助入住中，AVA 默认将缺席的主住客视为稍后到达。 员工明确保存的 No, not staying 选择会覆盖该默认值。 最近一次明确的员工选择会保留，供之后的自助入住使用。 提醒会发到主预订，而不是额外住客的预订。 提醒投递尽力而为，不会延迟或导致入住失败。

重试前检查预订

Opera 提醒发布可能因记录锁定而延迟。 再次选择 Continue 前，请先在 Opera 中检查主预订。

共享住客先到达时发放房间访问权限​

共享住客先于主住客入住时，AVA 可以发放房间访问权限。 这适用于共享住客已标记为到店并与分配的房间共享的情况。

对于房卡，AVA 会在拒绝请求前刷新 Opera 的实时入住情况。 同一检查也支持已到店共享住客的丢失房卡补发。 陪同住客仍保留在主预订中，并遵循正常流程。

如果共享住客已退房或使用其他房间，AVA 会拒绝访问。 这可以防止为错误房间创建房卡。

  1. 确认共享住客已通过 AVA 或 Opera 入住。

  2. 确认共享住客和主住客在 Opera 中使用同一房间。

  3. 重试 Create Keycard 或丢失房卡流程。

  4. 如果 Opera 无法确认入住，请让住客前往前台。

    ✓ 只有实时房间和到店检查均通过后，AVA 才应发放访问权限。

第 4 步：选择住客放置方式​

选择 AVA 在登记期间如何将额外住客放入 Opera。

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

  2. 在 Registration 中找到 Additional Guest Under。

  3. 选择一个选项：

    选项结果
    Sharer Reservation为额外住客创建单独的 Opera 预订。
    Accompany Profile将住客作为主预订上的陪同档案添加。

  4. 决定是否将该选择应用于现有额外住客。

  5. 如果要转换现有住客，请开启 Apply this setting to existing additional guests。 AVA 会在登记期间转换符合条件的 Opera 共享住客或陪同住客。

  6. 点击 Save Check-In Policy。

    ✓ 新的额外住客始终遵循所选选项。

房间同步后，房间附加会遵循相同的放置方式。 在 Sharer Reservation 模式下，AVA 会在附加房间前验证关联共享住客。 它不会将陪同档案添加到主预订中。 在 Accompany Profile 模式下，AVA 会让住客继续附加到主预订。

选择共享住客文件目的地​

选择 Opera 显示护照、身份证件和已签署登记卡附件的位置。 护照和身份证件副本也会保留在每位共享住客的住客档案中。 已保存的目的地会控制新的上传内容，包括明确到店入住期间创建的登记卡。 你选择的目的地优先于 AVA 默认的共享住客预订目标。

  1. 在 Registration 中找到 Upload sharer documents to。

  2. 选择一个选项：

    选项结果
    Main Guest Reservation在主预订中收集所有共享住客文件和登记卡。
    Sharer Reservation将每位共享住客的文件和登记卡附加到其共享住客预订。

  3. 点击 Save Check-In Policy。

    ✓ 新签署的登记卡会使用所选的 Opera 目的地。

现有 PMS 附件

更改此设置不会移动 Opera 中已经存储的附件。 保存设置后，新上传内容会遵循该设置。

现有住客转换

该复选框默认关闭。关闭时，AVA 会保留现有的共享住客和陪同住客关系。 开启时，AVA 会在登记期间转换符合条件的现有额外住客。 这不是批量迁移。之后关闭该选项不会撤销已经完成的转换。

转换条件

AVA 只会转换财务详情完整且未发生变化的已预订 Opera 预订。 主预订上的套餐可以保留，且在两个转换方向中都不会改变。 符合条件的共享住客可以继承数量、金额、额度和消耗均为零的房价计划套餐。 仅套餐单价非零并不会阻止转换，只要数量和计算金额为零即可。 由预订添加、已消耗、非零或未知的套餐活动仍需要员工审核。 移除现有共享住客时，套餐、入住率、房价和财务检查也必须全部通过。 成人和儿童数量均为零的共享住客可以转换，前提是所有出站路由目标都指向保留的主预订 ID。 账单明细或 comp 路由、指向其他预订的路由以及不受支持的路由结构仍会阻止转换。 AVA 会在分离共享关系后、取消旧共享住客预订前再次检查路由。 如果 Opera 无法证明转换安全，AVA 会暂停登记并等待员工审核。

如果转换中途停止，请在重试前恢复原来的设置。 否则，请让员工在 Opera 中核对受影响的住客。

配置共享住客付款​

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

  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 reservation共享住客应与主预订一致AVA 使用主预订的付款方式。
    Specific OPERA method共享住客需要独立的付款方式AVA 使用你选择的付款和担保代码。

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

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

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

AVA 会从 Opera 加载符合条件的非卡类付款方式和担保代码。 标签使用 Opera 的描述，代码按数字顺序显示。 每个列表会缓存 30 天。 在 Opera 中更改代码后，点击 Refresh from OPERA。 刷新会更新所有使用所选列表的字段。 AVA 会在拒绝新添加的代码前，用最新的 Opera 数据检查这对代码。

刷新结果

如果刷新无法读取某个列表，AVA 会保留之前读取的代码，并显示刷新警告。 使用 Try Again 再次请求该列表。 重新打开字段后，警告会清除。

两个列表都必须加载

在 AVA 加载两个符合条件的列表之前，无法保存 Specific OPERA method。 如果某个列表不可用，请使用 Try Again，或让 Opera 管理员检查访问权限。 只有拥有设置写入权限的用户，才能在共享住客对话框中刷新这些列表。

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

部署前确认 Opera 设置

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

设置共享住客房价代码​

当新的 Opera 共享住客预订需要特定房价代码时，使用此设置。

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

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

  3. 找到 Sharer Rate Code。

  4. 点击该字段，从 PMS 目录加载活动房价代码建议。

  5. 选择一个建议，或手动输入有效代码。

  6. 如果要移除覆盖值，请清空该字段。

  7. 点击 Save Check-In Policy。

    ✓ AVA 会保存该代码，用于未来的共享住客预订，并将其与 Opera 同步。

该设置适用于 AVA 创建单独的 Sharer Reservation 的情况。 空值会移除覆盖值，并恢复主预订的正常房价计划行为。 即使目录中没有匹配的活动建议，AVA 也会保留自定义值。

房价代码建议

建议显示当前所选酒店的活动房价计划。 如果列表为空或不可用，请手动输入代码，或点击 Retry。

重新保存旧的共享住客房价设置

如果你的物业在本次更新前已保存共享住客房价，请在部署后再次保存 Sharer Rate Code。 这样会为新的共享住客保留现有值并将其与 Opera 同步。 字段重命名后，之前保存的值仍然可用。

从 Opera 会同步什么内容​

连接后，AVA 会接收：

  • ✅ 住客预订和账单明细（folio）
  • ✅ 房间可用性和状态
  • ✅ 共享 AVA 格式的住客档案信息
  • ✅ 入住/退房交易
  • ✅ 房间阻挡信息
  • ✅ Do Not Move 房锁状态
  • ✅ 通过标准预订流程同步预订预计到达和离店时间
  • ✅ 关联预订的 Group Checkout 功能

对客人与员工的影响​

  • 住客表单会根据 Opera 规则调整。 必填字段和隐藏字段会随 Opera 配置变化，因此住客只会看到需要填写的内容。
  • 住客档案使用共享 AVA 布局。 Opera 的住客详情现在会以与 AVA v2 相同的字段结构打开。
  • 较长的住客地址可以安全同步。 必要时，AVA 会将地址拆分到 Opera 的四行地址中。每行都会保持在 Opera 的 80 字节限制内。
  • 地址更新会清除过时的行。 AVA 会填充 Opera 的全部四个地址栏位，因此较短的新地址会移除旧地址遗留的行。
  • 预订查找使用 Opera。 如果未配置 Opera，住客查找步骤会失败。
  • 最近的 Opera 更改最多可能需要五秒才会显示。 外部 Opera 更新后，这可能会影响预订和账单明细读取。请稍等片刻，然后刷新 AVA，再验证更改。
  • Opera 接受超过报告房间容量的额外住客。 AVA 会通过 Opera 的陪同档案流程添加该住客。
  • 外部参考查找会验证完整预订。 AVA 会先在完整的 Opera 记录上检查请求的外部参考和到店日期，然后再选择预订。如果值不匹配或结果不明确，AVA 不会选择预订。
  • OTA 参考号的字母大小写可能不同。 如果精确的外部参考查找没有结果，AVA 会将参考号转换为大写后重试一次，然后在完整预订记录上进行不区分大小写的比较。确认号查找行为不变。
  • 选定的到店预订保持明确。 当到店请求提供选定的 Opera 预订时，AVA 只为这些预订办理入住。它不会自动添加缺失的共享住客；当共享住客先到达时，会保留待处理的主预订，也不会扩展空的选择。
  • 退房查找遵循 Opera 的 PMS 营业日期。 午夜后，AVA 会将退房查找限制为 Opera 当前 PMS 营业日应退房的预订。AVA 还会检查退房日期本身。按日历日期退房的预订可能要等夜审（Night Audit）推进营业日期后才可用。
  • ACI 姓名搜索使用活动预订。 Staff Access 会使用住客的完整姓名（包括多部分姓名）检查活动的 Opera 预订。
  • ACI 可以将同名预订分组。 需要经过验证的自助终端工作人员凭据。单设备 ACI 使用现有凭据，不会启动双设备运行时。
  • 主预订仍是主预订。 AVA 只会对选定的额外预订免除主住客登记。
  • 额外住客更新不会覆盖主住客。 带有姓名的更新会在选定预订上创建额外住客。
  • 回头客额外住客可以复用 Opera 档案。 开启 Match and merge guest profiles 后，AVA 会在创建新的额外住客档案前，按姓名和身份证件进行搜索。
  • Opera 护照代码可以匹配 AVA 的护照类型。 在档案匹配期间，AVA 将 Opera 的确切代码 PAS 和 PASSPORT 视为等价。
  • 不确定的匹配不会自动复用档案。 AVA 要求得到已验证的唯一匹配。工作人员可以选择已验证的候选档案，或创建新档案。
  • 档案匹配会使用额外的 Opera 调用。 唯一匹配可能需要读取更多档案。员工比较时只会显示数量受限的已验证候选项。
  • 陪同档案使用权威的主住客上下文。 创建陪同档案前，AVA 会刷新 Opera 预订，并要求恰好一个明确的主住客及可用的档案 ID。缺失、空白、不匹配或不明确的身份上下文会在创建档案前停止操作。
  • 手动分组只会改变 AVA 的 ACI 流程。 它不会在 Opera 中创建或更改预订组。
  • 活动预订默认会显示。 取消的预订不会出现在常规查找结果中，除非工作流明确要求它们。
  • 多房间预订会把搜索到的房间保留在正确的卡片上。 即使 Opera 将家庭预订规范化为主确认号，或使用不同的内部 ID，AVA 仍会保留你查找的确认号。
  • 原生 Opera 链接可以定义预订家庭。 当 Vouch 为你的物业启用原生分组时，AVA 会遵循 Opera 的关联预订，而不是匹配住客、到店日期或共享预订参考号。
  • 原生分组只保留匹配的房间。 AVA 会排除已取消、未到店、已退房、虚拟房间以及日期不重叠的入住记录，也会将共享住客和同一房间的记录合并为一个实体房间。
  • SiteMinder 预订使用安全回退机制。 如果 Opera 没有原生关联家庭，AVA 会匹配完全一致的 SiteMinder 组件参考号，而不会将参考号相似但无关的预订合并。
  • 你查找的预订仍是主预订。 打开子预订或共享住客预订时，流程仍从该预订开始，同时 AVA 会显示同一家庭中其他符合条件的房间。
  • 原生分组需要选择启用。 Vouch 部署团队会按物业启用此功能。在他们确认部署前，Opera 的默认行为保持不变。
  • 部署可能使家庭标识符变更一次。 分组模式改变后，分析数据可能会再次统计某个预订，因为 AVA 保存了新的家庭标识符。
  • 已验证的单设备和双设备 ACI 支持房间操作。 工作人员可以查看房间状况和入住率、刷新 Opera 分配、选择准备就绪的替代房间，并更新 Clean、Dirty 或 Inspected 状态。
  • 房间刷新失败时保持原状态。 如果 Opera 没有返回房间或返回含糊的多房间结果，AVA 会保留已存房间，而不是选择其他房间。
  • 智能分配会检查完整入住时段。 即使 Opera 显示房间今天为空，AVA 也会排除在请求到店日期至离店日期之间已分配给其他预订的房间。
  • 迟到的 Opera 共享住客会保留共享房间。 如果主住客已入住，即使允许重新分配，AVA 仍会为迟到的关联共享住客保留该房间。
  • 保留的共享住客房间仍需满足房间准备状态。 关联入住保留房间时，AVA 接受 Clean、Inspected、Dirty 或 Pickup。Out of Order 和 Out of Service 仍会被阻止。
  • 你自己预订的预分配房间仍符合条件。 AVA 不会仅因为 Opera 将该房间列在当前预订中就拒绝它。
  • Opera 记录延迟会使用现有回退机制。 如果 AVA 无法读取重叠预订，Opera 仍会执行最终冲突检查；发生冲突后，AVA 会重试另一个房间。
  • Opera 返回空的停用房间结果是有效的。 当 Opera 没有返回停用房间时，AVA 会将结果视为空，房间分配可以继续。缺失或格式错误的结果仍会显示 PMS 不可用错误。
  • 套房组件会检查每个关联房间。 如果 Opera 用组件房间表示套房，AVA 会在分配前检查每个成员的入住情况和准备状态。
  • 已入住的组件房间优先级更高。 如果一个成员已入住，AVA 会保留该已入住原因，而不是选择其他未准备状态。
  • 未经验证的自动选择套房会保持阻塞。 如果 AVA 无法验证自动选择的组件套房，就会阻止分配请求。
  • 普通房间保持现有路径。 这些额外的组件房间检查不适用于普通房间或无关的自动选择房间。
  • 房间操作需要经过验证的员工设备。 AVA 会在换房前检查当前的 Opera 分配，并要求 Opera 确认后，才会将客房服务更新报告为成功。
  • Opera 报告支持时可使用 Group Checkout。 连接激活后，在 Settings → Check-In → Check-In Policy 中开启它。
  • 部分多房间入住在刷新后仍然有效。 注册的主房间入住后，重新获取的预订仍会让后续空房间保持可用。AVA 会将房间匹配到同一预订家庭，因此无关的已入住房间无法解锁它。
  • 后续空房间操作仍可用。 选择并办理后续空房间入住后，AVA 只会将该房间发送到 Opera。对于已入住但没有自身访问载荷的空房间，AVA 会检查商户的 Keycard 设置。若不可用，AVA 会检查同一预订中已入住兄弟房间的明确 Keycard 访问权限。随后会显示 Room Information 和 Create Keycard。
  • 共享住客预订保持分开。 如果 Opera 为多个预订 ID 使用一个确认号，AVA 仍会将每个预订作为独立的入住目标。
  • 多余的共享住客共用一个房间结果。 当 Opera 将主预订和零入住人数的共享住客关联到同一实体房间时，AVA 会显示一个房间结果。
  • 独立的共享住客状态仍会显示。 如果相关记录包含住客进度、付款、账单或入住状态，AVA 会继续显示该记录。
  • 住客放置对现有住客采取选择加入。 Apply this setting to existing additional guests 复选框默认关闭。开启后，登记会将符合条件的现有 Opera 共享住客或陪同住客转换为所选的 Additional Guest Under 选项。新的额外住客始终使用所选选项。
  • 零入住人数的共享住客套餐可以安全继承。 成人数和儿童数均为零的共享住客可以保留房价计划套餐，前提是其数量、计算价格、额度和消耗均为零。仅单位价格非零并不会阻止转换。预订新增、已消耗、非零或未知的套餐活动仍需要员工审核。主预订套餐保持不变。
  • 路由到主预订的共享住客可以转换。 成人数和儿童数均为零的共享住客可以转换，前提是所有出站路由目标都指向保留的主预订。账单明细或 comp 路由、其他预订目标以及不受支持的结构仍会被阻止。
  • 现有住客转换需要 Opera 确认。 AVA 会保持登记待处理，直到 Opera 返回新放置方式的完整且匹配的住客和预订标识符。随后，它会将排队的文件发送到已确认的目标位置。
  • 待处理转换在刷新预订后仍会保留。 当 Opera 暂时遗漏或更改住客档案时，AVA 会保留待处理住客及其文件。Opera 确认放置方式后，请刷新预订并重试。
  • Sharer 付款设置控制生成的预订。 特定的付款和担保配对优先于 Opera 的现金方式查找。 如果没有特定配对，AVA 会使用 Opera 中符合条件的现金付款方式。
  • Sharer Rate Code 的保存会与 Opera 同步。 AVA 会先保存代码，然后完成依赖它的 PMS 同步。 如果 PMS 设置保存失败，房价代码同步也会停止，以避免部分更新。 清空字段会移除未来共享住客预订的覆盖值。
  • Sharer 付款副本会单独协调。 AVA 可以完成共享，而付款副本仍处于待处理状态。 已确认的发送前失败和 Opera 拒绝可以重新打开副本，以便安全重试。 结果不明确时会保持暂停，以防止在 Opera 中创建重复的付款方式。
  • 住客放置设置会与 Vouch Core 同步。 保存 Additional Guest Under 或共享住客付款设置后，保存的值会转发给未来的 Opera 住客操作。
  • 收费房型会保持稳定。 当 AVA 在 Opera 中分配房间时，即使实体房间属于不同房型，收费房型也不会改变。
  • 向房间新增住客仍会同步。 如果员工在入住期间添加另一位住客，AVA 会更新 Opera，使额外住客继续附着在该房间上。
  • 房间附加会遵循住客放置方式。 AVA 会在住客同步后附加房间时使用当前的 Additional Guest Under 设置。 在 Sharer Reservation 模式下，AVA 要求关联共享住客与预订匹配，并拥有主住客档案。 房间附加期间不会创建陪同档案。 在 Accompany Profile 模式下，AVA 会保留现有的陪同档案附加流程。
  • 会阻止新的重复关系。 如果 Opera 无法证明所请求的共享住客关联，AVA 会停止附加房间，而不是重写主预订的住客列表。 这样可以防止重复的共享住客和陪同档案关系。 它不会移除已经存在的重复关系，也不会修复成人和儿童入住人数。
  • 人工协助入住可以显示房价代码。 当 Opera 返回房价代码时，AVA 会在员工协助入住的所选预订卡上显示它。
  • 双设备 ACI 可以显示 Arrival brief。 工作人员可以在配对的住客平板流程上方查看建议提示和只读的预订事实。
  • Arrival brief 可以显示十组 Opera 详情。 包括 VIP 等级、会员类型、房价代码、提醒、备注、已付押金、余额、住宿总费用、偏好和套餐。
  • Arrival brief 会按需加载详情。 AVA 会先加载核心预订事实，然后在请求时获取档案、房价或账单明细详情。
  • 可选部分会独立加载。 工作人员可以打开 Profile、Rate 或 Folio，而无需加载其他部分。
  • 可选部分可以刷新。 某个部分加载完成后或读取失败时，工作人员可以选择 Refresh。
  • 多预订 Arrival brief 会使用可用的侧栏空间。 住客平板控件会保持在侧栏底部。
  • 单预订 Arrival brief 保持紧凑。 AVA 会将住客平板控件保留在通常的位置。
  • 配对平板预览会保持其尺寸。 在较矮的屏幕上，员工面板会滚动，而不会缩小住客预览。
  • 按需加载不会改变常规账单。 入住、退房和付款流程保持现有行为。
  • 缺失的 Opera 值仍会显示。 AVA 会显示 Not provided，而不是隐藏缺失的详情。
  • Arrival brief 仅供员工查看且为只读。 它适用于当前双设备 ACI 流程中的确切住客，绝不会更改 Opera 数据。
  • 可以查看 Arrival brief 的建议。 工作人员可以选择 Done 或 Dismiss，需要时再使用 Reopen。
  • 旅行社标签会保持可见。 Opera 可以把代理名称传入 sourceName。 这样免收匹配就能看到类似 Booking.com (VCC) 的标签。
  • 支付入账可以添加备注。 Opera 支付或押金成功后，AVA 会在 Opera 中添加一条预订备注。 它使用你在 Settings → Payment 中配置的 Default Comment Type / Location。
  • 支付金额应与物业货币一致。 货币不匹配时，Opera 可能返回内部错误。
  • 上传的文件可能出现在 Opera 附件中。 同步后，你可以从预订中验证旅行证件和登记卡上传内容。
  • Opera 附件名称会在上传前规范化。 AVA 会移除住客姓名中的标点，同时保留字母（包括泰文字符）、数字、空格、_ 和 -。 AVA 会根据文件内容识别常见文件类型，并使用匹配的扩展名。 这样可以避免 R. Rendy Purwidyaputra 等姓名导致 OHIP 返回“Chosen file is invalid”错误。
  • 预订预计时间会保持同步。 AVA 会将预计到达和离店时间写回 Opera。 Opera 响应后，AVA 会将规范化后的值读入 Streamliner。 住客登记后，住客填写的 Estimated Arrival Time 和 Departure Time 值会更新 Opera。 对主预订，AVA 使用主住客的有效值。 对 Opera 共享住客，AVA 会将有效时间写入共享住客自己的预订。 如果某个时间字段只对主住客可见，共享住客会继承主住客的有效值。 当该字段对共享住客可用时，共享住客自己的有效值仍具有权威性。 AVA 不会将共享住客的时间复制到主预订。 缺失或无效的值会保留 Opera 中现有的时间不变。 在支持的预订卡和列表行中，你可以看到由 PMS 提供的预计到达和离店时间。
  • 特殊代码遵循所选入住模式。 到店前、Self Check-In 和 Assisted Check-In 分别使用各自的登记、预授权和入住代码。 如果你明确将某个模式的代码留空，AVA 不会回退到全局 OPERA Check-In 代码。 AVA 首次加载旧设置时，会将旧的平铺设置复制到各个模式。 如果不同模式的代码不同，请分别编辑并保存每个模式。 Self Check-In 标签页会首先打开，未激活的模式面板在选中前保持隐藏。 退房仍然独立，并使用全局退房代码。
  • 可选的退房特殊代码会重试 Opera 的瞬时失败。 短暂的 OHIP 错误发生后，AVA 会重试一次。 重试前它会检查 Opera，因此不确定的响应不会创建重复代码。 即使可选更新失败，退房仍会完成。
  • Opera 账单策略会影响住客账单。 隐藏和免收规则的效果不同。
  • 付款策略控件显示在 Settings → Payment 中。 能力数据会控制你能看到哪些住宿和 Opera 专属控件。
  • ACI No Post 受能力控制。 在 Settings → Payment → Payment Policy Controls → No Post Controls 中启用后，AVA 会在人工协助入住成功后请求 OPERA 入账限制。
  • ACI No Post 覆盖已入住的预订。 AVA 会将其应用于主预订或单个预订，以及每位已入住的共享住客。
  • No Post 失败不会撤销入住。 后续操作失败时，请在 OPERA 中验证预订，并手动应用该限制。
  • 普通 OPERA 入住不变。 此行为需要启用人工协助入住 No Post 设置。
  • 免收策略会减少房间套餐费用及已识别的房间套餐组件。 对于到店前预订，预计的 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

没有出现 OPERA 提醒代码​

现象： 提醒选择器没有显示代码，或无法加载代码。

解决方法：

  1. 确认当前 PMS 是 Opera。

  2. 确认你的 Opera 用户可以读取酒店提醒代码参考数据。

  3. 刷新 Settings → Check-In → Check-in essentials。

  4. 再次选择 Choose alert。

  5. 如果没有任何代码，请让 Opera 管理员配置提醒代码。

    ✓ AVA 只接受酒店返回的提醒代码。

到店较晚提醒未发布​

现象： 额外住客先入住，但主预订没有新的提醒。

解决方法：

  1. 确认提醒设置已启用并保存。
  2. 确认所选提醒代码仍存在于 Opera 中。
  3. 在 ACI 中，AVA 询问时选择 Yes, arriving later。
  4. 在 Opera 中打开主预订，检查所选提醒区域。
  5. 稍等片刻并刷新 Opera，然后重试。

当 AVA 已找到相同代码和区域时，会避免重复发布。 如果 Opera 拒绝了记录更新，请先检查预订状态，再重试。 5. 如果选择了 OCIM，还需要 enterpriseId

API 连接错误​

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

共享住客房价代码无法保存​

你会看到： 无法保存共享住客房价代码，或代码没有传到 Opera。

原因： AVA 必须确认 PMS 已接受该设置。 提供商配置失败会停止依赖该设置的房价代码更新。

解决方法：

  1. 确认 Settings → Essentials 中显示 Opera Integration Configured。
  2. 返回 Settings → Check-In → Check-In Policy。
  3. 选择活动目录建议，或输入 Opera 中的确切代码。
  4. 再次点击 Save Check-In Policy。
  5. 如果房价代码建议失败，请点击 Retry 或手动输入代码。
  6. 创建新的共享住客预订前，在 Opera 中确认该代码。
本次更新后的现有值

如果你的物业之前配置过共享住客房价，请在部署后重新保存该字段。 这样会将保留的值与 Opera 同步。

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

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

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

解决方法：

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

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

Opera 拒绝有效的文件附件​

你会看到： 护照、住客文件或登记卡上传失败，并显示“Chosen file is invalid”。

原因： Opera 可能会拒绝包含住客姓名标点符号的附件名称。

解决方法：

  1. 在 AVA 中刷新预订。

  2. 再次尝试上传文件。

  3. 在 Opera 中打开预订，确认附件是否出现。

  4. 如果上传仍然失败，请向支持团队提供预订号和错误截图。

    ✓ AVA 现在会在发送 Opera 附件前移除不支持的标点符号。

Opera 拒绝较长的住客地址​

你会看到： 保存较长地址时，住客更新或入住失败。

原因： Opera 将每行地址限制为 80 字节，并允许四行地址。

解决方法：

  1. 在 AVA 中刷新预订。

  2. 再次尝试住客更新或入住。

  3. 如果地址仍然失败，请缩短地址字段中的非必要文字。

  4. 在住客档案或 Opera 中确认已保存的地址。

    ✓ AVA 会在发送到 Opera 前，在合适的位置拆分较长地址。

越南语及其他带重音符号的地址

Opera 计算的是字节数，而不是可见字符数。带重音符号的字符可能更快达到限制。

Opera 提示预订正在被更改​

你会看到： 最终入住显示“此预订正在被用户……更改”。

原因： 另一个 Opera 更新仍持有预订记录锁。 此消息出现前，房间分配可能已经成功。 AVA 会自动将最终的 Opera 入住写入重试最多四次。

解决方法：

  1. 等待 AVA 完成自动重试。

  2. 如果冲突仍然存在，请在 AVA 中刷新预订。

  3. 在 Opera 中检查预订的最新房间和入住状态。

  4. 仅当 Opera 未完成入住时，才再次尝试最终入住。

    ✓ 短暂的 Opera 记录锁应会解除，且不会更改房间。

如果四次尝试后 AVA 显示 PMS_RESERVATION_MUTATION_IN_PROGRESS，请联系支持。 请附上预订号、时间和错误截图。

重复入住前先检查 Opera

Opera 的结果不明确时，不要重复最终入住。 请先在 Opera 中确认预订状态。

共享住客付款副本需要检查​

你会看到： 共享住客预订已存在，但复制的付款方式缺失或不明确。

原因： Opera 会附加复制的付款方式，并且可能在 AVA 收到响应前接受请求。 AVA 只会重试已确认的发送前失败和 Opera 明确拒绝的请求。 结果不明确时会暂停，以防止重复付款方式。

解决方法：

  1. 在 AVA 中刷新预订。

  2. 在 Opera 中打开相关的共享住客预订。

  3. 确认付款方式是否已经显示。

  4. 结果不明确时，不要手动添加付款方式。

  5. 使用确认号、预订 ID 和尝试时间联系支持。

    ✓ AVA 可以安全地重试已确认的失败，而不会追加第二个付款方式。

不要重复不明确的付款副本操作

Opera 超时并不能证明复制失败。 重复任何付款操作前，请先检查 Opera。

共享住客付款代码无法加载​

现象： 共享住客付款设置中没有可选的付款方式或担保代码。

解决方法：

  1. 点击 Refresh from OPERA。
  2. 如果出现刷新警告，点击 Try Again。
  3. 确认 Opera 返回非卡付款方式和担保代码。
  4. 如果列表仍不可用，请让 Opera 管理员检查访问权限。

在两个列表都加载前，不能保存 Specific OPERA method。只有拥有设置写入权限的用户才能刷新共享住客对话框中的列表。

现有额外住客仍保留原来的放置方式​

你会看到： 现有的 Opera 共享住客或陪同住客在登记后仍保持当前关系。

原因： Apply this setting to existing additional guests 默认关闭。 除非开启此 Opera 专用选项，否则 AVA 会保留现有关系。

解决方法：

  1. 打开 Settings → Check-In → Check-In Policy。
  2. 确认预期的 Additional Guest Under 选项。
  3. 开启 Apply this setting to existing additional guests。
  4. 点击 Save Check-In Policy。
  5. 再次登记受影响的预订。
  6. 检查 Opera，确认符合条件的住客已移动到所选安排。
现有检查点

如果之前的转换尚未完成，关闭此选项不会接受部分变更。 恢复该转换所使用的设置，然后重试，或请支持团队进行审核。

回头客创建了重复档案​

你会看到： 回头客额外住客在 Opera 中获得了新档案。

原因： 档案复用处于关闭状态，或 AVA 无法验证唯一匹配。 在双设备 ACI 中，模糊结果也需要工作人员作出选择。 AVA 仅将确切的护照代码 PAS 和 PASSPORT 视为等价。

解决方法：

  1. 打开 Settings → Essentials → PMS Integration。

  2. 确认当前 PMS 为 Opera。

  3. 找到 Guest registration。

  4. 开启 Match and merge guest profiles。

  5. 点击 Save。

  6. 检查住客姓名和身份证件是否与 Opera 中的现有档案匹配。

  7. 再次尝试额外住客登记。

    ✓ AVA 只会在身份匹配经过验证后复用现有档案。

Opera 护照代码

Opera 可能将护照存储为 PAS，而 AVA 会确认 PASSPORT。 在复用档案期间，这两个确切代码可以匹配。 其他证件代码仍需要完全匹配。

双设备 ACI 审核

在员工设备上，为一个候选档案选择 Review profile，或为多个候选档案选择 Review N profiles。 比较候选档案详情，然后选择档案或 Create new。 当住客行显示搜索失败时，选择 Retry。 登记会使用已保存的选择，而不会重复执行档案搜索。

合并已验证的重复 Opera 档案​

当 Opera 中已有同一住客的两个到五个已验证档案时，可使用此流程。 只有同时启用 Opera 档案复用和受保护的档案合并功能时，才可以合并。

  1. 在辅助入住中打开重复档案审核。

  2. 选择两个到五个已验证的重复档案。

  3. 选择要保留的档案作为 Survivor。

  4. 查看最新的 Opera 预览。

  5. 只有确认档案详情和 Survivor 正确后，才确认合并。

    ✓ AVA 只有在 Opera 确认保留档案并移除已弃用档案后才会完成合并。 ✓ 预订、日期、入住人数和状态仍会关联到正确的预订。

合并操作不可逆

确认住客身份和保留档案后再合并。 合并完成后，已弃用的档案 ID 不能再次使用。

AVA 可能阻止合并的原因

如果姓名、未遮蔽的证件、出生日期或国籍不匹配，AVA 会阻止合并。 档案内容已改变、候选项不明确或 Opera 响应不完整时，也会阻止合并。

空档案审核需要作出决定​

你会看到： 审核页面已打开，但没有可供选择的 Opera 档案。

解决方法：

  1. 选择 Retry lookup 刷新空结果。

  2. 如果 AVA 暂时禁用按钮，请等待重试冷却时间。

  3. 如果结果仍为空，请重新打开审核页面。

  4. 先确认没有现有档案符合条件，再选择 Create a new profile。

  5. AVA 在住客行显示你的决定后，继续登记。

    ✓ AVA 不会自动选择或创建档案。

档案查找失败后，你保存的签名仍可用。 当身份未改变时，明确的选择会在收据续期期间保留。 如果所选档案变得不可用，AVA 会要求重新作出决定。 登记开始后，该选择即会固定。

不要从不确定的结果中选择

如果有多个档案匹配，请在 AVA 中审核候选档案。 不要仅依赖已遮蔽的证件后缀。

重复档案合并不可用​

你会看到： 重复档案审核期间没有显示合并操作。

原因： 受保护的合并或档案复用未启用，或者 Opera 没有报告合并能力。

解决方法：

  1. 确认当前 PMS 为 Opera。

  2. 确认已启用 Match and merge guest profiles。

  3. 请 Vouch 管理员确认该物业已启用受保护的档案合并。

  4. 刷新住客审核并再次比较候选档案。

    ✓ 只有发布配置和物业设置均允许时，才会显示合并操作。

Opera 阻止或无法确认档案合并​

你会看到： AVA 阻止合并、显示结果不确定，或提示需要支持团队审核。

原因： Opera 可能拒绝已修改的档案详情、返回不完整的验证数据，或使写入结果变得未知。

解决方法：

  1. 不要立即重复合并。

  2. 在 Opera 中打开受影响的档案，确认哪个档案仍处于活动状态。

  3. 记录保留档案、已弃用档案 ID、预订号以及 AVA 显示的消息。

  4. 联系 Vouch 支持进行核对。

    ✓ 在支持团队确认 Opera 状态前，AVA 会继续阻止不确定的操作。

Opera 路由阻止共享住客转换​

你会看到： 看似符合条件、成人数和儿童数均为零的共享住客无法转换为陪同住客。

原因： AVA 只允许所有目标都指向保留主预订的房间路由。 账单明细或 comp 路由、其他预订目标以及不受支持的路由结构均不符合条件。

解决方法：

  1. 在 Opera 中打开共享住客预订和主预订。

  2. 检查共享住客的每个出站路由目标。

  3. 移除不受支持的路由，或将所有费用路由到保留的主预订。

  4. 在 AVA 中刷新预订，然后再次登记住客。

    ✓ AVA 会在取消旧共享住客预订前重新检查路由。

Opera 共享住客的房间附加被阻止​

现象： 住客同步后房间附加停止，或 Opera 显示附加错误。

原因： AVA 无法验证关联共享住客、预订身份或主住客档案。 AVA 会停止操作，而不是创建陪同档案或重写主住客列表。

解决方法：

  1. 在 Opera 中打开主预订和关联共享住客。

  2. 确认共享链接指向同一预订家庭。

  3. 确认共享住客有主住客档案。

  4. 在 AVA 中刷新预订。

  5. 重试房间附加。

    ✓ Opera 确认请求的放置方式后，AVA 才会附加房间。

不会修复现有重复关系

此保护机制会阻止新的重复关系。 它不会移除 Opera 中已有的重复档案，也不会修正已存储的成人和儿童入住人数。 更改住客放置设置前，请让支持团队检查现有重复关系。

住客转换后登记仍处于待处理状态​

你会看到： 现有住客转换后登记未完成。 住客文件尚未发送到 Opera。

原因： AVA 正在等待 Opera 确认新的住客放置方式。 这样可以避免将文件发送到旧的或错误的住客档案。

解决方法：

  1. 等待 Opera 完成预订更新。

  2. 在 AVA 中刷新预订。

  3. Opera 显示已确认的住客放置方式后，再次尝试登记。

  4. 在 Opera 中检查住客档案或预订附件。

    ✓ 只有在确认的 Opera 标识符保存后，AVA 才会发送文件。

不要使用旧的 Opera 档案

登记待处理期间，不要手动将文件上传到之前的档案。 如果待处理状态持续，请让前台在 Opera 中检查预订。

已完成的转换不会撤销

关闭复选框只会阻止未来的转换。 它不会恢复 Opera 中已经转换的关系。

一保存 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. 对于最近的外部 Opera 更改，等待最多五秒使其显示。
  4. 在 AVA 中刷新预订。
  5. 等待 Opera 完成账单明细（folio）更新。
  6. 如果余额仍未确认，请联系前台或支持团队。

ETA 不更新​

你会看到： 预订仍显示旧的到达或离店时间。

解决方法：

  1. 在 Opera 中打开预订。
  2. 如果住客是共享住客，请检查共享住客自己的预订。
  3. 如果该字段仅对主住客可见，请检查规范主住客的值。
  4. 确认预计时间已保存到正确的预订中。
  5. 更新同步后刷新 Operations View。
  6. 如果时间来自住客表单，请确认对应的时间字段已启用。
  7. 如果仍未显示，请检查 Opera 连接，并在几分钟后重试。
共享住客时间保留在共享住客预订中

AVA 不会将共享住客的预计时间复制到主预订。 仅对主住客可见的字段可以从规范主住客为共享住客提供缺失值。 这样可以让每位住客的到达和离店详情保留在其自己的 Opera 入住记录中。

多房间房卡看起来为空​

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

解决方法：

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

Opera 共享住客显示为第二个房间​

你会看到： 一个 Opera 预订在 AVA 中显示为两个房间结果。

原因： Opera 可能会为同一个实体房间返回主预订和关联的共享住客。

AVA 会将多余的零入住人数共享住客归入包含完整住客信息的房间。 具有住客进度、付款、账单或入住状态的记录仍会显示。

解决方法：

  1. 在 AVA 中刷新预订。

  2. 在 Opera 中确认重复记录使用相同的实体房间和入住日期。

  3. 检查两条记录是否有住客进度、付款、账单或入住活动。

  4. 从包含完整住客信息的房间结果继续操作。

  5. 如果两个房间结果仍然存在且没有独立活动，请联系支持团队。

    ✓ 多余的 Opera 共享住客应显示在一个实体房间结果中。

真正的双房间预订仍会分开

AVA 不会合并分配到不同实体房间或不同共享组的预订。

Opera 将错误的房间分组​

你会看到： 多房间查找包含无关房间，或缺少关联房间。

原因： 原生分组使用 Opera 的关联家庭和日期重叠的入住记录。 已取消、未到店、已退房、虚拟房间以及日期不重叠的记录会被排除。

解决方法：

  1. 在 Opera 中打开所有受影响的预订。

  2. 确认这些预订属于同一个原生关联家庭。

  3. 检查入住日期至少有一晚重叠。

  4. 确认房间未被取消、未到店、已退房，也不是虚拟房间。

  5. 保存 Opera 更正后，在 AVA 中刷新预订。

  6. 如果家庭仍然不正确，请联系支持团队。

    ✓ AVA 应为每个符合条件的实体房间显示一个结果。

SiteMinder 回退机制

没有原生 Opera 链接的 SiteMinder 组件使用其完全一致的外部参考号。 相似的住客档案、到店日期或预订参考号不会将无关预订合并。

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

你会看到： 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 对普通房间和无关的自动选择房间使用现有的房间分配路径。

Opera 智能分配跳过空房间​

你会看到： 房间今天显示为空，但智能房间分配选择了另一个房间。

原因： 在这位住客的入住时间范围内，该房间已分配给其他预订。 即使房间今天实际为空，AVA 也会保护其他预订。

解决方法：

  1. 在 AVA 中检查请求的到店和离店日期。

  2. 在 Opera 中打开该房间的重叠预订。

  3. 确认该预订是否应保留该房间。

  4. 在 AVA 中刷新预订，然后重试分配。

  5. 只有确认重叠预订后，才手动分配该房间。

    ✓ 智能分配会选择当前已准备好且在请求的完整入住期间可用的房间。

Opera 记录暂时延迟

如果 AVA 无法读取重叠的 Opera 预订，Opera 仍会在分配期间检查冲突。 如果 Opera 拒绝了存在冲突的房间，AVA 可以重试另一个候选房间。

Opera 合规报告值被遮蔽​

请让 Opera 管理员启用 Module Level Access Control，并向 AVA OHIP 客户端授予 Sensitive Data Access。确认权限适用于正确的 Opera 酒店后，再重新生成报告。AVA 会排除被遮蔽的护照值和 1800-01-01 出生日期占位值。

到店日房间显示错误的状态标记​

当 Opera 将已入住预订报告为 Due Out 时，AVA 会在预订和每张已占用房卡上显示 Due Out。Reserved、Checked Out、Cancelled 和 No Show 等明确房间状态保持不变。

不提供更高房型​

只有在酒店的房型政策允许升级、已订房型在整个入住期间都没有准备好的房间，并且更高房型有库存且已准备就绪时，AVA 才会显示升级选项。刷新预订后重新打开房间分配。

房型换房计划被拒绝​

AVA 会在执行前重新检查每晚库存和房间状态。若其他预订发生变化，或目的房间受到 Do Not Move、Out of Order 或酒店配置的阻止提醒保护，计划就会被拒绝。刷新 AVA 后选择仍符合条件的房间。

Opera 拒绝必需的换房​

如果 Opera 将预订标记为 Do Not Move，需要换到其他房间的操作会失败。AVA 会保留当前房间，不会报告虚假的成功。只有在 Opera 确认房间可移动后，才应解除锁定并重试。

共享房间不应参与换房​

如果房间由住客家庭中的其他预订占用，或由多个预订共享，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 身份管理模式
  • 问题开始的时间
  • 你已经尝试过的步骤