申甌程控交換機酒店PMS接口
發布日期：2021-08-29 瀏覽次數：5264
一、串口轉發方式
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
