02-第2章 PMS接口协议.doc

C&C08 数字程控交换系统 酒店接口机用户手册目 录目 录第2章 PMS接口协议2-12.1 串口通信协议2-12.1.1 串口的使用和分配2-12.1.2 串口协议2-22.1.3 串口协议的选择2-62.1.4 串口上传输的消息概述2-92.1.5 消息重传2-112.1.6 消息探询2-152.1.7 串口上传输的房态消息格式2-192.1.8 串口上传输的Mini吧消息格式2-222.1.9 串口上传输的话单消息格式2-232.1.10 串口上传输的CheckIn/CheckOut消息格式2-262.1.11 串口上传输的电话权限控制消息格式2-302.1.12 串口上传输的留言等待消息格式2-312.1.13 串口上传输的免打扰消息格式2-322.1.14 串口上传输的修改姓名消息格式2-332.1.15 串口上传输的多语言自动叫醒消息格式2-342.1.16 串口上传输的VIP贵宾客人叫醒消息格式2-352.1.17 串口上传输的留言数目消息格式2-362.1.18 串口上传输的恢复邮箱消息格式2-372.1.19 串口上传输的拷贝邮箱消息格式2-382.1.20 串口上传输的查询邮箱消息格式2-392.1.21 串口上传输的生成邮箱消息格式2-392.1.22 串口上传输的删除邮箱消息格式2-402.1.23 串口上传输的修改邮箱密码消息格式2-412.2 文件共享方式的通信协议2-412.2.1 引言2-412.2.2 共享文件的记录格式2-44iC&C08 数字程控交换系统 酒店接口机用户手册第2章 PMS接口协议第2章 PMS接口协议接口系统使用ISDN的2B+D技术同C&C08交换机相连。接口系统与酒店电脑系统的连接方式有两种，一种是通过网络的文件共享方式进行通信，一种是通过RS232串口进行通信。下面就这两种通信方式的协议及各种消息格式进行详细的说明。2.1 串口通信协议2.1.1 串口的使用和分配串口上传输的消息根据传输的方向可分为两部分，一是从交换机发给PMS系统的消息，如房态消息、计费话单消息、Mini吧消息、语音邮箱留言数目消息；二是从PMS系统发给交换机的消息，如叫醒、免打扰、客房入住情况、留言等待、电话权限控制等消息。传输时使用的是交换机和酒店管理系统之间的PMS接口。为了最大程度地和国内PMS厂商集成，将支持3个串口。其使用分配组合如下：1. 使用一个串口串口1：PMS系统发给交换机的所有消息及交换机发给PMS系统的房态、Mini吧消息、计费话单消息、语音邮箱留言数目消息。串口2：空闲。串口3：空闲。2. 使用两个串口串口1：PMS系统发给交换机的所有消息及交换机发给PMS系统的房态、Mini吧消息、语音邮箱留言数目消息。串口2：交换机发给PMS系统的计费话单消息。串口3：空闲。或串口1：PMS系统发给交换机的所有消息。串口2：交换机发给PMS系统的房态、Mini吧、语音邮箱留言数目消息、计费话单消息。串口3：空闲。3. 使用三个串口串口1：PMS系统发给交换机的所有消息。串口2：交换机发给PMS系统的房态、Mini吧消息、语音邮箱留言数目消息。串口3：交换机发给PMS系统的计费话单消息。建议使用方式2和3，因为方式1易引起PMS接口链路异常紧张。但由于和PMS集成的可能性多种多样，在PMS接口链路不紧张的情况下，仅使用一个串口是有可能的。故在这里提供这种方式。2.1.2 串口协议为了最大程度地和国内PMS厂商集成，PMS接口的串口通信提供了四种协议： PMS1协议、PMS2协议、PMS3协议、PMS4协议。下面分别进行介绍。1. PMS1协议(1) PMS系统(a) 发送所有消息的格式必须为后面给出的消息格式。PMS必须为每个消息计算，并且将它当成一个结束字符传送。 为在之后之前，并且包括的所有字符的循环校验码（这些字符的位异或，为了处理的方便，如果结果刚好等于“0”(0x00)则转换为0x20）。当传送了一个完整的消息后，PMS系统必须等2秒。如果2秒之后，PMS没有收到，或者收到，PMS将认为消息丢失，并且将根据配置确定是否进行重传。重传预定的次数后，进行下一消息的传送。PMS必须有一个队列进行传输，如果这个队列溢出，消息将丢失，如果有消息丢失，PMS应该进行提示。 注意：另外一个重发的机制是三次重发后，将这个消息保存在PMS的错误文件中，并继续发送下一个消息。上面所讲的机制适用于短期的链路故障。当PMS系统发送一个消息后，若立即收到一个，PMS在进行重发之前必须再等待1秒钟。若经过这样的三次，则PMS应该将消息保存到一个错误文件中，并且进行下一个消息的发送。如果有消息丢失，PMS应该将错误报给系统管理员。在查明错误的原因后，应该用数据库交换进行再同步。当PMS发送一个消息后，若立即收到一个消息，它在发出第二个消息之前必须再等待1秒钟。PMS在收到一个消息后，应该发回一个或者。发送或者消息必须在发送完一个消息后进行（此时，如果有消息在发，必须将此消息发送完后才能发送或者）。例如：如果PMS在发送一个消息的中间过程，它必须在发送完以后，再发或者。如下所示：MessageBody(b) 接收当PMS收到一个完整的消息后，PMS必须计算的正确性，检查完后，必须发回一个或者。在此过程中检查到错误要放到一个文件中。PMS不能发送任何错误的响应给交换机，如“无效的命令”，“语法错误”等。(2) 交换机(a) 发送所有消息格式应该采用给出的消息格式。交换机必须计算码，并且将它作为一个消息的结束字符。当传送了一个完整的消息后，交换机系统必须等2秒。如果2秒之内，交换机没有收到，或者收到，交换机将认为消息丢失，并且进行重传。交换机进行重传，若经过同样的三次，则应该将该消息保存到一个错误文件中，并且进行下一个消息的发送。同时，交换机应该将错误报给管理员。在查明错误的原因后，应该用该错误文件进行再同步。当交换机发送一个消息后，立即收到一个消息，它在发出第二个消息之前必须再等待1秒钟。交换机在收到一个消息后，应该发回一个或者。发送或者NAK消息必须在发送完一个消息后进行(如果此时有消息待发)。例如：如果交换机在发送一个消息的中间过程，它必须在发送完以后，再发或者。如下所示：MessageBody如果此时没有消息发，将如下所示：(b) 接收当从PMS收到一个完整的消息后，交换机将计算从开始，到结束，并且包括的循环校验码，如果和一致，将发回一个，否则，发回一个。发和必须在刚才发送的消息之后发送，在此中间，不能再发送任何消息。当收到的消息包里含有损坏的数据和无效的命令，则发回一个。如果号码在交换机的数据库中不存在，则交换机收到PMS的消息后，将发回一个消息。2. PMS2协议(1) PMS系统(a) 发送PMS系统的发送和PMS1协议中的一样。PMS发送消息时计算的方法和PMS1协议中的方法一样。并且，发送给交换机的或消息也和PMS1协议中的一致（不以结尾）。(b) 接收与PMS1中一样。但是，计算从交换机得到的消息的校验码的方法不一样。计算方法如下： = 首先计算在之后之前，并且包括的字符的循环校验码（这些字符的位异或, 为了处理的方便，如果刚好等于0(0x00)则转换为0x20），然后将计算的结果与ASCII码40(HEX)进行位或操作，这才是校验码。这样计算的原因是为了避免有和相同的控制码。注意，只有在交换机发送消息给PMS系统时，才用这种计算校验码的方法。从交换机收到的任何消息都将以结尾。(2) 交换机(a) 发送所有消息都将以结尾。其它同PMS1。消息格式为： =循环校验码的结果和40(HEX)进行位或操作(b) 接收同PMS1中一样。3. PMS3协议(1) PMS系统(a) 发送PMS系统的发送和PMS1协议中的一样。有些PMS供应商使用PMS3协议是为了使用早期的一种重传的机制：发出消息两秒内收到或没有响应后，开始重传。建议重传的最大次数为3次。(b) 接收与PMS1中一样。(2) 交换机(a) 发送交换机的发送和PMS1协议中讲的一样。(b) 接收同PMS1中一样。4. PMS4协议(1) PMS系统(a) 发送PMS系统的发送和PMS1协议是一样的。但是，不用等待应答消息。因此，PMS4协议的消息发送是否成功没有反馈消息，也没有消息重传的机制。PMS4协议的引入，是为了提供一种简单的协议，以适应不同的需要。(b) 接收与PMS2中一样。收到的所有消息都将以结尾，但是不用回送应答消息。(2) 交换机(a) 发送交换机的发送和PMS2协议中的一样，所有的消息都将以结尾。不同的是，不用等待PMS的应答。收到消息后也不用回送应答。(b) 接收同PMS1中一样，有一点不同的是，此时不用进行循环校验码的计算。而且，不用回送应答消息。即，不用回送或的应答。2.1.3 串口协议的选择1. 协议之间的不同点采用PMS3协议的情况下，酒店接口在收到Check In或Check Out命令时，会返回一个最新的房态（房间的状态）给PMS系统。这是PMS3和PMS1、PMS2的不同点；PMS2发送命令给PMS接口时同PMS1，不同的是从PMS接口接收信息时计算的方法且PMS2情况下每个消息后附加一个，而PMS1只在、之后附加。PMS4不同于其它协议的一个显著区别是：发送的所有消息都不用等待应答，而且收到消息后也不用回送应答。另外，消息格式稍有不同，发送命令给PMS接口时同PMS1，但PMS接口侧不用计算，从PMS接口接收信息时，每个消息后都附加了一个。2. 如何选择协议更新房态PMS通过PMS接口提供了一种简单、方便的更新房态的方法。如果在酒店中有一个可替换的方法（PMS终端、电视接口）也能达到这个目的时，酒店可能不会选择这个方法。在这种情况下，PMS接口在收到Check In或Check Out命令时，将会回送一个不变的房态消息（在PMS3情况下）。如果使用PMS接口更新房态的功能，将有如下所示的两个方法：l 在Check Out的时候，PMS系统在它的数据库中将这个房态标示为RE（Cleaning Request），当服务员打扫房间的时候，服务员将房态已变更的消息通过话机送给交换机再由PMS接口自动发给PMS系统。若PMS接口在晚上自动将所有房态变更为RE的选项没有被使用，在Check Out的时候，由PMS接口将这个房间的房态设为RE（Cleaning Request），但这只能在PMS3协议的情况下使用。l 由PMS接口在晚上自动将所有房态标示为RE（Cleaning Request）。晚上的同一时候，PMS系统也会把所有房间设为同样的值。当服务员打扫房间时，房态消息通过酒店接口发给PMS系统，告知房态已变。在Check Out的时候，PMS系统将这个房态设置为RE（Cleaning Request）。从PMS接口过来的房态消息为已清洁或清洁通过检查时，PMS系统才会更新自己数据库中的这个房态（其它消息将忽略）。四种协议都会使用这种方法。尽管PMS接口提供了更新后的房态的几种消息，PMS系统可能将忽略其中几种，或者将它们映射到自己的房态消息中。在一个房间的状态为Check In的时候，PMS系统也有可能会忽略来自PMS接口的这个房间的房态消息。只有在使用PMS3协议时，酒店接口在收到一个Check In或Check Out的时候，会回送一个最新的房态消息给PMS系统，这可以用来避免链路故障带来的数据不一致的问题（如果房态消息丢失）。如果为其它三种协议，将没有一种机制恢复丢失的房态消息。3. 房态消息使得链路过载如果打开PMS接口自动在某个时间将所有房间设为RE（Cleaning request）的功能，PMSI链路可能会过载。或者在话务台上将许多房间的房态改变时，也会出现PMSI链路过载的情况。PMS接口在一秒内会发送五个房间的房态消息（基于1200波特率），如果PMS不能以这种速度处理到达的房态消息，则PMS应该有一个更大的接收缓冲区来保存从PMS接口过来的房态消息，然后处理。在某些情况下所有房间的房态可能连续地改变，此时PMS要处理最多可能达到4000个连续的房态消息（假定这是酒店中最大的房间数），可据此选择用于接收的缓冲区的大小。每个房态消息有13个字符（不包括、和）。4. 选择PMS1协议如果选择PMS1协议，则不能自动重发丢失的房态消息。只有通过人工重发这个丢失的房态消息。所以，当选择此协议时，要求PMS能够有很快的速度处理到达的房态消息的能力或者PMS系统能保存消息，以防房态消息丢失。如果PMS系统没有这种能力，则必须考虑使用PMS3协议，因为丢失的房态消息在这种情况下可以重发。建议：PMS系统应该在每晚链路负荷很轻的时候，用自己数据库中的房态消息更新PMS接口中的房态消息。这可以通过数据库交换功能来实现（PMS在需要的时候，应该有数据库交换的功能）。5. 选择PMS2协议PMS系统如果希望从PMS接口收到的每个消息以结尾，或者不能识别以作为结尾字符的数据，则必须考虑PMS2协议。在选择PMS1协议中对PMS系统的要求在选择PMS2时也是一样的。如果要求协议对称，则应该避免使用PMS2协议。因为在使用PMS2协议时，PMS不管是在发送还是在接收都将用不同的方法计算，且在接收的时候，希望结束字符为6. 选择PMS3协议如果PMS在每晚可以使用数据库交换，则可以考虑PMS3协议。数据库交换使得PMS系统可以从PMS接口中得到最新的房态消息。应该注意的是，在PMS3协议下，PMSI链路可能不够用，因为对于每个Check Out命令，酒店接口都要回送一个RE（Cleaning Request）消息。7. 选择PMS4协议PMS4协议的消息发送是否成功没有反馈消息，也没有消息重传的机制。收到的所有消息都将以结尾，但是不用回送应答消息。PMS4协议的引入，是为了提供一种简单的协议，以适应不同的需要。2.1.4 串口上传输的消息概述1. 消息格式概述PMS系统和酒店接口系统之间的连接是用标准的RS232串口实现的。在此链路上传输的消息格式如下：发送： 接收： or 含义： = ( 02HEX ) 帧开始 = ( 03HEX ) 帧结束 = 代表PMS接口命令的ASCII字符串 = 循环校验码。这个字符被用来检测消息的正确性，并且必须在后。它计算的是之后到之前，包括的所有字符的八位的循环校验码。PMS2协议计算循环校验码有些不同，将在PMS2协议中解释。= (06HEX ) 接收方发来的正确响应消息。说明校验正确，并且消息的内容能够被接收方所理解。= (15HEX) 接收方发来的否定响应消息。说明收到的字 符和计算的不匹配，或者消息不能被接收方所理解。错 误的消息也将以返回，说明消息内容有错。所有PMS接口消息都有关键词，并且数据字段以空格为界限。一些发给PMS接口的消息有定长格式字段（如房态），如果不足，将以空格填充。下面是两个定长字段消息，是酒店管理系统（PMS）发给酒店接口的 Check In的例子，号码为1010和70268。STXSEST1010CHINETXBCCSTXSEST70268CHINETXBCC& 说明：(1) 所有空白区为空格（20HEX）。(2) 号码定长为8个字符，不够以空格字符（20HEX）填充。(3) 所有消息中的关键词均要区分大小写，一般只有两个字符。一些PMS消息有被双引号包括的ASCII字符串（如修改姓名消息中的客人姓名）。2. 号码指南房号一般和电话号码一致，当然这不是必须的。例如，1010房的电话号码为1010，344房的电话号码为0344。PMSI基于电话号码，所以，电话号码和房号的对应关系应是PMS的任务。如果号码在交换机的数据库中不存在，则交换机收到PMS接口的消息后，将发回一个NAK消息，如果PMS重发这个消息，交换机将发回ACK以避免不断的重发。一个客房可能有多个电话号码（如有多个话机），在这种情况下，PMS应该针对每个电话号码发送一个PMSI 消息。3. 消息类型在酒店管理系统与酒店接口之间有如下消息：(1) 酒店接口发给PMS（酒店管理系统）的消息l 房态消息l 话单消息l Mini吧消息l 语音邮箱留言数目消息(2) 酒店管理系统发给酒店接口的消息l 电话权限消息l CheckIn/CheckOut消息l 留言灯消息l 免打扰消息l 修改客人姓名消息l 自动叫醒消息l 贵宾客人消息l 恢复语音邮箱消息l 拷贝语音邮箱消息 查询语音邮箱消息l 房态消息（PMS给酒店接口发消息，改变指定房间的房态，因此，该消息双方都可发送）l 生成邮箱消息l 删除邮箱消息l 修改邮箱密码消息2.1.5 消息重传1. 消息发送当消息从酒店接口发送给PMS系统之前，消息的所有内容都将保存到一个缓冲区中，并且和PMS接口的输出队列相联系，最后以先进先出的方式发送给PMS系统。不需要保存的消息为和，一发送完毕，就将它们丢弃。2. 消息重传当PMS接口发送了一个房态消息或探询消息给PMS系统后，PMS接口将等待从PMS系统发来的响应。如果在超时之前收到一个，或者没有收到任何消息，PMS接口将进行消息的重传。3. 重传的机制酒店接口系统应该有这种功能：可以允许重传或者不允许。这为最高的权限，如果系统的重传机制没有允许，则后面所讲的自动关闭重传和自动打开重传将不起作用。当重发功能为允许状态时（可在PMS接口的功能选择窗口中进行选择：选中酒店管理系统接口，右键操作），系统根据传输的结果可以自动打开重传或自动关闭重传机制。另外还可以人工定义重传的次数（Retransmission Number，XNUM）。在发送的过程中，一个“完全发送循环”指的是PMS接口发送同样的一个消息到达最大发送次数（XNUM）。当消息重传为关闭状态时，发送一个消息后，保存消息的缓冲区将被释放，并且立即被设置为空闲。PMS接口将忽略从PMS系统收到的任何响应（或）。如图2-1所示：图2-1 PMS重传机制示意图当消息重传为打开状态时，发送一个消息后，保存消息的缓冲区不被释放。相反，PMS接口将等待从PMS系统来的消息。如果在超时之前收到消息，保存消息的缓冲区将被释放。当PMS接口收到一个消息时，或者在预定的时间内没有收到任何响应消息，如果以下两个条件满足，PMS接口将进行重传：l 消息重传机制没有关闭；l 消息发送次数没有到达一个“完全发送循环”，即发送次数没有到达PMS接口预定的最大发送次数（XNUM）。如果消息重发不成功，这个消息所占的缓冲区将设置为空闲，并且将进行下一个消息的发送。如图2-2所示（假设XNUM为3）：图2-2 PMS消息重发不成功时的处理4. 自动关闭重传机制如果PMS接口在两个完全消息循环中没有收到任何响应消息，消息重发功能将自动关闭（图2-3），并且PMS接口将进行以下动作：l 打开酒店接口上的告警；l 在消息监视屏幕上显示“发送失败”。图2-3 PMS自动关闭重传机制如果消息重发功能关闭，更多的消息将按图2-3中情况发送直到丢失。图2-3显示了消息重发的自动关闭功能。5. 自动打开重传机制消息的重传功能自动关闭后，当PMS接口从PMS收到一个后，又自动将重发功能打 开。当消息重发功能自动打开后，“重复发送打开”将显示在酒店接口消息监视的屏幕上。图2-4显示了自动打开消息的重发功能的过程：图2-4 PMS的自动打开重传机制2.1.6 消息探询探询这个功能主要是为了监视通信端口的状态，是一项系统功能，作为一个选项，有允许和不允许两种选择。可在 PMS接口的功能选择窗口中进行选择。当探询功能为打开状态时，每当PMS接口向串口发送一个消息（和消息除外），就将探询定时器复位到初始值。当探询定时器（Polling Timer, PTMR）超时时，一个探询的消息将发给PMS，探询消息的格式和房态消息的格式一样，消息的文本区为“ST PO”，探询消息和房态消息一样，消息的重发功能也将发生作用。1. 发送探询消息设定：“探询”为打开状态；“消息重传”为关闭。在这种情况下，每当探询定时器超时后，都将发送探询消息。如图2-5所示：图2-5 PMS发送探询消息2. 用探询检查链路问题设定：“探询”为打开状态；“消息重传”为允许状态，并且没有关闭；最大重传数为2。一般来说，PMS接口没有很多房态消息发送给PMS 系统，探询消息可以用来监视消息传送的问题。也就是说，两个连续的消息（一个完全发送循环）可以是探询消息 ，也可以是一个房态消息和一个探询消息。如图2-6、图2-7所示：图2-6 PMS探询失败关闭消息重发机制图2-7 PMS探询和房态发送失败关闭消息重发机制3. 使用探询打开重复发送设定：“探询”为打开状态；“消息重传”为允许状态，但自动关闭；重复发送次数为2。消息重传自动关闭后，当PMS接口收到一个后，又自动打开消息重传功能。一般PMS接口发给PMS 系统的消息不是很多，探询消息将用来检测链路的反应。如图2-8所示：图2-8 PMS探询打开重复发送2.1.7 串口上传输的房态消息格式房态功能提供了一种方便、快捷地更新PMS系统中的房态的方法。当酒店中任一个房间的房态改变时，交换机都将此房态改变的消息通过酒店接口发给PMS系统。PMS系统可利用这个消息给客人开一间干净的客房，同时，监视整个酒店的客房状态。1. 房态消息酒店接口发送给PMS的房态有七种，这些房态消息的语法和含义如下所示：消息含义ST RE未清洁(Cleaning Requested)ST PR清洁中(Cleaning in Progress)ST CL清洁完毕(Room Cleaned)ST PA清洁审核完成(Passed Inspection)ST FA清洁审核失败(Failed Inspection)ST SK跳过清洁(Cleaning Skipped)ST NS不出卖(Not For Sale)房态消息是一个定长记录格式的消息（不带服务员工号），消息中每个域在下面的示例中给出（假定为PMS1或PMS3，即不带）：2. 房态消息格式STXSTXXXXXXXXYYETXBCC(1) 所有空白区为空格；(2) XXXXXXXX=房间号码，最多8个号码，为右对齐（不足用空格填充）；(3) YY=最新的房态（如CL表示“清洁完毕”）；(4) 示例：STXST1010CLETXBCCSTXST17025CLETXBCC3. PMS向酒店接口发送的命令格式不仅酒店接口给PMS系统发送房态消息，PMS也可以通过给酒店接口发送以下消息将指定房间改变到指定的房态。这些命令如下：消息含义SE ST RE未清洁SE ST PR在清洁过程中SE ST CL已清洁SE ST PA清洁检查通过SE ST FA未通过清洁检查SE ST SK跳过清洁SE ST NS不出卖4. 交换机发送房态消息的格式 ST new status 其中： 为房间的电话号码“new status”是房态的两个字符，它可能为以上七种房态的某一个值；当服务员工号放到房态信息中时，房态消息如下所示：ST new status MI NNNN其中，MI为 服务员工号标示，NNNN为1到4位的服务员工号，整个域的长度为4，右对齐（不足用空格填充）。例如：当房态发生改变时，交换机通过酒店接口发送如下的命令给PMS： ST 5006 PA MI 1234其中：5006 房间的电话号码PA清洁状态通过检查MI说明将包括服务员工号1234 为服务员工号2.1.8 串口上传输的Mini吧消息格式客人一般可在自己的房间进行一些酒水的消费，此称为Mini吧。通过交换机的PMS接口，可以用最快的速度将Mini吧信息传到酒店前台。1. 不使用服务员工号时Mini吧的消息格式ST MN STXSTMNXXXXXXXXYYYYYYYYETXBCC其中：=客人房间的号码，8位，使用右对齐（不足用空格填充）；=客人消费的Mini吧信息，8位，使用右对齐，不足8位用空格填充。(1) 所有空白区为空格；(2) XXXXXXX=房间电话号码，最多8位，为右对齐，不足用空格填充；(3) YYYYYYYY=Mini吧消费情况，8位，为右对齐，不足用空格填充。(4) 示例当房间电话为2130的房间的Mini吧消费信息为1000（单位由酒店管理系统确定）时，交换机发送如下消息：STXSTMN21301000ETXBCC2. 使用服务员工号时Mini吧的消息格式ST MN MI其中：=客人房间的号码，8位，使用右对齐（不足用空格填充）；=客人消费的Mini吧信息，8位，使用右对齐，不足8位用空 格填充；MI = 服务员工号标示； = 服务员工号。Mini吧消息格式的例子（省略前面部份）YYYYYYYYMINNNNETXBCC(1) YYYYYYYY=Mini吧消费的金额，8位，为右对齐，不足用空格填充。(2) MI = 服务员工号标示(3) NNNN=1到4位的服务员工号，整个域的长度为4，右对齐（不足用空格填充）。(4) 示例当房间电话为2130的房间的Mini吧消费信息为1000（单位由酒店管理系统确定）时，服务员工号为2100时，交换机发送如下消息：STXSTMN21301000MI2100ETXBCC2.1.9 串口上传输的话单消息格式酒店接口机接收交换机主机发过来的计费话单，然后将它发给PMS系统，这样，当客人在前台结帐时，收银员能方便地计算客人的全部费用。酒店管理系统有的有电话计费功能，有的没有电话计费功能。如果没有电话计费功能，则应该考虑发送带有通话金额的话单。1. 酒店管理系统没有电话计费功能时的话单消息格式PMS接口传给PMS系统的话单消息格式为：ST BI 其中： = 客房的电话号码，即主叫号码，8位，右对齐，不足用空格填充； = 被叫的号码，24位，右对齐，不足用空格填充； = 通话结束时间& 说明：时间格式有两种，一种格式采用的年号为2位，整个时间为17位，另一种格式采用的年号为4位，整个时间为19位。实际采用何种方式将根据酒店前台的需要，进行选择。17位格式为：YY-MM-DD,HH:MM:SS如： 98-01-15,17：34：23；日期和时间用两位数值表示，不足两位，需在前面补0，如98-01-15中的0119位格式为：YYYY-MM-DD,HH:MM:SS如： 1998-01-15,17：34：23；除年份用四位表示外，其它的日期和时间均用两位数值表示，不足两位在前面补0，如1998-01-15中的01 注意：酒店管理系统要注意的问题：(1) 对于酒店接口发过来的串口话单消息，PMS要能识别出其中的时间格式，对于不符合约定格式的话单消息要予以拒绝。(2) 话单消息中的通话结束时间是与交换机严格一致的，PMS接收话单时也要求直接取话单消息中的通话结束时间，不能以PMS本身计算机的当前时间为通话结束时间。 = 时长，5位，以秒为单位，右对齐，不足用空格填充； = 本次通话的金额，6位，以人民币分为单位，右对齐，不足用空格填充。计费消息格式的例子：17位时间格式的消息的总长度为73个字节（包括空格），每个域的长度如下（另，19位时间格式中年号为4位，消息总长度为75个字节）122824175611STXSTBI Dn Called endtimeIntervalmoneyETXBCC17位时间格式的例子：如果房间电话为2110的客人呼叫号码为01063901000的被叫，结束时间为98-01-15,12:30:00，通话时长为6000秒，金额为120元（12000分）人民币，则计费话单消息为：STXSTBI21000106390100098-01-15，12：30：00600012000ETXBCC2. 酒店管理系统有电话计费系统时的话单消息格式在这种方式下，没有金额这一项，PMS接口传给PMS系统的话单消息格式为：ST BI 其中： = 客房的电话号码，即主叫号码，8位，右对齐，不足用空格填充； = 被叫的号码，24位，右对齐，不足用空格填充； = 通话结束时间，时间格式有17位和19位两种，实际采用哪种根据酒店前台的需要进行选择。17位时间格式如：98-01-15,17：34：2319位时间格式如：1998-01-15,17：34：23 = 时长，5位，以秒为单位，右对齐，不足用空格填充；计费消息格式例子：17位时间格式的消息的总长度为66个字节（另，19位时间格式中年号为4位，消息总长度为68个字节），每个域的长度如下所示：12282417511STXSTBI DnCalled end TimeIntervalETXBCC17位时间格式的例子：如果房间电话为2110的客人呼叫号码为01063901000的被叫，起始时间为98-01-15,12:30:00，通话时长为6000秒，则计费话单消息为：STXSTBI21100106390100098-01-15,12：30：006000ETXBCC2.1.10 串口上传输的CheckIn/CheckOut消息格式当客人入住或退房时，酒店管理系统会发送Check In或Check Out消息给酒店接口。从这些消息中，可以了解客房的入住情况。另外，在交换机收到PMS的Check In或Check Out消息时，可能要自动改变客房的长途呼出权限：收到Check In的时候，打开长途权限；收到Check Out的时候，关闭长途权限。另外，一般在星级酒店，也有一个房间多个人的情况，在Check In/Check Out的时候，对于一个房间多个人的情况的处理是很不同的，要慎重考虑。（当然，PMS通过发一个指定的电话权限的消息也能够将这个电话的权限开关到指定的权限级别。）同时支持的四种Check In/Check Out操作如下：1. 只进行Check In/Check Out操作消息此种方式可以了解客房的入住情况。消息格式如下：SE ST CH IN仅只进行Check In操作SE ST CH OU仅只进行Check Out操作其中： = 房间的电话号码，8位，右对齐，不足用空格填充；消息格式例子：房间电话为2110的客人进行Check In后，进行 Check Out。STXSEST2110CHINETXBCCSTXSEST2110CHOUETXBCC& 说明：(1) 在Check Out操作中，要将这个指定客人的信息删除，如果删除后客房中没有人，则要将这个客房的电话权限关闭到只有群内权限。(2) 在这里，因为没有指出客人的姓名，故这个客房的所有客人信息将被删除，电话权限将被关闭到只有群内电话。2. 带电话权限进行Check In/CheckOut这种方式可以在进行Check In/Check Out的同时，进行电话权限的操作。消息格式如下：消息注释SE ST E0 CH IN进行Check In操作，同时开群内电话SE ST E1 CH IN进行Check In操作，同时开市内电话SE ST E2 CH IN进行Check In操作，同时开本地电话SE ST E3 CH IN进行Check In操作，同时开国内长途电话SE ST E4 CH IN进行Check In操作，同时开国际长途电话SE ST EX CH OU进行Check Out操作， 同时关电话权限，使其只有群内权限& 说明：(1) E0、E1、E2、E3、E4为电话权限，分别为群内电话、市内电话、本地电话、国内长途、国际长途；(2) 如果一个客房已经有了Check In，再来一个同样权限的Check In，将不再开电话权限，而仅是修改客人的Check In数据库，如果客人姓名不一样，将把它作为第二个客人的姓名。(3) 如果进行Check Out，并且在Check Out中指定关闭的电话权限，是没有意义的。为了最大的和PMS厂商兼容（例如中软酒店），将允许这种消息存在，但是对于交换机来说，无论是那一个级别，都将关闭到只有群内权限（群内电话免费）。消息格式的例子：房间电话为2110的客人进行Check In，开国内长途，然后进行 Check Out。STXSEST2110E3CHINETXBCCSTXSEST2110E3CHOUETXBCC3. 带客人姓名进行Check In/Check Out这种方式可以在进行Check In/Check Out的同时，进行客人姓名的传送。 注意：(1) 如果要修改客人的姓名，用修改姓名的消息（呼叫姓名显示）实现。(2) 如果用另一个姓名进行Check In， 则认为是同一个房间的另一个客人。消息格式：SECP CH IN带客人姓名进行Check InSE CP CH OU带客人姓名进行Check Out其中： = 客人的姓名，为字符串。为了不和控制字符混淆，姓名用双引号包括。长度为30个字节，其中引号占用两个字节，姓名最多28个字节，左对齐，不足用空格填充。例如：客人“Webster, Mirriam”进行开房，房间电话为5100，然后进行Check Out。SECP 5100 “Webster, Mirriam ” CH INSECP 5100 “Webster, Mirriam ” CH OU4. 带客人姓名和电话权限进行Check In/Check Out这种方式进行Check In/Check Out的同时进行客人姓名和电话权限的控制。在可能的情况下，建议使用这种方式。因为这种方式一次性发送足够的信息，不需第二次发送。消息格式如下：消息含义SE CP E0 CH IN进行Check In操作，同时开群内电话SE CP E1 CH IN进行Check In操作，同时开市内电话SE CP E2 CH IN进行Check In操作，同时开本地电话SE CP E3 CH IN进行Check In操作，同时开国内长途电话SE CP E4 CH IN进行Check In操作，同时开国际长途电话SE CP EX CH OU进行Check Out操作， 同时关电话权限为群内权限& 说明：(1) 如果一个已经Check In的房间收到另一个不同姓名的Check In，则认为是一个房间两个人的情况，如果还有，则继续