DB44/T 2144-2018 汽车客运站数据联网及售票接口技术规范
DB44/T 2144-2018 Car passenger transportation station data networking and ticketing interface technical specifications
基本信息
发布历史
-
2018年12月
研制信息
- 起草单位:
- 广东南粤通客运联网中心有限公司、交通运输部科学研究院、深圳市丛文科技有限公司、深圳市运发集团股份有限公司。
- 起草人:
- 彭美华、沈志纲、陈剑华、叶思华、秦海军、周红全、谷云辉、严东梅、苏振杰、钟宇鹏、招展樑、李德富、付立、刚红润、梁江涛、刘志、冯俊刚。
- 出版信息:
- 页数:90页 | 字数:- | 开本: -
内容描述
ICS03.220.01
R11
备案号:61538-2019DB44
广东省地方标准
DB44/T2144—2018
汽车客运站数据联网及售票
接口技术规范
Technicalspecificationforbusterminalfielddatanetworkingand
ticketsellinginterface
2019-07-24发布2019-08-01实施
广东省市场监督管理局发布
DB44/T2144—2018
目次
前言................................................................................II
1范围..............................................................................1
2规范性引用文件....................................................................1
3术语、定义和缩略语................................................................1
3.1术语和定义....................................................................1
3.2缩略语........................................................................2
4总体要求..........................................................................2
4.1通信方式......................................................................2
4.2安全认证......................................................................2
4.3传输要求......................................................................2
4.4质量要求......................................................................3
4.5存储要求......................................................................3
4.6实名制要求....................................................................3
4.7其他技术要求..................................................................3
5系统结构和数据实体................................................................3
5.1系统结构......................................................................3
5.2数据实体......................................................................4
6接口协议..........................................................................5
6.1报文帧结构....................................................................5
6.2实时数据变更推送接口..........................................................7
7接口请求和响应信息................................................................9
7.1基础数据......................................................................9
7.2信息服务数据.................................................................24
7.3行业监管数据.................................................................28
7.4联网售票数据.................................................................34
8联网售票操作.....................................................................49
8.1电子票号获取.................................................................49
8.2联网售票.....................................................................52
8.3联网取票.....................................................................63
8.4网络售票补打票...............................................................67
8.5联网退票.....................................................................67
9交易数据报送.....................................................................70
9.1代售方交易数据报送...........................................................71
9.2票源方结算单报送.............................................................72
附录A(规范性附录)编目编码规则...................................................74
附录B(规范性附录)接口响应请求状态码.............................................82
I
DB44/T2144—2018
前言
本规范按照GB/T1.1-2009给出的规则起草。
本规范由广东省交通运输厅提出并归口。
本规范主要起草单位:广东南粤通客运联网中心有限公司、交通运输部科学研究院、深圳市丛文科
技有限公司、深圳市运发集团股份有限公司。
本规范主要起草人:彭美华、沈志纲、陈剑华、叶思华、秦海军、周红全、谷云辉、严东梅、苏振
杰、钟宇鹏、招展樑、李德富、付立、刚红润、梁江涛、刘志、冯俊刚。
II
DB44/T2144—2018
汽车客运站数据联网及售票接口技术规范
1范围
本规范规定了广东省汽车客运站数据联网的总体要求、系统结构和数据实体、接口协议、接口请求
和响应信息、联网售票操作、交易数据报送等。
本规范适用于三级及以上汽车客运站站务系统、客运企业售票系统、定制出行售票系统、区域联网
系统、省联网售票中心系统和手机APP、微信公众号等互联网售票系统的开发,以及各系统与省联网售
票中心系统的数据联网和联网售票交易操作。
三级以下的汽车客运站数据联网、水路客运联网售票可参照执行。
2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅所注日期的版本适用于本文
件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。
GB/T2260中华人民共和国行政区划代码
GB/T2261.1个人基本信息分类与代码第1部分:人的性别代码
GB/T2261.3个人基本信息分类与代码第3部分:健康状况代码
GB/T4762政治面貌代码
GB/T12402经济类型分类与代码
GA/T16.4道路交通管理信息代码第4部分:机动车车辆类型代码
GA482中华人民共和国机动车驾驶证
JT/T309中华人民共和国汽车客运站(点)代码
JT/T415-2006道路运输电子政务平台编目编码规则
JT/T417中华人民共和国汽车客运线路代码
JT/T697.7-2014交通信息基础数据元第7部分:道路运输信息基础数据元
JT/T809道路运输车辆卫星定位系统平台数据交换
JT/T979.2-2015道路客运联网售票系统第2部分:信息数据元
JT/T979.4道路客运联网售票系统第4部分:部级联网售票平台接入技术要求
JT/T979.5道路客运联网售票系统第5部分:乘车凭证技术要求
3术语、定义和缩略语
3.1术语和定义
JT/T979.4和JT/T979.5界定的术语和定义适用于本文件。
3.1.1
客运企业售票系统ticketingsystemofpassengertransportenterprise
普通班车客运企业向社会公众提供客票实时查询、网络购票等服务,组织建设的管理系统。
1
DB44/T2144—2018
3.1.2
定制出行售票系统ticketingsystemofcustompassengertransport
定制出行客运企业向社会公众提供客票实时查询、网络购票等服务,组织建设的管理系统。
3.1.3
区域联网系统districtnetworkingsystem
在某特定区域(地市行政区域或企业集团)内已经实现汽车客运站数据联网的管理系统。
3.1.4
发车站条形码barcodeofdepartstation
在购票时由站务系统生成,打印或显示在乘车凭证上用于发车站在线查验车票信息的条形码编号。
3.1.5
乘车凭证号boardingvouchernumber
在购票时由站务系统生成后,用于标识乘车凭证的唯一性编码。
3.2缩略语
APP应用(Application)
CSV逗号分隔值(Comma-SeparatedValues)
FTP文件传输协议(FileTransferProtocol)
HTTP超文本传输协议(HyperTextTransferProtocol)
IP网络互联协议(InternetProtocol)
JSONJavaScript对象表示法(JavaScriptObjectNotation)
MQ消息队列(MessageQueue)
VPN虚拟专用网络(VirtualPrivateNetwork)
URI统一资源标识符(UniformResourceIdentifier)
4总体要求
4.1通信方式
三级及以上汽车客运站站务系统(或区域联网系统、客运企业售票系统、定制出行售票系统)与省
联网售票中心平台之间应采用面向连接的链路通信方式,通过专线或互联网+VPN的方式实现互联。具体
要求如下:
连接方式:支持FTP、MQ、Web服务等通信方式;
——通信协议:采用HTTP1.1短连接方式,且请求内容和应答内容分别在一个HTTP包内进行传输;
——编码要求:汉字编码采用UTF-8编码;
——性能要求:最低响应延时不超过30s;
——故障恢复:在没有外部因素影响的情况下,网络故障恢复时间不超过30m。
4.2安全认证
省联网售票中心平台对三级及以上汽车客运站站务系统(或区域联网系统、客运企业售票系统、定
制出行售票系统)的接入请求进行安全认证,具体要求如下:
——加密方式:省联网售票中心平台作为服务端,提供服务的IP地址以及加密密钥等信息,供站务
系统(或区域联网系统、客运企业售票系统、定制出行售票系统)接入;
——链路加密:采用基于国家密码主管部门许可加密算法的VPN设备进行数据加密传输。
2
DB44/T2144—2018
4.3传输要求
4.3.1三级及以上汽车客运站站务系统(或区域联网系统、客运企业售票系统、定制出行售票系统)
应支持7×24h持续稳定的数据交换,其他等级汽车客运站应在营业时间内支持持续稳定的数据交换。
4.3.2系统之间支持断点续传,在网络恢复正常时应及时将故障期间未传输的数据重新上传。
4.4质量要求
4.4.1数据提供方应保证数据的真实性、完整性。
4.4.2数据提供方应在接收到数据请求后1s内作出响应。
4.5存储要求
省联网售票中心平台支持存储站务系统(或区域联网系统、客运企业售票系统、定制出行售票系统)
报送的全部历史数据,存储容量不少于3年的历史数据。
4.6实名制要求
遵照JT/T979.4中4.3的要求。
4.7其他技术要求
省联网售票中心平台应按照JT/T309完成省内客运站的编码工作,并规范相应的客运站名称、简称、
别称和英文名称。
5系统结构和数据实体
5.1系统结构
汽车客运站数据联网的由省联网售票中心平台、站务系统、客运企业售票系统、定制出行售票系统、
区域联网系统、前置机和传输线路共同组成,汽车客运站数据联网的系统结构如图1所示。
a)在票源方系统(或区域联网系统)端部署前置服务器,票源方系统(或区域联网系统)与前置
服务器进行连接,接入区域联网系统的票源方系统不需要部署前置服务器与省联网售票中心平
台连接;
b)在省联网售票中心平台和票源方系统(或区域联网系统)的前置机部署数据接口服务,通过数
据接口服务通信实现数据的上报、下发、查询以及联网售票操作功能;
c)在省联网售票中心平台和票源方系统(或区域联网系统)的前置机部署数据库,同时兼容HTTP
协议接口和数据库视图两种数据采集模式;
d)在HTTP协议接口模式下,省联网售票中心平台和票源方系统(或区域联网系统)的前置机通
过数据HTTP接口通信实现数据的上报,票源方系统(或区域联网系统)负责按要求将数据同
步到本单位的前置服务器并通过HTTP协议接口推送到省联网售票中心平台前置机。
在数据库视图模式下,省联网售票中心平台通过部署在票源方系统(或区域联网系统)前置机的数
据视图抓取数据,实现汽车客运站业务数据的定时采集。票源方系统(或区域联网系统)负责按要求在
生产数据库建立数据视图,并与前置服务器进行连接。
3
DB44/T2144—2018
省
级
中心数据库省
联运
网
数据交换服务政
中系
心统
平
台
数据库
数据接口服务系统
互联网+VPN或专线
前置机前置机前置机前置机前置机
数据抓取服务系统数据抓取服务系统数据抓取服务系统数据抓取服务系统数据抓取服务系统
客运站智能系统区域联网系统客运企业售票系统定制出行售票系统其他售票系统
客运站智能系统
图1汽车客运站数据联网的系统结构图
5.2数据实体
省联网售票中心平台与票源方系统(或区域联网系统)之间通过数据联网传输的数据实体分为查询
和上报两大类。
5.2.1查询类数据实体
查询类数据实体的数据实体名称、数据提供方和数据使用方的一般规定见表1。
表1查询类数据实体的数据实体名称、数据提供方和数据使用方
序号数据实体名称数据提供方数据使用方
1本省运输企业基本档案省联网售票中心平台票源方系统、区域联网系统
2外省运输企业基本档案省联网售票中心平台票源方系统、区域联网系统
3本省客运班车基本档案省联网售票中心平台票源方系统、区域联网系统
4外省客运班车基本档案省联网售票中心平台票源方系统、区域联网系统
4
DB44/T2144—2018
表1(续)
序号数据实体名称数据提供方数据使用方
5本省汽车客运站档案省联网售票中心平台票源方系统、区域联网系统
6外省汽车客运站档案省联网售票中心平台票源方系统、区域联网系统
7线路牌档案省联网售票中心平台票源方系统、区域联网系统
8本省地域行政档案省联网售票中心平台票源方系统、区域联网系统
9外省地域行政档案省联网售票中心平台票源方系统、区域联网系统
10本省从业人员基本档案省联网售票中心平台票源方系统、区域联网系统
11车辆安全例检档案省联网售票中心平台票源方系统、区域联网系统
12本省车辆地理信息省联网售票中心平台票源方系统、区域联网系统
13本省车辆运行轨迹播放省联网售票中心平台票源方系统、区域联网系统
14乘客实名制信息省联网售票中心平台票源方系统、区域联网系统
5.2.2报送类数据实体
报送类数据实体的数据实体名称、数据发送方和数据接收方的一般规定见表2。
表2报送类数据实体的数据实体名称、数据发送方和数据接收方
序号数据实体名称数据发送方数据接收方
1车辆安全例检信息票源方系统省联网售票中心平台、区域联网系统
2车辆进出站安全监管信息票源方系统省联网售票中心平台、区域联网系统
3电子路单信息票源方系统省联网售票中心平台、区域联网系统
4票源方售票服务状态及参数票源方系统省联网售票中心平台、区域联网系统
5班次信息票源方系统省联网售票中心平台、区域联网系统
6发班班次票源方系统省联网售票中心平台、区域联网系统
7班次动态信息票源方系统省联网售票中心平台、区域联网系统
8发班信息票源方系统省联网售票中心平台、区域联网系统
9售票信息票源方系统省联网售票中心平台、区域联网系统
10改签信息票源方系统省联网售票中心平台、区域联网系统
11退票信息票源方系统省联网售票中心平台、区域联网系统
12销票信息票源方系统省联网售票中心平台、区域联网系统
13取票信息票源方系统省联网售票中心平台、区域联网系统
14补票信息票源方系统省联网售票中心平台、区域联网系统
15检票信息票源方系统省联网售票中心平台、区域联网系统
6接口协议
6.1报文帧结构
6.1.1报文规范
省联网售票中心平台接口请求报文结构见图2。
5
DB44/T2144—2018
HTTPBody
通讯报文头数据体
HTTP协议版本系统名签名长度保留字段
签名数据请求内容
Header(3bytes)(8bytes)(8bytes)(64bytes)
图2省联网售票中心平台接口请求报文结构
省联网售票中心平台接口请求报文结构见表3。
表3省联网售票中心平台接口请求报文结构(HTTP请求协议)
协议类型协议字段字段值必填说明
Host省级联网售票系统IP是
Acceptapplication/JSON是接收的JSON类型数据
HeaderContent-typeapplication/octet-stream是Content为二进制数据
URI遵照交易类型URI定义是
Content-lengthBody的长度否
Body数据内容是见6.1.4
省联网售票中心平台接口返回报文结构见图3。
HTTPBody
通讯报文头数据体
HTTP协议版本系统名签名长度保留字段
签名数据应答内容
Header(3bytes)(8bytes)(8bytes)(64bytes)
图3省联网售票中心平台接口返回报文结构
省联网售票中心平台接口返回报文结构见表4。
表4省联网售票中心平台接口返回报文结构(HTTP应答协议)
协议类型协议字段字段值必填说明
Acceptapplication/JSON是返回的JSON类型数据
HeaderContent-typeapplication/octet-stream是Content为二进制数据
Content-lengthBody的长度否
Body数据内容是见6.1.5
6.1.2通讯报文
省联网售票中心平台和票源方系统(或区域联网系统、客运企业售票系统、定制出行售票系统)通
信协议采用私有协议和JSON协议,其中私有协议采用定长规则。数据的第一部分为签名数据;数据的第
二部分为明文数据,按JSON协议解析。
通讯报文结构见表5。
6
DB44/T2144—2018
表5通讯报文结构
标签名称类型长度必填说明
protover协议版本String3是1.0、2.0等(可根据版本控制进行修改)
用于标识省联网售票中心平台、站务系统、区域联网系统、
sysid系统名String8是
客运企业售票系统或定制出行售票系统
signlen签名长度String8是
reserve保留字段String64是用于通讯协议扩充使用
第一部分为签名数据;数据的第二部分为明文数据,按JSON
data数据是
协议解析
6.1.3接口响应请求状态码
接口响应请求状态码应使用HTTP协议中规范的状态码。接口响应请求状态码见附录B。
6.1.4请求正文
请求正文应采用JSON对象,请求由公共请求信息和接口请求信息组成。请求正文形式见表6。
表6请求正文形式
标签名称类型必填说明
publicrequest公共请求信息String是JSON格式,见表7
body接口请求信息String是JSON格式
表7公共请求信息内容
标签名称类型必填说明
requestid请求唯一标识String是JSON格式
6.1.5响应正文
响应正文应采用JSON对象,响应正文由公共返回信息和接口返回信息组成。
响应正文形式见表8。
表8响应正文形式
标签名称类型必填说明
publicresponse公共返回信息String是JSON格式,见表9
body接口返回信息String是JSON格式
表9公共返回信息内容
标签名称类型必填说明
statuscode响应状态代码Int是见附录B
requestid请求唯一标识String是JSON格式
6.2实时数据变更推送接口
6.2.1请求正文
7
DB44/T2144—2018
请求正文应采用J对象,请求由公共请求信息和请求报文信息组成。
请求正文形式见表10。
表10实时数据变更推送请求正文形式
标签名称类型长度必填说明
publicrequest公共请求信息是JSON格式,见表11
body请求报文信息String是见7、8、9章
表11公共请求信息内容
标签名称类型必填说明
protover协议版本String是1.0、2.0等(可根据版本控制进行修改)
6位系统ID+6位时间到秒数+6位计数器;所有数
据交换类型都要到计数器中取,计数器达到最大
pushid推送唯一标识String是
值,要自动从0开始。位数不够时在编码前以0
补齐。
Typecode数据推送类型String是见表12
signdata签名数据String是对body内容进行签名
reserve保留字段String是用于通讯协议扩充使用
表12联网实时数据变更推送类型
推送类型数据内容标识推送机制说明
车辆安全例检信息safetycases生成例检报告数据时,应实时推送数据
车辆进出站安全监管信息leavingsattioncheck生成安检报告时,应实时推送数据
电子路单信息electronicroadform生成路单时,应实时推送数据
票源方售票服务状态及参数platservicesstatus系统开启、关闭或有变化时,应实时推送
班次信息passengershift当有变化时,应实时推送数据
发班班次departshift当数据生成时,应实时推送数据
正常情况下5分钟推送一次
定制服务
推荐标准
- DB32/T 2212-2012 镇稻11号生产技术规程 2012-12-28
- DB32/T 2215-2012 立体草莓栽培技术规程 2012-12-28
- DB32/T 2184-2012 南粳5055栽培技术规程 2012-12-28
- DB32/T 2195-2012 堤内池塘半流水养殖河蟹技术规程 2012-12-28
- DB32/T 2219-2012 雪山鸡孵化技术规程 2012-12-28
- DB32/T 2199-2012 食用菌清洁生产技术规程 2012-12-28
- DB32/T 2167-2012 杨树四旁树覆盖面积折算标准 2012-12-10
- DB32/T 2196-2012 在用尿素合成塔检验规则 2012-12-31
- DB32/T 2182-2012 粳稻品种 南粳5055 2012-12-28
- DB32/T 2203-2012 驱避剂中避蚊胺、驱蚊酯的测定 液相色谱法、气相色谱法 2012-12-28