技术专区为您提供行业知识、功能解释、设置常见问题
========================== 酒店接口 V3.32.=========================
前言:文档中酒馆软件等第三方对接软件用 PMS 表示,话务台用国威IPPBX电话交换机 HB8000 表示。
===============================================================
1. 转接方式
1.1 串口转发方式:
1.1.1 设置方式,话务台进入 [ 系统设置 ]->[ 数据转发 ]->[ 串口转发 ] ,选中“转发给”,并选中实际的转发串口号。
1.1.2 转发串口通信参数
波特率 2400, 无校验位 , 数据位 8, 停止位 2
1.2 网口转发方式:
1.2.1: 设置方式,话务台进入 [ 系统设置 ]->[ 数据转发 ]->[ 网络转发 ] ,选中“转发”,在“目标机器名”中设定对端(酒管软件所在电脑 )IP 地址、点击 [ 测试连接 ] ,测试连接情况。
1.2.2: 网络通信参数:采用 TCP 连接方式,本端模式 TCP Client, 固定连接至 TCP Server 3777 端口。
1.2.3 :心跳(可选)国威IPPBX电话交换机 HB8000 每隔 20 秒发一次,发送 R22 ;第三方软件需回复 Q22# , 3 次收不到,将进行自动重连。
1.3 文件保存方式 [ 仅用于保存话单 ] :
1.3.1 设置方式,话务台进入 [ 系统设置 ]->[ 数据转发 ] ,选中“话单保存”项,然后指定话单文件保存的路径。
1.3.2. 话单文件以每日为单位产生,以“ yyyymmdd.txt ”形式命名,其中 yyyy 表示年份, mm 表示月份, dd 表示日。
--------------------------------------------------------------
2. 话单格式
2.1 话单格式
国威IPPBX电话交换机 HB8000->PMS
T 始话 时长 主叫 内线号码 被叫 话单类型 话费 ( 回车换行 )
采用 ASCII 码,每条话单以特定字母( T 或 C )打头,以回车换行 (0D 0A) 结尾,每项占据固定宽度,均为左对齐。
T 始话 时长 主叫 内线号码 被叫 话单类型 话费 ( 回车换行 )
采用 ASCII 码,每条话单以 T 打头,以回车换行 (0D 0A) 结尾,每项占据固定宽度,均为左对齐。
例如
T20050920083428 000324 8012 8012 02134567890 1 02 0.50 ( 回车换行 )
( 注意每条话单结尾处有回车换行 )
始话: 2005 年 09 月 20 日 08 时 34 分 28 秒 宽度 :15( 字母 T 除外 )
时长: 00 时 03 分 24 秒 宽度 :7
主叫: 8012 宽度 :16
内线号码: 8012 宽度 :8
被叫: 02134567890 宽度 :24
中继号: 1 宽度 :8( 内线电话则中继号为 0)
话单类型: 02 宽度 :3(00: 国际长途 ;01: 港澳台 ;02: 国内长途 ;03: 长途手机 ;04: 特服电话 ;05: 本地网电话 ;06: 传呼 ;07: 手机市话 ;08: 一般市话 ;09: 内线电话 ;10:IP 国际长途 ;11:IP 国内长途 ;12: 呼入电话 ; 13: 免费电话 ; 14: 汇接电话 ; 19 :未接电话 )
话费: 0.50 宽度 :8
--------------------------------------------------------------
3. 等级设定
以下为话务台软件的分机等级控制接口,指令酒店管理软件等(下文用 PMS 表示)传入,指令形式为 ASCII 码,每条指令以 # 结束 ( 没有回车换行 )
设定分机等级
PMS-> 国威IPPBX电话交换机 HB8000: 01*P*XXXX# 设置 XXXX 分机的等级为 P, XXXX 为弹性编码
国威IPPBX电话交换机 HB8000->PMS: R10*P*XXXX( 回车换行,下同 )
例如: Q01*3*8123# 设置 8123 分机的等级为 3
R01*3*8123 已经设置成功
--------------------------------------------------------------
4. 叫醒服务
设定叫醒服务
PMS-> 国威IPPBX电话交换机 HB8000: Q02*HHMM*XXXX# 设置 XXXX 分机的叫醒时间为 HH:MM, XXXX 为弹性编码
国威IPPBX电话交换机 HB8000->PMS: R02*HHMM*XXXX
国威IPPBX电话交换机 HB8000->PMS: R28*HHMM*XXXX 叫醒成功
国威IPPBX电话交换机 HB8000->PMS: R29*HHMM*XXXX 叫醒失败
例如: Q02*0750*8000# 设置 8000 分机的叫醒时间为 07:50
R02*0750*8000 已经设置成功
Q02**8000# 清空 8000 分机的叫醒时间
R02**8000 已经设置成功
--------------------------------------------------------------
5. 免打扰设置
5.1 设定内线免打扰设置
PMS-> 国威IPPBX电话交换机 HB8000: Q03*P*XXXX# 设置 XXXX 分机的免打扰开关 (P:0- 关 1- 开 ) , XXXX 为弹性编码
国威IPPBX电话交换机 HB8000->PMS: R03*P*XXXX
例如: Q03*1*8012# 设置 8012 分机的免打扰开关为开
R03*1*8012 已经设置成功
5.2 设定外线免打扰设置
PMS-> 国威IPPBX电话交换机 HB8000: Q04*P*XXXX# 设置 XXXX 分机的免打扰开关 (P:0- 关 1- 开 ) , XXXX 为弹性编码
国威IPPBX电话交换机 HB8000->PMS: R04*P*XXXX 已经设置成功
例如: Q04*1*8012# 设置 8012 分机的免打扰开关为开
R04*1*8012 已经设置成功
--------------------------------------------------------------
6. 分机语音属性设置
6.1 设定【语音属性】设置
PMS-> 国威IPPBX电话交换机 HB8000: Q07*P*XXXX# 设置 XXXX 分机的语音属性 (P: 0/1/2/3/4/5/6/7 中文 / 英语 / 法语 / 德语 / 葡萄牙语 / 韩语 / 日语 / 俄语 ) , XXXX 为弹性编码
国威IPPBX电话交换机 HB8000->PMS: R07*P*XXXX
例如:
Q07*1*8012# 设置 8012 分机的语音属性为英语
R07*1*8012 已经设置成功
6.2 设定【语音属性 2 】设置
PMS-> 国威IPPBX电话交换机 HB8000: Q08*P*XXXX# 设置 XXXX 分机的语音属性 (P: 0/1/6/7/8/9/10/11/12 中文 / 英语 / 法语 / 西班牙语 / 韩语 / 日语 / 俄语 / 自定义 1/ 自定义 2) , XXXX 为弹性编码
国威IPPBX电话交换机 HB8000->PMS: R08*P*XXXX
例如: Q08*1*8012# 设置 8012 分机的语音属性为英语
R08*1*8012 已经设置成功
--------------------------------------------------------------
7. 房态 MINI 吧格式
国威IPPBX电话交换机 HB8000->PMS
F 时间 分机物理号 分机弹编 数据 帐号 ( 回车换行 )
采用 ASCII 码,每条记录以 F 打头,以回车换行 (0D 0A) 结尾,每项占据固定宽度,均为左对齐。
例如
F20110620153028 2 8002 11*12*23*56 20 ( 回车换行 )
( 注意每条记录结尾处有回车换行 )
时间: 2011 年 06 月 20 日 15 时 30 分 28 秒 宽度 :15( 字母 F 除外 )
分机物理号: 2 宽度 :8
分机弹编: 8002 宽度 :16
数据: 11*12*23*56 宽度 :35 (可记录多个代码,用 * 号间隔)
帐号: 20 宽度 :8 (65535 表示没有帐号 )
=============================== 话机操作 ==================================
在话务台 - 系统参数设置 是否 房态 / 迷你吧消费登陆帐号
---------- 设置为 是,则话机输入为(先登入帐号): * 账号 * 密码 #141 代码 * 代码 *~~~* 代码 #
---------- 设置为 否,则话机输入为: 141 代码 * 代码 *~~~* 代码 #
代码包括星号***多输入 30 位,多个代码用星号隔开,***个“ 1 ”为功能字头 )
===============================================================================
8. 信息话机设置
设定用户信息
设定:必须至少发送三条协议,包括 1 、 2 、 3 的头一条协议。( Q09*0*XXXX* 性别 * 姓名 # 、 Q09*1*XXXX* 电话 1* 电话 2# 、 Q09*2*XXXX* 备注 # ),否则将可能出现显示不全的问题。
8.1 设定用户性别和姓名
PMS-> 国威IPPBX电话交换机 HB8000: Q09*0*XXXX* 性别 * 姓名 # XXXX 为弹性编码,性别: 1/2 男 / 女,姓名:***长 10 个字符(五个汉字)
国威IPPBX电话交换机 HB8000->PMS: R09*0*XXXX* 性别 * 姓名
例: Q09*0*8000*1* 李四 #
R09*0*8000*1* 李四
8.2 设定用户联系方式 1 和联系方式 2
PMS-> 国威IPPBX电话交换机 HB8000: Q09*1*XXXX* 联系方式 1* 联系方式 2# XXXX 为弹性编码,联系方式号码:***多 18 个字符
国威IPPBX电话交换机 HB8000->PMS: R09*1*XXXX* 联系方式 1* 联系方式 2
例: Q09*1*8000*88228899*13566889999#
R09*1*8000*88228899*13566889999
8.2 设置用户备注信息
PMS-> 国威IPPBX电话交换机 HB8000: Q09*MM*XXXX* 备注 # XXXX 为弹性编码,备注信息:***多 128 字符,每次截取 32 个字符( 16 个汉字)发送,按实际长度控制发送次数 MM : 2/3/4/5 32*4=128 字节
国威IPPBX电话交换机 HB8000->PMS: R09*MM*XXXX* 备注
例:备注信息为富强民主文明和谐倡导自由平等公正法治倡导爱国敬业诚信友善,则发送如下:
Q09*2*8000* 富强民主文明和谐倡导自由平等公正 #
R09*2*8000* 富强民主文明和谐倡导自由平等公正
Q09*3*8000* 法治倡导爱国敬业诚信友善 #
R09*3*8000* 法治倡导爱国敬业诚信友善