酒店接口用户指导书

资料编码产品名称酒店接口

使用对象工程师/合作方工程师/用户产品版本多版本

编写部门固网技术支持部资料版本V1.0

酒店接口用户指导书

拟制：资料开发部日期：2000-12-21

审核：陈永轩日期：2005-03-03

审核：日期：

批准：黄勇日期：2005-03-03

华为技术有限公司

版权所有侵权必究

UI1AVUUI酒店接口用户指导书文档密级：内部公开

修订记录

日期修订版本描述作者

2001-04-24V1.0在抓臭虫活动中，将发现的问题进行修改。谢宁

修改了装帧中的出版说明和出版状态。

1、'深圳华为技术有限公司'改成'华为技

2001-08-31V1.0术有限公司'。孙颖

2、增加’OpitX(TM)'商标。

3、去掉’编辑开发中心’。

2002-10-12V1.0处理发现的BUG、错别字孙颖

2003-03-15V1.0全文检视，文档内容无修改童勋

全文检视，增加缩略语、摘要，更改文档名

2005-03-03V1.0称(原文档名称“酒店接口用户手册”)；陈永轩

将原附件内容合入文档，取消附件。

UI1AVUUI酒店接口用户指导书文档密级：内部公开

目录

第1章概述..........................................................................1

1.1功能概述......................................................................1

1.1.1交换机中的酒店功能......................................................1

1.1.2PMS接口...............................................................2

1.1.3酒店用语音邮箱.........................................................2

1.2组网方式及酒店接口系统的基本组成.............................................3

1.2.1酒店接口机在网中所处的位置及其通信方式..................................3

1.2.2酒店接口系统的基本组成.................................................5

第2章PMS接口协议..................................................................6

2.1串口通信协议.................................................................6

2.1.1串口的使用和分配........................................................6

2.1.2串口协议...............................................................7

2.1.3串口协议的选择........................................................11

2.1.4串口上传输的消息概述..................................................13

2.1.5消息重传..............................................................15

2.1.6消息探询..............................................................19

2.1.7串口上传输的房态消息格式..............................................23

2.1.8串口上传输的Mini吧消息格式............................................25

2.1.9串口上传输的话单消息格式..............................................27

2.1.10串口上传输的Checkln/CheckOut消息格式...............................30

2.1.11串口上传输的电话权限控制消息格式.....................................33

2.1.12串口上传输的留言等待消息格式.........................................34

2.1.13串口上传输的免打扰消息格式...........................................35

2.1.14串口上传输的修改姓名消息格式.........................................35

2.1.15串口上传输的多语言自动叫醒消息格式...................................36

2.1.16串口上传输的VIP贵宾客人叫醒消息格式.................................38

2.1.17串口上传输的留言数目消息格式.........................................39

2.1.18串口上传输的恢复邮箱消息格式.........................................39

2.1.19串口上传输的拷贝邮箱消息格式.........................................40

2.1.20串口上传输的查询邮箱消息格式.........................................41

2.1.21串口上传输的生成邮箱消息格式..........................................41

2.1.22串口上传输的删除邮箱消息格式.........................................42

2.1.23串口上传输的修改邮箱密码消息格式.....................................43

2.2文件共享方式的通信协议......................................................44

2.2.1引言..................................................................44

UI1AVUUI酒店接口用户指导书文档密级：内部公开

2.2.2共享文件的记录格式......................................................47

第3章安装与调试点.................................................................62

3.1安装规范及流程...............................................................62

3.1.1环境要求燃............................................................62

3.1.2安装准备..............................................................62

3.1.3安装流程..............................................................63

3.1.4安装注意事项..........................................................64

3.2硬件安装....................................................................65

3.2.1概述..................................................................65

3.2.2安装酒店接口计算机....................................................65

3.2.3安装CTX卡...........................................................66

3.2.4酒店接口系统与交换机之间接口安装......................................69

3.3软件安装....................................................................71

3.3.1运行环境...............................................................71

3.3.2网络配置..............................................................71

3.3.3终端系统软件安装......................................................85

3.3.4终端系统设置..........................................................91

3.3.5交换机侧的数据设定....................................................96

3.4调试........................................................................97

第4章酒店接口机操作界面...........................................................98

4.1界面简介.....................................................................98

4.1.1界面图.................................................................98

4.1.2系统主菜单............................................................98

4.2系统主菜单操作..............................................................99

4.2.1文件(E)....................................................................................................................99

4.2.2话单管理(B).............................................................................................................99

4.2.3系统管理(X)...........................................................................................................101

4.2.4查询(C)..................................................................................................................106

4.3树视窗口中各节点的操作.....................................................107

4.3.1酒店接口节点..........................................................107

4.3.2酒店功能节点.........................................................107

4.3.3房态节点.............................................................108

4.3.4Mini吧节点...........................................................109

4.3.5计费话单节点.........................................................109

4.3.6CheckIn/CheckOut节点..............................................110

4.3.7电话权限控制节点......................................................111

4.3.8留言等待节点..........................................................112

4.3.9免打扰节点...........................................................112

4.3.10修改姓名节点........................................................112

UI1AVUUI酒店接口用户指导书文档密级：内部公开

4.3.11自动叫醒节点.........................................................113

4.3.12VIP贵宾客人自动叫醒节点.............................................115

4.3.13酒店管理系统接口节点................................................116

4.3.14消息监视节点........................................................119

4.3.15语音邮箱节点........................................................120

4.3.16生成邮箱节点........................................................120

4.3.17清除邮箱节点........................................................120

4.3.18修改口令节点........................................................120

4.3.19恢复邮箱节点........................................................121

4.3.20拷贝邮箱节点........................................................121

4.3.21查询邮箱节点.........................................................122

第5章酒店接口业务操作............................................................123

5.1C&C08机酒店业务..........................................................123

5.1.1CheckIn/CheckOut..............................................................................................123

5.1.2房态.................................................................124

5.1.3自动叫醒..............................................................125

5.1.4免打扰...............................................................126

5.1.5话费结算.............................................................127

5.1.6Mini吧...............................................................128

5.1.7电话权限控制..........................................................129

5.1.8留言灯................................................................130

5.2酒店用语音邮箱.............................................................131

5.2.1生成邮箱..............................................................131

522清除邮箱...............................................................131

523修改口令...............................................................132

524恢复邮箱...............................................................133

5.2.5拷贝邮箱.............................................................134

5.2.6查询邮箱.............................................................134

第6章酒店接口机维护..............................................................136

6.1CTX插卡故障...............................................................136

6.2酒店接口通信出现异常.......................................................137

6.3酒店接口无法连接主机.......................................................137

6.4酒店接口无法维护用户数据、长短号对照表.....................................138

6.5酒店接口取不到话单.........................................................138

6.6酒店接口无法为用户设置叫醒服务.............................................139

6.7酒店接口设置叫醒到100个左右时再也不能设置成功.............................139

6.8酒店接口上Mini吧、房态功能不能实现........................................139

6.9酒店接口不能传送话单.......................................................140

UI1AVUUI酒店接口用户指导书文档密级：内部公开

6.10CheckIn/CheckOut时不能自动生成、删除语音邮箱...........................142

6.11酒店接口不能自动取话单....................................................142

6.12酒店接口上设置用户电话权限时提示号码不存在................................143

6.13酒店接口给酒店管理系统传送的话单有重复的现象..............................143

6.14酒店接口/话务台上提示话单写文件失败.......................................144

第7章串口上传送的消息格式........................................................145

7.1协议介绍....................................................................145

7.2消息格式列表...............................................................146

721接收的消息（PMS接口接收，酒店管理系统发送）.........................146

7.2.2发送的消息（PMS接口发送，酒店管理系统接收）.........................149

第8章共享文件的记录格式..........................................................150

8.1共享文件列表...............................................................150

8.2共享文件详解...............................................................151

8.2.1DHQX.UB--自动开关电话权限文件（由酒店管理系统生成，标记法）.........151

8.2.2FANGTALUB一房态消息文件（由酒店接口生成，标记法）.................152

8.2.3MIN旧AR.UB-Mini吧消息文件（由酒店接口生成，长度法）................152

824YYYYMMDD.HD一话单消息文件（由酒店接口生成，长度法）................152

825口UYAN.UB-留言灯消息文件（由酒店管理系统生成，标记法）..............153

8.2.6MDR.L旧--免打扰消息文件（由酒店管理系统生成，标记法）................153

8.2.7KEREN.UB—Checkln/CheckOut消息文件（由酒店管理系统生成，长度法）.....153

8.2.8XGXM.UB一修改姓名消息文件（由酒店管理系统生成，长度法）...........154

829JIAOXING.LIB一自动叫醒消息文件（由酒店管理系统生成，长度法）.........154

8.2.10LYSM.UB—留言数目文件（由酒店接口生成，标记法）...................154

8211HFYX.L旧一恢复邮箱消息文件（由酒店管理系统生成，长度法）............154

8212KBYX.LIB一拷贝邮箱消息文件（由酒店管理系统生成，长度法）............154

8213CXYX.LIB一查询邮箱消息文件..........................................155

8214GBKR.UB—贵宾客人消息文件（由酒店管理系统生成，长度法）............155

8215MAKEMAIL.LIB一生成邮箱消息文件（由酒店管理系统生成，标记法）.......155

8.2.16DELMAIL.UB一删除邮箱消息文件（由酒店管理系统生成,标记法）........155

8.2.17MODPW.L旧一修改邮箱密码消息文件（由酒店管理系统生成，标记法）....155

UI1AVUUI酒店接口用户指导书文档密级：内部公开

关键词：

酒店接口、PMS、PMSL用户指导书、串口、消息格式

摘要：

本文主要描述了酒店接口软件的调试与维护，对网上该产品的安装、调试与维护有指导意义。

缩略语清单：

参考资料清单：

UI1AVUUI酒店接口用户指导书文档密级：内部公开

第1章概述

1.1功能概述

在信息技术日益重要的今天，如果要想拥有一家成功的酒店，除了要提供完

善的设施和良好的服务外，还要拥有先进的酒店通信设备。在酒店行业中，

先进的通信技术不仅可以方便客人，提高酒店的形象，而且可以改善酒店的

管理水平。华为公司生产的C&C08酒店接口机正好满足了现代酒店对先进通

信技术的需求。

C&C08酒店接口机的作用是将酒店管理系统与华为公司的C&C08程控交换

机连接起来，从而提供良好的酒店通信服务。与酒店接口机配套的C&C08程

控交换机的版本包括V610R003、V610R005,V610R103,和V610R105。

C&C08酒店接口机的主要功能可分为三个部分：交换机中的酒店功能、PMS

接口和酒店用语音邮箱。

1.1.1交换机中的酒店功能

交换机中的酒店功能包括：Checkin/Checkout,房态、设置叫醒、免打扰、

Mini吧、留言通知、电话权限控制、话费结算、语音邮箱管理等业务。

・Checkin/Checkout（客房入住情况）

当客人入住时，自动开办客人的长途呼叫权限；当客人退房时，自动关闭客

人的长途呼叫权限。同时，利用这些入住/退房信息，可以得到酒店客房的入

住情况。

•房态

可通过话机通知PMS系统关于客房的状态（房态）。房态分为未清洁、清洁

中、清洁完毕、清洁后已审核、清洁后未通过审核、跳过清洁、不开房等。

让酒店管理人员及时了解客房状态，合理调配客房入住情况。

・设置叫醒

“设置叫醒”业务可分为“自动叫醒”、“多语言叫醒”、“VIP叫醒”。交

换机可以在五分钟内向500个房间提供自动叫醒服务。若没有人接听，隔五

分钟再次振铃，如此反复。若三次之后依然无人接听，则通知话务台人工干

预，同时在打印机上输出记录。若此酒店同时使用酒店资产管理系统（Property

ManagementSystem,PMS）,可以在入住时设定自动叫醒的语种，使客人

2005-01-26华为机密，未经许可不得扩散第1页，共163页

酒店接口用户指导书文档密级：内部公开

UI1AVUUI

宾至如归。在特殊情况下，可使用VIP贵宾叫醒，让话务员提供人工叫醒，

提高服务的等级。

・免打扰

可以为客人设定电话免打扰服务，此种服务可分为个人、集体两种方式。

•Mini吧

客人可以在自己的房间进行消费，这些消费的信息可以通过客房的话机输入,

然后交换机通过PMS接口将它送到PMS系统中。

•留言通知

当客人有留言时，可以通过设定留言等待命令将客房的留言灯打开，以通知

客人有电话留言。

・电话权限控制

通过接收PMS系统发来的命令，可以按要求设定客房的电话权限。

・电话计费

将客人房间电话的详细计费话单通过PMS接口送到PMS系统中。

・服务员工号

服务员执行酒店功能操作时，可以输入自己的工号，并且交换机将验证工号

的长度。

可见交换机中的酒店业务可以满足现代酒店的需要，不但提高了酒店的管理

水平，也给客人带来更方便，更亲切的服务。

1.1.2PMS接口

PMS接口即“资产管理系统(PropertyManagementSystem,PMS)”接

口。该接口将酒店电脑系统同C&C08交换机连为一体，支持酒店电脑系统同

交换机之间的信息交换，用于客人的入住/退房、客人资料、客人状态、客人

在酒店内的饮食娱乐消费等费用管理工作。客人免除了除登记、结帐外的其

它手续，且收到的帐单上包括全部费用，丰富了酒店管理系统中的业务功能,

方便了客人，提升了酒店形象。

1.1.3酒店用语音邮箱

每个客人在酒店开房后，都会分配到一个使用缺省口令和欢迎词的语音邮箱。

客人可以在邮箱中定制一段自己的语音来作为自己的欢迎词。另外，作为个

人邮箱，客人还可把自己的名字记录在欢迎词中，以免误拨电话。如果从客

2005-01-26华为机密，未经许可不得扩散第2页，共163页

酒店接口用户指导书文档密级：内部公开

UI1AVUUI

人的房间以外访问这个语音邮箱，将会提示输入密码（口令）。缺省的口令

为客人的姓名或CheckIn的时间（为了保密，客人可以改变此登录口令）。

当客人不在时、如果有呼叫进来，则主叫可以在客人的语音邮箱中留言。客

人房间中的留言灯（有未读信息时亮，无时灭）将会提示客人其邮箱中是否

有未读的消息。若有，客人可登录到自己的语音邮箱听取留言。

当客人退房时（进行CheckOut）,所有的留言（读过的或没读的），都将

移到一个叫CheckOut的邮箱中，并在这个邮箱中保留一段可选的时间。在

这段时间内，客人可以使用CheckOut的语音邮箱服务，来听取留言。另外

还有Re-Checkin（恢复邮箱）的功能，该功能可将客人在Chechout邮箱的

留言移到客人原来的CheckIn邮箱中。

当一个客人从一个房间移到另一个房间时，可通过PMS接口的拷贝邮箱的命

令将客人的留言和祝贺词转移到该房间的语音邮箱中。

1.2组网方式及酒店接口系统的基本组成

1.2.1酒店接口机在网中所处的位置及其通信方式

酒店功能组网方式如图1-1所示。

2005-01-26华为机密，未经许可不得扩散第3页，共163页

UI1AVUUI酒店接口用户指导书文档密级：内部公开

•G-akinGukdt•awn

.豳•电舐询ij

.蹲I®.管酗箱

•知就•激攫

•Mi吧

脚照GGK酷斓矩

图1-1C&C08酒店功能组网图

如图1-1,C&C08的酒店接口机（即PMS接口）使用ISDN的2B+D技术同

C&C08交换机相连，将酒店管理系统同C&C08交换机连为一体，支持酒店

管理系统同交换机之间的信息交换。

酒店接口与酒店管理系统的通信方式有两种，一种方式是通过RS232链路，

通过串口进行通信，可以有一个或多个串口（最多三个）；另一种方式是通

过网络的文件共享的方式进行通信。

在串口方式中，酒店接口和酒店管理系统之间通过串口协议进行通信，为了

最大程度地和国内PMS厂商集成，PMS接口的串口通信提供了四种协议：

PMS1协议、PMS2协议、PMS3协议、PMS4协议。相关内容可参见第二章

和附录。

在文件共享方式中，酒店接口和酒店管理系统之间通过共享文件进行通信，

这些文件都是定长记录的二进制文件。通过记录文件的长度和设置文件记录

中的标记两种方式来决定需要传递的消息。相关内容可参见第二章和附录。

2005-01-26华为机密，未经许可不得扩散第4页，共163页

酒店接口用户指导书文档密级：内部公开

UI1AVUUI

文件共享方式的特点是准确可靠。例如，当要设定某个话机的电话权限时，

能够保证最终会设定成功，不会因为通信故障而没能设定。如果由于某种原

因而没有设定成功的话，以后会再次进行设定，直到设定成功为止。

事实上，在PMS接口的串口方式中，对于电话权限、免打扰、留言灯等消息,

从串口上收到以后都会保存到文件中去，如果设定失败，以后会从文件中读

出再次进行设置，直到设定成功为止。

1.2.2酒店接口系统的基本组成

用户线

DSL板CTX卡

网卡或网络或网卡或

串口串口线串口

交换机酒店接口PC机酒店电脑系统PC机

图1-2交换机与酒店电脑系统的连接方式

・硬件系统

硬件系统包括一台酒店接口PC机（硬件配置推荐为586主机、32兆以上内

存。）、华为公司自行设计生产的CTX卡、网卡（或串口线）等。PC机上

的CTX卡通过用户线与C&C08交换机上的DSL板相连，完成与C&C08交

换机的连接。酒店接口机与酒店管理系统之间的连接根据通信方式的不同可

使用串口线或网线进行连接。通过串口进行通信时使用串口线，通过网络文

件共享的方式进行通信时使用网线。连接方式如图1-2所示•

酒店接口PC机又叫PMS接口或酒店接口机；酒店管理系统PC机又简称为

PMS或酒店管理系统。

・软件系统

酒店接口的软件系统为运行在中文Windows95或Windows98平台上的一套

酒店接口的终端系统软件，完成C&C08酒店接口机的酒店功能。

2005-01-26华为机密，未经许可不得扩散第5页，共163页

UI1AVUUI酒店接口用户指导书文档密级：内部公开

第2章PMS接口协议

接口系统使用ISDN的2B+D技术同C&C08交换机相连。接口系统与酒店电

脑系统的连接方式有两种，一种是通过网络的文件共享方式进行通信，一种

是通过RS232串口进行通信。下面就这两种通信方式的协议及各种消息格式

进行详细的说明。

2.1串口通信协议

2.1.1串口的使用和分配

串口上传输的消息根据传输的方向可分为两部分，一是从交换机发给PMS系

统的消息，如房态消息、计费话单消息、Mini吧消息、语音邮箱留言数目消

息；二是从PMS系统发给交换机的消息，如叫醒、免打扰、客房入住情况、

留言等待、电话权限控制等消息。传输时使用的是交换机和酒店管理系统之

间的PMS接口。为了最大程度地和国内PMS厂商集成，将支持3个串口。

其使用分配组合如下：

使用一个串口

串口1：PMS系统发给交换机的所有消息及交换机发给PMS系统的房态、

Mini吧消息、计费话单消息、语音邮箱留言数目消息。

串口2：空闲。

串口3：空闲。

使用两个串口

串口1：PMS系统发给交换机的所有消息及交换机发给PMS系统的房态、

Mini吧消息、语音邮箱留言数目消息。

串口2：交换机发给PMS系统的计费话单消息。

串口3：空闲。

或

串口1：PMS系统发给交换机的所有消息。

串口2：交换机发给PMS系统的房态、Mini吧、语音邮箱留言数目消息、计

费话单消息。

2005-01-26华为机密，未经许可不得扩散第6页，共163页

酒店接口用户指导书文档密级：内部公开

UI1AVUUI

串口3：空闲。

使用三个串口

串口1：PMS系统发给交换机的所有消息。

串口2：交换机发给PMS系统的房态、Mini吧消息、语音邮箱留言数目消息。

串口3：交换机发给PMS系统的计费话单消息。

建议使用方式2和3,因为方式1易引起PMS接口链路异常紧张。但由于和

PMS集成的可能性多种多样，在PMS接口链路不紧张的情况下，仅使用一

个串口是有可能的。故在这里提供这种方式。

2.1.2串口协议

为了最大程度地和国内PMS厂商集成，PMS接口的串口通信提供了四种协

议：PMS1协议、PMS2协议、PMS3协议、PMS4协议。下面分别进行介

绍。

PMS1协议

(1)PMS系统

(a)发送

所有消息的格式必须为后面给出的消息格式。

PMS必须为每个消息计算＜BCC＞,并且将它当成一个结束字符传送。＜BCC＞

为在＜STX＞之后＜ETX＞之前，并且包括＜ETX＞的所有字符的循环校验码(这

些字符的位异或，为了处理的方便，如果结果刚好等于“\0”(0x00)则转换为

0x20)。

当传送了一个完整的消息后，PMS系统必须等2秒。如果2秒之后，PMS没

有收至kACK＞,或者收至U＜NAK＞,PMS将认为消息丢失，并且将根据配置确

定是否进行重传。重传预定的次数后，进行下一消息的传送。PMS必须有一

个队列进行传输，如果这个队列溢出，消息将丢失，如果有消息丢失，PMS

应该进行提示。

△主意：

另外一个重发的机制是三次重发后，将这个消息保存在PMS的错误文件中,

并继续发送下一个消息。上面所讲的机制适用于短期的链路故障。

2005-01-26华为机密，未经许可不得扩散第7页，共163页

酒店接口用户指导书文档密级：内部公开

UI1AVUUI

当PMS系统发送一个消息后，若立即收到一个＜NAK＞,PMS在进行重发之

前必须再等待1秒钟。若经过这样的三次，则PMS应该将消息保存到一个错

误文件中，并且进行下一个消息的发送。如果有消息丢失，PMS应该将错误

报给系统管理员。在查明错误的原因后，应该用数据库交换进行再同步.

当PMS发送一个消息后，若立即收到一个＜ACK＞消息，它在发出第二个消息

之前必须再等待1秒钟。

PMS在收到一个消息后，应该发回一个＜ACK＞或者＜NAK＞。发送＜ACK＞或

者yNAK＞消息必须在发送完一个消息后进行（此时，如果有消息在发，必须

将此消息发送完后才能发送＜ACK＞或者＜NAK＞）。例如：如果PMS在发送

一个消息的中间过程，它必须在发送完以后，再发＜ACK＞或者＜NAK＞。如下

所示：

＜STX＞MessageBody＜ETX＞＜BCC＞＜ACK＞

（b）接收

当PMS收到一个完整的消息后，PMS必须计算＜BCC＞的正确性，检查完后，

必须发回一个＜ACK＞或者＜NAK＞。在此过程中检查到错误要放到一个文件中。

PMS不能发送任何错误的响应给交换机，如“无效的命令”，“语法错误”

等。

（2）交换机

（a）发送

所有消息格式应该采用给出的消息格式。

交换机必须计算＜BCC＞码，并且将它作为一个消息的结束字符。

当传送了一个完整的消息后，交换机系统必须等2秒。如果2秒之内，交换

机没有收到＜ACK＞,或者收到＜NAK＞,交换机将认为消息丢失，并且进行重

传。交换机进行重传，若经过同样的三次，则应该将该消息保存到一个错误

文件中，并且进行下一个消息的发送。同时，交换机应该将错误报给管理员。

在查明错误的原因后，应该用该错误文件进行再同步。

当交换机发送一个消息后，立即收到一个＜ACK＞消息，它在发出第二个消息

之前必须再等待1秒钟。

交换机在收到一个消息后，应该发回一个＜ACK＞或者＜NAK＞。发送vACK＞或