酒店管理系統(tǒng)PMS接口協(xié)議

1、酒店通信系統(tǒng)PM眼口協(xié)議規(guī)范 TOC o 1-5 h z 一簡介2 HYPERLINK l bookmark0 o Current Document 二TCP/IP鏈路2 HYPERLINK l bookmark2 o Current Document TCP層2請求包的格式規(guī)范2 HYPERLINK l bookmark4 o Current Document TCP/IP鏈路通信確認(rèn)機(jī)制2 HYPERLINK l bookmark6 o Current Document TCP/IP鏈路存活消息2字段填充3 HYPERLINK l bookmark8 o Current Document

2、PAB港UPMM間的消息3CDR（話單）發(fā)送請求消息3語音郵箱事件3房間狀態(tài)事件4 HYPERLINK l bookmark10 o Current Document Minibar入賬事件4 HYPERLINK l bookmark12 o Current Document Minibar清單事件4 HYPERLINK l bookmark14 o Current Document REPLY消息5 HYPERLINK l bookmark16 o Current Document PM第UPABX間的消息5 HYPERLINK l bookmark18 o Current Document

3、 CHECK-IN消息5 HYPERLINK l bookmark20 o Current Document ROOMCHANGE房消息6VOICEMAILATTRIBUTION語音郵箱屬性消息6 HYPERLINK l bookmark22 o Current Document Modification修改客房信息7 HYPERLINK l bookmark24 o Current Document CHECK-OUT!房消息7 HYPERLINK l bookmark26 o Current Document NightAuditRequest（夜間審計(jì)請求消息）8 HYPERLINK l

4、 bookmark28 o Current Document CallbarredTelephone（禁撥號碼）設(shè)置8 HYPERLINK l bookmark30 o Current Document 添加語音留言8修訂歷史錯誤！未定義書簽。簡介本協(xié)議規(guī)范的目的是使酒店通信系統(tǒng)(以下簡稱PABX夠同步與酒店管理系統(tǒng)(以下簡稱PMS完成酒店用戶的Check-1n、Check-Out和換房，弁能夠主動向酒店管理系統(tǒng)發(fā)送用戶發(fā)起呼叫所產(chǎn)生的計(jì)費(fèi)帳單。PABXfPMS之間采用TCP/IP完成本協(xié)議規(guī)范的通信。TCP/IP鏈路TCP層采用IPV4,PABXTCP鏈路連接的服務(wù)端，PMSMTCP鏈路連接

5、的客戶端，TCP通信端口是5001.請求包的格式規(guī)范除了ACKNAC外的每個請求都已STX(0 x02開始，ETX(0 x03結(jié)束，STX和ETX之間為請求消息內(nèi)容，即,MSGBODY須不能包含STX或ETX字符。TCP/IP鏈路通信確認(rèn)機(jī)制當(dāng)收到請求消息后，接收方必須在15秒內(nèi)回復(fù)發(fā)送方ACK或NAQ肖息。如果發(fā)送方收到NACK消息或未在15秒內(nèi)收到任何應(yīng)答表示消息發(fā)送失敗。其中ACK是一個字節(jié)值是0 x06,NAC愿一個字節(jié)值是0 x07.TCP/IP鏈路存活消息PABX在60秒內(nèi)收到 PMS發(fā)這個消息是通信雙方每隔30秒向?qū)Ψ桨l(fā)送的消息。假如送過來的鏈路存活消息則關(guān)閉連接弁清空鏈路的緩沖

6、區(qū)。字段STX#NodeIdentificationETX長度1141-#”表示是TCP/IP鏈路存活消息-Nodeid:-FFFF表示是PM或送給PABX勺鏈路存活消息-EEEE表示是PABXg：送給PMS勺鏈路存活消息字段填充規(guī)定的字如果請求消息中的字段的值長度少于協(xié)議中規(guī)定的長度則用空格字符填充到協(xié)議中符長度。3.PABX到PM/間的消息CDR（話單）發(fā)送請求消息PAB難呼叫結(jié)束時，會主動發(fā)送當(dāng)PM皺有告訴PABX酉店沒有處于夜審狀態(tài)時,CDR合PMS話單以文本格式進(jìn)行傳輸。注：各個不同字段的長度以字節(jié)為單位字段STXJROOMCalltypeStarttimedurationcostN

7、umbercalledorcallingnumberETX長度11811458201字符：CDR（話單）發(fā)送請求消息-R00M（8個字符）：客房號-CallType（1個字符）：呼叫類型，”“主叫，被叫。-Starttime（14個字符）：呼叫開始時間，格式如yyyymmddhhmmss如“20080808202020-Duration（5個字符）：呼叫周期，格式為mmmss如01520表示的是15分鐘20秒。-Cost（8個字符）：話費(fèi)，格式是7個數(shù)字字符加一個小數(shù)點(diǎn)，如7.02表示7元2分。-Numbercalledorcallingnumber（20個字符）：主叫或被叫號碼，格式與ISD

8、N號碼格式一致。語音郵箱事件該事件在用戶退房時，PABX僉測到用戶的語音郵箱的狀態(tài)，弁把相應(yīng)的狀態(tài)發(fā)送給PMSo注：各個不同字段的長度以字節(jié)為單位字段STXEROOMCodeMStatusETX長度118111E字符：表示事情消息-ROOMK8個字符）:客房號-M”字符：表示語音郵箱事件。-Status（1個字符）：-0”表示語音郵箱已空-1-8”,表示剩余的語音留言數(shù)，9表示語音數(shù)溢出房間狀態(tài)事件該事件是把相應(yīng)的的房間狀態(tài)發(fā)送給PMS注：各個不同字段的長度以字節(jié)為單位字段STXEROOMCodeSStatusAccountETX長度11811101E字符：表示事情消息-R00M（8個字符）:

9、客房號-S字符：房間狀態(tài)事件。Status（1個字符）：1:未打掃2:已打掃3:正在查房Account（10個字符）：帳號Minibar入賬事件該事件是把相應(yīng)的的房間Minibar消費(fèi)總額費(fèi)用發(fā)送給PM&注：各個不同字段的長度以字節(jié)為單位。字段STXEROOMCodeCChargeAccountETX長度11818101E字符：表示事情消息8個字符）客房號Minibar7.02 表示 7-Charge（8個字符）：消費(fèi)總額，格式是7個數(shù)字字符加一個小數(shù)點(diǎn)，如-Account（1O個字符）：帳號Minibar清單事件該事件是把相應(yīng)的的房間消費(fèi)清單發(fā)送給PMS注：各個不同字段的長度以字節(jié)為單位。字

10、段STXEROOMCodeIDetailQuantityAccountETX長度十1181303101E”字符：表示事情消息-ROOM（8個字符）：客房號-I”字符：Minibar清單事件，1個字符。-Detail:物品清單編號，30個字符-Quantity:物品數(shù)量，3個字符。-Account（1O個字符）：帳號REPLY消息當(dāng)PABX攵到PM液送過來的命令消息時，發(fā)送該消息表示PAB濯否接受或拒絕發(fā)送過來的命令消息注：各個不同字段的長度以字節(jié)為單位。字段STXRROOMStatusETX長度11811R字符：表示REPLY0應(yīng)）消息-R00M（8個字符）：客房號-Status（1個字符）：

11、表示各個具體PMS命令的響應(yīng)E:錯誤的消息G:不可用的客房號。回應(yīng)PM皺送過來的CHECK-IN肖息 拒絕PM皺送過來的CHECK-IN肖息回應(yīng)PM或送過來的CHECK-OU 消息。P:C:D:M :拒絕PM或送過來的 回應(yīng)PM或送過來的 拒絕PM或送過來的 回應(yīng)PM或送過來的CHECK-OU 消息。ROOM CHANGE!、。ROOM CHANGE!、。Modification 消息。N:V:拒絕PM或送過來的Modification 消息?；貞?yīng)PM或送過來的語音郵箱屬性消息。W:拒絕PM或送過來的語音郵箱屬性消息。U:T:X:Z:回應(yīng)PM或送過來的 拒絕PM或送過來的回應(yīng)PM或送過來的拒絕

12、PM或送過來的Night Audit Request Night Audit RequestCall barred TelephoneCall barred Telephone消息消息消息消息A:B:回應(yīng)PM或送過來的語音留言設(shè)置消息拒絕PM或送過來的語音留言設(shè)置消息4.PMS至UPABX間的消息CHECK-IN消息當(dāng)有新的客戶入住時,PMS登記完用戶的信息后把用戶的信息發(fā)送給PABX注：各個不同字段的長度以字節(jié)為單位。PABW回REPLU肖息回應(yīng)消息處理的結(jié)果。注：各個不同字段的長度以字節(jié)為單位字段STXAROOMNameLanguageVIPstatusDODWake-upcalltime

13、長度118201134字段DNDETX長度11A”字符：表示CHECK-INB息R00M（8個字符）：客房號Name（20個字符）：客戶姓名，以“utf-8”編碼。Language（1個字符）：客戶語言，中文，英語，俄羅斯，”“：日本，韓國。Gender（1個字符）：客戶性別，“0”：男，“1”：女。VIPstatus（1個字符）：“（空格），表示不是VIP客戶，VVIP客戶DOD（3個字符）：呼叫權(quán)限。第一個字符表示市話，第二個字符國內(nèi)長途，第三個字符表示國際長途一表示未開通，”表示開通。Wake-upcalltime（4個字符）：叫醒時間。0000:表示沒有該功能HHMMS示呼叫叫醒時間，

14、24小時制的。DND（1個字符）：免打擾1”開啟。0”關(guān)閉。ROOMCHANGE消息、當(dāng)客人的所登記的客房發(fā)生改變，PM或送該消息給PABXPABX到該消息后，關(guān)閉原先客房的外呼權(quán)限，弁轉(zhuǎn)移用戶的呼叫屬性和配置信息。PABXM回REPLY消息回應(yīng)消息處理的結(jié)果。注：各個不同字段的長度以字節(jié)為單位字段STXHOldroomNewroomETX長度（以字節(jié)為單位）11881-H”字符：表示ROOMCHANGE!、-Oldroom（8個字符）：舊客房-Newroom（8個字符）：新客房VOICEMAILATTRIBUTIONS音郵箱屬性肖息該消息是用于開啟或關(guān)閉客房的語音郵箱功能。PABX返回REP

15、LW肖息回應(yīng)消息處理的結(jié)果。注：各個不同字段的長度以字節(jié)為單位。字段STXFroomActionETX長度（以字節(jié)為單位）11811F”字符：表示ROOMCHANGE目-room（8個字符）：客房編號-Action（1個字符）屬性-1:開啟-0:關(guān)閉Modification修改客房信息PMSM以通過該消息修改，客房用戶的信息如修改呼叫權(quán)限、修改叫醒服務(wù)時間、開啟或關(guān)閉免打擾信息等信息。PABXM回REPL瀚息回應(yīng)消息處理的結(jié)果。注：各個不同字段的長度以字節(jié)為單位字段STXMROOMNameLanguageVIPstatusDODWake-upcalltime長度：118201134字段DNDE

16、TX長度11-M字符：Modification修改客房消息-ROOM（8個字符）：客房號-Name（20個字符）：客戶姓名，以“ISO8859-1”編碼。如果是全“0字符表示未修改-Language（1個字符）：客戶語言，0：表示未修改，1：表示中文，2“：英語，3俄羅斯，4“：日本，5：韓國。Gender（1個字符）：客戶性別，“0”：男，“1”：女VIPstatus（1個字符），表示未修改，V,:VIP客戶DOD（3個字符）：呼叫權(quán)限。000”：表示未修改。定義與CHECK-IN中的DODS義相同。Wake-upcalltime（4個字符）：叫醒時間。00000”：表示沒有該功能HHMM表

17、示呼叫叫醒時間，24小時制的。DND（1個字符）：免打擾1：開啟。0:關(guān)閉。4.5CHECK-OUTl房消息當(dāng)用戶退房時，PMSS該發(fā)送該消息給PABX通知PABXffi戶已退房。PABX返回REPLW肖息回應(yīng)消息處理的結(jié)果。注：各個不同字段的長度以字節(jié)為單位字段STXDroomETX長度（以字節(jié)為單位）1181D字符：，表示是退房消息。-room（8個字符）二表示退房的客房號4.6NightAuditRequest（夜間審計(jì)請求消息）當(dāng)酒店開始夜間審查時，PM毆送該消息給PAB造訴酒店開始夜審。PABX攵到該消息后停止或重新開始向PMS發(fā)送話單。PABXM同REPL瀚息回應(yīng)消息處理的結(jié)果。注：各個不同字段的長度以字節(jié)為單位。字段STXNCodeETX長度1111N字符：，夜間審計(jì)請求消息。-Code（1個字符）：表示夜審的操作碼-0”表示結(jié)束夜審。-T表示開始夜審。CallbarredTelepho