TalenTel-PMSI酒店管理系统接口协议说明2.pdf
下载文档
上传人:地**
编号:1262828
2024-11-21
19页
260.61KB
1、 文件编号:文件编号:UTUT-TALENTELTALENTEL-PMSIPMSI-002002 文件名称:文件名称:TalenTelTalenTel-PMSIPMSI 酒店管理系统接口协议说明(酒店管理系统接口协议说明(V3.11V3.11)创建日期:创建日期:20052005-0606-0101 修改日期:修改日期:20122012-0202-2222 保密级别:中保密级别:中 目 录 修改历史记录.3 一、系统说明.4 1、系统简介.4 2、主要功能说明.4 3、基本通信方式.4 二、PMSI 接口协议说明.5 1、总体说明.5 2、具体接口协议说明.6 TalenTel-PMSI 酒店2、管理系统接口协议说明 机密 第 3 页 2/22/2012 强讯科技强讯科技 修改历史记录修改历史记录 一、2009-8-20 1、增加夜审消息 2、在前台迷你吧消息报文中增加日期和时间项 二、2010-2-8 3、在前台留言点灯消息中,增加了主叫号码的参数选项 4、在 CHECK IN 消息中,增加了 CODETYPE 的参数选项,以标识号码类型 注:本文本中所有协议中的标点符号,在实际应用中,增应为英文半角字符 三、2012-02-22 5、在与酒管系统的通信协议中,为串行口通信增加 BCC 校验功能 TalenTel-PMSI 酒店管理系统接口协议说明 机密 第 4 页 2/22/2013、2 强讯科技强讯科技 一、系统说明一、系统说明 1 1、系统简介、系统简介 TalenTel-PMSI软件是一套连接酒店管理系统(PMS)与酒店通信服务系统的中间系统,它接收酒店管理系统发来的各种指令,对指令进行分析后,将指令转换为对其它通信设备的指令,并将结果返回给酒店管理系统。对于通信服务系统要发给酒店管理系统的消息,均先发给PMSI接口软件,然后由PMSI软件转发给酒店管理系统(PMS),从而达到沟通前台服务系统与后台通信服务系统之间的目的。本文档的目的在于详细说明与酒店管理系统(PMS)之间的接口协议,此文档的使用者是酒店管理系统(PMS)接口软件的开发人员,按此协议进行开发,就可以与4、本公司的TalenTel-PMSI系统相连接并正常实现各项功能。2 2、主要功能说明、主要功能说明 本接口协议主要包括以下几项功能:1、酒店客房电话控制协议(CHECK IN/OUT,DND 等)2、酒店客房统一消息服务控制协议(VMS、FAX、SMS)3、酒店叫醒系统接口控制协议(Morning Call System)4、酒店语音确认系统接口控制协议(MiniBar,房态确认)5、酒店计费系统数据接口协议(计费话单传送)3 3、基本通信方式、基本通信方式 TalenTel-PMSI 接口对酒店管理系统支持两种物理通信连接方式:网络连接和串行口连接。在使用网络连接时,接口使用 TCP/IP 5、协议中的 TCP 协议进行命令和信息传递。在使用串行口连接时,使用一种类似于 BSC 协议的通信控制协议。酒店管理系统每次发给 PMSI 的指令后,PMSI 均要给酒店管理系统一个回应,表示命令是接收正确,但并不表示命令执行成功,对于执行失败的命令,PMSI 将给出消息。PMSI 发送给酒店管理系统的消息,酒店管理系统也可给出回响,以表示正确接收到 PMSI发送的消息数据。TalenTel-PMSI 酒店管理系统接口协议说明 机密 第 5 页 2/22/2012 强讯科技强讯科技 二、二、PMSIPMSI 接口协议说明接口协议说明 1 1、总体说明、总体说明 以下协议说明为 TalenTel-6、PMSI 与酒店管理系统(PMS)的标准接口协议说明,有的酒店管理系统并不使用全部接口协议而只使用其中部分的接口协议,本协议说明中的每条命令都可以单独使用,互相之间没有影响。本协议附有一个测试使用的酒店管理系统接口方测试程序,模拟酒店管理系统的接口操作,测试程序向接口网关程序发送命令,并显示 TalenTel-PMSI 发来的状态数据信息。模拟测试时使用 TCP/IP 协议进行信息传送。使用 TCP/IP 协议进行通信时,PMSI 系统可以作为服务器端,也可以作为客户端,选择在PMSI 的设置中选择。所有通信帧都加有帧开始标识(STX,0 x02)和帧结束标识(ETX,0 x03)。协议具体说7、明如下文。如果使用串行口与酒店管理系统通信,系统有两种模式,一种是不带 BCC 校验的通信模式,在这种模式下,系统不使用帧开始标识(STX,0 x02)和帧结束标识(ETX,0 x03),只使用回车换行(0X0D,0X0A)作为一条指令的结束标识,便于使用 WINDOWS 自带的超级终端进行测试。在串行口通信中为保证数据传输的正确性,接收命令消息的一方,在分析完收到的命令后,如果各项数据正确,则应发送 ACK(0 x06)给发送命令的一方,如果各项数据有问题,则发送NAK(0 x15)给发送命令的一方,如果连续发送三次都失败,则发送方不再进行发送,将失败的命令记录在日志中。另一种串行口通信模式8、是带 BCC 校验的通信模式,系统使用使用帧开始标识(STX,0 x02)和帧结束标识(ETX,0 x03),在最后增加一个字节,作为 BCC 上校验,格式如下:STX(一个字节)数据项(多个字节)ETX(一个字节)BCC(一个字节)BCC 的校验范围从数据项开始(不包括 STX)到结束(包括 ETX),接收方进行校验处理,如果发现校验错误,则回 NAK 表示通信错误,如果校验正确,则回 ACK 表示通信成功,如果连续发送三次都失败,则发送方不再进行发送,将失败的命令记录在日志中。本说明中每条协议中由几个数据项组成,每个数据项不一定都必要,接收系统对不认识的数据项可以不进行处理,发送系统对没有9、的数据项也可以不进行发送,以达到系统之间最大的兼容性。TalenTel-PMSI 酒店管理系统接口协议说明 机密 第 6 页 2/22/2012 强讯科技强讯科技 2 2、具体、具体接口协议说明接口协议说明 (1)入驻(由(由 PMS 系统发送给系统发送给 PMSI 统)统)CHECKIN;ROOM=XXXX;LEVEL=X;LANGUAGE=X;NAME1=XXX;NAME2=XXX;INFO=XXX;VMSNAME=XXXX;PASSWORD=XXX;FAX=XXX;SMS=XXXX;KEYCODE=XXX;OPID=XXX;CODETYPE=X;说明:CHECKIN:表示从酒店管理系统向10、接口网关程序发送的入驻命令。ROOM:表示入驻的房间号码 LEVEL:房间分机级别 NAME1:客人姓名 1 NAME2:客人姓名 2 INFO:客人其它信息 LANGUAGE:表示开启语音信箱时语音信箱的语种,1 中文 2 英文 3 德文 4 韩文 5 日文 VMSNAME:表示语音信箱用户名称 PASSWORD:表示语音信箱访问密码 FAX:传真信箱号码 SMS:移消息接收设备号码,可以是移动电话或小灵通电话号码 KEYCODE:帧序号(可选,用于处理异步返回结果)OPID:操作员工号,发现操作指令人员的标识 CODETYPE:房间号码类型,0:表示分机号码,1:表示房间号码 返回结果:C11、HECKIN;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作结果,大于等于 0 表示成功,其它表示失败 TalenTel-PMSI 酒店管理系统接口协议说明 机密 第 7 页 2/22/2012 强讯科技强讯科技 (2)换房命令(由(由 PMS 系统发送给系统发送给 PMSI 统)统)CHANGEROOM;OLDROOM=XXXX;NEWROOM=XXX;KEYCODE=XX;OPID=XXX;说明:CHANGEROOM:换房命令 OLDROOM:表示旧的房间号码 NEWROOM:表示新的房间号码 KEYCODE:帧序号(可选,用于处理异步返回结果)OPID:操作员工号12、,发现操作指令人员的标识 返回结果:CHANGEROOM;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作结果,大于等于 0 表示成功,其它表示失败 (3)前台设置房间分机免打扰命令(由(由 PMS 系统发送给系统发送给 PMSI 统)统)RECEPTIONDND;DNDTEL=XXX;DNDTYPE=X;SDATE=XX;STIME=XX;EDATE=XX;ETIME=XX;TIMETYPE=X;OPID=XX;KEYCODE=XX;说明:RECEPTIONDND:前台设置分机免打扰命令 DNDTEL:要设置分机免打扰的电话号码 DNDTYPE:设置或取消分机免打扰,113、:表示设置,2:表示取消 SDATE:设定免打扰开始日期 yyyyMMdd EDATE:设定免打扰结束日期 yyyyMMdd STIME:设定免打扰开始时间,HHMMSS ETIME:免打扰开始结束时间,HHMMSS TIMETYPE:时间设定类型 0:表示在开始日期及时间设置 DND,在结束日期及时间取消 DND 如果 SDATE 或 STIME 为空表示即时设置 DND 1:表示从开始日期到结束日期的期间每天中,在开始时间设置 DND,TalenTel-PMSI 酒店管理系统接口协议说明 机密 第 8 页 2/22/2012 强讯科技强讯科技 在结束时间取消 DND OPID:进行设定操作14、人员的工号 KEYCODE:帧序号(可选,用于处理异步返回结果)返回结果:RECEPTIONDND;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作结果,大于等于 0 表示成功,其它表示失败 (4)设置房间分机等级(由(由 PMS 系统发送给系统发送给 PMSI 统)统)SETEXTCOS;ROOM=XXXX;TELLEVEL=X;OPID=XX;KEYCODE=XX;说明:SETEXTCOS:分机等级修改 ROOM:房间号码 TELLEVEL:分机等级。0:内部;1:市话;2:长话;3:国际 OPID:进行设定操作人员的工号 KEYCODE:帧序号(可选,用于处理异步返15、回结果)返回结果:SETEXTCOS;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作结果,大于等于 0 表示成功,其它表示失败 (5)前台留言命令(由(由 PMS 系统发送给系统发送给 PMSI 统)统)RECEPTIONMSG;MSGTYPE=X;MSGTEL=XXX;OPID=XX;KEYCODE=XX;CALLER=XXX;说明:RECEPTIONMSG:前台留言命令 MSGTYPE:留言类型,1:表示设置,2:表示取消 MSGTEL:要点亮留言灯的电话号码 OPID:进行设定操作人员的工号 CALLER:设置点灯的回叫号码,以被点灯话机回叫时,叫到正确的分机上。16、KEYCODE:帧序号(可选,用于处理异步返回结果)TalenTel-PMSI 酒店管理系统接口协议说明 机密 第 9 页 2/22/2012 强讯科技强讯科技 返回结果:RECEPTIONMSG;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作结果,大于等于 0 表示成功,其它表示失败 (6)前台叫醒设置命令(由(由 PMS 系统发送给系统发送给 PMSI 统)统)WAKEUPSET;TEL=XXX;SDATE=XX;STIME=XX;TIMES=X;WTYPE=X;EDATE=XX;OPID=XX;KEYCODE=XX;说明:WAKEUPSET:前台叫醒设置命令 TE17、L:被叫醒的电话号码,SDATE:表示要叫醒的日期或要取消的叫醒的设置日期,格式为 8 位,如“20041015”表示 2004 年 10 月 15 日。一个分机设有多次叫醒时,取消时要以此日期 为准。STIME:表示要叫醒的时间或要取消的叫醒的设置时间。格式为 6 位,如“180705”,表示 18 时 07 分 05 秒。一个分机设有多次叫醒时,取消时要以此时间为 准。如果取消叫醒的操作没有传来 SDATE 及 STIME,则系统取消此分机 的所有叫醒设置。TIMES:叫醒操作的重试次数,如果是取消操作不用。WTYPE:设置操作类型,1:表示设置叫醒操作 2:表示取消叫醒设置操作 EDAT18、E:结束每天定时叫醒的日期,如果是取消操作不用。如果系统传来了这 个参数,表示是设置从 SDATE 到 EDATE 之间,每天都在 STIME 时,进 行叫醒操作。如果没有 EDATE 这个参数,则表示只设置一天的叫醒。如果是取消叫醒设置,则 EDATE 也是匹配查询条件之一,如果要取消带 EDATE 的叫醒设置,则在取消时必须也传来正确的 EDATE。KEYCODE:帧序号(可选,用于处理异步返回结果)OPID:操作员工号,发现操作指令人员的标识 每条命令设置一个电话的叫醒,多个电话设置发送多条命令 TalenTel-PMSI 酒店管理系统接口协议说明 机密 第 10 页 2/22/201219、 强讯科技强讯科技 返回结果:WAKEUPSET;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作结果,大于等于 0 表示成功,其它表示失败 (7)前台房态消息(由(由 PMSI 系统发送给系统发送给 PMS 系统)系统)ROOMSTATE;ROOMNUM=XXX;STATE=X;OPERATOR=XXX;KEYCODE=XXX;说明:ROOMSTATE:前台房态消息 ROOMNUM:房间号 STATE:房间状态,0 没有准备好,1 已经准备好 OPERATOR:操作员代码,进行房态输入操作的服务员代码 KEYCODE:帧序号(可选,用于处理异步返回结果)返回结果:ROO20、MSTATE;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作结果,大于等于 0 表示成功,其它表示失败 (8)前台迷你吧消息(由(由 PMSI 系统发送给系统发送给 PMS 系统)系统)MINBARMSG;ROOMNUM=XXX;GOODTYPE=XXX;GOODNUM=XX;MONEY=XXX;OPERATOR=XX;SDATE=YYYYMMDD;STIME=HHMMSS;KEYCODE=XXX;说明:MINBARMSG:前台迷你吧消息 ROOMNUM:房间号 GOODTYPE:物品种类或编码 GOODNUM:物品数量 MONEY:消费数额 OPERATOR:操作员代21、码,进行迷你吧输入操作的服务员代码 SDATE:表示操作日期,格式为 YYYYMMDD,如 20090820 表示 2009 年 8 月 20 日 STIME:表示操作时间,格式为 HHMMSS,如 163024 表示 16 点 30 分 24 秒 TalenTel-PMSI 酒店管理系统接口协议说明 机密 第 11 页 2/22/2012 强讯科技强讯科技 KEYCODE:帧序号(可选,用于处理异步返回结果)每条消息送出一种物品的情况,多种物品使用多条消息有的酒店管理系统要求直接送出客房消费的金额,则使用 MONEY 选项进行传送。注意:金额内可能包含小数。语音程序在与用户交互时要能输入此金22、额。返回结果:MINBARMS;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作结果,大于等于 0 表示成功,其它表示失败 (9)离店(由(由 PMS 系统发送给系统发送给 PMSI 统)统)CHECKOUT;ROOM=XXXX;SAVEMSG=X;MSGPROMPT=X;KEYCODE=XXX;OPID=XX;说明:CHECKOUT:表示从酒店管理系统向接口网关程序发送的离店命令。ROOM:房间号码 SAVEMSG:留言保留天数,此值为 0 表示语音信箱不保留未听留言。MSGPROMPT:有留言是否提示,1 表示提示,0 表示不提示。如果提示,会收到VMSRESULT 23、消息。VMS 系统收到 CHECKOUT 后,应取消与此分机相关的所有叫醒设置。KEYCODE:帧序号(可选,用于处理异步返回结果)OPID:操作员工号,发现操作指令人员的标识 返回结果:CHECKOUT;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作结果,大于等于 0 表示成功,其它表示失败 (10)分机状态测试结果(由(由 PMSI 系统发送给系统发送给 PMS 统)统)TESTRESULT;ROOM=XXXX;EXTSTATUS=X;KEYCODE=XXX;说明:TESTRESULT:分机状态测试结果 ROOM:房间号码 TalenTel-PMSI 酒店管理系统接24、口协议说明 机密 第 12 页 2/22/2012 强讯科技强讯科技 EXTSTATUS:分机状态。0:表示空闲,1:表示占用 KEYCODE:帧序号(可选,用于处理异步返回结果)系统收到 CHECKOUT 命令后,应先对房间分机状态进行测试,如在免打扰状态,则取消免打扰。同时对分机状态进行测试,并通过本条消息向酒店管理系统发送分机状态数据。返回结果:TESTRESULT;RESULT=X;KEYCODE=XXX;其中:RESULT 表示消息接收结果,大于等于 0 表示成功,其它表示失败 (11)信箱留言状态消息(由(由 PMSI 系统发送给系统发送给 PMS 系统)系统)VMSRESULT;25、ROOMNUM=XXXX;NEWMESSAGE=X;OLDMESSAGE=X;KEYCODE=XXX;说明:VMSRESULT:信箱留言状态消息 ROOMNUM:房间号码 NEWMESSAGE:信箱新留言条数 OLDMESSAGE:信箱旧留言条数 KEYCODE:帧序号(可选,用于处理异步返回结果)系统收到 CHECKOUT 或 VMSSTATE 命令后,将 CHECKOUT 或 VMSTATE 命令转发给 VMS 系统,VMS 系统通过此命令将对应房间分机的留言状态发送给酒店管理系统。返回结果:VMSRESULT;RESULT=X;KEYCODE=XXX;其中:RESULT 表示消息接收结果26、,大于等于 0 表示成功,其它表示失败 (12)计费数据消息(由(由 PMSI 系统发送给系统发送给 PMS 系统)系统)计费数据消息的格式与交换机发送的计费数据格式相同,具体格式与交换机的类型有关,有参照交换机相关的计费数据资料,PMSI 只将此计费数据消息转发给酒店管理系统,不进行数据处理。TalenTel-PMSI 酒店管理系统接口协议说明 机密 第 13 页 2/22/2012 强讯科技强讯科技 说明:系统收到交换机的计费数据后,转换为以上格式发送给给酒店管理系统进行计费或对已经有通话费用的话单进行结账处理。如果系统使用本系统内置的计费系统进行计费话单处理,则发送到 PMS 系统的计费27、话单格式如下:ACCOUNT;EXT=XXX;UID=XXX;SDATE=XXXX;STIME=XXXX;DURATION=XX;LINE=X;CODE=XXX;CALLTYPE=X;WAITTIME=XXXX;FEE=XX;RATE=XXX;AREACODE=XXX;AREANAME=XXX;KEYCODE=XXX;说明:EXT:主叫分机号码 UID:被叫号码 SDATE:呼叫日期,格式为“YYYY-MM-HH”,如“2004-08-03”表示 2004年 8 月 3 号 STIME:呼叫开始时间,格式为“HH:MM:SS”,如“09:13:47”,表示 9 点 13 分 47 秒 DURA28、TION:通话时长,格式为“HH:MM:SS”,如“00:03:14”,表示 3 分 14 秒 LINE:呼叫占用的外线号 CODE:呼叫密码,只在使用密码计费的情况下使用。CALLTYPE:呼叫类型,未用 WAITTIME:振铃等待时间,格式为“HH:MM:SS”,如“00:03:14”,表示 3 分 14 秒 FEE:通话费用,以元为单位,保留两位小数。RATE:通话费率,以元为单位,保留两位小数 AREACODE:呼叫区号 AREANAME:呼叫城市名称 返回结果:ACCOUNT;RESULT=X;KEYCODE=XXX;其中:RESULT 表示消息接收结果,大于等于 0 表示成功,其它29、表示失败 TalenTel-PMSI 酒店管理系统接口协议说明 机密 第 14 页 2/22/2012 强讯科技强讯科技 (13)TCP 连接定时检测消息(双向可用)(双向可用)CONNECTION_DATA;说明:收到定时检测消息的通信方以“CONNECTION_ECHO”字符串进行响应。在双方进行通信连接时,TCP 连接定时检测消息应由 TCP/IP 连接的客户端方发起,服务器端进行消息响应。客户端如果超时没有收到响应,则中断连接。(14)叫醒失败消息(由(由 PMSI 系统发送给系统发送给 PMS 系统)系统)WAKEUPFAIL;ROOMNUM=XXX;TIME=XXXXXXX;BEC30、AUSE=XX;KEYCODE=XXX;说明:WAKEUPFAIL:叫醒失败消息 ROOMNUM:房间号 TIME:原设定的叫醒时间 BECAUSE:叫醒失败的原因 KEYCODE:帧序号(可选,用于处理异步返回结果)返回结果:WAKEUPFAIL;RESULT=X;KEYCODE=XXX;其中:RESULT 表示消息接收结果,大于等于 0 表示成功,其它表示失败 (15)房间换名命令(由(由 PMS 系统发送给系统发送给 PMSI 统)统)CHANGENAME;ROOM=XXXX;NEWNAME1=XXX;NEWNAME2=XXX;KEYCODE=XXX;OPID=XX;说明:CHANGEN31、AME:房间换名命令 ROOM:表示要换名的房间号码 NEWNAME1:表示新的房间用户名称 1 NEWNAME2:表示新的房间用户名称 2 TalenTel-PMSI 酒店管理系统接口协议说明 机密 第 15 页 2/22/2012 强讯科技强讯科技 KEYCODE:帧序号(可选,用于处理异步返回结果)返回结果:CHANGENAME;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作结果,大于等于 0 表示成功,其它表示失败 (16)房间分机设置呼叫转移命令(由(由 PMS 系统发送给系统发送给 PMSI 统)统)SETEXTFORWARD;ROOM=XXXX;FORWA32、RDTO=XXXX;SDATE=XX;STIME=XX;EDATE=XX;ETIME=XX;TIMETYPE=X;OPID=XX;KEYCODE=XXX;说明:SETEXTFORWARD:房间分机设置呼叫转移命令 ROOM:表示要设置呼叫转移的房间号码 FORWARDTO:表示呼叫转移的目标分机号码,如果为空,取消转移 SDATE:设定呼叫转移开始日期 yyyyMMdd STIME:设定呼叫转移开始时间 HHMMSS EDATE:设定呼叫转移结束日期 yyyyMMdd ETIME:设定呼叫转移结束时间 HHMMSS TIMETYPE:时间设定类型 0:表示在开始日期及时间设置呼叫转移,在结束日33、期及时间取消呼叫转移 1:表示从开始日期到结束日期的期间每天中,在开始时间设置呼叫转移,在结束时间取消呼叫转移 OPID:设定呼叫转移的操作员工号 KEYCODE:帧序号(可选,用于处理异步返回结果)返回结果:SETEXTFORWARD;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作结果,大于等于 0 表示成功,其它表示失败 (17)信箱留言状态查询(由(由 PMS 系统发送给系统发送给 PMSI 系统)系统)VMSSTATE;ROOM=XXXX;KEYCODE=XXX;OPIP=XXX;说明:TalenTel-PMSI 酒店管理系统接口协议说明 机密 第 16 页 234、/22/2012 强讯科技强讯科技 VMSSTATE:信箱留言状态查询 ROOM:房间号码 KEYCODE:帧序号(可选,用于处理异步返回结果)OPID:操作员工号,发现操作指令人员的标识 返回结果:VMSSTATE;RESULT=X;KEYCODE=XXX;其中:RESULT 表示指令接收结果,大于等于 0 表示成功,其它表示失败 注:PMSI 使用“信箱留言状态消息”进行回复 (18)分机状态查询(由(由 PMS 系统发送给系统发送给 PMSI 系统)系统)EXTSTATE;ROOM=XXXX;KEYCODE=XXX;OPID=XX;说明:EXTSTATE:分机状态查询 ROOM:房间号码35、 KEYCODE:帧序号(可选,用于处理异步返回结果)OPID:操作员工号,发现操作指令人员的标识 返回结果:EXTSTATE;RESULT=X;KEYCODE=XXX;其中:RESULT 表示指令接收结果,大于等于 0 表示成功,其它表示失败 注:PMSI 使用“分机状态消息”进行回复 (19)分机状态消息(由(由 PMSI 系统发送给系统发送给 PMS 系统)系统)EXTRESULT;ROOMNUM=XXXX;COS=X;DND=X;FORWARD=XXX;KEYCODE=XXX;说明:EXTRESULT:分机状态消息 ROOMNUM:房间号码 COS:分机级别 DND:免打扰设置,0:表36、示没有设置,1:表示已经设置 TalenTel-PMSI 酒店管理系统接口协议说明 机密 第 17 页 2/22/2012 强讯科技强讯科技 FORWARD:呼叫转移目的分机号码,为空表示没有设置呼叫转移 KEYCODE:帧序号(可选,用于处理异步返回结果)返回结果:EXTRESULT;RESULT=X;KEYCODE=XXX;其中:RESULT 表示消息接收结果,大于等于 0 表示成功,其它表示失败 注:本消息是对“分机状态查询”指令的回复 (20)叫醒成功消息(由(由 PMSI 系统发送给系统发送给 PMS 系统)系统)WAKEUPSUCCESS;ROOMNUM=XXX;TIME=XXXX37、XXX;RETRY=X;KEYCODE=XXX;说明:WAKEUPSUCCESS:叫醒失败消息 ROOMNUM:房间号 TIME:原设定的叫醒时间 RETRY:叫醒重试次数 KEYCODE:帧序号(可选,用于处理异步返回结果)返回结果:WAKEUPSUCCESS;RESULT=X;KEYCODE=XXX;其中:RESULT 表示消息接收结果,大于等于 0 表示成功,其它表示失败 (21)内线电话监控报警消息(由(由 PMSI 系统发送给系统发送给 PMS 系统)系统)INTERNAL_CALL_ALARM;ROOMNUM=XXX;STIME=XXXXXXX;ETIME=XXXXXX;CALLN38、UM=X;KEYCODE=XXX;说明:INTERNAL_CALL_ALARM:内线电话监控报警消息 ROOMNUM:房间号 STIME:累计呼叫开始时间,格式为 YYYYMMDDmmHHSS ETIME:累计呼叫结束时间 TalenTel-PMSI 酒店管理系统接口协议说明 机密 第 18 页 2/22/2012 强讯科技强讯科技 CALLNUM:累计时间内呼叫次数 KEYCODE:帧序号(可选,用于处理异步返回结果)返回结果:INTERNAL_CALL_ALARM;RESULT=X;KEYCODE=XXX;其中:RESULT 表示消息接收结果,大于等于 0 表示成功,其它表示失败 (22)39、房间换语种命令(由(由 PMS 系统发送给系统发送给 PMSI 统)统)CHANGELANG;ROOM=XXXX;NEWLANG=X;KEYCODE=XXX;OPID=XX;说明:CHANGELANG:房间换语种命令 ROOM:表示要换名的房间号码 NEWLANG:表示新的房间语种,含义与入住指令相同 KEYCODE:帧序号(可选,用于处理异步返回结果)OPID:操作员工号,发现操作指令人员的标识 返回结果:CHANGELANG;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作结果,大于等于 0 表示成功,其它表示失败 (23)夜审开始种命令(由(由 PMS 系统发送给系40、统发送给 PMSI 统)统)AUTID_START;OPTYPE=X;KEYCODE=XXX;OPID=XXX;说明:OPTYPE:表示操作类型,1:表示正常开始夜审 KEYCODE:帧序号(可选,用于处理异步返回结果)OPID:操作员工号,发现操作指令人员的标识 返回结果:AUTID_START;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作结果,大于等于 0 表示成功,其它表示失败 (24)夜审操作结束(由(由 PMSI 系统发送给系统发送给 PMS 统)统)TalenTel-PMSI 酒店管理系统接口协议说明 机密 第 19 页 2/22/2012 强讯科技强讯科技 AUTID_END;OPTYPE=X;KEYCODE=XXX;OPID=XXX;说明:OPTYPE:表示操作类型,1:表示正常结束夜审 KEYCODE:帧序号(可选,用于处理异步返回结果)OPID:操作员工号,发现操作指令人员的标识 返回结果:AUTID_END;RESULT=X;KEYCODE=XXX;其中:RESULT 表示操作结果,大于等于 0 表示成功,其它表示失败