酒店管理系统pms接口协议.pdf

酒店通信系统 PMS 接口协议规范 一 简介 本协议规范的目的是使酒店通信系统(以下简称 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 之 间 为 请 求 消 息 内 容 ， 即 STXMSGBODYETX,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 # Node ETX Identification 长度 1 1 4 1 - “#”表示是 TCP/IP 链路存活消息 - Node id: - “FFFF”表示是 PMS 发送给 PABX 的链路存活消息. - “EEEE” 表示是 PABX 发送给 PMS 的链路存活消息. 2.5 字段填充 如果请求消息中的字段的值长度少于协议中规定的长度 则用空格字符填充到协议中规定的字符长度。 3. PABX 到 PMS 之间的消息 3.1 CDR （话单）发送请求消息 当PMS 没有告诉PABX 酒店没有处于夜审状态时，PABX 在呼叫 束时，会主动发送 CDR 给 PMS，话单以文本格式进行传输。 注：各个不同字段的长度以字节为单位。 字 S J R Ca S d c Number E 段 T OO ll type tart uratio ost called or TX X M time n calling number 长 1 1 8 1 1 5 8 20 1 度 4 - “J”字符: CDR （话单）发送请求消息 - ROOM(8 个字符):客房号 - Call Type(1 个字符):呼叫类型，”a”,主叫，”b”，被叫。 - Starttime(14 个 字 符 ):呼 叫 开 始 时 间 ， 格 式 如 yyyymmddhhmmss,如”20080808202020” -