中软酒店管理系统-接口部分教材

PAGE2中软酒店管理系统CSHISINTERNATIONAL®功能手册中软酒店管理系统CSHISINTERNATIONAL®功能手册PAGE1中软好泰公司CSHIS中软好泰公司CSHISTOC\o"1-4"\h\z\u第13章、中软酒店管理系统-接口部分 213.1、电话计费 213.1.1、登陆计费系统 213.1.2、状态监视窗口 513.1.3、信息查询 613.1.4、串口信息 713.1.5、串口信息ASCII 813.1.6、录入话单 813.1.7、话单查询 813.1.7、原始话单 913.1.8、暂停计费 913.1.9、恢复计费 1013.1.10、注意事项 1013.1.11、电话计费调试流程 1113.2、电话pms功能 1213.2.1、登陆pms系统 1213.2.2、状态监视窗口 1213.2.3、酒店功能 1313.2.4、pms调试流程 1413.3、电话房态及电话MINIBAR功能 1513.3.1、电话房态系统登陆 1513.3.2、状态监视窗口 1513.3.3、电话房态的原理及注意事项 1613.4、会员卡接口 1613.4.1、会员卡接口配置 1613.4.2会员卡配置方法 1613.5、门锁卡接口 3013.5.1、门锁卡接口配置 3013.5.2、门锁卡接口需要厂商提供参数 3213.5.3、门锁卡接口调试注意事项 3213.6、户籍发送接口 3313.6.1、户籍发送软件接口说明 3313.6.2、户籍发送系统配置说明 3313.7、证件扫描功能 3613.7.1证件扫描的安装 3613.7.2证件扫描调试中的可能问题 3613.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-313.1.2、状态监视窗口状态监视窗口是计费系统主界面。主要起到监控电话系统运行情况作用如图13-4显示通话时间：以秒为单位显示拨达电话的所属地区显示分机所属房间或酒店部门显示分机打出的电话号码显示总的应收费用蓝色代表现在处在状态监视功能显示电话发送的串口信息、显示收取的附加费显示收取的服务费功能显示计费单价显示电话开始通话时间显示酒店的分机号码此部分不属于计费部分内容以后详细介绍绿色代表电话计费系统已经启动显示电话发生的日期显示通话时间：以秒为单位显示拨达电话的所属地区显示分机所属房间或酒店部门显示分机打出的电话号码显示总的应收费用蓝色代表现在处在状态监视功能显示电话发送的串口信息、显示收取的附加费显示收取的服务费功能显示计费单价显示电话开始通话时间显示酒店的分机号码此部分不属于计费部分内容以后详细介绍绿色代表电话计费系统已经启动显示电话发生的日期图13-413.1.3、信息查询信息查询的主要功能查询客人的或酒店部门一段时间的电话单记录情况。其中起始日期和止期是必须输入域和如图13-5蓝色表示进入信息查询功能按不同的分机类型例如：客房，办公，查询查询的结束日期查询的开始日期可以分别输入分机号码，房号，和帐户名称可以查询一段金额的电话单输入完条件点查询，查询结果可以打印按酒店的不同部门查询可以分别按，国际，国内，市话，郊话来查询按被叫号码进行查询蓝色表示进入信息查询功能按不同的分机类型例如：客房，办公，查询查询的结束日期查询的开始日期可以分别输入分机号码，房号，和帐户名称可以查询一段金额的电话单输入完条件点查询，查询结果可以打印按酒店的不同部门查询可以分别按，国际，国内，市话，郊话来查询按被叫号码进行查询图13-5蓝色代表运行串口信息功能13.1.4、串口信息蓝色代表运行串口信息功能串口信息功能与windows的超级终端功能一致，显示交换机吐出的串口信息如图13-6下面区域显示对应上面串口信息显示的ASCII上面区域显示交换机的串口信息下面区域显示对应上面串口信息显示的ASCII上面区域显示交换机的串口信息图13-613.1.5、串口信息ASCII目前功能与串口信息功能完全一致详见13.1.413.1.6、录入话单录入话单功能，可以手工输入相应的打电话信息。当由于某些不可测原因造成的跑单发生时，可以手工补齐话单。防止跑单如图13-7代表此业务是正常发生，还是要冲减的项目输入完开始和结束时间，时长可以不输入输入电话拨打的开始时间和结束时间输入拨打的电话号码选择要录入的日期选择分机号码单击录入话单功能弹出录入话单窗口代表此业务是正常发生，还是要冲减的项目输入完开始和结束时间，时长可以不输入输入电话拨打的开始时间和结束时间输入拨打的电话号码选择要录入的日期选择分机号码单击录入话单功能弹出录入话单窗口图13-713.1.7、话单查询话单查询功能与信息查询功能完全一致，详情查看13.1.313.1.7、原始话单单击原始话单进入查询界面此功能用来查询交换机的串口信息是否符合系统中的话单格式的配置。如图13-13单击原始话单进入查询界面把查找出来的记录存为excel文件放在c:\cshis下删除查找出来的记录点击显示选种记录的ascii信息点查询按条件显示开始查询的日期和结束日期开始查询的时间和结束时间选择要查询内容的状态把查找出来的记录存为excel文件放在c:\cshis下删除查找出来的记录点击显示选种记录的ascii信息点查询按条件显示开始查询的日期和结束日期开始查询的时间和结束时间选择要查询内容的状态图13-1313.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-1113.1.11、电话计费调试流程提示：提示：具体电话相关配置祥见系统配置中的电话配置。硬件方面必须有单独的串口线来与工作站相连，不能与其他功能走一个线。13.2、电话pms功能电话pms功能主要实现酒店可以直接通过前台系统来实现开关长途，叫早服务，宾客免扰，语音留言等功能13.2.1、登陆pms系统登陆pmd系统与登陆系统计费系统完全一致见图13-1,13-2,13-313.2.2、状态监视窗口蓝色显示停在状态监视窗口状态监视窗口动态显示每一条pms功能实现的状态如图13-12蓝色显示停在状态监视窗口向交换机发送的信息次数代表某一个规程执行的次数步骤显示通讯规程停在第几步绿色代表pms功能已经启动设置的时间显示纪录功能是否完成：显示实现的功能名称监视窗口向交换机发送的信息次数代表某一个规程执行的次数步骤显示通讯规程停在第几步绿色代表pms功能已经启动设置的时间显示纪录功能是否完成：显示实现的功能名称监视窗口图13-1213.2.3、酒店功能在电话系统中可以通过此功能来实现pms功能如图13-13叫醒时间只对叫醒起作用功能选择是相应的功能项目的选择分机号码单击酒店功能按钮弹出酒店叫醒时间只对叫醒起作用功能选择是相应的功能项目的选择分机号码单击酒店功能按钮弹出酒店图13-12项目功能选择项目说明酒店功能设置(此功能主要用于测试)国际长途开关国际长途业务国内长途开关国内长途业务郊区电话开关郊区电话业务市内电话开关市区电话业务Chickin发送chickin信息Chinkout发送chickout信息留言灯开关电话留言灯，（针对交换机）语音信箱留言灯开关电话留言灯，（针对语音卡）电话叫早设置取消电话叫早功能宾客免扰设置取消宾客的免打扰功能宾客姓名发送宾客的姓名给交换机授权码此功能用于房间中多个客人分别记录电话消费的（交换机必须支持）语音信箱开关语音信箱的业务团队屏蔽用于屏蔽团队客人的电话，功能开通后散客将不能给团队客人去电修改语音信箱信息当语种信息发生变化时，发送更改信息13.2.4、pms调试流程提示：提示：pms配置主要是两点就是通讯规程和命令格式。具体配置祥见系统配置中的电话配置。硬件方面必须有单独的串口线来与工作站相连，不能与其他功能走一个线。并且检查系RMSTUS中有TEL的触发器13.3、电话房态及电话MINIBAR功能电话房态功能的作用，由服务员直接通过酒店客房中的电话更改酒店系统中的房间状态，可以减少通报客房中心过程，增加员工的工作效率。电话MINIBAR通过服务员直接对电话操作，给房间挂账，可以减少操作流程。13.3.1、电话房态系统登陆登陆电话房态系统与登陆系统计费系统完全一致见图13-1,13-2,13-313.3.2、状态监视窗口蓝色表示在状态监视窗口状态监视窗口起到监控电话房态的运行情况如图13-13蓝色表示在状态监视窗口挂帐金额代表MINIBAR的挂账金额显示操作的房间操作分机号码操作的时间显示房态的操作项目此区域显示电话房态功能挂帐金额代表MINIBAR的挂账金额显示操作的房间操作分机号码操作的时间显示房态的操作项目此区域显示电话房态功能图13-1313.3.3、电话房态的原理及注意事项·电话房态MINIBAR挂账的原理与pms功能相仿。都是计算机与电话交换机进行通讯。不同的是，房态控制和MINIBAR挂账主要是通过串口发给电话交换机发命令字符。·要实现电话房态和MINIBAR挂账功能，首先需要管交换机厂商要相应的参数。并且交换机要有相应的串口。因为酒店系统一个串口线只能实现单一功能。（电话房态和MINIBAR算一个功能）13.4、会员卡接口会员卡功能主要实现酒店的会员管理功能.,并同时起到给客户打折,积分返还等功能13.4.1所需文件:CsmemCard.dll,MWIC_32.DLL,csmis.ini13.4.2会员卡配置方法一基本配置1.hotel.ini中[会员卡]使用会员卡=YES会员卡制卡串口=COM1,机器名1,机器名2…;COM2,机器名3,机器名4;COM3…会员卡默认模板=Csmis.ini文件[会员卡参数]密码={缺省是211149}·在cshis中的sysBAR.INI中[Sysinfo]Opercd=91397[Skin]SkinColor=12632256BackgroundColor=13421504[MakeCard]AutoReadCard=N（用会员卡的机器中此处必须是N）·在hotel.ini中2.如果工作站需要制卡则系统配置系统信息配置工作站配置中制卡工作站号=本机工作站号3.配置会员卡交易代码及对应餐厅付款代码系统配置交易及费用配置交易代码中系统配置销售点系统配置费用及付款中4.卡类配置系统配置交易及费用配置消费卡类型卡属性及说明信用卡:可冲值,可透支冲值卡:只可冲值,不能透支次数卡:此类受[可用刷卡次数]的限制,只有在卡的[刷卡次数]<[允许刷卡次数]时次数卡可以使用,5.累计消费及积分配置系统配置交易及费用配置费用分类只有[会员卡累计]有效时,该的费用分类的消费才可以被累计消费和计算积分积分比例:每xx元的此类消费可积一分起算费用:只有在消费金额>起算费用时才开始积分,起算积分因子:本类消费在达到起算费用时的积分积分公式if消费<起算费用then积分=0else积分=起算积分因子＋(消费-起算费用)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结帐自动废卡=NO3）调试时，注意将门锁提供的接口文件拷贝到工作站的c:\cshis\4)将公司做好的接口程序和csmis文件，test.exe文件拷贝到工作站的c:\cshis\，同时按照接口说明将csmis文件修改好5）使用test.exe测试制卡，读卡，开门，通过后，将该程序关闭，使用中软系统制卡、读卡13.5.2、门锁卡接口需要厂商中软酒店管理系统门锁卡接口部分需门锁制卡公司提供的资料：完整的PROPERTYMANAGEMENTSYSTEM（PMS）接口规范：硬件连接方法，连接线接法初始化制卡设备，关闭制卡设备方法根据宾馆业务，制新卡（开房），复制卡（房间合住），修改卡（延住等），作废卡（结帐），挂失卡（丢失），校验卡（读卡）等的调用方法对POS系统的接口，即对卡片其他轨道的读写能力二·在接口方面若有疑问，提供必要的技术支持应有详细的接口函数说明,最好提供delphi调用范例注：提供调用的接口函数，必须为Windows32位动态库.要求必须有厂家提供的相关的EXE直接调用接口动态库，可现场测试。接口动态连接库,还要有参数说明,最好有厂商自己的测试程序13.5.3、门锁卡接口调试调试门锁之前,确保机器端口可以正常运行,首先要保证门锁厂商的调试程序可以调通.,如果不通说明,厂商处就有问题,需要联系厂商,保证他们自己的软件可以调通.在厂商的程序调通的前提下,可以用公司自己的测试程序调试!,在调试成功的前提下,再用前台程序进行调试.以便确定是那一个部分的问题,依次解决。13.6、户籍发送接口户籍发送是根据公安局的格式内容把客人的信息传送给公安局的软件上，再通过软件发送给公安局13.6.1、户籍发送软件户籍发送是根据当地公安户籍部门提供的户籍接口规范生成符合规范最终的户籍文件，一般形式为文本文件（*.txt）或数据库文件(*.dbf,*.mdb)等。接口动态库名称为police.dllCSHIS主程序需调用police.dll中SendToPolice过程户籍发送的所有工作在SendToPolice过程中完成。具体实现可参考实例应注意的一些问题：籍屏幕中没有对应的输入域户籍接口规范中有些必需输入的项目而在中软系统户籍屏幕中没有对应的输入域，此时可与户籍系统人员沟通是否可把某些项目的内容固定，如把职业固定为‘其他’民族固定为‘汉族‘。或在户籍屏幕中其他未使用的内容代替，如用‘邮政编码’代替‘民族’，但这种方法需要求前台操作员严格按规范输入。否则可能造成生成的户籍文件对方户籍系统无法识别。代码化问题有时户籍接口规范中许多内容需要以代码化形式出现，如：性别男＝‘1‘女＝’2‘则应自行转换，汉字双字节问题例如：有时户籍接口规范中要求客人姓名长度为20字节，应从酒店系统中ACCOUNT表中acct_nm字段中获得，该字段长度为40字节，则只能截取acct_nm字段前20位，这时就应判断截取后的最后一个汉字是否被截掉一半，否则汉字可能出现乱码。函数functionchinesefont_convert(sourcestr:string;len:integer):string;可判断并自动截去最后的乱码。重复发送问题为避免已经发送过户籍的客人，重复发送可在发送同时在ACCOUNT表中为已发送的客人打标记,用reserved2字段(reserved2字段共30位开房时缺省为‘******************************’,由于门锁卡可能也用到reserved2字段,为避免冲突规定门锁卡使用1-15位,户籍使用16-20位,打标记时请勿改动其他位。)13.6.2一环境配置在控制面板-管理工具中添加ODBC数据源，选择(miscrosoftparadoxdriver*.db给该数据源起名为’ParadoxFiles’。操作系统一定要打补丁sp2，否则生成时报错。ParadoxFiles的数据库位置指向c:\cshis\在控制面板-区域管理中修改机器日期，时间格式。设为’yyyy-mm-ddhh-mm-ss’24小时制。在中软系统工作目录\\服务器\temp\下查找是否有acctcard.udl文件。如果没有，请创建。如果是数据库方式发送，则acctcard.udl指向要发往的数据源。如果是文本方式，则acctcard.udl与cs2000.udl指向同一个服务器。根据户籍发送格式的要求，在Cs2000.udl所指的数据库中创建四张表。表名分别是：acct_nation本国人到店户籍表acct_foreign外国人到店户籍表acct_nationleave本国人离店户籍表acct_foreignleave外国人离店户籍表以上四张表要按照户籍发送要求格式字段创建，字段类型都为char,长度按要求走。二户籍格式配置屏幕各部分说明：(顺序从上到下，从左至右)户籍发送种类：本国到店，外国到店，本国离店，外国离店。点击不同的单选钮，下面将调出相应的格式文件。发票种类显示/隐藏：点击该处，将显示或隐藏左侧选择栏，可以加大格式设计窗口报表格式设计：对相应的格式进行修改，按照户籍发送的要求进行修改。将需要的字段拖到Details中。下面介绍一些常用的字段处理方法：日期时间字段的格式处理：报表文件字段的默认格式为’yyyy-mm-ddhh-mm-ss’，一般的，公安局要求的日期时间字段的格式与默认格式不相符。当不相符时，需要对其进行格式处理。例：如果要求格式为’yymmdd’则建立一个formula,在formula中用replace函数把’-‘去掉。Replace(‘2002-11-11’,‘-‘,’’)，显示出来就是’20021111’。性别字段处理：传入的数据为‘男’，‘女’，要将她转化为’1’,’2’复选框多次