TalenTel-PMSI酒店管理系統接口協議說明2.pdf
下載文檔
上傳人:地**
編號:1262828
2024-11-21
19頁
260.61KB
1、 文件編號:文件編號:UTUT-TALENTELTALENTEL-PMSIPMSI-002002 文件名稱:文件名稱:TalenTelTalenTel-PMSIPMSI 酒店管理系統接口協議說明(酒店管理系統接口協議說明(V3.11V3.11)創建日期:創建日期:20052005-0606-0101 修改日期:修改日期:20122012-0202-2222 保密級別:中保密級別:中 目 錄 修改歷史記錄.3 一、系統說明.4 1、系統簡介.4 2、主要功能說明.4 3、基本通信方式.4 二、PMSI 接口協議說明.5 1、總體說明.5 2、具體接口協議說明.6 TalenTel-PMSI 酒店2、管理系統接口協議說明 機密 第 3 頁 2/22/2012 強訊科技強訊科技 修改歷史記錄修改歷史記錄 一、2009-8-20 1、增加夜審消息 2、在前臺迷你吧消息報文中增加日期和時間項 二、2010-2-8 3、在前臺留言點燈消息中,增加了主叫號碼的參數選項 4、在 CHECK IN 消息中,增加了 CODETYPE 的參數選項,以標識號碼類型 注:本文本中所有協議中的標點符號,在實際應用中,增應為英文半角字符 三、2012-02-22 5、在與酒管系統的通信協議中,為串行口通信增加 BCC 校驗功能 TalenTel-PMSI 酒店管理系統接口協議說明 機密 第 4 頁 2/22/2013、2 強訊科技強訊科技 一、系統說明一、系統說明 1 1、系統簡介、系統簡介 TalenTel-PMSI軟件是一套連接酒店管理系統(PMS)與酒店通信服務系統的中間系統,它接收酒店管理系統發來的各種指令,對指令進行分析后,將指令轉換為對其它通信設備的指令,并將結果返回給酒店管理系統。對于通信服務系統要發給酒店管理系統的消息,均先發給PMSI接口軟件,然后由PMSI軟件轉發給酒店管理系統(PMS),從而達到溝通前臺服務系統與后臺通信服務系統之間的目的。本文檔的目的在于詳細說明與酒店管理系統(PMS)之間的接口協議,此文檔的使用者是酒店管理系統(PMS)接口軟件的開發人員,按此協議進行開發,就可以與4、本公司的TalenTel-PMSI系統相連接并正常實現各項功能。2 2、主要功能說明、主要功能說明 本接口協議主要包括以下幾項功能:1、酒店客房電話控制協議(CHECK IN/OUT,DND 等)2、酒店客房統一消息服務控制協議(VMS、FAX、SMS)3、酒店叫醒系統接口控制協議(Morning Call System)4、酒店語音確認系統接口控制協議(MiniBar,房態確認)5、酒店計費系統數據接口協議(計費話單傳送)3 3、基本通信方式、基本通信方式 TalenTel-PMSI 接口對酒店管理系統支持兩種物理通信連接方式:網絡連接和串行口連接。在使用網絡連接時,接口使用 TCP/IP 5、協議中的 TCP 協議進行命令和信息傳遞。在使用串行口連接時,使用一種類似于 BSC 協議的通信控制協議。酒店管理系統每次發給 PMSI 的指令后,PMSI 均要給酒店管理系統一個回應,表示命令是接收正確,但并不表示命令執行成功,對于執行失敗的命令,PMSI 將給出消息。PMSI 發送給酒店管理系統的消息,酒店管理系統也可給出回響,以表示正確接收到 PMSI發送的消息數據。TalenTel-PMSI 酒店管理系統接口協議說明 機密 第 5 頁 2/22/2012 強訊科技強訊科技 二、二、PMSIPMSI 接口協議說明接口協議說明 1 1、總體說明、總體說明 以下協議說明為 TalenTel-6、PMSI 與酒店管理系統(PMS)的標準接口協議說明,有的酒店管理系統并不使用全部接口協議而只使用其中部分的接口協議,本協議說明中的每條命令都可以單獨使用,互相之間沒有影響。本協議附有一個測試使用的酒店管理系統接口方測試程序,模擬酒店管理系統的接口操作,測試程序向接口網關程序發送命令,并顯示 TalenTel-PMSI 發來的狀態數據信息。模擬測試時使用 TCP/IP 協議進行信息傳送。使用 TCP/IP 協議進行通信時,PMSI 系統可以作為服務器端,也可以作為客戶端,選擇在PMSI 的設置中選擇。所有通信幀都加有幀開始標識(STX,0 x02)和幀結束標識(ETX,0 x03)。協議具體說7、明如下文。如果使用串行口與酒店管理系統通信,系統有兩種模式,一種是不帶 BCC 校驗的通信模式,在這種模式下,系統不使用幀開始標識(STX,0 x02)和幀結束標識(ETX,0 x03),只使用回車換行(0X0D,0X0A)作為一條指令的結束標識,便于使用 WINDOWS 自帶的超級終端進行測試。在串行口通信中為保證數據傳輸的正確性,接收命令消息的一方,在分析完收到的命令后,如果各項數據正確,則應發送 ACK(0 x06)給發送命令的一方,如果各項數據有問題,則發送NAK(0 x15)給發送命令的一方,如果連續發送三次都失敗,則發送方不再進行發送,將失敗的命令記錄在日志中。另一種串行口通信模式8、是帶 BCC 校驗的通信模式,系統使用使用幀開始標識(STX,0 x02)和幀結束標識(ETX,0 x03),在最后增加一個字節,作為 BCC 上校驗,格式如下:STX(一個字節)數據項(多個字節)ETX(一個字節)BCC(一個字節)BCC 的校驗范圍從數據項開始(不包括 STX)到結束(包括 ETX),接收方進行校驗處理,如果發現校驗錯誤,則回 NAK 表示通信錯誤,如果校驗正確,則回 ACK 表示通信成功,如果連續發送三次都失敗,則發送方不再進行發送,將失敗的命令記錄在日志中。本說明中每條協議中由幾個數據項組成,每個數據項不一定都必要,接收系統對不認識的數據項可以不進行處理,發送系統對沒有9、的數據項也可以不進行發送,以達到系統之間最大的兼容性。TalenTel-PMSI 酒店管理系統接口協議說明 機密 第 6 頁 2/22/2012 強訊科技強訊科技 2 2、具體、具體接口協議說明接口協議說明 (1)入駐(由(由 PMS 系統發送給系統發送給 PMSI 統)統)CHECKIN;ROOM=XXXX;LEVEL=X;LANGUAGE=X;NAME1=XXX;NAME2=XXX;INFO=XXX;VMSNAME=XXXX;PASSWORD=XXX;FAX=XXX;SMS=XXXX;KEYCODE=XXX;OPID=XXX;CODETYPE=X;說明:CHECKIN:表示從酒店管理系統向10、接口網關程序發送的入駐命令。ROOM:表示入駐的房間號碼 LEVEL:房間分機級別 NAME1:客人姓名 1 NAME2:客人姓名 2 INFO:客人其它信息 LANGUAGE:表示開啟語音信箱時語音信箱的語種,1 中文 2 英文 3 德文 4 韓文 5 日文 VMSNAME:表示語音信箱用戶名稱 PASSWORD:表示語音信箱訪問密碼 FAX:傳真信箱號碼 SMS:移消息接收設備號碼,可以是移動電話或小靈通電話號碼 KEYCODE:幀序號(可選,用于處理異步返回結果)OPID:操作員工號,發現操作指令人員的標識 CODETYPE:房間號碼類型,0:表示分機號碼,1:表示房間號碼 返回結果:C11、HECKIN;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作結果,大于等于 0 表示成功,其它表示失敗 TalenTel-PMSI 酒店管理系統接口協議說明 機密 第 7 頁 2/22/2012 強訊科技強訊科技 (2)換房命令(由(由 PMS 系統發送給系統發送給 PMSI 統)統)CHANGEROOM;OLDROOM=XXXX;NEWROOM=XXX;KEYCODE=XX;OPID=XXX;說明:CHANGEROOM:換房命令 OLDROOM:表示舊的房間號碼 NEWROOM:表示新的房間號碼 KEYCODE:幀序號(可選,用于處理異步返回結果)OPID:操作員工號12、,發現操作指令人員的標識 返回結果:CHANGEROOM;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作結果,大于等于 0 表示成功,其它表示失敗 (3)前臺設置房間分機免打擾命令(由(由 PMS 系統發送給系統發送給 PMSI 統)統)RECEPTIONDND;DNDTEL=XXX;DNDTYPE=X;SDATE=XX;STIME=XX;EDATE=XX;ETIME=XX;TIMETYPE=X;OPID=XX;KEYCODE=XX;說明:RECEPTIONDND:前臺設置分機免打擾命令 DNDTEL:要設置分機免打擾的電話號碼 DNDTYPE:設置或取消分機免打擾,113、:表示設置,2:表示取消 SDATE:設定免打擾開始日期 yyyyMMdd EDATE:設定免打擾結束日期 yyyyMMdd STIME:設定免打擾開始時間,HHMMSS ETIME:免打擾開始結束時間,HHMMSS TIMETYPE:時間設定類型 0:表示在開始日期及時間設置 DND,在結束日期及時間取消 DND 如果 SDATE 或 STIME 為空表示即時設置 DND 1:表示從開始日期到結束日期的期間每天中,在開始時間設置 DND,TalenTel-PMSI 酒店管理系統接口協議說明 機密 第 8 頁 2/22/2012 強訊科技強訊科技 在結束時間取消 DND OPID:進行設定操作14、人員的工號 KEYCODE:幀序號(可選,用于處理異步返回結果)返回結果:RECEPTIONDND;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作結果,大于等于 0 表示成功,其它表示失敗 (4)設置房間分機等級(由(由 PMS 系統發送給系統發送給 PMSI 統)統)SETEXTCOS;ROOM=XXXX;TELLEVEL=X;OPID=XX;KEYCODE=XX;說明:SETEXTCOS:分機等級修改 ROOM:房間號碼 TELLEVEL:分機等級。0:內部;1:市話;2:長話;3:國際 OPID:進行設定操作人員的工號 KEYCODE:幀序號(可選,用于處理異步返15、回結果)返回結果:SETEXTCOS;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作結果,大于等于 0 表示成功,其它表示失敗 (5)前臺留言命令(由(由 PMS 系統發送給系統發送給 PMSI 統)統)RECEPTIONMSG;MSGTYPE=X;MSGTEL=XXX;OPID=XX;KEYCODE=XX;CALLER=XXX;說明:RECEPTIONMSG:前臺留言命令 MSGTYPE:留言類型,1:表示設置,2:表示取消 MSGTEL:要點亮留言燈的電話號碼 OPID:進行設定操作人員的工號 CALLER:設置點燈的回叫號碼,以被點燈話機回叫時,叫到正確的分機上。16、KEYCODE:幀序號(可選,用于處理異步返回結果)TalenTel-PMSI 酒店管理系統接口協議說明 機密 第 9 頁 2/22/2012 強訊科技強訊科技 返回結果:RECEPTIONMSG;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作結果,大于等于 0 表示成功,其它表示失敗 (6)前臺叫醒設置命令(由(由 PMS 系統發送給系統發送給 PMSI 統)統)WAKEUPSET;TEL=XXX;SDATE=XX;STIME=XX;TIMES=X;WTYPE=X;EDATE=XX;OPID=XX;KEYCODE=XX;說明:WAKEUPSET:前臺叫醒設置命令 TE17、L:被叫醒的電話號碼,SDATE:表示要叫醒的日期或要取消的叫醒的設置日期,格式為 8 位,如“20041015”表示 2004 年 10 月 15 日。一個分機設有多次叫醒時,取消時要以此日期 為準。STIME:表示要叫醒的時間或要取消的叫醒的設置時間。格式為 6 位,如“180705”,表示 18 時 07 分 05 秒。一個分機設有多次叫醒時,取消時要以此時間為 準。如果取消叫醒的操作沒有傳來 SDATE 及 STIME,則系統取消此分機 的所有叫醒設置。TIMES:叫醒操作的重試次數,如果是取消操作不用。WTYPE:設置操作類型,1:表示設置叫醒操作 2:表示取消叫醒設置操作 EDAT18、E:結束每天定時叫醒的日期,如果是取消操作不用。如果系統傳來了這 個參數,表示是設置從 SDATE 到 EDATE 之間,每天都在 STIME 時,進 行叫醒操作。如果沒有 EDATE 這個參數,則表示只設置一天的叫醒。如果是取消叫醒設置,則 EDATE 也是匹配查詢條件之一,如果要取消帶 EDATE 的叫醒設置,則在取消時必須也傳來正確的 EDATE。KEYCODE:幀序號(可選,用于處理異步返回結果)OPID:操作員工號,發現操作指令人員的標識 每條命令設置一個電話的叫醒,多個電話設置發送多條命令 TalenTel-PMSI 酒店管理系統接口協議說明 機密 第 10 頁 2/22/201219、 強訊科技強訊科技 返回結果:WAKEUPSET;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作結果,大于等于 0 表示成功,其它表示失敗 (7)前臺房態消息(由(由 PMSI 系統發送給系統發送給 PMS 系統)系統)ROOMSTATE;ROOMNUM=XXX;STATE=X;OPERATOR=XXX;KEYCODE=XXX;說明:ROOMSTATE:前臺房態消息 ROOMNUM:房間號 STATE:房間狀態,0 沒有準備好,1 已經準備好 OPERATOR:操作員代碼,進行房態輸入操作的服務員代碼 KEYCODE:幀序號(可選,用于處理異步返回結果)返回結果:ROO20、MSTATE;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作結果,大于等于 0 表示成功,其它表示失敗 (8)前臺迷你吧消息(由(由 PMSI 系統發送給系統發送給 PMS 系統)系統)MINBARMSG;ROOMNUM=XXX;GOODTYPE=XXX;GOODNUM=XX;MONEY=XXX;OPERATOR=XX;SDATE=YYYYMMDD;STIME=HHMMSS;KEYCODE=XXX;說明:MINBARMSG:前臺迷你吧消息 ROOMNUM:房間號 GOODTYPE:物品種類或編碼 GOODNUM:物品數量 MONEY:消費數額 OPERATOR:操作員代21、碼,進行迷你吧輸入操作的服務員代碼 SDATE:表示操作日期,格式為 YYYYMMDD,如 20090820 表示 2009 年 8 月 20 日 STIME:表示操作時間,格式為 HHMMSS,如 163024 表示 16 點 30 分 24 秒 TalenTel-PMSI 酒店管理系統接口協議說明 機密 第 11 頁 2/22/2012 強訊科技強訊科技 KEYCODE:幀序號(可選,用于處理異步返回結果)每條消息送出一種物品的情況,多種物品使用多條消息有的酒店管理系統要求直接送出客房消費的金額,則使用 MONEY 選項進行傳送。注意:金額內可能包含小數。語音程序在與用戶交互時要能輸入此金22、額。返回結果:MINBARMS;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作結果,大于等于 0 表示成功,其它表示失敗 (9)離店(由(由 PMS 系統發送給系統發送給 PMSI 統)統)CHECKOUT;ROOM=XXXX;SAVEMSG=X;MSGPROMPT=X;KEYCODE=XXX;OPID=XX;說明:CHECKOUT:表示從酒店管理系統向接口網關程序發送的離店命令。ROOM:房間號碼 SAVEMSG:留言保留天數,此值為 0 表示語音信箱不保留未聽留言。MSGPROMPT:有留言是否提示,1 表示提示,0 表示不提示。如果提示,會收到VMSRESULT 23、消息。VMS 系統收到 CHECKOUT 后,應取消與此分機相關的所有叫醒設置。KEYCODE:幀序號(可選,用于處理異步返回結果)OPID:操作員工號,發現操作指令人員的標識 返回結果:CHECKOUT;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作結果,大于等于 0 表示成功,其它表示失敗 (10)分機狀態測試結果(由(由 PMSI 系統發送給系統發送給 PMS 統)統)TESTRESULT;ROOM=XXXX;EXTSTATUS=X;KEYCODE=XXX;說明:TESTRESULT:分機狀態測試結果 ROOM:房間號碼 TalenTel-PMSI 酒店管理系統接24、口協議說明 機密 第 12 頁 2/22/2012 強訊科技強訊科技 EXTSTATUS:分機狀態。0:表示空閑,1:表示占用 KEYCODE:幀序號(可選,用于處理異步返回結果)系統收到 CHECKOUT 命令后,應先對房間分機狀態進行測試,如在免打擾狀態,則取消免打擾。同時對分機狀態進行測試,并通過本條消息向酒店管理系統發送分機狀態數據。返回結果:TESTRESULT;RESULT=X;KEYCODE=XXX;其中:RESULT 表示消息接收結果,大于等于 0 表示成功,其它表示失敗 (11)信箱留言狀態消息(由(由 PMSI 系統發送給系統發送給 PMS 系統)系統)VMSRESULT;25、ROOMNUM=XXXX;NEWMESSAGE=X;OLDMESSAGE=X;KEYCODE=XXX;說明:VMSRESULT:信箱留言狀態消息 ROOMNUM:房間號碼 NEWMESSAGE:信箱新留言條數 OLDMESSAGE:信箱舊留言條數 KEYCODE:幀序號(可選,用于處理異步返回結果)系統收到 CHECKOUT 或 VMSSTATE 命令后,將 CHECKOUT 或 VMSTATE 命令轉發給 VMS 系統,VMS 系統通過此命令將對應房間分機的留言狀態發送給酒店管理系統。返回結果:VMSRESULT;RESULT=X;KEYCODE=XXX;其中:RESULT 表示消息接收結果26、,大于等于 0 表示成功,其它表示失敗 (12)計費數據消息(由(由 PMSI 系統發送給系統發送給 PMS 系統)系統)計費數據消息的格式與交換機發送的計費數據格式相同,具體格式與交換機的類型有關,有參照交換機相關的計費數據資料,PMSI 只將此計費數據消息轉發給酒店管理系統,不進行數據處理。TalenTel-PMSI 酒店管理系統接口協議說明 機密 第 13 頁 2/22/2012 強訊科技強訊科技 說明:系統收到交換機的計費數據后,轉換為以上格式發送給給酒店管理系統進行計費或對已經有通話費用的話單進行結賬處理。如果系統使用本系統內置的計費系統進行計費話單處理,則發送到 PMS 系統的計費27、話單格式如下:ACCOUNT;EXT=XXX;UID=XXX;SDATE=XXXX;STIME=XXXX;DURATION=XX;LINE=X;CODE=XXX;CALLTYPE=X;WAITTIME=XXXX;FEE=XX;RATE=XXX;AREACODE=XXX;AREANAME=XXX;KEYCODE=XXX;說明:EXT:主叫分機號碼 UID:被叫號碼 SDATE:呼叫日期,格式為“YYYY-MM-HH”,如“2004-08-03”表示 2004年 8 月 3 號 STIME:呼叫開始時間,格式為“HH:MM:SS”,如“09:13:47”,表示 9 點 13 分 47 秒 DURA28、TION:通話時長,格式為“HH:MM:SS”,如“00:03:14”,表示 3 分 14 秒 LINE:呼叫占用的外線號 CODE:呼叫密碼,只在使用密碼計費的情況下使用。CALLTYPE:呼叫類型,未用 WAITTIME:振鈴等待時間,格式為“HH:MM:SS”,如“00:03:14”,表示 3 分 14 秒 FEE:通話費用,以元為單位,保留兩位小數。RATE:通話費率,以元為單位,保留兩位小數 AREACODE:呼叫區號 AREANAME:呼叫城市名稱 返回結果:ACCOUNT;RESULT=X;KEYCODE=XXX;其中:RESULT 表示消息接收結果,大于等于 0 表示成功,其它29、表示失敗 TalenTel-PMSI 酒店管理系統接口協議說明 機密 第 14 頁 2/22/2012 強訊科技強訊科技 (13)TCP 連接定時檢測消息(雙向可用)(雙向可用)CONNECTION_DATA;說明:收到定時檢測消息的通信方以“CONNECTION_ECHO”字符串進行響應。在雙方進行通信連接時,TCP 連接定時檢測消息應由 TCP/IP 連接的客戶端方發起,服務器端進行消息響應。客戶端如果超時沒有收到響應,則中斷連接。(14)叫醒失敗消息(由(由 PMSI 系統發送給系統發送給 PMS 系統)系統)WAKEUPFAIL;ROOMNUM=XXX;TIME=XXXXXXX;BEC30、AUSE=XX;KEYCODE=XXX;說明:WAKEUPFAIL:叫醒失敗消息 ROOMNUM:房間號 TIME:原設定的叫醒時間 BECAUSE:叫醒失敗的原因 KEYCODE:幀序號(可選,用于處理異步返回結果)返回結果:WAKEUPFAIL;RESULT=X;KEYCODE=XXX;其中:RESULT 表示消息接收結果,大于等于 0 表示成功,其它表示失敗 (15)房間換名命令(由(由 PMS 系統發送給系統發送給 PMSI 統)統)CHANGENAME;ROOM=XXXX;NEWNAME1=XXX;NEWNAME2=XXX;KEYCODE=XXX;OPID=XX;說明:CHANGEN31、AME:房間換名命令 ROOM:表示要換名的房間號碼 NEWNAME1:表示新的房間用戶名稱 1 NEWNAME2:表示新的房間用戶名稱 2 TalenTel-PMSI 酒店管理系統接口協議說明 機密 第 15 頁 2/22/2012 強訊科技強訊科技 KEYCODE:幀序號(可選,用于處理異步返回結果)返回結果:CHANGENAME;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作結果,大于等于 0 表示成功,其它表示失敗 (16)房間分機設置呼叫轉移命令(由(由 PMS 系統發送給系統發送給 PMSI 統)統)SETEXTFORWARD;ROOM=XXXX;FORWA32、RDTO=XXXX;SDATE=XX;STIME=XX;EDATE=XX;ETIME=XX;TIMETYPE=X;OPID=XX;KEYCODE=XXX;說明:SETEXTFORWARD:房間分機設置呼叫轉移命令 ROOM:表示要設置呼叫轉移的房間號碼 FORWARDTO:表示呼叫轉移的目標分機號碼,如果為空,取消轉移 SDATE:設定呼叫轉移開始日期 yyyyMMdd STIME:設定呼叫轉移開始時間 HHMMSS EDATE:設定呼叫轉移結束日期 yyyyMMdd ETIME:設定呼叫轉移結束時間 HHMMSS TIMETYPE:時間設定類型 0:表示在開始日期及時間設置呼叫轉移,在結束日33、期及時間取消呼叫轉移 1:表示從開始日期到結束日期的期間每天中,在開始時間設置呼叫轉移,在結束時間取消呼叫轉移 OPID:設定呼叫轉移的操作員工號 KEYCODE:幀序號(可選,用于處理異步返回結果)返回結果:SETEXTFORWARD;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作結果,大于等于 0 表示成功,其它表示失敗 (17)信箱留言狀態查詢(由(由 PMS 系統發送給系統發送給 PMSI 系統)系統)VMSSTATE;ROOM=XXXX;KEYCODE=XXX;OPIP=XXX;說明:TalenTel-PMSI 酒店管理系統接口協議說明 機密 第 16 頁 234、/22/2012 強訊科技強訊科技 VMSSTATE:信箱留言狀態查詢 ROOM:房間號碼 KEYCODE:幀序號(可選,用于處理異步返回結果)OPID:操作員工號,發現操作指令人員的標識 返回結果:VMSSTATE;RESULT=X;KEYCODE=XXX;其中:RESULT 表示指令接收結果,大于等于 0 表示成功,其它表示失敗 注:PMSI 使用“信箱留言狀態消息”進行回復 (18)分機狀態查詢(由(由 PMS 系統發送給系統發送給 PMSI 系統)系統)EXTSTATE;ROOM=XXXX;KEYCODE=XXX;OPID=XX;說明:EXTSTATE:分機狀態查詢 ROOM:房間號碼35、 KEYCODE:幀序號(可選,用于處理異步返回結果)OPID:操作員工號,發現操作指令人員的標識 返回結果:EXTSTATE;RESULT=X;KEYCODE=XXX;其中:RESULT 表示指令接收結果,大于等于 0 表示成功,其它表示失敗 注:PMSI 使用“分機狀態消息”進行回復 (19)分機狀態消息(由(由 PMSI 系統發送給系統發送給 PMS 系統)系統)EXTRESULT;ROOMNUM=XXXX;COS=X;DND=X;FORWARD=XXX;KEYCODE=XXX;說明:EXTRESULT:分機狀態消息 ROOMNUM:房間號碼 COS:分機級別 DND:免打擾設置,0:表36、示沒有設置,1:表示已經設置 TalenTel-PMSI 酒店管理系統接口協議說明 機密 第 17 頁 2/22/2012 強訊科技強訊科技 FORWARD:呼叫轉移目的分機號碼,為空表示沒有設置呼叫轉移 KEYCODE:幀序號(可選,用于處理異步返回結果)返回結果:EXTRESULT;RESULT=X;KEYCODE=XXX;其中:RESULT 表示消息接收結果,大于等于 0 表示成功,其它表示失敗 注:本消息是對“分機狀態查詢”指令的回復 (20)叫醒成功消息(由(由 PMSI 系統發送給系統發送給 PMS 系統)系統)WAKEUPSUCCESS;ROOMNUM=XXX;TIME=XXXX37、XXX;RETRY=X;KEYCODE=XXX;說明:WAKEUPSUCCESS:叫醒失敗消息 ROOMNUM:房間號 TIME:原設定的叫醒時間 RETRY:叫醒重試次數 KEYCODE:幀序號(可選,用于處理異步返回結果)返回結果:WAKEUPSUCCESS;RESULT=X;KEYCODE=XXX;其中:RESULT 表示消息接收結果,大于等于 0 表示成功,其它表示失敗 (21)內線電話監控報警消息(由(由 PMSI 系統發送給系統發送給 PMS 系統)系統)INTERNAL_CALL_ALARM;ROOMNUM=XXX;STIME=XXXXXXX;ETIME=XXXXXX;CALLN38、UM=X;KEYCODE=XXX;說明:INTERNAL_CALL_ALARM:內線電話監控報警消息 ROOMNUM:房間號 STIME:累計呼叫開始時間,格式為 YYYYMMDDmmHHSS ETIME:累計呼叫結束時間 TalenTel-PMSI 酒店管理系統接口協議說明 機密 第 18 頁 2/22/2012 強訊科技強訊科技 CALLNUM:累計時間內呼叫次數 KEYCODE:幀序號(可選,用于處理異步返回結果)返回結果:INTERNAL_CALL_ALARM;RESULT=X;KEYCODE=XXX;其中:RESULT 表示消息接收結果,大于等于 0 表示成功,其它表示失敗 (22)39、房間換語種命令(由(由 PMS 系統發送給系統發送給 PMSI 統)統)CHANGELANG;ROOM=XXXX;NEWLANG=X;KEYCODE=XXX;OPID=XX;說明:CHANGELANG:房間換語種命令 ROOM:表示要換名的房間號碼 NEWLANG:表示新的房間語種,含義與入住指令相同 KEYCODE:幀序號(可選,用于處理異步返回結果)OPID:操作員工號,發現操作指令人員的標識 返回結果:CHANGELANG;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作結果,大于等于 0 表示成功,其它表示失敗 (23)夜審開始種命令(由(由 PMS 系統發送給系40、統發送給 PMSI 統)統)AUTID_START;OPTYPE=X;KEYCODE=XXX;OPID=XXX;說明:OPTYPE:表示操作類型,1:表示正常開始夜審 KEYCODE:幀序號(可選,用于處理異步返回結果)OPID:操作員工號,發現操作指令人員的標識 返回結果:AUTID_START;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作結果,大于等于 0 表示成功,其它表示失敗 (24)夜審操作結束(由(由 PMSI 系統發送給系統發送給 PMS 統)統)TalenTel-PMSI 酒店管理系統接口協議說明 機密 第 19 頁 2/22/2012 強訊科技強訊科技 AUTID_END;OPTYPE=X;KEYCODE=XXX;OPID=XXX;說明:OPTYPE:表示操作類型,1:表示正常結束夜審 KEYCODE:幀序號(可選,用于處理異步返回結果)OPID:操作員工號,發現操作指令人員的標識 返回結果:AUTID_END;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作結果,大于等于 0 表示成功,其它表示失敗