酒店通信系统PMS接口协议规范
一简介 (2)
二TCP/IP链路 (2)
2.1 TCP层 (2)
2.2 请求包的格式规范 (2)
2.3 TCP/IP链路通信确认机制 (2)
2.4 TCP/IP链路存活消息 (2)
2.5 字段填充 (3)
3. PABX到PMS之间的消息 (3)
3.1 CDR（话单）发送请求消息 (3)
3.2 语音邮箱事件 (3)
3.3 房间状态事件 (4)
3.4 Minibar入账事件 (4)
3.5 Minibar清单事件 (4)
3.6 REPL Y消息 (5)
4. PMS到PABX之间的消息 (5)
4.1 CHECK-IN消息 (5)
4.2 ROOM CHANGE 换房消息 (6)
4.3 VOICE MAIL ATTRIBUTION语音邮箱属性消息 (6)
4.4 Modification修改客房信息 (7)
4.5 CHECK-OUT 退房消息 (7)
4.6 Night Audit Request(夜间审计请求消息) (8)
4.7 Call barred Telephone(禁拨号码)设置 (8)
4.8添加语音留言 (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之间为请求消息内容，即
2.3 TCP/IP链路通信确认机制
当收到请求消息后，接收方必须在15秒内回复发送方ACK或NAK消息。如果发送方收到NACK消息或未在15秒内收到任何应答表示消息发送失败。其中ACK是一个字节值是0x06，NACK是一个字节值是0x07.
2.4 TCP/IP链路存活消息
这个消息是通信双方每隔30秒向对方发送的消息。假如PABX在60秒内收到PMS发送过来的链路存活消息则关闭连接并清空链路的缓冲区。
-“#”表示是TCP/IP链路存活消息
-Node id:
- “FFFF”表示是PMS发送给PABX的链路存活消息.
- “EEEE”表示是PABX发送给PMS的链路存活消息.
2.5 字段填充
如果请求消息中的字段的值长度少于协议中规定的长度则用空格字符填充到协议中规定的字符长度。
3. PABX到PMS之间的消息
3.1 CDR（话单）发送请求消息
当PMS没有告诉PABX酒店没有处于夜审状态时，PABX在呼叫结束时，会主动发送CDR给PMS，话单以文本格式进行传输。
-ROOM(8个字符):客房号
-Call Type(1个字符):呼叫类型，”a”,主叫，”b”，被叫。
-Starttime(14个字符):呼叫开始时间，格式如yyyymmddhhmmss,如”20080808202020”
-Duration(5个字符):呼叫周期，格式为mmmss,如01520表示的是15分钟20秒。
-Cost(8个字符):话费，格式是7个数字字符加一个小数点，如7.02表示7元2分。
-Number called or calling number(20个字符)：主叫或被叫号码，格式与ISDN号码格式一致。
3.2 语音邮箱事件
该事件在用户退房时，PABX检测到用户的语音邮箱的状态，并把相应的状态发送给PMS。
-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。
-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个字符。
-Quantity：物品数量，3个字符。
-Account(10个字符):帐号