酒店门锁管理系统接口说明

发布时间 : 2024/5/19 0:43:47 星期日 文章酒店门锁管理系统接口说明更新完毕开始阅读

LS-PMS酒店门锁管理系统集成发卡接口说明书 <版本号:2.0> 13

例子说明：假如在server.exe中添加了客户端2个客户端 发行机编号 01 电脑名称为 c1 , 发行机编号 02 电脑名称为 c2,如果从c1电脑要在c2电脑上发行卡，则dd 为 02 ss 为 01.

命令代码：1字节，ASCII码，指定执行的命令。

B-客人退房（注销卡） E-读卡

G-客人入住（发卡）

I-新客人入住（发卡，同时将在住客人退房） 应答代码：1-2字节，ASCII码，指定命令执行的结果。

0-成功完成 1-未确定的错误

2-错误的（无效的）目标地址 3-无效的命令代码 4-串口错误 5-发行机正忙 6-无效的客房 7-新卡

8-发行机等候超时 10-无效的时间 11-客户端没有连接 12-客户端通信错误

数据区（data）：数据可根据需要给出不同数据，格式为：|data。 |（0x7C即分割符’|’）标明字段（域）开始。

字段（域）标识，1-2字节ASCII码，标明字段（域）数据意义。 字段ID R(0x52) D(0x44) O(0x4F) N(0x4E) 2009年3月31日星期二

说明 房号 客人入住时间 客人预离时间 客人姓名 数据长度 1-7 12 12 1-30 格式 yyyymmddhhnn yyyymmddhhnn 示例 803 200405081200 200410011200 13

LS-PMS酒店门锁管理系统集成发卡接口说明书 <版本号:2.0> 14

C(0x43) 7.3 命令详解

发卡数量 1 仅数字 以下示例中LIS（Locstar Interface System）代表创佳接口系统，PMS代表酒店管理系统接口，< >括号括起来的部分代表1字节的控制字符。 7.3.1 客人入住/退房命令

新客人入住（I）：此命令首先将指定房间内所有客人退房（仅数据库操作，不注销客人卡）再发行新的客人卡。此命令仅适用于第一位客人入住，在同一房间添加客人请使用 “客人入住”命令。必须字段：R,N,D,O；可选字段：P。示例：

PMS：0103I|R101|P00|NDuck|D200212201200|O200212302100 LIS：03010

客人入住（G）：此命令根据指定房间和时间发行客人卡（当前在住客人不受任何影响）。必须字段：R,N,D,O；可选字段：P。示例：

PMS：0103G|R102|P00|NDu|D200212201200|O200212302100 LIS：03010

客人退房（B）：此命令将指定房间内客人退房。必须字段：R；可选字段：N。此命令的dd（目标地址）有特殊用途，当dd为‘00’时只将客人退房不注销客人卡，当dd为合法地址时，将客人退房并注销客人卡（磁卡客人卡且使用手动发行机不予注销）。不包括N（客人姓名）时将房间内所有客人退房，包括客人姓名时将房间内指定客人退房。示例： PMS：0000B|R101 LIS：00000 7.3.2 验卡/读客人卡命令

命令码（E），此命令读客人卡信息，并从数据库中检索卡信息。若检索成功，将相关信息（R,P,N,D,O）返回。示例： PMS：0103E

LIS：03010|R101|P010203|NDuck|D200212201200|O200212302100 2.4 TCP/IP接口数据传输规则

（1） 接口系统为Socket Server，酒店系统为Socket Client。 （2） 双方必须设置相同的端口号。

（3） 接口系统对每一个请求都有应答，应检查应答信息，以确定请求是否成功完成。

2009年3月31日星期二 14

LS-PMS酒店门锁管理系统集成发卡接口说明书 <版本号:2.0> 15

建议接口使用方等待接口系统回应时使用“超时跳出”的方式，防止系统异常造成的意外中断引发死循环。 附录 A

参数说明：[in]为输入参数，[out]为输出参数。

客人卡如不能开门则请注意门锁上的响声，2声代表时间不正确，5声代表房号不正确。

2009年3月31日星期二 15