安美PMS综合业务接口协议规范.pdfVIP

安美PMS 综合业务接口协议规范 2011 年 5 月 一． 简介 本协议规范的目的是使安美数字客房系统或者宽带计费系统（以下简称 AMTT ）能够 同步地与酒店管理系统（以下简称HOTEL ）完成酒店客人的Check-In、Check-Out 和换房， 对客人上网或者其它业务（比如 VOD/打印等）产生计费帐单，并能查询 HOTEL 方的客人 留言和帐单。 AMTT 与 HOTEL 之间采用 TCP 或串口进行通信，对于采用消息/帐单等双向 PMS 业务 的场合，由于接口数据流量相对较大，尽可能采用TCP 通信。 采用 TCP 通信时，AMTT 作为客户方，默认连接 HOTEL 方的 TCP 端口 5000，端口双 方均可。AMTT 在同一时刻只能与HOTEL 建立一个TCP 连接，HOTEL 方主动请求Check-In， Check-Out 和换房，AMTT 主动请求为客人抛送帐单，查询留言和帐单。AMTT 尽可能长时 间地与HOTEL 保持 TCP 连接，除非发生故障或者进行系统维护，不要主动关闭 TCP 连接。 若采用串口进行通信，链路规程：默认速率为 9600，数据位 8，停止位 1，无校验位， 流控默认为硬件流控，也可视情况采用 xon/off 或者无流控。 本协议描述部分“ ”和“ ”间表示必须包含的部分，“[”和“] ”间表示可选可不选 的部分。 二. 协议描述 2.1 请求包格式规范以及应答处理 1. 每个请求都以 STX （0x02 ）开始，ETX （0x03 ）结束，STX 和 ETX 间为请求消息 内容，ETX 后跟一字节校验符，即STXMSGBODYETXLRC ，MSGBODY 内必须不能包含任何 STX 或 ETX 字符。无论串口或者 TCP 通信，ETX 后都需要 跟一字节的 LRC 校验，产生 LRC 的具体算法：从 STX 后的字节开始，到 ETX 结 束（不包括 STX，但是包括ETX ）的每字节进行XOR 操作，结果即为 LRC ； 2. 任意方接受到请求后，必须回答 ACK （0x06 ）、或者 NAK （0x15 ）、或者 ENQ （0x05 ）； 3. ACK 表示被请求方正确接收到了请求，但并不表示已经对该请求作了正确的事务 处理； 4. 当发生 LRC 校验错误时，或者收到 ENQ 但是 2 秒内并没有发出过任何请求，被请 求方必须应答 NAK ；收到NAK 的一方，必须重传上一条请求； 5. 请求方在收到不正确的非 NAK/ACK 应答或者在 2 秒内没有收到任何应答时，必须 发送 ENQ ，ENQ 发送最多重复 3 次，无任何应答则丢弃本次请求，做详细日志。 第 1 页 共 8 页 ENQ 的意义为，向对端请求重发对最近2 秒内的最后一条指令所做的 ACK ／NAK 应答。收到 ENQ 的一方，若在 2 秒内没有收到过任何请求，那么直接发送 NAK ， 否则发送上一次 ACK/NAK 应答； 6. 接口的数据交互是全双工的，请求方在等待应答的超时间隔内，可能在未收到 ACK/NAK 应答前先收到对方的请求(STX 开头) ，那么应先处理对方的请求； 7. 请求内容的每个字段间以“|”字符作为分隔字符，每个字段内必须不能包含“|” 字符，第一个字段表达该请求的类型，比如是 check-in 还是 check-out，后续的字段 包含该类型请求中必要包含的其它信息，比如房间号，客人姓名等。第一个字段前 可有分隔符，也可没有分隔符，最后一个字段后可跟分隔符，也可不跟分隔符；请 求类型后的各字段间没有特别严格的顺序定义，只要包含了协议规定该请求类型中 必须有的所有字段，不论各字段间顺序如何，均视为合法请求；合法请求中不可识 别的字段作忽略处理，而不是丢弃整个请求；对于非法请求，做静默丢弃处理。 2.2 链路建立和拆除流程 链路建立使用 LS 指令，LS 表示 Link Start ，对于 TC