客运联网售票系统软件接口规范Word文档下载推荐.docx
《客运联网售票系统软件接口规范Word文档下载推荐.docx》由会员分享,可在线阅读,更多相关《客运联网售票系统软件接口规范Word文档下载推荐.docx(23页珍藏版)》请在冰豆网上搜索。
![客运联网售票系统软件接口规范Word文档下载推荐.docx](https://file1.bdocx.com/fileroot1/2022-10/20/af3e896f-d601-475a-a374-c0e21cbde83e/af3e896f-d601-475a-a374-c0e21cbde83e1.gif)
3.2.17取客运站站点编码13
3.3客运站提供的接口13
3.3.1取票价13
3.3.2售票更新13
3.3.3锁定座票(新增)13
3.3.4取消锁票(新增)13
3.3.5废票更新14
3.3.6重打印更新14
3.3.7退票更新14
3.3.8班次信息表14
3.3.9站点信息表15
3.3.10检票信息表15
3.3.11售票明细表(财务对帐用)15
3.3.12售票查询15
3.3.13班次信息表更新15
3.3.14站点编码表更新16
3.3.15检票信息表更新16
3.3.16售票明细表更新16
4其它补充说明的规范16
4.1关于电子票16
4.2接口的更新规则17
4.3异站售票提示和日志17
5本地操作关键流程与程序设计参考规范18
5.1售本站票18
5.2售异站票19
5.3退票20
5.4废票20
6附录21
6.1客运站编码21
6.2班车说明22
6.3退票费计算22
6.4V5.0不再使用的的接口列表22
6.4.1锁定座票22
6.4.2取消锁票22
6.4.3取得班次票价23
6.4.4取票价(存储过程)23
6.5新流程主要特性及设计原理图示23
、八、亠
1前言
1.1概述
珠海市客运联网售票系统是在珠海市交委的组织下建立的全市客运站联网售票系统。
该系统利用先进的计算机技术,将全市16个客运站的售票系统整合为一个整体,实现客运站互相售票的目标。
为了最大限度的保持各客运站的独立性和特性,减少重复投资,联网售票系统采用交易中间件技术来实现客运站之间的相互售票交易功能。
本系统提供统一的软件接口,嵌入客运站现有的售票系统中,实现现有客运站售票系统与联网售票系统的无缝连接。
客运站售票系统经过少量的改动后,利用软件接口,即可实现联网售票。
各客运站可以保持现有界面风格不变、操作习惯不变。
本文档响应新的联网售票系统客户端接口产品,在《珠海客运-联网售票系统-软件接口
规范(V4.9X)»
的基础上,阐述新的联网售票系统的软件接口规范(V5.0),其中重点更改
了售票业务、退票业务、废票业务、重打票等的业务流程。
各方开发单位有义务严格按照本规范的要求,参考软件接口开发手册,将软件接口嵌入相关计算机系统的软件模块中。
1.2定义
DLL(DynamicLinkableLibrary):
动态链接库,是一种磁盘文件(通常带有DLL扩展名),它由全局数据、服务函数和资源组成,在运行时被系统加载到进程的虚拟空间中,成为调用进程的一部分。
存储过程(StoredProcedure):
是由SQLServer引擎执行的预编译SQL语句,用来封装针对数据库服务器的一整套操作或查询。
1.3参考资料
《珠海市客运联网售票系统总体设计方案»
《珠海市客运联网售票系统软件功能需求说明书»
《珠海市客运联网售票系统概要设计说明书»
《广东省汽车客运站收费规则实施细则»
《关于2004年我省公路客运春运票价的批复»
《珠海客运-联网售票系统-软件接口规范(4.9X)»
2约定
软件接口的安装不同编码的客运站需要不同的安装盘。
如对于二汽和东圃客运站需要提供不同的安装盘。
软件接口提供
本规范要求的软件接口,分别由珠海交通信息化建设投资营运有限公司和客运站提供。
珠海交通信息化建设投资营运有限公司负责制定接口规范,编写使用手册,指导应用方开发应用。
软件接口应用
本规范要求的软件接口,分别由珠海交通信息化建设投资营运有限公司和珠海市各客运站使用。
双方按照规范要求,负责将软件接口嵌入相关计算机系统的软件模块中,实现联网售票目标。
接口形式
本软件接口以三种形式提供。
动态链接库(DLL)
存储过程
表
操作系统
Windows98/2000系列操作系统。
数据库
MicrosoftSQLServer2000数据库。
开发工具
本软件接口支持的开发工具有Delphi,PowerBuilder,VisualBasic,VisualC++,VisualFoxPro。
软件平台
本软件接口使用了BEA公司的交易中间件Tuxedo。
因此,所有使用本软件接口的计算机系统必须安装Tuxedo客户端软件。
该软件由交通信息化投资建设营运有限公司负责安装。
用途本软件接口只能用于珠海市客运联网售票系统,未经许可,不能用于其它用途。
流程规范
理流程标准。
本文档行文约定
红色(粗体)新增接口或特殊说明;
正文黑色粗体为各接口的增补说明、建议或注意事项。
3接口规范
3.1接口总览
注:
粗红体为新增或变更接口;
灰色表格部分为客运站提供部分。
序号
类别
名称
描述
备注
1
调度接口
SchemeRefresh
班次更新
DLL
投资公司提供
2
售票接口
TicketLock2
锁定座票(新)
3
SchBaselnfo
班次基本信息查询
4
Pricelnfo2
票价信息(新)
5
LockCancel2
取消锁票(新)
6
TicketUpdate
售票更新
7
TicketRePrint
售票重打印
8
TicketBlankout
废票
9
TicketOff
退票
10
GetOffFare
获取退票费率
11
CheckUser
代理认证
12
GetTicketNo
取票号
13
SchBaseInfo
取得班次基本信息
14
ConfirmAct
确认接口
15
GetStCode
取得中心站点编码
16
检票接口
TicketExam
检票
17
对帐明细
SellCollate
18
票价接口
ProGetPrice2
取票价(新)
客运站提供*
19
ProTicketUpdate
20
ProTicketLock
21
ProTicketUnlock
22
ProTicketBlankout
废票接口
23
ProReprint
重打印接口
24
ProTicketOff
退票接口
25
读取数据接口
tcscheme
班次信息
26
tc_stationcode
站点编码
27
tcticketExam
检票信息
28
tcticketsell
售票明细
29
查询接口
班次信息更新
ProQuerySell
售票明细查询
30
ProWrtScheme
班次信息更新
*客运站提供的接口必须提供相关的用户和口令,并有相应的权限。
提示:
此接口现阶段的版本为5.0,在原接口4.XX版本上升级而来,为便于用户对比使用,现将与上版本不一致的地方用粗黑体标示加以区别,没有标示粗黑体的则没有变化。
3.2票务中心提供的接口
3.2.1班次更新
名称:
功能:
将客运站班次增加、停止的信息上传给票务中心。
说明:
每天凌晨,调用此接口,将本客运站生成的班次信息上传到票务中心;
另外,在调度软件中嵌入该接口,在班次发生变化时,调用此接口,将班次变化信息上传给票务中心。
一次可传多条记录。
该接口在批量上传的时候,可以同时将班次的票价信息上传到中心,票价包括全票价、
半票价、学生票价。
所传票价仅作参考用,不作为当时交易依据。
在正常的调度期间,当
票价发生变化时,不需要调用该接口。
使用建议:
1)客运站调度软件中,在即时调度中使用该接口,实现小批量次更新;
避免在产生总调度计划(全日)时使用。
总调度计划(全日)由中心工作人员在凌晨集中提取。
2)客运站即时调度中,班次上传时尽量使用组装成数据集批量上传,不宜分拆
成一条条的数据上传,导致频繁的调用班次上传接口。
3.2.2锁定座票
名称:
锁定座票
功能:
根据用户输入参数,锁定票务中心数据库的相应票源,并返回锁结果。
只在售异地票时使用,售本地票无须再调用任何锁票接口。
选定购票数量(座位)后,都应调用该函数,锁定相应票源。
如果锁票不成功,则判断返回值,如果属于网络故障或者代理服务器故障,售票软件应接收到错误信息,终止此次交易过程;
由于售本地票不调任何锁票接口,不受此限制。
3.2.3取消锁票
取消锁票
取消前面的所有锁票操作,或指定座位解锁。
缺省值‘0'
为取消所有锁票。
在售票流程中,调用该接口取消前面的所有锁票请求。
只有售票员放弃卖票或者取消当前所选的所有票时,才调用此接口;
解锁单个座位,指定输入参数为相应座位。
这里原有函数保值不变,增加一个函数LockCancel2,此函数在原来的函数的基础上增
加一个输入参数szDepot,用于指示要执行解锁的票在哪个客运站场。
3.2.4售票明细
售票明细
更新票务中心数据库、异地客运站数据库的售票信息,产生车票防伪码。
不论是售本地票还是异地票,都需要调用本接口。
售本站票时,先调用本站售票更新接口,如果更新成功,则调用本接口,否则不调用本接口;
售异站票时,只需调用本接口即可,用户可以在调用本接口成功后在本站数据库记录售异站票的信息。
一次最多允许同时更新60张票,但只能操作同一个客运站的票。
退订票、退调票时可以不锁定座位。
改乘时,反映当时的售票