大客户酒店接口使用手册.docx

1、大客户酒店接口使用手册技 术 文 件技术文件名称：SS10VIC大客户酒店接口使用手册 技术文件编号： 版 本：ZXSS10 VIC V1.0.2 文件质量等级：共 26 页(包括封面) 拟 制 审 核 中兴通讯股份有限公司目 录ZXSS10 VIC大客户酒店接口使用手册51范围52术语、定义和缩略语53安装53.1命令脚本升级53.2 配置通信文件53.3 酒店接口机人机命令配置63.4酒店接口机模拟测试84酒店接口机命令手册94.1计费业务命令94.1.1 登记、撤销立即计费94.1.2 启动立即计费话单发送104.1.3 停止立即计费话单发送104.1.4 话单的实时传送114.1.5

2、话单传送返回114.1.6 话单重传124.1.7 输出话单重传数量134.1.8 握手消息134.1.9 话单格式144.1.10 酒店第三方话单接收程序的编写164.1.11 话单保存成文件方式174.2用户管理命令184.2.1用户号码184.2.2. 查询用户权限194.2.3. 修改用户权限214.2.4. 查询用户新业务224.2.5. 预约用户新业务234.2.6. 删除用户新业务234.2.7. 查询用户闹醒时间244.2.8. 创建用户闹醒时间244.2.9. 修改用户闹醒时间254.2.10. 删除用户闹醒时间264.2.11. 显示用户的转移号码274.2.12. 创建用

3、户的转移号码274.2.13. 删除用户的转移号码284.2.14. 激活去激活免打扰业务284.2.15 用户管理命令使用原则294.3大客户更新命令294.3.1查询用户信息响应294.3.2同步用户信息响应294.3.3录音响应304.4房态管理命令304.4.1向酒店系统鉴权命令304.4.2登记房态命令315.操作结果码315.1软交换操作结果315.2HLR操作结果（上移用户）316 酒店系统的通信部分编程指导37修改记录文件编号版本号拟制人/修改人拟制/修改日期更改理由主要更改内容（写要点即可）张海军2006.05.29创建杨旭涛2006-8-15修改石启国2006-8-18修改

4、颜虹2007-06-06修改增加第三方酒店和大客户系统的握手说明注：文件第一次拟制时，“更改理由”、“主要更改内容”栏写“无”。ZXSS10 VIC大客户酒店接口使用手册1范围本手册用于大客户酒店接口机的安装使用，提供对外接口命令格式。本规范由中兴通讯股份有限公司提出并负责解释。2术语、定义和缩略语SS：Soft Switch，软交换系统HLR：综合智能用户管理平台MML：人机命令3安装3.1命令脚本升级酒店接口人机命令提供79527955，分别是增加，删除，修改，查询酒店接口配置命令。3.2 配置通信文件配酒店接口机（可以是大客户服务器或者大客户话务台）zxssopr目录gc_mgt.ini

5、，做如下改动。NodeStyleCount=7 / 服务器类型加1，增加了一种新的类型NodeList2Count=1 / 增加一个计费服务器，NodeList5Count=1 /增加一个数据代理服务NodeList6Count=1 / 增加一个酒店接口机节点 NodeList2_1 / 计费服务器节点信息 NodeCode = 306 OfficeCode = 1 IP = 10.40.94.145NodeList5_1 NodeCode = 306 / 数据库节点号 OfficeCode = 1/ 数据库模块号 IP = 10.40.94.145 / 数据库的IP NodeList6_1

6、NodeCode = 306 / 酒店接口机的节点号 OfficeCode = 1/ 酒店接口机的模块号 IP = 10.40.94.145/ 酒店接口机的IP 增加一个接口机，都需要更新通信配置。3.3 酒店接口机人机命令配置 使用人机命令79527955，通过TELNET连接数据服务器，执行“命令号/？”如“7952 /?”可以查看帮助。命令允许输入字符(ASCII 0 128) 7952增加酒店接口序号参数名称可选性类型范围说 明1HOTELIP必选字符1-20酒店IP，表示酒店管理机的IP，当参数3群号设为65535，本参数表示端口号，端口请大于10002PORTTYPE 必选整型0-

7、255端口类型，表示端口类型，其中1对应billcvt.dll，是话单传送的服务；2对应oamsvr.dll，用户属性管理；3对应HNormal.dll对应大客户更新；4对应OprRoomInfo.dll房态管理；现在只支持端口类型1和23CENTREXID必选整型1-65535群号，表示业务组号，请一定要设置，但是当群号设置为65535时，参数1请设置端口，酒店对应的群号，一个酒店管理一个群4DLLNAME任选字符0-16接口库名，动态库名称，按照参数2端口类型对应动态库名，参见参数25STARTC任选字符0-7开始符，开始符号，例子中为#，开始和结束符号对应一条酒店管理系统发过来的命令。6

8、ENDC任选字符0-7结束符结束符号，例子中为*7IOFFICE任选整型0-255接口机局号，接口机的局号，和通信支撑规划的局号一样，8IMODULE任选整型0-9999接口机模块号，接口机的模块号，和通信支撑规划的模块号一样9IPNO任选整型0-9999接口机PNO，接口机的PNO号，可不填10DOFFICE任选整型0-255话务台局号，客户端的局号，可不填11DMODULE任选整型0-9999话务台模块号，客户端的模块号，可不填12DPNO任选整型0-9999话务台PNO，客户端进程PNO号，可不填13ISHLR任选整型0-1群是否上移，表示群是否上移到HLR，请注意管理的群是否被上移到H

9、LR上，0不上移对应SS用户，1上移对应HLR用户，请确定该群是否上移到HLR.14INFO任选整型0-2147483647备用配置一台酒店接口机需注意：一台酒店接口机最多提供10种业务，最多可以连接100个酒店举例1：配置一台酒店接口机的计费业务，对酒店管理机提供网络接口。步骤1： 增加酒店管理机IP-10.40.94.165，业务类型为1，群号为77，动态库名为billcvt.dll，开始符为#，结束符为*，接口机局号为10，模块号为2000，请确认和通信配置文件中一致。7952:1=10.40.94.165,2=1,3=77,4=billcvt.dll,5=#,6=*,7=10,8=20

10、00;步骤2： 增加业务端口，服务端口号5010，业务类型为1，群号为65535时表示输入端口号，接口机局号10，模块号2000。同一台接口机对应不同业务类型，端口请设置为不同。7952:1=5010,2=1,3=65535,7=10,8=2000;举例2：配置一台酒店接口机的数据业务，对酒店管理机提供COM1串口（配置都一样，只是与酒店是通过串口线相连）。 步骤1：增加酒店管理机IP-10.40.94.165，业务类型为1，群号为77，动态库名为oamsvr.dll，开始符为#，结束符为*，接口机局号为10，模块号为2000，请确认和通信配置文件中一致。7952:1=10.40.94.165

11、,2=2,3=77,4=oamsvr.dll,5=#,6=*,7=10,8=2000;步骤2：增加酒店管理机业务端口5511，业务类型为2，群号为65535时表示输入端口号，接口机局号10，模块号2000。请确认和通信配置文件中一致。7952:1=5511,2=2,3=65535,7=10,8=2000;注：1.这里的酒店接口机可以是大客户服务器或者大客户话务台（因为都有Hgatesvr程序和billcvt.dll，oamsvr.dll），注意使用7952命令时局号和模块号设置正确。 2.一个酒店接口机可以对应多个酒店；一个酒店只能对应一个接口机3使用酒店接口机的数据业务，确认oamsvr.i

12、ni文件设置正确。串口连接基本步骤与A中相似，只是步骤1用7952增加的不是IP地址而是”1”（ 酒店管理机与酒店接口机的com1串口相连）、”2”（ 酒店管理机与酒店接口机的串口com2相连），串口方式不需要步骤2。步骤1举例：7952:1=1,2=1,3=77,4=billcvt.dll,5=#,6=*,7=10,8=1001;7952:1=2,2=2,3=77,4=oamsvr.dll,5=#,6=*,7=10,8=1001;3.4酒店接口机模拟测试1酒店接口机安装好后，打开hgatesvr.exe可以看到以下界面，如图所示，酒店接口机已经打开5010和5011两个端口等待酒店的连接：2

13、在对应酒店可以运行版本里Terminal.exe终端仿真程序，在对端IP填入酒店接口机的地址，以及端口号进行连接，如果使用串口，在通信端口中选择相应的端口，如COM1：对酒店提供网络接口：如图所示，对端IP指接口机IP，连接成功后输入命令字符串回车命令字符串如：#START FEEENQ Action=REG:Num=4820001*成功将返回#START FEEENQ OK*,表示登记4820001号码的话单传送接下来输入：#START RESTARTCHARGE*成功将返回#START RESTARTCHARGEACK OK*,表示启动立即话单传送，这时如果有话单，界面上将显示下面格式的话

14、单：START$CHARGE$Aid$CallingNum$CalledNum$Bearerserv$StartTime$TimeLen&Fee0$fee1$fee2$fee3$fee4$fee5$fee6$fee7$fee8$4酒店接口机命令手册4.1计费业务命令4.1.1 登记、撤销立即计费功能：酒店系统向大客户系统登记或撤销需要发送话单的号码或群号。输入：#START FEEENQ Action=?:Num=?*响应：#START FEEACK FAIL:REASON* 或#START FEEACK OK*说明：“#”表示命令的开始符号，“*”表示命令的结束符号，默认情况下开始符号为“#

15、”，结束符号为“*”，也可通过人机命令重新设置（参考上面的人机命令7952-7955）。 Action 的值： REG/DEL 单个号码的登记与注销 CTXREG/CTXDEL 群号登记与注销登记或注销成功则返回#START FEEACK OK*。登记或注销失败则返回#START FEEACK FAIL:REASON*，其中REASON为失败码REASON=1，表示号码或群号已登记过（数据库中已存在）REASON=4，表示要注销的号码或群号不存在（数据库中没有此记录）REASON=5，表示酒店数已超过200，不允许再登记REASON=7，表示数据库操作错误举例：登记号码为4820001命令：#

16、START FEEENQ Action=REG:Num=4820001*登记群号为55命令#START FEEENQ Action= CTXREG:Num=55*撤销号码为4820001命令：#START FEEENQ Action=DEL:Num=4820001*撤销群号为55命令#START FEEENQ Action= CTXDEL:Num=55*注意事项：如果按群号登记，将比较话单中的群号（CtxNo）与登记的群号是否相等，相等则发送；如果按号码登记，将比较话单中的付费号码（PayNo）与登记的号码是否一致，相等则发送。对同一个酒店，一张话单最多只向酒店发送一次。在GUI界面上，如果撤

17、销酒店，则这个酒店下所有的登记的号码都撤销登记了,酒店资源就释放了。重新登记这个酒店相当于登记了一个新的酒店。1.1.0版本开始，酒店登记和撤销不再需要发送上述命令，只要在GUI界面上登记或撤销即可。为了兼容以前的酒店管理系统，如果发送登记或撤销命令到大客户系统，都会回一个成功消息。4.1.2 启动立即计费话单发送功能：大客户系统接收该命令后启动向酒店系统发送话单。 输入：#START RESTARTCHARGE*响应：#START RESTARTCHARGEACK OK*说明：“#”表示命令的开始符号，“*”表示命令的结束符号，默认情况下开始符号为“#”，结束符号为“*”，也可通过人机命令重

18、新设置（参考上面的人机命令7952-7955）。大客户立即计费服务器收到启动立即计费话单发送命令后，就会发送话单，并返回响应信息。4.1.3 停止立即计费话单发送功能：大客户系统接收该命令来决定是否停止向酒店系统发送话单。 输入：#START STOPCHARGE*响应：#START STOPCHARGEACK OK*说明：“#”表示命令的开始符号，“*”表示命令的结束符号，默认情况下开始符号为“#”，结束符号为“*”，也可通过人机命令重新设置（参考上面的人机命令7952-7955）。使用本命令停止话单传送后，需要发送#START RESTARTCHARGE*命令启动话单传送4.1.4 话单的

19、实时传送功能：交换机通过该消息实时的把酒店客房分机产生的话单发送到酒店系统中去。回应：#START$CHARGE$Aid$CallingNum$CalledNum$Bearerserv$StartTime$TimeLen&Fee0$fee1$fee2$fee3$fee4$fee5$fee6$fee7$fee8$* 说明：“#”表示命令的开始符号，“*”表示命令的结束符号，默认情况下开始符号为“#”，结束符号为“*”，也可通过人机命令重新设置（参考上面的人机命令7952-7955）。 Aid : 流水号，流水号最大为32767;START$CHARGE：话单开始符CallingNum：话单中的付

20、费号码CalledNum：话单中的被叫号码Bearerserv：承载业务 StartTime：通话开始时间，格式YYYY-MM-DD hh:mm:ss TimeLen：通话时长，单位为秒 Fee0：代表总费用,单位为元; 格式：a.bc 如2.78,1.00 fee18代表个子费用,单位为元; 格式：a.bc举例：#START$CHARGE$1001$4820001$5820001$0$2007-09-17 11:22:33$120&0.60$0.60$0$0$0$0$0$0$0$*表示：流水号为1001，付费号码为4820001，被叫号码为5820001，承载业务为0，开始时间为2007-0

21、9-17 11:22:33，通话时长为120秒，总费用为0.6元，费子项1为0.6元，其他费子项为0。注意事项：大客户立即计费系统采用停等协议发送话单，必须收到正确回应的流水号后，才会发送下一下条记录，否则一直发送这张话单，这时第三方酒店程序收到这张重复话单后需要回一个#START CHARGEACK Aid*给大客户系统，（Aid为这张话单对应的流水号），流水号在0开始到32767之间循环。每次增1，当到32767后，下次再从0开始。4.1.5 话单传送返回 功能：接口酒店通过该消息返回流水号,用于确认话单数据有没有收到. 输入：#START CHARGEACK Aid*说明：“#”表示命令

22、的开始符号，“*”表示命令的结束符号，默认情况下开始符号为“#”，结束符号为“*”，也可通过人机命令重新设置（参考上面的人机命令7952-7955）。Aid：为收到的话单记录上的流水号，需要第三方酒店程序每次收到话单后，回一个#START CHARGEACK Aid*给大客户系统举例：如收到话单：#START$CHARGE$1001$4820001$5820001$0$2007-09-17 11:22:33$120&0.60$0.60$0$0$0$0$0$0$0$*应回应：#START CHARGEACK 1001*4.1.6 话单重传功能：大客户系统接收该命令查找符合条件的话单向酒店重发。

23、输入：#START RESEND Action=?:NUM=?:STIME=?:ETIME=?* 响应：#START RESEND RTN=?* 说明：“#”表示命令的开始符号，“*”表示命令的结束符号，默认情况下开始符号为“#”，结束符号为“*”，也可通过人机命令重新设置（参考上面的人机命令7952-7955）。Action 的值: REG 按付费号码查找重传话单 CTXREG 按群号查找重传话单 NO 重传与群号和付费号码无关，只与时间有关，此时号码(NUM)填写0NUM 号码或群号STIME 时间开始段YYYYMMDDhhmmssETIME 时间结束段RTN的值: 0:成功 1: 忙(正

24、在检查重传话单的处理) 2: 有重传话单还没有传完举例：如要重传号码为4820001，2006年8月15日的话单#START RESEND Action=REG:NUM=4820001:STIME=20060815000000:ETIME=20060815235959*如要重传2006年8月15日到8月17日的全部话单#START RESEND Action=NO:NUM=0:STIME=20060815000000:ETIME=20060817235959*4.1.7输出话单重传数量功能：大客户系统向酒店发送需要重传的话单数量输出:#START RESEND RTN=?$BILLCOUNT=

25、?*说明：“#”表示命令的开始符号，“*”表示命令的结束符号，默认情况下开始符号为“#”，结束符号为“*”，也可通过人机命令重新设置（参考上面的人机命令7952-7955）。 RTN：0-查找操作成功,文件数为BILLCOUNT后面给出的数, 1-表示查找的备份文件坏，或文件不存在 2-文件队列中要发送的文件太多，稍后再重发送重发指令BILLCOUNT：查找操作成功后统计出的重传话单数量，如为0表示没有满足条件的话单 注意:当大客户系统收到话单重传命令后，首先回应一个消息（参考4.1.6说明）,，然后发送话单数量（重传话单数量为已经发送过的符合条件的话单, 对于还没有发送的话单，不在重传统计之

26、内），最后发送需要重传的话单。4.1.8 握手消息功能：第三方酒店向大客户系统发送握手消息。 输入：#START RESTARTCHARGE*响应：#START RESTARTCHARGEACK OK*说明：“启动立即计费话单发送”同时可以作为第三方酒店系统定时向大客户系统发送握手消息，间隔建议1分钟，可根据需要进行调整。第三方酒店系统向大客户系统发送#START RESTARTCHARGE*，大客户系统回应#START RESTARTCHARGEACK OK*，表示双方通信正常。若大客户系统超时不回应，则表示通信中断。通信中断后，建议第三方酒店缩短握手时间，建议每20s发送#START RE

27、STARTCHARGE*，一旦收到大客户系统回应#START RESTARTCHARGEACK OK*，表示链路恢复。链路恢复后，大客户系统将自动恢复向第三方酒店传送话单。4.1.9 话单格式送到酒店的话单内容项及其格式可以通过工具BillConfig.exe进行配置。如果没有配置则按照默认的格式输出。（1）默认格式#START$CHARGE$Aid$CallingNum$CalledNum$Bearerserv$StartTime$TimeLen&Fee0$fee1$fee2$fee3$fee4$fee5$fee6$fee7$fee8$* 说明：START$CHARGE：话单开始符 Aid

28、： 流水号，大客户送过来的话单流水号CallingNum：话单中的付费号码CalledNum：话单中的被叫号码Bearerserv：承载业务 StartTime：通话开始时间，格式YYYY-MM-DD hh:mm:ss TimeLen：通话时长，单位为秒 Fee0：代表总费用,单位为元; 格式：a.bc 如2.78,1.00 fee18代表个子费用,单位为元; 格式：a.bc（2）定制话单格式 运行BillConfig.exe配置程序，打开“功能-话单项配置”如下图所示：其中： 可选话单项表示原始话单信息 输出项表示输出格式中包含的话单内容项及其顺序 分隔符表示输出格式中项与项之间的分隔符，必

29、选 时间格式表示输出的开始时间或结束时间项的格式，必选 开始项表示输出格式中开始部分，如不选表示为空 结束项表示输出格式中结束部分，如不选表示为空 项前缀表示输出格式中每项的前缀，如不选表示为空可选的话单项如下：主叫号码原始话单中的主叫号码被叫号码原始话单中的被叫号码开始时间格式按配置的格式结束时间格式按配置的格式时长(秒)通话时长，单位为秒付费号码收费的号码 总费用单位为元; 格式：a.bc 如3.21 费子项1单位为元; 格式：a.bc 费子项2单位为元; 格式：a.bc 费子项3单位为元; 格式：a.bc 费子项4单位为元; 格式：a.bc 费子项5单位为元; 格式：a.bc 费子项6单位为元; 格式：a.bc 参考主叫号码 计费分析时用的主叫号码参考被叫号码 计费分析时用的被叫号码 业务类别话单中的业务类别 入中继群 出中继群 连接号码 主叫分析标记 被叫分析标记 承载业务 终端业务 终止原因 时钟变化标志 计费标志 补充业务 计费方标识 CTX群标识 注意事项：a. 输出到酒店的话单内容除开始项外的第一项固定为流水号,界面上不需要配置b. 话单项中补充业务ss的内容包含7个字节,输出格式0x1234567890abcd 中高位在前,低位在后,如上面例子中0x12为ss6, 0xcd为ss0c. 配置保存后，需要重启接口机才会生效4.1.