酒店通信系统PMS接口协议规范一简介................................................................................................................. 二TCP/IP链路....................................................................................................2.1 TCP层.....................................................................................................2.2 请求包的格式规范................................................................................2.3 TCP/IP链路通信确认机制....................................................................2.4 TCP/IP链路存活消息............................................................................2.5 字段填充................................................................................................3. PABX到PMS之间的消息..............................................................................3.1 CDR（话单）发送请求消息.................................................................3.2 语音邮箱事件........................................................................................3.3 房间状态事件........................................................................................3.4 Minibar入账事件...................................................................................3.5 Minibar清单事件...................................................................................3.6 REPLY消息............................................................................................4. PMS到PABX之间的消息.........................................................................4.1 CHECK-IN消息.....................................................................................4.2 ROOM CHANGE 换房消息.................................................................. 4.3 VOICE MAIL ATTRIBUTION语音邮箱属性消息.................... 4.4 Modification修改客房信息................................................................... ........................................................................ 退房消息4.5 CHECK-OUT 4.6 Night Audit Request(夜间审计请求消息) .............................................. 4.7 Call barred Telephone(禁拨号码)设置................................................... 4.8添加语音留言.........................................................................................修订历史...............................................................................................................一简介本协议规范的目的是使酒店通信系统(以下简称PABX)能够同步与酒店管理系统(以下简称PMS)完成酒店用户的Check-In、Check-Out和换房，并能够主动向酒店管理系统发送用户发起呼叫所产生的计费帐单。
PABX与PMS之间采用TCP/IP完成本协议规范的通信。
二 TCP/IP链路2.1 TCP层采用IPV4，PABX是TCP链路连接的服务端，PMS是TCP链路连接的客户端，TCP通信端口是5001.2.2 请求包的格式规范除了ACK、NACK以外的每个请求都已STX(0x02)开始，ETX(0x03)结束，STX和ETX之间为请求消息内容，即<STX><MSGBODY><ETX>,MSGBODY 内必须不能包含STX 字符。
ETX或．2.3 TCP/IP链路通信确认机制当收到请求消息后，接收方必须在15秒内回复发送方ACK或NAK消息。
如果发送方收到NACK消息或未在15秒内收到任何应答表示消息发送失败。
其中ACK是一个字节值是0x06，NACK是一个字节值是0x07.2.4 TCP/IP链路存活消息这个消息是通信双方每隔30秒向对方发送的消息。
假如PABX在60秒内收到PMS发送过来的链路存活消息则关闭连接并清空链路的缓冲区。
字段 STX#NodeETXIdentification1 411长度-“#”表示是TCP/IP链路存活消息-Node id:- “FFFF”表示是PMS发送给PABX的链路存活消息.- “EEEE”表示是PABX发送给PMS的链路存活消息.2.5 字段填充如果请求消息中的字段的值长度少于协议中规定的长度则用空格字符填充到协议中规定的字符长度。
．3. PABX到PMS之间的消息3.1 CDR（话单）发送请求消息当PMS没有告诉PABX酒店没有处于夜审状态时，PABX在呼叫结束时，会主动发送CDR给PMS，话单以文本格式进行传输。
注：各个不同字段的长度以字节为单位。
字STJ ROOM CallStarduratcoNumberETXst calledtypeort 段 ionXcalling timenumber长度1 1 8 1 14 5 8 20 1-“J”字符: CDR（话单）发送请求消息-ROOM(8个字符):客房号-Call Type(1个字符):呼叫类型，”a”,主叫，”b”，被叫。
-Starttime(14个字符):呼叫开始时间，格式如yyyymmddhhmmss,如””-Duration(5个字符):呼叫周期，格式为mmmss,如01520表示的是15分钟20秒。
-Cost(8个字符):话费，格式是7个数字字符加一个小数点，如7.02表示7元2分。
-Number called or calling number(20个字符)：主叫或被叫号码，格式与号码格式一致。
ISDN．3.2 语音邮箱事件该事件在用户退房时，PABX检测到用户的语音邮箱的状态，并把相应的状态发送给PMS。
注：各个不同字段的长度以字节为单位。
-“E”字符:表示事情消息-ROOM(8个字符):客房号-“M”字符: 表示语音邮箱事件。
-Status(1个字符)：-“0”,表示语音邮箱已空-“1-8”,表示剩余的语音留言数，9表示语音数溢出。
3.3 房间状态事件该事件是把相应的的房间状态发送给PMS。
注：各个不同字段的长度以字节为单位。
-“E”字符:表示事情消息-ROOM(8个字符):客房号房间状态事件。
: ”字符S“--Status(1个字符)：- 1: 未打扫- 2: 已打扫- 3: 正在查房-Account(10个字符):帐号3.4 Minibar入账事件该事件是把相应的的房间Minibar消费总额费用发送给PMS。
注：各个不同字段的长度以字节为单位。
-“E”字符:表示事情消息-ROOM(8个字符):客房号-“C”字符: Minibar入账事件。
-Charge(8个字符): 消费总额，格式是7个数字字符加一个小数点，如7.02表示7元2分-Account(10个字符):帐号3.5 Minibar清单事件该事件是把相应的的房间消费清单发送给PMS。
注：各个不同字段的长度以字节为单位。
．-“E”字符:表示事情消息-ROOM(8个字符):客房号-“I”字符: Minibar清单事件,1个字符。
-Detail：物品清单编号，30个字符。
-个字符。
3Quantity：物品数量，-Account(10个字符):帐号3.6 REPLY消息当PABX收到PMS发送过来的命令消息时，发送该消息表示PABX是否接受或拒绝发送过来的命令消息。
注：各个不同字段的长度以字节为单位。
字段 STX R ROOM Status ETX181长度 11-“R”字符:表示REPLY(回应)消息-ROOM(8个字符):客房号。
-Status(1个字符)：表示各个具体PMS命令的响应.E: 错误的消息G: 不可用的客房号。
消息。
CHECK-IN发送过来的PMS回应 I :J：拒绝PMS发送过来的CHECK-IN消息。
O：回应PMS发送过来的CHECK-OUT消息。