酒店通信系统PMS接口协议.docxVIP

酒店通信系统PMS接口协议

TOC\o1-3\h\z一简介 1

二TCP/IP链路 2

2.1TCP层 2

2.2请求包的格式规范 2

2.3TCP/IP链路通信确认机制 2

2.4TCP/IP链路存活消息 2

2.5字段填充 2

3.PABX到PMS之间的消息 3

3.1CDR（话单）发送请求消息 3

3.2语音邮箱事件 3

3.3房间状态事件 3

3.4Minibar入账事件 4

3.5Minibar清单事件 4

3.6REPLY消息 5

4.PMS到PABX之间的消息 5

4.1CHECK-IN消息 5

4.2ROOMCHANGE换房消息 6

4.3VOICEMAILATTRIBUTION语音邮箱属性消息 6

4.4Modification修改客房信息 7

4.5CHECK-OUT退房消息 7

4.6NightAuditRequest(夜间审计请求消息) 8

4.7CallbarredTelephone(禁拨号码)设置 8

4.8添加语音留言 8

修订历史 8

一简介

本协议规范的目的是使酒店通信系统(以下简称PABX)能够同步与酒店管理系统(以下简称PMS)完成酒店用户的Check-In、Check-Out和换房，并能够主动向酒店管理系统发送用户发起呼叫所产生的计费帐单。

PABX与PMS之间采用TCP/IP完成本协议规范的通信。

二TCP/IP链路

2.1TCP层

采用IPV4，PABX是TCP链路连接的服务端，PMS是TCP链路连接的客户端，TCP通信端口是5001.

2.2请求包的格式规范

除了ACK、NACK以外的每个请求都已STX(0x02)开始，ETX(0x03)结束，STX和ETX之间为请求消息内容，即STXMSGBODYETX,MSGBODY内必须不能包含STX或ETX字符。

2.3TCP/IP链路通信确认机制

当收到请求消息后，接收方必须在15秒内回复发送方ACK或NAK消息。如果发送方收到NACK消息或未在15秒内收到任何应答表示消息发送失败。其中ACK是一个字节值是0x06，NACK是一个字节值是0x07.

2.4TCP/IP链路存活消息

这个消息是通信双方每隔30秒向对方发送的消息。假如PABX在60秒内收到PMS发送过来的链路存活消息则关闭连接并清空链路的缓冲区。

字段

STX

#

NodeIdentification

ETX

长度

1

1

4

1

“#”表示是TCP/IP链路存活消息

Nodeid:

-“FFFF”表示是PMS发送给PABX的链路存活消息.

-“EEEE”表示是PABX发送给PMS的链路存活消息.

2.5字段填充

如果请求消息中的字段的值长度少于协议中规定的长度则用空格字符填充到协议中规定的字符长度。

3.PABX到PMS之间的消息

3.1CDR（话单）发送请求消息

当PMS没有告诉PABX酒店没有处于夜审状态时，PABX在呼叫结束时，会主动发送CDR给PMS，话单以文本格式进行传输。

注：各个不同字段的长度以字节为单位。

字段

STX

J

ROOM

Calltype

Starttime

duration

cost

Numbercalledorcallingnumber

ETX

长度

1

1

8

1

14

5

8

20

1

“J”字符:CDR（话单）发送请求消息

ROOM(8个字符):客房号

CallType(1个字符):呼叫类型，”a”,主叫，”b”，被叫。

Starttime(14个字符):呼叫开始时间，格式如yyyymmddhhmmss,如”20080808202020”

Duration(5个字符):呼叫周期，格式为mmmss,如01520表示的是15分钟20秒。

Cost(8个字符):话费，格式是7个数字字符加一个小数点，如7.02表示7元2分。

Numbercalledorcallingnumber(20个字符)：主叫或被叫号码，格式与ISDN号码格式一致。

3.2语音邮箱事件

该事件在用户退房时，PABX检测到用户的语音邮箱的状态，并把相应的状态发送给PMS。

注：各个不同字段的长度以字节为单位。

字段

STX

E

ROOM

CodeM

Status

ETX

长度

1

1

8

1

1

1

“E”字符:表示事情消息

ROOM(8个字符):客房号

“M”字符:表示语音邮箱事件。