对接 Yeastar P 系列软件版 和 Oracle Hospitality OPERA

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

准备工作

重要: 为保证对接成功,且对接功能可用,请先仔细阅读以下对接要求和对接建议,并完成相关任务。
对接要求
环境 要求
Yeastar
  • PBX 版本83.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. 点击 保存

执行结果