酒店管理系统PMS接口协议

1、酒店通信系统PM眼口协议规范 TOC o 1-5 h z 一简介2 HYPERLINK l bookmark0 o Current Document 二TCP/IP链路2 HYPERLINK l bookmark2 o Current Document TCP层2请求包的格式规范2 HYPERLINK l bookmark4 o Current Document TCP/IP链路通信确认机制2 HYPERLINK l bookmark6 o Current Document TCP/IP链路存活消息2字段填充3 HYPERLINK l bookmark8 o Current Document

2、PAB港UPMM间的消息3CDR（话单）发送请求消息3语音邮箱事件3房间状态事件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（夜间审计请求消息）8 HYPERLINK l

4、 bookmark28 o Current Document CallbarredTelephone（禁拨号码）设置8 HYPERLINK l bookmark30 o Current Document 添加语音留言8修订历史错误！未定义书签。简介本协议规范的目的是使酒店通信系统(以下简称PABX够同步与酒店管理系统(以下简称PMS完成酒店用户的Check-1n、Check-Out和换房，弁能够主动向酒店管理系统发送用户发起呼叫所产生的计费帐单。PABXfPMS之间采用TCP/IP完成本协议规范的通信。TCP/IP链路TCP层采用IPV4,PABXTCP链路连接的服务端，PMSMTCP链路连接

5、的客户端，TCP通信端口是5001.请求包的格式规范除了ACKNAC外的每个请求都已STX(0 x02开始，ETX(0 x03结束，STX和ETX之间为请求消息内容，即,MSGBODY须不能包含STX或ETX字符。TCP/IP链路通信确认机制当收到请求消息后，接收方必须在15秒内回复发送方ACK或NAQ肖息。如果发送方收到NACK消息或未在15秒内收到任何应答表示消息发送失败。其中ACK是一个字节值是0 x06,NAC愿一个字节值是0 x07.TCP/IP链路存活消息PABX在60秒内收到 PMS发这个消息是通信双方每隔30秒向对方发送的消息。假如送过来的链路存活消息则关闭连接弁清空链路的缓冲

6、区。字段STX#NodeIdentificationETX长度1141-#”表示是TCP/IP链路存活消息-Nodeid:-FFFF表示是PM或送给PABX勺链路存活消息-EEEE表示是PABXg：送给PMS勺链路存活消息字段填充规定的字如果请求消息中的字段的值长度少于协议中规定的长度则用空格字符填充到协议中符长度。3.PABX到PM/间的消息CDR（话单）发送请求消息PAB难呼叫结束时，会主动发送当PM皱有告诉PABX酉店没有处于夜审状态时,CDR合PMS话单以文本格式进行传输。注：各个不同字段的长度以字节为单位字段STXJROOMCalltypeStarttimedurationcostN

7、umbercalledorcallingnumberETX长度11811458201字符：CDR（话单）发送请求消息-R00M（8个字符）：客房号-CallType（1个字符）：呼叫类型，”“主叫，被叫。-Starttime（14个字符）：呼叫开始时间，格式如yyyymmddhhmmss如“20080808202020-Duration（5个字符）：呼叫周期，格式为mmmss如01520表示的是15分钟20秒。-Cost（8个字符）：话费，格式是7个数字字符加一个小数点，如7.02表示7元2分。-Numbercalledorcallingnumber（20个字符）：主叫或被叫号码，格式与ISD

8、N号码格式一致。语音邮箱事件该事件在用户退房时，PABX佥测到用户的语音邮箱的状态，弁把相应的状态发送给PMSo注：各个不同字段的长度以字节为单位字段STXEROOMCodeMStatusETX长度118111E字符：表示事情消息-ROOMK8个字符）:客房号-M”字符：表示语音邮箱事件。-Status（1个字符）：-0”表示语音邮箱已空-1-8”,表示剩余的语音留言数，9表示语音数溢出房间状态事件该事件是把相应的的房间状态发送给PMS注：各个不同字段的长度以字节为单位字段STXEROOMCodeSStatusAccountETX长度11811101E字符：表示事情消息-R00M（8个字符）:

9、客房号-S字符：房间状态事件。Status（1个字符）：1:未打扫2:已打扫3:正在查房Account（10个字符）：帐号Minibar入账事件该事件是把相应的的房间Minibar消费总额费用发送给PM&注：各个不同字段的长度以字节为单位。字段STXEROOMCodeCChargeAccountETX长度11818101E字符：表示事情消息8个字符）客房号Minibar7.02 表示 7-Charge（8个字符）：消费总额，格式是7个数字字符加一个小数点，如-Account（1O个字符）：帐号Minibar清单事件该事件是把相应的的房间消费清单发送给PMS注：各个不同字段的长度以字节为单位。字

10、段STXEROOMCodeIDetailQuantityAccountETX长度十1181303101E”字符：表示事情消息-ROOM（8个字符）：客房号-I”字符：Minibar清单事件，1个字符。-Detail:物品清单编号，30个字符-Quantity:物品数量，3个字符。-Account（1O个字符）：帐号REPLY消息当PABX攵到PM液送过来的命令消息时，发送该消息表示PAB濯否接受或拒绝发送过来的命令消息注：各个不同字段的长度以字节为单位。字段STXRROOMStatusETX长度11811R字符：表示REPLY0应）消息-R00M（8个字符）：客房号-Status（1个字符）：

11、表示各个具体PMS命令的响应E:错误的消息G:不可用的客房号。回应PM皱送过来的CHECK-IN肖息 拒绝PM皱送过来的CHECK-IN肖息回应PM或送过来的CHECK-OU 消息。P:C:D:M :拒绝PM或送过来的 回应PM或送过来的 拒绝PM或送过来的 回应PM或送过来的CHECK-OU 消息。ROOM CHANGE!、。ROOM CHANGE!、。Modification 消息。N:V:拒绝PM或送过来的Modification 消息。回应PM或送过来的语音邮箱属性消息。W:拒绝PM或送过来的语音邮箱属性消息。U:T:X:Z:回应PM或送过来的 拒绝PM或送过来的回应PM或送过来的拒绝

12、PM或送过来的Night Audit Request Night Audit RequestCall barred TelephoneCall barred Telephone消息消息消息消息A:B:回应PM或送过来的语音留言设置消息拒绝PM或送过来的语音留言设置消息4.PMS至UPABX间的消息CHECK-IN消息当有新的客户入住时,PMS登记完用户的信息后把用户的信息发送给PABX注：各个不同字段的长度以字节为单位。PABW回REPLU肖息回应消息处理的结果。注：各个不同字段的长度以字节为单位字段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个字符）：呼叫权限。第一个字符表示市话，第二个字符国内长途，第三个字符表示国际长途一表示未开通，”表示开通。Wake-upcalltime（4个字符）：叫醒时间。0000:表示没有该功能HHMMS示呼叫叫醒时间，

14、24小时制的。DND（1个字符）：免打扰1”开启。0”关闭。ROOMCHANGE消息、当客人的所登记的客房发生改变，PM或送该消息给PABXPABX到该消息后，关闭原先客房的外呼权限，弁转移用户的呼叫属性和配置信息。PABXM回REPLY消息回应消息处理的结果。注：各个不同字段的长度以字节为单位字段STXHOldroomNewroomETX长度（以字节为单位）11881-H”字符：表示ROOMCHANGE!、-Oldroom（8个字符）：旧客房-Newroom（8个字符）：新客房VOICEMAILATTRIBUTIONS音邮箱属性肖息该消息是用于开启或关闭客房的语音邮箱功能。PABX返回REP

15、LW肖息回应消息处理的结果。注：各个不同字段的长度以字节为单位。字段STXFroomActionETX长度（以字节为单位）11811F”字符：表示ROOMCHANGE目-room（8个字符）：客房编号-Action（1个字符）属性-1:开启-0:关闭Modification修改客房信息PMSM以通过该消息修改，客房用户的信息如修改呼叫权限、修改叫醒服务时间、开启或关闭免打扰信息等信息。PABXM回REPL瀚息回应消息处理的结果。注：各个不同字段的长度以字节为单位字段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个字符）：呼叫权限。000”：表示未修改。定义与CHECK-IN中的DODS义相同。Wake-upcalltime（4个字符）：叫醒时间。00000”：表示没有该功能HHMM表

17、示呼叫叫醒时间，24小时制的。DND（1个字符）：免打扰1：开启。0:关闭。4.5CHECK-OUTl房消息当用户退房时，PMSS该发送该消息给PABX通知PABXffi户已退房。PABX返回REPLW肖息回应消息处理的结果。注：各个不同字段的长度以字节为单位字段STXDroomETX长度（以字节为单位）1181D字符：，表示是退房消息。-room（8个字符）二表示退房的客房号4.6NightAuditRequest（夜间审计请求消息）当酒店开始夜间审查时，PM殴送该消息给PAB造诉酒店开始夜审。PABX攵到该消息后停止或重新开始向PMS发送话单。PABXM同REPL瀚息回应消息处理的结果。注：各个不同字段的长度以字节为单位。字段STXNCodeETX长度1111N字符：，夜间审计请求消息。-Code（1个字符）：表示夜审的操作码-0”表示结束夜审。-T表示开始夜审。CallbarredTelepho