对接 Yeastar P 系列 IPPBX 和 Oracle Hospitality OPERA

本文介绍如何对接 Yeastar P 系列 IPPBX 和 Oracle Hospitality OPERA。

准备工作

重要： 为保证对接成功，且对接功能可用，请先仔细阅读以下对接要求和对接建议，并完成相关任务。
对接要求
环境 要求
Yeastar
  • PBX 版本：37.11.0.56 或更高
  • PBX 订阅服务：酒店 PMS 集成
    提示： Yeastar 提供付费订阅和 30 天的免费试用。你可以进入 订阅服务，按需试用或订阅此服务。
Oracle
注：
  • 建议联系 PMS 供应商，将你的 Oracle 环境升级到以下版本或更高版本。
  • IFC8 和 Yeastar PBX 必须处于同一局域网中。
  • PMS 版本：OPERA 5 (版本 5.6) 或 OPERA Cloud
  • IFC8 版本：8.15.0.0
  • FIAS 版本：2.20.25
对接建议
  • 在 PBX 管理网页上将所有客房分机添加到指定分机组中，后续对接过程中你需要按分机组来指定与 OPERA PMS 进行交互的分机。
    提示： 你可以将所有客房分机添加至同一个分机组，也可以按照客房类型 / 楼层/或其他任意方式进行分组。

    更多信息，请参见 创建分机组。

  • 在 PBX 管理网页上录制或上传自定义提示音，后续对接过程中你需要指定客人接听叫醒电话时播放的提示音。

    更多信息，请参见 录制自定义提示音 和 上传自定义提示音。

操作步骤

  1. 访问 PMS 集成页面。

    1. 登录 PBX 管理网页，进入 应用对接 > PMS集成。
    2. 点击右上角的 集成。
  2. 启用 PMS 集成，然后填写 OPERA PMS 的 IP 地址 / 域名和端口。
    注： 用户无法在 OPERA PMS 上查看 IP 地址 / 域名和端口，因此请联系你的 PMS 提供商获取相关信息。

    1. 打开 PMS集成 的开关。
    2. 在 PMS地址 和 端口 栏，填写 OPERA PMS 的 IP 地址 / 域名和端口。
  3. 在 酒店客房分机组 栏，选择客房分机所在的分机组。

    注：
    • 下拉列表中的分机组从 分机和中继 > 分机组 同步而来。
    • 特定事件 (如房客入住) 发生时，只有指定分机组中的分机能与 OPERA PMS 自动同步。
  4. 在 叫醒服务 栏，设置叫醒服务的全局呼叫规则。
    注： 要向客人提供叫醒服务，你需要在 OPERA PMS 中设置叫醒时间和频率，PBX 将从 PMS 同步闹钟设置，并根据以下规则在指定时间自动拨打客房电话。

    关于叫醒服务示例，请参见 叫醒服务。

    配置项 说明
    超时时间 (秒) 设置叫醒电话的响铃超时时间 (单位：秒)。
    • 默认值：20
    • 有效值：5 到 300
    重复响铃次数 选择客人未接听叫醒电话时的重复响铃次数。
    • 默认值：0 (表示只响铃话机一次)
    • 有效值：1、2、 3
    响铃间隔时间 (分钟) 设置重复响铃的间隔时间 (单位：分钟)。
    • 默认值：10
    • 有效值：1 到 30
    提示音

    选择客人接听叫醒电话时播放的提示音。

    你可以从下拉列表中选择现有提示音，或者点击 上传 上传自定义提示音。

    注： 下拉列表中的提示音从 PBX 设置 > 提示音 > 自定义提示音 同步而来。
  5. 在 计费 栏，为外线通话和迷你吧选择计费类型。
    1. 在 通话计费类型 栏，为外线通话指定计费类型。
      注： 要对客人的外线通话进行计费，你需要在 PBX 上指定计费类型，并在 PBX 或 PMS 上添加通话计费规则。客人挂断外线通话后，PBX 会发送相关信息到 PMS。

      关于通话计费示例，请参见 通话计费。

      选项 说明
      基于目的地和总费用

      Yeastar PBX 对外线通话进行计费。

      客人挂断外线通话后，PBX 先根据系统上的费率规则计费，再发送 被叫号码、通话时长 和 总费用 给 OPERA PMS。
      注： 如果你选择此计费类型，你需要在 PBX 上添加费率规则。更多信息，请参见 添加费率规则。
      基于目的地和时长
      注： OPERA Cloud 由于自身限制，不支持此计费类型。

      OPERA PMS 对外线通话进行计费。

      客人挂断外线电话后，PBX 发送 被叫号码 和 通话时长 给 OPERA PMS，PMS 自行计费。
    2. 在 迷你吧计费类型 栏，指定迷你吧的计费类型。
      注： 要对客人的迷你吧消费进行计费，你需要在 PMS 上添加商品，并在 PBX 上配置迷你吧特征码、指定计费类型。当酒店员工通过客房话机拨打特定的特征码时，PBX 会发送相关信息到 PMS。

      关于迷你吧计费的示例，请参见 迷你吧计费。

      选项 说明
      基于总金额

      酒店员工 计算迷你吧消费金额。

      酒店员工计算好迷你吧消费金额后，通过客房话机拨打 {minibar_feature_code}{total_amount}，PBX 会同步此客房的迷你吧消费金额到 PMS，并计入客人账单中。
      注： {minibar_feature_code} 指迷你吧特征码，{total_amount} 指消费金额。
      基于种类和数量

      OPERA PMS 计算迷你吧消费金额。

      酒店员工通过客房话机拨打 {minibar_feature_code}*{item_code}*{quantity}，PBX 会将客人消费的迷你吧商品和对应数量同步到 PMS，PMS 自行计费并同步到客人账单中。
      注： {minibar_feature_code} 指迷你吧特征码，{item_code} 指商品代码，{quantity} 指商品数量。
  6. 点击 保存。

执行结果