客运联网售票系统软件接口规范.docx
- 文档编号:9595483
- 上传时间:2023-02-05
- 格式:DOCX
- 页数:27
- 大小:304.60KB
客运联网售票系统软件接口规范.docx
《客运联网售票系统软件接口规范.docx》由会员分享,可在线阅读,更多相关《客运联网售票系统软件接口规范.docx(27页珍藏版)》请在冰豆网上搜索。
客运联网售票系统软件接口规范
客运联网售票系统
软件接口规范(V5.0)
目录
1前言5
1.1概述5
1.2定义5
1.3参考资料5
2约定6
3接口规范7
3.1接口总览7
3.2票务中心提供的接口8
3.2.1班次更新8
3.2.2锁定座票9
3.2.3取消锁票9
3.2.4售票明细9
3.2.5售票重打印10
3.2.6废票10
3.2.7退票10
3.2.8取退票费率10
3.2.9检票11
3.2.10对帐明细11
3.2.11代理认证11
3.2.12取票号11
3.2.13班次基本信息查询11
3.2.14取得班次票价12
3.2.15取得中心站点信息12
3.2.16确认接口12
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
锁定座票(新)
DLL
投资公司提供
3
SchBaseInfo
班次基本信息查询
DLL
投资公司提供
4
PriceInfo2
票价信息(新)
DLL
投资公司提供
5
LockCancel2
取消锁票(新)
DLL
投资公司提供
6
TicketUpdate
售票更新
DLL
投资公司提供
7
TicketRePrint
售票重打印
DLL
投资公司提供
8
TicketBlankout
废票
DLL
投资公司提供
9
TicketOff
退票
DLL
投资公司提供
10
GetOffFare
获取退票费率
DLL
投资公司提供
11
CheckUser
代理认证
DLL
投资公司提供
12
GetTicketNo
取票号
DLL
投资公司提供
13
SchBaseInfo
取得班次基本信息
DLL
投资公司提供
14
ConfirmAct
确认接口
DLL
投资公司提供
15
GetStCode
取得中心站点编码
DLL
投资公司提供
16
检票接口
TicketExam
检票
DLL
投资公司提供
17
对帐明细
SellCollate
对帐明细
DLL
投资公司提供
18
票价接口
ProGetPrice2
取票价(新)
存储过程
客运站提供*
19
售票接口
ProTicketUpdate
售票更新
存储过程
客运站提供*
20
ProTicketLock
锁定座票(新)
存储过程
客运站提供*
21
ProTicketUnlock
取消锁票(新)
存储过程
客运站提供*
22
ProTicketBlankout
废票接口
存储过程
客运站提供*
23
ProReprint
重打印接口
存储过程
客运站提供*
24
ProTicketOff
退票接口
存储过程
客运站提供*
25
读取数据接口
tc_scheme
班次信息
表
客运站提供*
26
tc_stationcode
站点编码
表
客运站提供*
27
tc_ticketExam
检票信息
表
客运站提供*
28
tc_ticketsell
售票明细
表
客运站提供*
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张票,但只能操作同一个客运站的票。
退订票、退调票时可以不锁定座位。
改乘时,反映当时的售票信息,同正常售票一样。
代理点调用时,必须售票更新成功时才能输出防伪码。
3.2.5售票重打印
名称:
售票重打印
功能:
更新票务中心数据库,生成防伪码。
说明:
出现打印错误但尚未退出本次的售票功能时,可以重新打印车票,否则只能通过废票功能来实现。
一次可以最多重打1张,但只能操作同一个客运站的票。
3.2.6废票
名称:
废票
功能:
将已售出的票作废。
说明:
对售票更新成功的车票,如果打印出现错误,或者未打印,或者因为特殊原因要将该票废除,此时调用此接口完成废票业务。
各客运站(代理点)只能废除本地售出的车票,不能废除别的客运站(代理点)售出的车票,这一功能限制由废票接口内部实现。
另外废票时有半小时的时间限制,这一功能限制由废票接口内部实现。
只能废自己售出的票。
一次最多能废60张票,但只能操作同一个客运站的票。
3.2.7退票
名称:
退票
功能:
将已售出的票退掉。
说明:
退票可在发车站和异地实现,在发车站退票,由各客运站根据自己的业务规则退票;在代售点退票,按照交通部规定全市统一规则退票。
退票成功后调用本接口,将退票信息上传至票务中心。
在网络故障时,不能异地退票,只能在发车站退票。
最多一次可退60张票,但只能操作同一个客运站的票。
同时只能退同一个票源站的票。
3.2.8取退票费率
名称:
取退票费率
功能:
取票务中心全市统一的退票费率。
说明:
该接口只是在非发车站退票时调用,即代理点退票按照全市统一的退票费率收取退票手续费。
系统自动根据售票时间计算费率,并返还给代理点。
在网络故障时,不能异地退票,只能在发车站退票。
3.2.9检票
名称:
检票
功能:
将相应票号的已售出车票标志为已检票。
说明:
在当天的空闲时间,调用此接口,将当天检票信息或打单信息上传到票务中心,可以选择和班次更新时一起上传。
一次将整车的信息上传。
一次最多500条。
3.2.10对帐明细
名称:
对帐明细
功能:
将一定时间段的售票数据,包括退、废、重打印。
说明:
票务中心和各客运站进行对帐的时候,如果双方的帐目不相同,各客运站需要将指定售票日期范围之内的售、退、废、重打印票的所有数据上传到票务中心,由票务中心找出差异。
每次调用最多允许同时上发500条记录。
3.2.11代理认证
名称:
代理认证
功能:
检查该用户是否合法使用。
说明:
只有代理点售票需要调用该接口,接口返回是否合法,。
当新密码和旧密码不同时认为修改密码。
新密码和旧密码均不允许为空。
3.2.12取票号
名称:
取票号。
功能:
返回当前的票号串。
说明:
代理在调用售票更新之前,调用该接口。
成功之后才能执行售票更新和打印。
每次最多返回30张票号,每10位一个票号,中间没有任何的间隔符号。
3.2.13班次基本信息查询
名称:
班次基本信息查询
功能:
根据用户输入参数,查询票务中心数据库,返回符合查询条件的班次信息。
本站信息不返回。
说明:
买票之前必须先进行班次查询,代理点的班次查询和客运站的班次查询不同在于代理的查询只返回中心数据的班次信息,不包含票价等即时信息。
3.2.14取得班次票价
名称:
取得班次票价
功能:
根据用户输入参数,返回相应客运站班次的票价信息。
说明:
除客运站之外,其它客户端在售票时,必须先调用班次查询接口,然后制定班次。
输入的参数均是执行SchBaseInfo接口返回的参数。
3.2.15取得中心站点信息
名称:
取得中心站点信息
功能:
根据用户输入站点编码缩写或者站点名称名字,返回中心站点信息。
说明:
输入的参数可以是汉字或者是站点编码的缩写,中心流程自动判断,返回所有符合条件的站点编码,包括中心代码、名称、缩写,如输入“东莞”,中心返回所有站点名称包含东莞的站点信息,如果输入“DG”或者“dg”,中心返回所有站点缩写包含“DG”的站点信息。
3.2.16确认接口
名称:
确认接口
功能:
客户端调用售票、重打印、废票、退票等接口操作,如果取得返回值或者在成功完成其它后续操作之后,最少保证成功写入本地数据库,调用该接口进行确认。
说明:
中心更新根据参数更新相应的记录,如果需要确认的记录超过一定的时间阀值,中心监控软件报警,进入人工处理流程。
客户端可以不理会本接口的返回值。
当调用中心售、退、废等接口返回非“0”值时,调用该接口,通知中心,接收的是非“0”值。
调用中心售、退、废等接口返回“0”值时,继续往下处理,如果更新本地数据库失败,不调用确认接口。
如果成功调用确认接口。
确认接口返回值只是提供给调用者写入日志的依据,不用做其它处理。
3.2.17取客运站站点编码
名称:
取客运站站点编码
功能:
从客运站提供的表tc_stationcode读取信息,写入到票务中心数据库。
说明:
如果对本站的站点编码进行了修改,由客运站更新到本表。
该表由客运站自动写入,同时可以由票务中心通过存储过程写入到该表。
每次调用最多允许同时上发500条记录。
3.3客运站提供的接口
3.3.1取票价
名称:
取票价
功能:
获取指定时间、班次(线路)、到站的座位票价、以及座位图等信息。
说明:
由客运站提供该接口,由投资公司负责调用。
3.3.2售票更新
名称:
售票更新
功能:
更新客运站售票记录,写入流水帐。
说明:
由客运站提供该接口,由投资公司负责调用。
如果是多条售票记录,一次更新一条记录,在存储过程里面不要有任何提交和回滚的语句。
3.3.3锁定座票(新增)
名称:
锁定座票。
功能:
提供对异站过来的锁票请求进行可售检查,锁定座位的功能,通过参数返回成功锁定的座位串。
说明:
由客运站提供该接口,由投资公司负责调用。
对来自异站的锁票请求,根据班车座位当时的实际准售情况作出正确的回应。
对于不指定座位的锁票要求,站方提供锁定满足数量要求的座位,并将锁定的座位信息返回;对于指定座位的锁票请求,如果不能满足,站方提供锁定满足数量要求的其他座位,并将锁定的座位信息返回,中心服务负责将座位号返回给调用终端。
对于指定座位的锁票,只提供调用一次锁票锁一个座位的功能,其中参数@c_seat只能接收一个长度为3位的座位号。
3.3.4取消锁票(新增)
名称:
取消锁票。
功能:
提供对异站过来的解锁请求进行座位解锁。
说明:
此处的解锁是解锁前面过程ProTicketLock锁定的座位,对终端、座位锁票记录不存在的锁票记录进行解锁,返回‘0’,即函数执行成功。
3.3.5废票更新
名称:
废票更新
功能:
更新客运站售票记录,写入废票。
说明:
由客运站提供该接口,由投资公司负责调用。
如果是多条废票记录,一次更新一条记录,在存储过程里面不要有任何提交和回滚的语句。
3.3.6重打印更新
名称:
重打印更新
功能:
更新客运站售票记录,写入流水帐。
说明:
由客运站提供该接口,由投资公司负责调用。
如果是多条重打印记录,一次更新一条记录,在存储过程里面不要有任何提交和回滚的语句。
3.3.7退票更新
名称:
退票更新
功能:
更新客运站售票记录,写入退票记录。
说明:
由客运站提供该接口,由投资公司负责调用。
如果是多条退票票记录,一次更新一条记录,在存储过程里面不要有任何提交和回滚的语句。
3.3.8班次信息表
说明:
分配给中心代理的用户必须有在任意时候对表tc_scheme有select、delete、truncate的权限。
每天晚上生成班次计划之后全部更新到此表,保证和本站班次信息一致。
本表只是批量上传的班次表。
少量更新的班次信息仍由客运站客户程序调用班次更新接口。
班次信息最迟应该在凌晨1点之前生成。
该表由客运站自动写入,同时可以由票务中心通过存储过程写入到该表。
3.3.9站点信息表
说明:
分配给中心代理的用户必须有在任意时候对表tc_stationcode有select、delete、truncate的权限。
如果对本站的站点编码进行了修改,由客运站更新到本表。
该表由客运站自动写入,同时可以由票务中心通过存储过程写入到该表。
3.3.10检票信息表
说明:
分配给中心代理的用户必须有在任意时候对表tc_ticketExam有select、delete、truncate的权限。
客运站不需要自动写入该表,由票务中心需要时通过调用存储过程写入到该表。
3.3.11售票明细表(财务对帐用)
说明:
分配给中心代理的用户必须有在任意时候对表tc_ticketsell有select、delete、truncate和创建索引的权限。
包括本站售票、售异站票的信息和被异站售出的票。
客运站不需要自动写入该表,由票务中心需要时通过调用存储过程写入到该表。
3.3.12售票查询
名称:
售票明细信息查询
功能:
指定票号查询本地数据库相关的售票信息。
说明:
由客运站提供该接口,由投资公司负责调用。
指定用户必须有执行ProQuerySell的权限。
3.3.13班次信息表更新
名称:
班次信息表更新
功能:
指定日期(可以限定班次),将相关的班次信息写入到表tc_scheme中。
说明:
由客运站提供该接口,由投资公司负责调用。
指定用户必须有执行ProWrtScheme的权限。
建议客运站批量上传也调用该接口。
3.3.14站点编码表更新
名称:
站点编码表更新
功能:
全部或指定站点编码,将相关的站点信息写入到表tc_stationcode中。
说明:
由客运站提供该接口,由投资公司负责调用。
指定用户必须有执行ProWrtStCode的权限。
建议客运站批量生成时也调用该接口。
3.3.15检票信息表更新
名称:
检票信息表更新
功能:
指定日期(可以限定班次),将相关的检票信息写入到表tc_ticketExam中。
说明:
由客运站提供该接口,由投资公司负责调用。
指定用户必须有执行ProWrtTicketExam的权限。
建议客运站批量生成时也调用该接口。
3.3.16售票明细表更新
名称:
售票明细表更新
功能:
指定日期(可以限定班次),将相关的售票明细信息写入到表tc_ticketsell中。
说明:
由客运站提供该接口,由投资公司负责调用。
指定用户必须有执行ProWrtTicketsell的权限。
建议客运站批量生成时也调用该接口。
4其它补充说明的规范
4.1关于电子票
电子票是指网上等手段售出的,乘客没有拿到实际的票据,只有票号等信息的票证。
乘客在网上完成售票之后,系统提供给乘客一个电子票号(即打印在票面上的条形码),乘客乘车前凭票号和身份证号取得乘车票据。
电话号码同时可以作为验证的另一个依据,并可以及时和乘客保持沟通。
基于以上功能,客运站需要提供凭票号、身份证或电话号码提取售票记录,并打印该售票记录的功能。
另外建议提供相关的监控功能,如发车前一定时间内提示服务员主动联系乘客。
即售出的电子票,必须由出票站(包括客运站或其它可以配送打印的代理)在打印完成之后、退票之前、废票之前或者改乘之前必须调用该接口进行确认。
具体参见本文档的3.2.4。
网上只提供查询和售票功能,不提供此外的其它功能。
网上售票时,localdepot为1000。
4.2接口的更新规则
接口新版本更换时,凡是涉及到异站售票需要调用的接口必须同时更新为新版本。
4.3异站售票提示和日志
各客运站售异站票时,必须按照本文档返回值的不同意思,提示错误信息,便于售票员分清出错源头和票务中心解决错误。
如售票明细接口中返回8,就应该提示类似“发车站更新不成功”的信息。
各客运站包括票务中心对异站售票,特别是异站售票出现异常时必须有完整的日志记录。
5本地操作关键流程与程序设计参考规范
5.1售本站票
5.2售异站票
5.3退票
5.4废票
6附录
6.1客运站编码
编码
名称
0010
珠海市客运联网售票票务管理中心
0011
珠海市长途汽车运输公司省汽车客运站
0012
珠海市第二公共汽车公司珠海汽车客运站
0013
珠海新天威交通发展有限公司天河客运站
00
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 客运 联网 售票 系统软件 接口 规范