申瓯程控交换机酒店PMS接口
发布日期：2021-08-29 浏览次数：9765
一、串口转发方式
1.要设置为串口转发及等级设定模式，进入“话台参数”->“话单转发”->“串口转发”，设置成“转发”。
话单转发及等级设定的串口不能和话务台与主机的通信串口冲突，否则转发无效。例如，若话务台与主机
的通信串口为com1，则话单转发的串口可以为com2。
1.1.☆话单转发串口通信协议
波特率 2400, 无校验位, 数据位 8, 停止位 2
=
2.话单格式
2.1 话单格式1
T始话 时长 主叫 内线号码 被叫 话单类型 话费 (回车换行)
采用ASCII码，每条话单以特定字母（T或C）打头，以回车换行(0D 0A)结尾，每项占据固定宽度，均为左对齐。
例如
T20050920083428 000324 8012 8012 02134567890 02 0.50 (回车换行)
(注意每条话单结尾处有回车换行)
始话：2005年09月20日08时34分28秒 宽度:15(字母T除外)
时长：00时03分24秒 宽度:7
主叫：8012 宽度:16
内线号码：8012 宽度:8
被叫：02134567890 宽度:24
话单类型：02 宽度:3(00:国际长途;01:港澳台;02:国内长途;03:长途手机;04:特服电话;05:本地网电话;06:传呼;07:手机市话;08:一般市话;09:内线电话;10:IP国际长途;11:IP国内长途;12:呼入电话; 13:免费电话; 14:汇接电话; 19：未接电话)
话费：0.50 宽度:8
2.2 话单转发格式2(增加中继号) (USO版本 > 9.75， 设置参数 ..\Data\2000Hwt.cxf -> [Trans] -> TType=1 )
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
2.3 话单转发格式3(由主控决定)
C始话时间 结束时间 通话时长 主叫 内线号码 被叫 中继号 话单类型 话费 (回车换行)
采用ASCII码，每条话单以C打头，以回车换行(0D 0A)结尾，每项占据固定宽度，均为左对齐。
例如
C20050920083428 20050920083752 000324 8012 8012 02134567890 1 02 0.50 (回车换行)
(注意每条话单结尾处有回车换行)
始话时间：2005年09月20日08时34分28秒 宽度:15(字母C除外)
结束时间：2005年09月20日08时34分28秒 宽度:15
时长：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.等级设定
以下为话务台软件的分机等级控制接口，指令由宾馆管理软件等传入，指令形式为ASCII码，每条指令以#结束(没有回车换行)
设定分机等级
Q10*P*XXXX# 设置XXXX分机的等级为P, XXXX为弹性编码
话务台的回答信号: R10*P*XXXX(回车换行，下同)
例如：Q10*3*8123# 设置8123分机的等级为3
R10*3*8123 已经设置成功
-------------------------------
4.叫醒服务
设定叫醒服务
Q06*HHMM*XXXX# 设置XXXX分机的叫醒时间为HH:MM, XXXX为弹性编码
话务台的回答信号: R06*HHMM*XXXX
叫醒成功: R98*HHMM*XXXX
叫醒失败: R99*HHMM*XXXX
例如：Q06*0750*8000# 设置8000分机的叫醒时间为07:50
R06*0750*8000 已经设置成功
Q06**8000# 清空8000分机的叫醒时间
R06**8000 已经设置成功
-------------------------------
5.免打扰设置
①设定免打扰设置
Q92*P*XXXX# 设置XXXX分机的免打扰开关(P:0-关 1-开)，XXXX为弹性编码
话务台的回答信号: R92*P*XXXX
例如：Q92*1*8012# 设置8012分机的免打扰开关为开
R92*1*8012 已经设置成功
注意：区分内线免打扰和外线免打扰功能的机型（主控程序一般在10.5500~11.000之间）以上命令作内线免打扰设置。
②设定外线免打扰设置
Q93*P*XXXX# 设置XXXX分机的免打扰开关(P:0-关 1-开)，XXXX为弹性编码
话务台的回答信号: R93*P*XXXX
例如：Q93*1*8012# 设置8012分机的免打扰开关为开
R93*1*8012 已经设置成功
-------------------------------
6.留言开关设置
设定留言开关设置
Q63*P*XXXX# 设置XXXX分机的留言开关(P:0-关 1-开)，XXXX为弹性编码
话务台的回答信号: R63*P*XXXX
例如：Q63*1*8012# 设置8012分机的留言开关为开
R63*1*8012 已经设置成功
-------------------------------
7.清除留言设置
清除留言
Q64*P*XXXX# 清除XXXX分机的留言(P=0表示清除)，XXXX为弹性编码
话务台的回答信号: R64*P*XXXX
例如：Q64*0*8012# 清除8012分机的留言
R64*0*8012 已经清除成功
-------------------------------
8.分机语音属性设置
设定【语音属性】设置
Q55*P*XXXX# 设置XXXX分机的语音属性(P: 0/1/2/3/4/5/6/7 中文/英语/法语/德语/葡萄牙语/韩语/日语/俄语)，XXXX为弹性编码
话务台的回答信号: R55*P*XXXX
例如：Q55*1*8012# 设置8012分机的语音属性为英语
R55*1*8012 已经设置成功
设定【语音属性2】设置 需主控版本支持（ver.=10.5500~11.0000；不同机型支持语音个数不同，以实际机型为准）
Q55*P*XXXX# 设置XXXX分机的语音属性(P: 0/1/6/7/8/9/10/11/12 中文/英语/法语/西班牙语/韩语/日语/俄语/自定义1/自定义2)，XXXX为弹性编码
话务台的回答信号: R55*P*XXXX
例如：Q55*1*8012# 设置8012分机的语音属性为英语
R55*1*8012 已经设置成功
-------------------------------
9.房态MINI吧格式
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”为功能字头)
------------------------------
10.信息话机设置
设定用户信息
设定：必须至少发送三条协议，包括1、2、3的头一条协议。（Q45*0*XXXX*性别*姓名#、Q45*1*XXXX*电话1*电话2#、Q45*2*XXXX*备注#），否则将可能出现显示不全的问题。
1)
Q45*0*XXXX*性别*姓名# XXXX为弹性编码，性别：1/2 男/女，姓名：最长10个字符（五个汉字）
R45*0*XXXX*性别*姓名
例： Q45*0*8000*1*李四#
R45*0*8000*1*李四
2)
Q45*1*XXXX*电话1*电话2# XXXX为弹性编码，电话号码：最多18个字符
R45*1*XXXX*电话1*电话2
例： Q45*1*8000*88228899*13566889999#
R45*1*8000*88228899*13566889999
3)
Q45*MM*XXXX*备注# XXXX为弹性编码，备注信息：最多128字符，每次截取32个字符（16个汉字）发送，按实际长度控制发送次数
MM : 2/3/4/5 32*4=128字节
R45*MM*XXXX*备注
例：备注信息为申瓯通信设备有限公司数字交换机信息话机，则发送如下：
Q45*2*8000*申瓯通信设备有限公司数字交换机信#
R45*2*8000*申瓯通信设备有限公司数字交换机信
Q45*3*8000*息话机#
R45*3*8000*息话机
------------------------------
11.内线通讯录转发接口(部分机型拥有此功能)
1)修改但未下载
Q46*0*XXXX*PPPP# // PPPP：通讯录名，最大13字符
2)确认下载，即话务台开始排序下载
Q46*1*0*0#
下载成功后回送：R46*0*XXXX*内线通讯录姓名，只回送有通讯录名字的，无通讯录名字的不回送
例：
Q46*0*8001*Tom#
Q46*0*8003*Lucy#
Q46*0*8002*James#
确认下载：发 Q46*1*0*0#
下载成功后回送：
R46*0*8002*James
R46*0*8003*Lucy
R46*0*8001*Tom
注：未发确认下载，命令不会生效
12.网络转发
通信协议同串口转发协议
12.1 通信协议
TCP，本端模式TCP Client, 固定连接至TCP Server 3721端口。
12.2 心跳（可选） USO每隔20秒发起一次，发送R02；第三方软件需回复Q02#。
二、文件保存方式
1.要设置话单保存为文件的模式，进入“话台参数”->“话单转发”，选中“保存话单为文件”项，然后指定话单文件保存的路径。
2.话单文件以每日为单位产生，以“yyyymmdd.txt”形式命名，其中yyyy表示年份，mm表示月份，dd表示日。
3.话单格式
T始话 时长 主叫 内线号码 被叫 话单类型 话费 (回车换行)
每条话单以T打头，以回车换行(0D 0A)结尾，每项占据固定宽度，均为左对齐。
例如
T20050920083428 000324 8012 8012 02134567890 02 0.50 (回车换行)
(注意每条话单结尾处有回车换行)
始话：2005年09月20日08时34分28秒 宽度:15(字母T除外)
时长：00时03分24秒 宽度:7
主叫：8012 宽度:16
内线号码：8012 宽度:8
被叫：02134567890 宽度:24
话单类型：02 宽度:3宽度:3(00:国际长途;01:港澳台;02:国内长途;03:长途手机;04:特服电话;05:本地网电话;06:传呼;07:手机市话;08:一般市话;09:内线电话;10:IP国际长途;11:IP国内长途;12:呼入电话; 13:免费电话; 14:汇接电话; 19：未接电话)
话费：0.50 宽度:8
