亨東智能客房管理系統(tǒng)與酒店管理系統(tǒng)接口方案V71

1、亨東智能客房管理系統(tǒng)與酒店管理系統(tǒng)接口方案V7.1一、亨東智能客房管理系統(tǒng)功能概要：亨東智能客房管理系統(tǒng)的主要功能之一，是可以讓管理人員在酒店各部門對酒店客房內(nèi)的設(shè)備狀態(tài)進(jìn)行遠(yuǎn)程實(shí)時查看和控制。亨東智能客房管理系統(tǒng)的房態(tài)包括住客凈房、住客臟房、非住客凈房、非住客臟房、非住客臟房清潔完畢待檢查等；系統(tǒng)產(chǎn)生的事件有房態(tài)轉(zhuǎn)變?yōu)樯鲜龇繎B(tài)的事件及客人退房請求、酒店查房合格可結(jié)賬等。二、亨東智能客房管理系統(tǒng)與酒店管理系統(tǒng)接口后可以實(shí)現(xiàn)以下功能：1、酒店管理系統(tǒng)在對客房進(jìn)行“開房”或“退房”操作時，通過接口，亨東智能客房管理系統(tǒng)也會對相應(yīng)客房的設(shè)備進(jìn)行“開房”或“退房”處理，同時此客房在亨東智能客房管理系統(tǒng)

2、中的房態(tài)也會相應(yīng)變?yōu)樽】头炕蚍亲】头俊?、酒店管理系統(tǒng)在對客房進(jìn)行“開房”或“退房”操作時，把客房信息、客人信息等數(shù)據(jù)反映在中間數(shù)據(jù)庫znkf_aux上，亨東智能客房管理系統(tǒng)可在需要時使用和顯示這些數(shù)據(jù)。3、亨東智能客房管理系統(tǒng)會把當(dāng)前本系統(tǒng)房態(tài)的變化（房態(tài)包括住客凈房、住客臟房、非住客凈房、非住客臟房、非住客臟房清潔完畢待檢查等狀態(tài)）及某些事件等內(nèi)容反映在中間數(shù)據(jù)庫znkf_aux上。其中有些房態(tài)以及某些事件如非住客臟房清潔完畢待檢查、客人退房請求、酒店查房合格可結(jié)賬等，是由亨東智能客房管理系統(tǒng)根據(jù)系統(tǒng)硬件設(shè)備自動產(chǎn)生的（酒店管理系統(tǒng)無法直接自動產(chǎn)生）。如果有必要，酒店管理系統(tǒng)可以參考使用這

3、些房態(tài)及事件數(shù)據(jù)。 4、除“開房”、“退房”功能以外的其它特殊功能。三、接口實(shí)現(xiàn)方法：為實(shí)現(xiàn)上述接口功能，酒店管理系統(tǒng)要進(jìn)行以下三個操作（注：1、最好由酒店管理系統(tǒng)把這三個操作集中到某個單獨(dú)的接口模塊中進(jìn)行； 2、在操作順序上請注意在（一）操作完成后再進(jìn)行（二）操作）：（一）酒店管理系統(tǒng)在中間數(shù)據(jù)庫znkf_aux的t_RoomInfoIn表上修改相應(yīng)客房的客房信息及客人信息。在安裝亨東智能客房管理系統(tǒng)服務(wù)器端軟件的服務(wù)器上，有一個SQL SERVER 2000數(shù)據(jù)庫(數(shù)據(jù)庫名為：znkf_aux，數(shù)據(jù)庫用戶名與密碼為酒店安裝數(shù)據(jù)庫時的用戶名與密碼)，其中有一個表t_RoomInfoIn，表中

4、對應(yīng)每個客房都有一個記錄。表中字段名、數(shù)據(jù)類型、字段含義及操作說明如下：字段 屬性數(shù)據(jù)類型字段含義及操作說明fRoomNo字符客房房號。最少4個字符，不足4個字符則在前面加字符“0”fRoomType字符客房類型，根據(jù)所用酒管軟件的客房類型進(jìn)行定義，如標(biāo)準(zhǔn)間、套間、總統(tǒng)套間等。開房時寫入。fRoomStatus數(shù)字與房態(tài)有關(guān)的數(shù)據(jù)。開房時寫入數(shù)字0；退房時寫入數(shù)字2。fGuestName字符客人的姓名。開房時寫入。fGuestSex字符客人的性別。開房時寫入。fGuestType字符客人類型，根據(jù)所用酒管軟件的客人類型進(jìn)行定義，如散客、團(tuán)體成員、協(xié)議單位、酒店會員等。開房時寫入。fGuestC

5、ountry字符客人的國籍。開房時寫入。fGuestCertificate字符客人的證件類型。開房時寫入。fGuestCertificateID字符客人的證件號碼。開房時寫入。fGuestAddress字符客人的地址。開房時寫入。fGuestPhone字符客人的電話號碼。開房時寫入。fGuestLockCardNo字符客人所持開門卡的卡號。開房發(fā)賓客卡時寫入。fGuestEnterTime日期時間客人入住時間。開房時寫入。fGuestPlanLeaveTime日期時間客人預(yù)離時間。開房時寫入。fGuestLeaveTime日期時間客人退房離開的時間。開房時寫入固定的時間：“2001-01-01

6、 01:01:01”；退房時寫入退房離開的時間。fMemo字符備注。fFlagbit標(biāo)記。每次更新此記錄都固定寫入1。fRefreshTime日期時間記錄更新時間。每次更新此記錄都寫入更新的時間。請注意：表中對應(yīng)每個客房都有一個記錄，fRoomNo代表其房號。若酒店管理軟件在表中找不到要某個要寫入的房號的記錄，請自動添加這個記錄，以使這個表的房號與酒店管理軟件中的房號得以對應(yīng)。注：1、我方可以通過讀這個數(shù)據(jù)庫中的表來得知酒店管理系統(tǒng)對客房的操作：即是開房還是退房。2、亨東智能客房管理系統(tǒng)服務(wù)器端安裝運(yùn)行后，數(shù)據(jù)庫znkf_aux就已被安裝在服務(wù)器上。另外在附件2中有數(shù)據(jù)庫znkf_aux的備份

7、文件（文件名為znkf_aux.bak），如果在這個服務(wù)器上沒有此數(shù)據(jù)庫，可手工新建一個名為znkf_aux的數(shù)據(jù)庫，并用這個文件直接恢復(fù)。（二）酒店管理系統(tǒng)調(diào)用動態(tài)鏈接庫。前臺或其它部門使用的酒店管理系統(tǒng)模塊在進(jìn)行開房或退房操作后，（建議由單獨(dú)的接口操作模塊）調(diào)用我方提供的動態(tài)鏈接庫znkfctrl.dll中的命令發(fā)送函數(shù)znkfModifyRoomStatus，向亨東智能客房管理系統(tǒng)傳遞操作指令。 函數(shù)說明：function znkfModifyRoomStatus(RoomNum: string; Param: integer): Integer;功能：向智能客房管理系統(tǒng)發(fā)送開房或退房命

8、令。輸入?yún)?shù)： RoomNum 字符型 （代表房號，不足4個字符則在前面加字符“0”）Param 數(shù)字型 （0代表開房命令，2代表退房命令）輸出參數(shù)：數(shù)字型，0代表操作成功，其它為操作失敗。其中參數(shù)RoomNum及Param由酒店管理系統(tǒng)調(diào)用時賦給，而開房或退房所對應(yīng)的具體操作已由操作員在亨東智能客房管理系統(tǒng)中預(yù)先設(shè)置好了。根據(jù)函數(shù)返回值可判斷操作是否成功。注：在附件1中有相應(yīng)的接口DLL。附件3中有相應(yīng)的調(diào)用DEMO。（三） 如果有必要，酒店管理系統(tǒng)可從中間數(shù)據(jù)庫znkf_aux的表t_RoomInfoOut上讀取相應(yīng)客房的房態(tài)及最近事件等內(nèi)容，作為自身房態(tài)及其它數(shù)據(jù)的參考。在（一）點(diǎn)所述數(shù)

9、據(jù)庫中，有另外一個表t_RoomInfoOut，表中字段名、數(shù)據(jù)類型、字段含義說明如下：字段 屬性數(shù)據(jù)類型字段含義fRoomNo字符客房房號。最少4個字符，不足4個字符則在前面加字符“0”fRoomStatus數(shù)字表示房態(tài)的數(shù)據(jù)。具體含義如下（以十進(jìn)制表示）：0：住客凈房1：住客臟房2：非住客凈房（待租凈房）3：非住客臟房4：非住客臟房清潔完畢，待檢查fRoomEvent數(shù)字客房發(fā)生的最近事件。具體含義如下（以十進(jìn)制表示）：0：房態(tài)變?yōu)樽】蛢舴?：房態(tài)變?yōu)樽】团K房2：房態(tài)變?yōu)榉亲】蛢舴浚ù鈨舴浚?：房態(tài)變?yōu)榉亲】团K房4：房態(tài)變?yōu)榉亲】团K房清潔完畢，待檢查21: 客人請求清理客房（客人按控制面

10、板上的“清理”鍵）22: 取消請求清理狀態(tài)23: 客人呼叫（客人按控制面板上的“SOS”鍵）24: 取消呼叫狀態(tài)25：客人請求退房（客人按控制面板上的“退房”鍵）26：取消請求退房狀態(tài)27：酒店查房合格，可結(jié)賬（客人請求退房后，服務(wù)人員查房合格時按控制面板上的特殊功能鍵）28：取消可結(jié)賬狀態(tài)29: 客人請求服務(wù)（客人按控制面板上的“服務(wù)”鍵）30: 取消請求服務(wù)狀態(tài)fKeyCard數(shù)字當(dāng)前插入的取電卡類型。具體含義如下（以十進(jìn)制表示）：0：無卡 1：客人卡 2：樓棟卡3：樓層卡 4：清潔卡 5：服務(wù)卡6：區(qū)域卡 7：領(lǐng)班卡 8：維修卡9：總管卡 10：應(yīng)急卡 15：其它卡fInfoFlags0

11、數(shù)字代表一些信息的標(biāo)記。每一個數(shù)據(jù)位都有其具體含義：位0：值為0時表示客房設(shè)備未處于總關(guān)狀態(tài)；值為1時表示客房設(shè)備處于總關(guān)狀態(tài)fDeviceStatusFlags數(shù)字代表一些客房設(shè)備的狀態(tài)。每一個數(shù)據(jù)位都有其具體含義：位0：值為0時表示房門關(guān)；值為1時表示房門開位1：值為0時表示保險(xiǎn)柜關(guān)；值為1時表示保險(xiǎn)柜開位2：值為0時表示請求清理關(guān)；值為1時表示請求清理開位3：保留位4：值為0時表示請求退房關(guān)；值為1時表示請求退房開位5：值為0時表示可結(jié)帳關(guān)；值為1時表示可結(jié)帳開位6：保留fMemo字符備注。fFlagbit標(biāo)記。我方每次更新此記錄都固定寫入1。fRefreshTime日期時間記錄更新時間

12、。每次更新此記錄都寫入更新的時間。 亨東智能客房管理系統(tǒng)在本系統(tǒng)的房態(tài)改變時或發(fā)生某些事件時，會在相應(yīng)客房的記錄中寫入有關(guān)房態(tài)及某些最近事件的數(shù)據(jù)。酒店管理系統(tǒng)通過訪問這個數(shù)據(jù)庫中的表來取得客房在亨東智能客房管理系統(tǒng)中所處房態(tài)以及發(fā)生的某些最近事件。注：這些數(shù)據(jù)可作為酒店管理系統(tǒng)中房態(tài)及其它數(shù)據(jù)的參考來源，酒店管系統(tǒng)可根據(jù)具體情況使用、部分使用或不使用這些數(shù)據(jù)。四、附：亨東智能客房管理系統(tǒng)房態(tài)流程： 亨東智能客房管理系統(tǒng)有一套房態(tài)系統(tǒng)，這個房態(tài)系統(tǒng)可以與酒店管理系統(tǒng)進(jìn)行數(shù)據(jù)交互。下面對亨東智能客房管理系統(tǒng)的房態(tài)流程進(jìn)行說明，供接口實(shí)現(xiàn)人員參考。亨東智能客房管理系統(tǒng)一共有五種房態(tài)：住客凈房、住客

13、臟房、非住客凈房、非住客臟房、非住客臟房清潔完待檢查。每個客房在某個時刻只表示為一種特定房態(tài)。亨東智能客房管理系統(tǒng)的房態(tài)流程分為開房及住客流程、退房及客房處理流程兩部分，下面對它們進(jìn)行分別說明。在表格中亨東智能客房管理系統(tǒng)簡稱亨東，酒店管理系統(tǒng)簡稱酒管。開房及住客流程：流程項(xiàng)目相關(guān)接口操作1、客人在前臺通過酒管軟件開房，房態(tài)自動變?yōu)樽】蛢舴烤乒苷{(diào)用DLL，并向t_RoomInfoIn表fRoomStatus字段寫入數(shù)據(jù)。操作正確后亨東向t_RoomInfoOut表fRoomStatus字段及fRoomEvent字段寫入數(shù)據(jù)。2、每日清晨，所有住客凈房自動變?yōu)樽】团K房亨東向t_RoomInfoO

14、ut表fRoomStatus字段及fRoomEvent字段寫入數(shù)據(jù)。3、服務(wù)員清掃，插入服務(wù)卡，圖標(biāo)為服務(wù)卡。清掃完畢后按1#特殊功能鍵，房態(tài)自動變?yōu)樽】蛢舴亢鄸|向t_RoomInfoOut表fRoomStatus字段及fRoomEvent字段寫入數(shù)據(jù)。退房及客房處理流程流程項(xiàng)目相關(guān)接口操作1、客人按“退房”鍵請求結(jié)帳，出現(xiàn)退房圖標(biāo)亨東向t_RoomInfoOut表fRoomEvent字段寫入數(shù)據(jù)。2、服務(wù)員查房。查房合格后按2#特殊功能鍵，出現(xiàn)可結(jié)帳圖標(biāo)亨東向t_RoomInfoOut表fRoomEvent字段寫入數(shù)據(jù)。3、客人在前臺通過酒管軟件辦理完結(jié)帳手續(xù)，房態(tài)自動變?yōu)榉亲】团K房，可結(jié)帳

15、圖標(biāo)消失酒管調(diào)用DLL，并向t_RoomInfoIn表fRoomStatus字段寫入數(shù)據(jù)。操作正確后亨東向t_RoomInfoOut表fRoomStatus字段及fRoomEvent字段寫入數(shù)據(jù)。4、服務(wù)員清掃，插入服務(wù)卡，圖標(biāo)為服務(wù)卡。清掃完畢，拔出服務(wù)卡，房態(tài)自動變?yōu)榉亲】团K房清潔完待檢查亨東向t_RoomInfoOut表fRoomStatus字段及fRoomEvent字段寫入數(shù)據(jù)。5、管理人員檢查，插入管理卡，圖標(biāo)為管理卡。檢查合格后按1#特殊功能鍵，房態(tài)自動變?yōu)榉亲】蛢舴亢鄸|向t_RoomInfoOut表fRoomStatus字段及fRoomEvent字段寫入數(shù)據(jù)。注：亨東智能客房管理系統(tǒng)還允許使用一種簡化的房態(tài)流程，在簡化的房態(tài)流程中，房態(tài)只分為住客房、非住客房兩種房態(tài)。相關(guān)的接口操作也相對簡單。對于開房及住客流程只含有表中第1項(xiàng)；對于退房及客房處理流程只含有表中第1、3兩項(xiàng)。具體請參閱亨東智能客房管理系統(tǒng)幫助文件。五、特殊的輔助功能說明：除“開房”、“退房”功能以外，接口還提供一些特殊的輔助功能，給有特殊需要的酒店使用。列出如下：1、取消或設(shè)置客房設(shè)備總關(guān)功能。調(diào)用我方提供的動態(tài)鏈接庫znkfctrl.dll中的命令發(fā)送函數(shù)znkfPowerOff，向亨東智能客房管理系統(tǒng)傳遞操作指令。 函數(shù)說明：znkfPowerOff(