酒店管理软件与门锁制卡软件接口协议版本0.9

由于门锁软件采用多种开发工具开发,为方便开发接口人员的工作,资深软件特制定了命令行调用协议。

该协议有以下优点:

  1. 异步调用,有超时检测机制,这样接口运行不会影响酒店管理软件的运行效率;
  2. 采用文本文件作为数据交换的媒介,易于开发与测试;
  3. 命令行调用,接口程序可以用任意程序语言或开发工具开发。

协议内容:

  1. 写卡协议
    由酒店系统写zisunic.txt文本文件,每次会重建该文件,格式如下:
    房号|入住日期|离住日期
    例:(301|2005-12-01 08:01:02|2005-12-02 12:00:00)
    然后酒店系统调用zisunic.exe -w
    (由制作接口方完成zisunic.exe内的响应-w参数功能,读zisunic.txt并制卡)
  2. 读卡协议
    酒店系统调用zisunic.exe -r   
    由制作接口方完成zisunic.exe内的响应-r参数功能,重建zisunic.txt文件,所读门锁系统房号数据写到zisunic.txt文本文件的第一行
    酒店系统读zisunic.txt文本文件的第一行房号
  3. 清卡协议
    酒店系统调用zisunic.exe -q
    由制作接口方完成zisunic.exe内的响应-q参数功能
  4. 完成标志
    所有操作最后必须设置注册表项HKEY_CURRENT_USER\SOFTWARE\zisun\hms\icwait为Y。酒店系统根据此标志判断接口程序是否运行完毕,或在20秒后超时。
  5. 设置方法:
    在酒店管理软件-系统管理-维护-IC卡设置里选择“通用门锁”;
    在酒店管理软件-接待系统-维护-房间设置-设置门锁系统房号。

协议版本号:0.9
协议发布日期:2006年5月31日

Posted on