中软酒店管理系统-接口部分.doc

中软酒店管理系统CSHISINTERNATIONAL®功能手册15
第13章、中软酒店管理系统-接口部分 2
13。1、电话计费 2
13。1。1、登陆计费系统 2
13。1.2、状态监视窗口 5
13。1。3、信息查询 6
13.1。4、串口信息 7
13。1。5、串口信息ASCII 8
13。1.6、录入话单 8
13.1.7、话单查询 8
13.1.7、原始话单 9
13.1。8、暂停计费 9
13。1.9、恢复计费 10
13。1。10、 注意事项 10
13.1.11、 电话计费调试流程 11
13。2、电话pms功能 12
13。2。1、登陆pms系统 12
13.2.2、状态监视窗口 12
13。2.3、酒店功能 13
13.2.4、pms 调试流程 14
13.3、电话房态及电话MINIBAR功能 15
13.3。1、电话房态系统登陆 15
13。3。2、状态监视窗口 15
13.3.3、电话房态的原理及注意事项 16
13.4、会员卡接口 16
13。4。1、会员卡接口配置 16
13。4。2会员卡配置方法 16
13。5、门锁卡接口 30
13。5。1、门锁卡接口配置 30
13.5。2、门锁卡接口需要厂商提供参数 32
13.5。3、门锁卡接口调试注意事项 32
13。6、户籍发送接口 33
136。1、户籍发送软件接口说明 33
13.6.2、户籍发送系统配置说明 33
13。7、证件扫描功能 36
13.7。1 证件扫描的安装 36
13。7。2 证件扫描调试中的可能问题 36
13。7。3 证件扫描的使用 37
第13章、中软酒店管理系统—接口部分
接口部分体现中软软件强大的扩展性和兼容性。其中包括：电话计费，电话pms，电话房态MINIBAR挂账,语音报吧,宽带计费，vod计费，房控接口，门锁接口，会员卡接口，证件扫描接口,银行信用卡接口 等 并随着业界技术不断的更新发展，我们的接口也随之增加.
13.1、电话计费
13。1。1、登陆计费系统
进入操作系统后cspmain.exe图标运行酒店管理系统，如图13—1所示：
双击该图标运行酒店管理系统

图13-1
在登录界面的右上方输入操作员代码及密码（密码长度小于等于13位）如图13—2所示
输入操作员代码及密码

图13—2
登陆完毕后点屏幕左下角，进入接口程序点击电话系统进入到计费屏幕,进入后电话计费自动启动（如何自动启动见系统配置电话部门) 图13-3
单击电话系统进入

图13—3
13。1。2、状态监视窗口
状态监视窗口是计费系统主界面.主要起到监控电话系统运行情况作用如图13-4
显示通话时间：以秒为单位
显示拨达电话的所属地区
显示分机所属房间或酒店部门
显示分机打出的电话号码
显示总的应收费用
蓝色代表现在处在状态监视功能
显示电话发送的串口信息、

显示收取的附加费
显示收取的服务费功能
显示计费单价
显示电话开始通话时间
显示酒店的分机号码
此部分不属于计费部分内容以后详细介绍
绿色代表电话计费系统已经启动
显示电话发生的日期

图13—4
13.1.3、信息查询
信息查询的主要功能查询客人的或酒店部门一段时间的电话单记录情况。其中起始日期和止期是必须输入域 和如图13—5
蓝色表示进入信息查询功能
按不同的分机类型例如：客房，办公，查询
查询的结束日期
查询的开始日期
可以分别输入分机号码，房号，和帐户名称
可以查询一段金额的电话单
输入完条件点查询，查询结果可以打印
按酒店的不同部门查询
可以分别按，国际，国内，市话，郊话来查询
按被叫号码进行查询

图13—5
蓝色代表运行串口信息功能
13.1。4、串口信息
串口信息功能与windows的超级终端功能一致，显示交换机吐出的串口信息如图13—6
下面区域显示对应上面串口信息显示的ASCII
上面区域显示交换机的串口信息

图13-6
13。1.5、串口信息ASCII
目前功能与串口信息功能完全一致 详见13。1。4
13.1。6、录入话单
录入话单功能，可以手工输入相应的打电话信息。当由于某些不可测原因造成的跑单发生时，可以手工补齐话单.防止跑单 如图 13-7
代表此业务是正常发生，还是要冲减的项目
输入完开始和结束时间，时长可以不输入
输入电话拨打的开始时间和结束时间
输入拨打的电话号码
选择要录入的日期
选择分机号码
单击录入话单功能弹出录入话单窗口

图13—7
13。1。7、话单查询
话单查询功能与信息查询功能完全一致,详情查看13。1。3
13.1。7、原始话单
单击原始话单进入查询界面
此功能用来查询交换机的串口信息是否符合系统中的话单格式的配置。如图13-13
把查找出来的记录存为excel文件放在c:\cshis下
删除查找出来的记录
点击显示选种记录的ascii信息
点查询按条件显示
开始查询的日期和结束日期
开始查询的时间和结束时间
选择要查询内容的状态

图13-13
13。1。8、暂停计费
单击显示红色，停止计费
点击暂停计费立即停止计费功能并且暂停计费显示红色 图13—9
图13—9
单击恢复原有颜色，重新计费
13。1.9、恢复计费
暂停计费后，点恢复计费重新恢复计费 图13—10
图13—10
单击退出按纽，需要输入登陆操作员的用户名和密码才能退出电话计费，防止误操作
13。1。10、 注意事项
· 在电话计费过程中要注意的事情如图13-11
图13—10
·当电话由于网络原因,或着长时间(1小时)没有收到话单,屏幕上方会闪动红色 如图13-11
图13—10
·电话计费下拉菜单中的关闭警报 如图13-11
关闭报警功能请误随便点击，选上后将没有报警功能

图13-11
13。1。11、 电话计费调试流程
提示：
具体电话相关配置祥见 系统配置中的电话配置。硬件方面必须有单独的串口线来与工作站相连，不能与其他功能走一个线。

13。2、电话pms功能
电话pms功能主要实现酒店可以直接通过前台系统来实现开关长途，叫早服务，宾客免扰,语音留言等功能
13。2。1、登陆pms系统
登陆pmd系统与登陆系统计费系统完全一致见图 13—1，13-2,13-3
13。2.2、状态监视窗口
蓝色显示停在状态监视窗口
状态监视窗口动态显示每一条pms功能实现的状态 如图 13—12
向交换机发送的信息
次数代表某一个规程执行的次数
步骤显示通讯规程停在第几步
绿色代表pms功能已经启动
设置的时间
显示纪录功能是否完成：
显示实现的功能名称
监视窗口

图13-12
13。2。3、酒店功能
在电话系统中可以通过此功能来实现pms功能 如图13-13
叫醒时间只对叫醒起作用
功能选择是相应的功能项目的选择
分机号码
单击酒店功能按钮弹出酒店

图13—12
项目
功能选择项目
说明
酒店功能设置(此功能主要用于测试)
国际长途
开关国际长途业务
国内长途
开关国内长途业务
郊区电话
开关郊区电话业务
市内电话
开关市区电话业务
Chick in
发送chick in 信息
Chink out
发送chick out 信息
留言灯
开关电话留言灯,(针对交换机）
语音信箱留言灯
开关电话留言灯，（针对语音卡）
电话叫早
设置取消电话叫早功能
宾客免扰
设置取消宾客的免打扰功能
宾客姓名
发送宾客的姓名给交换机
授权码
此功能用于房间中多个客人分别记录电话消费的(交换机必须支持）
语音信箱
开关语音信箱的业务
团队屏蔽
用于屏蔽团队客人的电话，功能开通后散客将不能给团队客人去电
修改语音信箱信息
当语种信息发生变化时，发送更改信息
13.2。4、pms 调试流程
提示：
pms配置主要是两点就是通讯规程和命令格式。具体配置祥见系统配置中的电话配置。硬件方面必须有单独的串口线来与工作站相连，不能与其他功能走一个线。并且检查系RMSTUS中有TEL的触发器

13.3、电话房态及电话MINIBAR功能
电话房态功能的作用，由服务员直接通过酒店客房中的电话更改酒店系统中的房间状态,可以减少通报客房中心过程，增加员工的工作效率 。电话MINIBAR通过服务员直接对电话操作，给房间挂账，可以减少操作流程。
13.31、电话房态系统登陆
登陆电话房态系统与登陆系统计费系统完全一致见图 13-1,13-2,13—3
13.3.2、状态监视窗口
蓝色表示在状态监视窗口
状态监视窗口起到监控电话房态的运行情况如图13—13
挂帐金额代表MINIBAR的挂账金额
显示操作的房间
操作分机号码
操作的时间
显示房态的操作项目
此区域显示电话房态功能

图13-13
13.3。3、电话房态的原理及注意事项
·电话房态MINIBAR挂账的原理与pms功能相仿.都是计算机与电话交换机进行通讯。不同的是房态控制和MINIBAR挂账主要是通过串口发给电话交换机发命令字符.
·要实现电话房态和MINIBAR挂账功能，首先需要管交换机厂商要相应的参数。并且交换机要有相应的串口.因为酒店系统一个串口线只能实现单一功能.（电话房态和MINIBAR算一个功能）
13。4、会员卡接口
会员卡功能主要实现酒店的会员管理功能.，并同时起到给客户打折，积分返还等功能
13。4.1、会员卡接口配置
所需文件：CsmemCard.dll， MWIC_32。DLL， csmis.ini
13.4。2会员卡配置方法
一 基本配置
1。
hotel。ini 中
[会员卡］
使用会员卡=YES
会员卡制卡串口=COM1，机器名1, 机器名2…；COM2, 机器名3, 机器名4;COM3…
会员卡默认模板=
Csmis。ini文件
[会员卡参数]
密码=
｛缺省是211149}
·在 cshis中的sysBAR。INI 中
[Sysinfo］
Opercd=91397
［Skin]
SkinColor=12632256
BackgroundColor=13421504
［MakeCard]
AutoReadCard=N（用会员卡的机器中此处必须是N）
·在hotel。ini中
2。
如果工作站需要制卡则
系统配置à系统信息配置à工作站配置中
制卡工作站号=本机工作站号
3。
配置会员卡交易代码及对应餐厅付款代码
系统配置à交易及费用配置à交易代码中
系统配置à销售点系统配置à费用及付款中
4。卡类配置
系统配置à交易及费用配置à消费卡类型卡属性及说明
信用卡:可冲值，可透支
冲值卡:只可冲值，不能透支
次数卡:此类受[可用刷卡次数］的限制，只有在卡的［刷卡次数］〈［允许刷卡次数]时次数卡可以使用，
5。累计消费及积分配置
系统配置à交易及费用配置à费用分类
只有［会员卡累计］有效时，该的费用分类的消费才可以被累计消费和计算积分
积分比例： 每xx元的此类消费可积一分
起算费用: 只有在 消费金额 〉 起算费用 时才开始积分,
起算积分因子: 本类消费在达到起算费用时的积分
积分公式
if 消费<起算费用 then
积分=0
else
积分=起算积分因子 ＋ （ 消费 - 起算费用 ) div 积分比例
二.会员卡优惠模板配置
1。 优惠模板
客史系统à会员卡列表à操作à定义优惠模板
a。模板属性
标准：只可定义与数量无关的优惠政策(前台房价折扣，餐厅折 扣）
自定义:可定义所有类型的优惠政策
建议:如无特殊需要尽量使用标准类型的优惠模板
2。定义优惠政策
定义优惠模板窗体中à定义优惠政策（鼠标右键）
前台房价折扣： 定义一次订房超过x间房时可使用的房价折扣
技巧： 新建时 在房类处点ctrl+a 则自动选中所有房类
前台特价房: 定义对应房类在优惠期间(订房的来离期必须完全包含在优惠政策的有效期之内）订房时可使用x次优惠房价
前台免费房晚: (结帐时使用)定义在结帐时可免除某种房类x天的房费 (住房的来离期必须完全包含在优惠政策的有效期之内）
注意：使用此优惠政策不会把帐户余额冲成负数（如:房价200 住了2天 帐户余额300，
使用此优惠政策免两天房费后 帐户余额=0而不会等于-100
餐厅折扣
禁用：如选择则此卡不能在对应销售点使用
免服:是否免收服务费
大类折扣：如选择则按屏幕右侧大类中的定义进行折扣
强行折扣: 如选择则不管在销售点配置中定义是否可打折，都强行按此处的折扣打折
三。制卡
此处以制折扣卡为例
1。 进入客史系统=>会员卡=>制卡
2。 在制卡屏幕中填写会员相应信息
姓名：会员卡的持卡人姓名，输入姓名后系统会自动查找宾客历史档案,若没有该客人的客史,则系统弹出如下窗口:
在该窗口中填写该客人的详细资料，包括：签名模式、照片等图片(签名模式和照片目前只支持jpg格式）。若已经存在同名宾客历史，则系统弹出如下窗口:
在该窗口中可以选择某一个已存在的客人或重新创建客史。
优惠模版：在制卡时可以为该卡指定一个优惠模版，通过选择模版，可以设定该卡在前台及餐厅的折扣率等优惠项目,在这里若不选择模版，也可以制卡,但需要使用“设置优惠政策”功能为该卡指定优惠政策,即在前台、POS等的折扣率及其他优惠。
参考号：客人将会员卡片上印制的号码输入到参考号处,便于以后查询
卡号：系统自动生成，不用修改
卡类型：选择相应卡类.若之前选择了优惠模版则这里会自动填充。
有效起、止期：该卡的使用有效期
密码：客人为会员卡设置密码
备注:可以填写关于卡的任何信息。
无姓名卡:若发卡时不清楚客人身份,可以选择“无姓名卡",则不必输入持卡人姓名.
填写会员卡持卡人资料入下，点击确定进入制卡窗口：
3. 制卡窗口操作
在该窗口点击“开始"完成制卡，制卡后关闭该窗口
13。5、门锁卡接口
门锁接口通过酒店系统直接制作房卡和注销房卡
13.5。1、门锁卡接口配置
所需文件：
1）系统信息配置-工作站配置中的—工作站号=制卡工作站

2)hotel。ini中 注意配置相应的选项
[会员卡］
自动制钥匙=YES
使用一卡通=NO
门锁卡制卡串口=COM1，机器名
默认离店时间=12：00
结帐自动废卡=NO
3）调试时，注意将门锁提供的接口文件拷贝到工作站的c：\cshis\
4） 将公司做好的接口程序和csmis文件,test。exe文件拷贝到工作站的c:\cshis\,同时按照接口说明将csmis文件修改好
5)使用test。exe测试制卡，读卡,开门，通过后,将该程序关闭，使用中软系统制卡、读卡
13。5.2、门锁卡接口需要厂商提供参数
中软酒店管理系统门锁卡接口部分需门锁制卡公司提供的资料：
完整的PROPERTY MANAGEMENT SYSTEM（PMS）接口规范:
硬件连接方法，连接线接法
初始化制卡设备，关闭制卡设备方法
根据宾馆业务，制新卡（开房)，复制卡(房间合住），修改卡（延住等），作废卡（结帐)，挂失卡（丢失），校验卡(读卡）等的调用方法
对POS系统的接口，即对卡片其他轨道的读写能力
二·在接口方面若有疑问,提供必要的技术支持
应有详细的接口函数说明,最好提供delphi调用范例
注:提供调用的接口函数,必须为Windows32位动态库。
要求必须有厂家提供的相关的EXE直接调用接口动态库,可现场测试。
接口动态连接库,还要有参数说明，最好有厂商自己的测试程序
13。5.3、门锁卡接口调试注意事项
调试门锁之前，确保机器端口可以正常运行，首先要保证门锁厂商的调试程序可以调通.,如果不通说明，厂商处就有问题,需要联系厂商,保证他们自己的软件可以调通。在厂商的程序调通的前提下，可以用公司自己的测试程序调试！,在调试成功的前提下，再用前台程序进行调试。以便确定是那一个部分的问题,依次解决.
13。6、户籍发送接口
户籍发送是根据公安局的格式内容把客人的信息传送给公安局的软件上，再通过软件发送给公安局
13。6。1、户籍发送软件接口说明
户籍发送是根据当地公安户籍部门提供的户籍接口规范生成符合规范最终的户籍文件，一般形式为文本文件（＊。txt）或数据库文件(＊。dbf，＊。mdb)等.
接口动态库名称为police.dll
CSHIS 主程序需调用
police。dll中SendToPolice 过程
户籍发送的所有工作在 SendToPolice过程中完成。
具体实现可参考实例
应注意的一些问题：
籍屏幕中没有对应的输入域
户籍接口规范中有些必需输入的项目而在中软系统户籍屏幕中没有对应的输入域，此时可与户籍系统人员沟通是否可把某些项目的内容固定,如把职业固定为‘其他’民族固定为‘汉族‘.或在户籍屏幕中其他未使用的内容代替，如用‘邮政编码’代替‘民族’，但这种方法需要求前台操作员严格按规范输入。否则可能造成生成的户籍文件对方户籍系统无法识别。
代码化问题
有时户籍接口规范中许多内容需要以代码化形式出现，如：性别 男＝‘1‘女＝’2‘ 则应自行转换，
汉字双字节问题
例如：有时户籍接口规范中要求客人姓名长度为20字节，应从酒店系统中ACCOUNT表中acctnm字段中获得，该字段长度为40字节,则只能截取acct_nm字段前20位,这时就应判断截取后的最后一个汉字是否被截掉一半,否则汉字可能出现乱码。 函数function chinesefont_convert（sourcestr：string；len:integer)：string；可判断
并自动截去最后的乱码。
重复发送问题
为避免已经发送过户籍的客人，重复发送可在发送同时在ACCOUNT表中为已发送的客人打标记，用reserved2字段(reserved2字段共30位开房时缺省为‘＊＊＊*＊＊*＊******＊＊＊＊＊*＊*＊＊*＊＊＊*＊’,由于门锁卡可能也用到reserved2字段,为避免冲突规定门锁卡使用1—15位,户籍使用16—20位， 打标记时请勿改动其他位。）
13。6。2、户籍发送系统配置说明
一 环境配置
1． 在控制面板-管理工具中添加ODBC数据源，选择(miscrosoft paradox driver ＊。db 给该数据源起名为 ’Paradox Files’.操作系统一定要打补丁sp2，否则生成时报错。
Paradox Files 的数据库位置指向c：\cshis\
2． 在控制面板—区域管理中修改机器日期,时间格式。设为’yyyy-mm—dd hh—mm-ss’ 24小时制.
3． 在中软系统工作目录 \\服务器\temp\下查找是否有acctcard。udl文件。如果没有，请创建.
如果是数据库方式发送,则acctcard.udl指向要发往的数据源.
如果是文本方式，则acctcard.udl与cs2000.udl指向同一个服务器。
4． 根据户籍发送格式的要求，在Cs2000.udl所指的数据库中创建四张表.表名分别是:
acct_nation 本国人到店户籍表
acct_foreign 外国人到店户籍表
acct_nationleave 本国人离店户籍表
acct_foreignleave 外国人离店户籍表
以上四张表要按照户籍发送要求格式字段创建，字段类型都为char,长度按要求走。
二 户籍格式配置
屏幕各部分说明：(顺序从上到下，从左至右）
1． 户籍发送种类:本国到店,外国到店，本国离店，外国离店。点击不同的单选钮，下面将调出相应的格式文件。
2． 发票种类显示/隐藏：点击该处，将显示或隐藏左侧选择栏，可以加大格式设计窗口
3． 报表格式设计:对相应的格式进行修改，按照户籍发送的要求进行修改。将需要的字段拖到Details中。
下面介绍一些常用的字段处理方法:
a. 日期时间字段的格式处理：报表文件字段的默认格式为’yyyy—mm—dd hh—mm—ss’，一般的,公安局要求的日期时间字段的格式与默认格式不相符.当不相符时，需要对其进行格式处理。例:如果要求格式为’yymmdd’ 则建立一个formula,在formula中用replace函数把'—‘去掉.Replace（‘2002-11—11’，‘—‘ ，’’）,显示出来就是’20021111'.
b. 性别字段处理:传入的数据为‘男'，‘女’，要将她转化为’1'，’2'
4． 复选框—-—多次发送：所谓多次发送是指，如果选上,则程序允许发送以前发过的户籍.如果不选，则只发未发送过的。
5． 复选框--—包括团队：是否包括团队主单。
6． 后缀:每条户籍记录结尾的标记。
7． 分隔符：一条户籍记录中,字段之间的分隔符。
8． 方式：是指户籍记录是发送到数据库中还是发送到文本文件中。(如果一个客人一个文本文件,就选择xml方式)
9． 本国人文件路径:包含两个路径输入域，前一个指本国来店客人户籍文件路径,后一个指本国离店客人户籍文件路径。如果方式是数据库方式，则填数据库表名(acctcard.udl则指向目的数据源)。如果是文本方式，则添文本文件名(包括路径)。
10． 本国人，外国人图片路径 填写图片路径。
11． 外国人文件路径:同上。
12． 文件头:户籍记录文件的文件头。可以是机器时间,也可以是机器时间减一。
13． 长度:文件头所占的位数.
14． 换行：户籍记录之间是否换行.
15． 日期格式：选择户籍发送要求的时间格式.
16． 如果要求发送图片,则在发送格式中把photo字段放到最后,在数据库的表中，添加photo字段，类型image
17． 如果是定做的,则要把police。dll文件拷贝到c：\cshis中。
18． 如果系统配置中的参数与提供的字典不一致,需要把参数设为一致。
—户籍发送ODBC配置图
13.7、证件扫描功能
证件扫描应用于前台系统，在客人入住登记时自动识别客人证件内容，可以提高前台人员工作效率
13.7.1 证件扫描的安装
安装步骤：
1 将扫描仪连接到USB端口,系统提示发现新硬件并查找设备驱动程序，选择FS531目录，完成驱动安装。
2 将LINKFILE目录中的所有文件拷贝到中软系统安装目录c：\cshis中.
3 打开hotel。ini，在“［图像扫描］"一节中添加“使用证件扫描=2”。
4 更换2005年以后前台程序，进入前台程序开房。
13。7.2 证件扫描调试中的可能问题
1 当扫描仪扫描出的图像过亮或过暗而导致系统无法识别证件信息时，可以运行LINKFILE目录中的VC_Sample。exe来校准扫描仪。
2 扫描时如果出现扫描仪初始化失败信息,可以运行FS531中的Uninstall.exe卸载扫描仪驱动，尝试连接到其他USB口重新安装驱动。
3当windows的登陆用户权限不够大的情况下例如：没有写win的权限，或者没有写cshis的权限,有可能会报错误.要特别注意
4护照扫描时要注意面积较大，要把条形码的地点放到机器上
13。7。3 证件扫描的使用
点击开房系统自动的弹出证件扫描如图13—15
这部分自动识别
放好证件点证件扫描
选择要扫描的证件类型

中软好泰公司CSHIS