1、亨东智能客房管理系统与酒店管理系统接口方案V7.1一、亨东智能客房管理系统功能概要：亨东智能客房管理系统的主要功能之一，是可以让管理人员在酒店各部门对酒店客房内的设备状态进行远程实时查看和控制。亨东智能客房管理系统的房态包括住客净房、住客脏房、非住客净房、非住客脏房、非住客脏房清洁完毕待检查等；系统产生的事件有房态转变为上述房态的事件及客人退房请求、酒店查房合格可结账等。二、亨东智能客房管理系统与酒店管理系统接口后可以实现以下功能：1、酒店管理系统在对客房进行“开房”或“退房”操作时，通过接口，亨东智能客房管理系统也会对相应客房的设备进行“开房”或“退房”处理，同时此客房在亨东智能客房管理系统2、中的房态也会相应变为住客房或非住客房。2、酒店管理系统在对客房进行“开房”或“退房”操作时，把客房信息、客人信息等数据反映在中间数据库znkf_aux上，亨东智能客房管理系统可在需要时使用和显示这些数据。3、亨东智能客房管理系统会把当前本系统房态的变化（房态包括住客净房、住客脏房、非住客净房、非住客脏房、非住客脏房清洁完毕待检查等状态）及某些事件等内容反映在中间数据库znkf_aux上。其中有些房态以及某些事件如非住客脏房清洁完毕待检查、客人退房请求、酒店查房合格可结账等，是由亨东智能客房管理系统根据系统硬件设备自动产生的（酒店管理系统无法直接自动产生）。如果有必要，酒店管理系统可以参考使用这3、些房态及事件数据。4、除“开房”、“退房”功能以外的其它特殊功能。三、接口实现方法：为实现上述接口功能，酒店管理系统要进行以下三个操作（注：1、最好由酒店管理系统把这三个操作集中到某个单独的接口模块中进行； 2、在操作顺序上请注意在（一）操作完成后再进行（二）操作）：（一）酒店管理系统在中间数据库znkf_aux的t_RoomInfoIn表上修改相应客房的客房信息及客人信息。在安装亨东智能客房管理系统服务器端软件的服务器上，有一个SQL SERVER 2000数据库(数据库名为：znkf_aux，数据库用户名与密码为酒店安装数据库时的用户名与密码)，其中有一个表t_RoomInfoIn，表中对4、应每个客房都有一个记录。表中字段名、数据类型、字段含义及操作说明如下：字段 属性数据类型字段含义及操作说明fRoomNo字符客房房号。最少4个字符，不足4个字符则在前面加字符“0”fRoomType字符客房类型，根据所用酒管软件的客房类型进行定义，如标准间、套间、总统套间等。开房时写入。fRoomStatus数字与房态有关的数据。开房时写入数字0；退房时写入数字2。fGuestName字符客人的姓名。开房时写入。fGuestSex字符客人的性别。开房时写入。fGuestType字符客人类型，根据所用酒管软件的客人类型进行定义，如散客、团体成员、协议单位、酒店会员等。开房时写入。fGuestCo5、untry字符客人的国籍。开房时写入。fGuestCertificate字符客人的证件类型。开房时写入。fGuestCertificateID字符客人的证件号码。开房时写入。fGuestAddress字符客人的地址。开房时写入。fGuestPhone字符客人的电话号码。开房时写入。fGuestLockCardNo字符客人所持开门卡的卡号。开房发宾客卡时写入。fGuestEnterTime日期时间客人入住时间。开房时写入。fGuestPlanLeaveTime日期时间客人预离时间。开房时写入。fGuestLeaveTime日期时间客人退房离开的时间。开房时写入固定的时间：“2001-01-01 6、01:01:01”；退房时写入退房离开的时间。fMemo字符备注。fFlagbit标记。每次更新此记录都固定写入1。fRefreshTime日期时间记录更新时间。每次更新此记录都写入更新的时间。请注意：表中对应每个客房都有一个记录，fRoomNo代表其房号。若酒店管理软件在表中找不到要某个要写入的房号的记录，请自动添加这个记录，以使这个表的房号与酒店管理软件中的房号得以对应。注：1、我方可以通过读这个数据库中的表来得知酒店管理系统对客房的操作：即是开房还是退房。2、亨东智能客房管理系统服务器端安装运行后，数据库znkf_aux就已被安装在服务器上。另外在附件2中有数据库znkf_aux的备份文7、件（文件名为znkf_aux.bak），如果在这个服务器上没有此数据库，可手工新建一个名为znkf_aux的数据库，并用这个文件直接恢复。（二）酒店管理系统调用动态链接库。前台或其它部门使用的酒店管理系统模块在进行开房或退房操作后，（建议由单独的接口操作模块）调用我方提供的动态链接库znkfctrl.dll中的命令发送函数znkfModifyRoomStatus，向亨东智能客房管理系统传递操作指令。函数说明：function znkfModifyRoomStatus(RoomNum: string; Param: integer): Integer;功能：向智能客房管理系统发送开房或退房命令。8、输入参数： RoomNum 字符型 （代表房号，不足4个字符则在前面加字符“0”）Param 数字型 （0代表开房命令，2代表退房命令）输出参数：数字型，0代表操作成功，其它为操作失败。其中参数RoomNum及Param由酒店管理系统调用时赋给，而开房或退房所对应的具体操作已由操作员在亨东智能客房管理系统中预先设置好了。根据函数返回值可判断操作是否成功。注：在附件1中有相应的接口DLL。附件3中有相应的调用DEMO。（三） 如果有必要，酒店管理系统可从中间数据库znkf_aux的表t_RoomInfoOut上读取相应客房的房态及最近事件等内容，作为自身房态及其它数据的参考。在（一）点所述数据库9、中，有另外一个表t_RoomInfoOut，表中字段名、数据类型、字段含义说明如下：字段 属性数据类型字段含义fRoomNo字符客房房号。最少4个字符，不足4个字符则在前面加字符“0”fRoomStatus数字表示房态的数据。具体含义如下（以十进制表示）：0：住客净房1：住客脏房2：非住客净房（待租净房）3：非住客脏房4：非住客脏房清洁完毕，待检查fRoomEvent数字客房发生的最近事件。具体含义如下（以十进制表示）：0：房态变为住客净房1：房态变为住客脏房2：房态变为非住客净房（待租净房）3：房态变为非住客脏房4：房态变为非住客脏房清洁完毕，待检查21: 客人请求清理客房（客人按控制面板上10、的“清理”键）22: 取消请求清理状态23: 客人呼叫（客人按控制面板上的“SOS”键）24: 取消呼叫状态25：客人请求退房（客人按控制面板上的“退房”键）26：取消请求退房状态27：酒店查房合格，可结账（客人请求退房后，服务人员查房合格时按控制面板上的特殊功能键）28：取消可结账状态29: 客人请求服务（客人按控制面板上的“服务”键）30: 取消请求服务状态fKeyCard数字当前插入的取电卡类型。具体含义如下（以十进制表示）：0：无卡 1：客人卡 2：楼栋卡3：楼层卡 4：清洁卡 5：服务卡6：区域卡 7：领班卡 8：维修卡9：总管卡 10：应急卡 15：其它卡fInfoFlags0数字11、代表一些信息的标记。每一个数据位都有其具体含义：位0：值为0时表示客房设备未处于总关状态；值为1时表示客房设备处于总关状态fDeviceStatusFlags数字代表一些客房设备的状态。每一个数据位都有其具体含义：位0：值为0时表示房门关；值为1时表示房门开位1：值为0时表示保险柜关；值为1时表示保险柜开位2：值为0时表示请求清理关；值为1时表示请求清理开位3：保留位4：值为0时表示请求退房关；值为1时表示请求退房开位5：值为0时表示可结帐关；值为1时表示可结帐开位6：保留fMemo字符备注。fFlagbit标记。我方每次更新此记录都固定写入1。fRefreshTime日期时间记录更新时间。每12、次更新此记录都写入更新的时间。亨东智能客房管理系统在本系统的房态改变时或发生某些事件时，会在相应客房的记录中写入有关房态及某些最近事件的数据。酒店管理系统通过访问这个数据库中的表来取得客房在亨东智能客房管理系统中所处房态以及发生的某些最近事件。注：这些数据可作为酒店管理系统中房态及其它数据的参考来源，酒店管系统可根据具体情况使用、部分使用或不使用这些数据。四、附：亨东智能客房管理系统房态流程：亨东智能客房管理系统有一套房态系统，这个房态系统可以与酒店管理系统进行数据交互。下面对亨东智能客房管理系统的房态流程进行说明，供接口实现人员参考。亨东智能客房管理系统一共有五种房态：住客净房、住客脏房、非13、住客净房、非住客脏房、非住客脏房清洁完待检查。每个客房在某个时刻只表示为一种特定房态。亨东智能客房管理系统的房态流程分为开房及住客流程、退房及客房处理流程两部分，下面对它们进行分别说明。在表格中亨东智能客房管理系统简称亨东，酒店管理系统简称酒管。开房及住客流程：流程项目相关接口操作1、客人在前台通过酒管软件开房，房态自动变为住客净房酒管调用DLL，并向t_RoomInfoIn表fRoomStatus字段写入数据。操作正确后亨东向t_RoomInfoOut表fRoomStatus字段及fRoomEvent字段写入数据。2、每日清晨，所有住客净房自动变为住客脏房亨东向t_RoomInfoOut表f14、RoomStatus字段及fRoomEvent字段写入数据。3、服务员清扫，插入服务卡，图标为服务卡。清扫完毕后按1#特殊功能键，房态自动变为住客净房亨东向t_RoomInfoOut表fRoomStatus字段及fRoomEvent字段写入数据。退房及客房处理流程流程项目相关接口操作1、客人按“退房”键请求结帐，出现退房图标亨东向t_RoomInfoOut表fRoomEvent字段写入数据。2、服务员查房。查房合格后按2#特殊功能键，出现可结帐图标亨东向t_RoomInfoOut表fRoomEvent字段写入数据。3、客人在前台通过酒管软件办理完结帐手续，房态自动变为非住客脏房，可结帐图标消失15、酒管调用DLL，并向t_RoomInfoIn表fRoomStatus字段写入数据。操作正确后亨东向t_RoomInfoOut表fRoomStatus字段及fRoomEvent字段写入数据。4、服务员清扫，插入服务卡，图标为服务卡。清扫完毕，拔出服务卡，房态自动变为非住客脏房清洁完待检查亨东向t_RoomInfoOut表fRoomStatus字段及fRoomEvent字段写入数据。5、管理人员检查，插入管理卡，图标为管理卡。检查合格后按1#特殊功能键，房态自动变为非住客净房亨东向t_RoomInfoOut表fRoomStatus字段及fRoomEvent字段写入数据。注：亨东智能客房管理系统还允16、许使用一种简化的房态流程，在简化的房态流程中，房态只分为住客房、非住客房两种房态。相关的接口操作也相对简单。对于开房及住客流程只含有表中第1项；对于退房及客房处理流程只含有表中第1、3两项。具体请参阅亨东智能客房管理系统帮助文件。五、特殊的辅助功能说明：除“开房”、“退房”功能以外，接口还提供一些特殊的辅助功能，给有特殊需要的酒店使用。列出如下：1、取消或设置客房设备总关功能。调用我方提供的动态链接库znkfctrl.dll中的命令发送函数znkfPowerOff，向亨东智能客房管理系统传递操作指令。函数说明：znkfPowerOff(RoomNum: string; Param: integer): Integer; 功能：向智能客房管理系统发送取消或设置客房设备总关功能的命令。输入参数： RoomNum 字符型 （代表房号，不足4个字符则在前面加字符“0”）Param 数字型 （0代表取消设备总关，1代表设置为设备总关）输出参数：数字型，0代表操作成功，其它为操作失败。其中参数RoomNum及Param由酒店管理系统调用时赋给。根据函数返回值可判断操作是否成功。注：在附件1中有相应的接口DLL。附件3中有相应的调用DEMO。