广东汽车客运站场数据联网及售票接口技术规范

'广东省汽车客运站场数据联网及售票接口技术规范（2014年12月修订实施）广东省交通运输厅二〇一四年十二月 目录1范围12规范性引用文件13术语和缩略语13.1术语13.2缩略语34系统要求34.1系统结构34.2技术要求45接口协议说明45.1接口方式45.2基本编码定义66数据联网内容66.1一般定义66.2本省运输企业基本档案66.3外省运输企业基础档案76.4本省客运班车基本档案76.5外省客运班车基本档案96.6本省汽车客运站档案96.7外省汽车客运站档案106.8省内运行线路档案106.9本省地域行政档案116.10外省地域行政档案116.11本省从业人员基本档案126.12本省车辆地理信息服务126.13本省车辆运行轨迹播放136.14班次信息136.15发班班次146.16发班信息167联网售票操作187.1联网售票流程187.2联网取票流程257.3联网退票流程307.4票务交易查询32附录：《广东省汽车客运站场数据联网及售票接口技术规范》修订说明36 前言请注意本规范的某些内容有可能涉及专利。本规范的发布机构不承担识别这些专利的责任。本规范由广东省交通运输厅提出并归口。本规范由广东省交通运输厅、广州市交通委员会、深圳市交通运输委员会、珠海市交通运输局、佛山市交通运输局、惠州市交通运输局、东莞市交通运输局、中山市交通运输局、江门市交通运输局、肇庆市交通运输局、顺德区环境运输和城市管理局、顺德区公路局、广东南粤通客运联网中心有限公司、广东省交通运输档案信息管理中心、广东省粤运交通股份有限公司、深圳市公路客货运输服务中心、广州交通信息化建设投资营运有限公司、深圳市运发集团股份有限公司、东莞市汇联票务服务有限公司、广州中运客运站场管理有限公司、深圳市丛文科技有限公司、珠海公交信禾长运股份有限公司、广东岭南通股份有限公司、广东省拱北汽车运输有限责任公司参与修订。 引言2009年4月,广东省交通运输厅下发了《关于印发<广东省汽车客运站站级验收标准（试行）>的通知》（粤交运[2009]95号），要求三级及以上客运站的汽车客运站场智能化管理系统必须与省道路运政管理信息系统实时联通，三级以下客运站的汽车客运站场智能化管理系统与省道路运政管理信息系统定时联通。为了配合《广东省汽车客运站站级验收标准（试行）》在全省顺利推行，更好地为汽车客运站提供基础数据支持，采集汽车客运站道路旅客运输有关数据并实现全省联网售票，在省道路运政管理信息系统客运部分管理功能的基础上制订本规范。本规范在有关标准、规范的基础上，对广东省汽车客运站场数据联网的技术要求、接口方式、数据格式、传送方式、数据质量以及全省汽车客运站联网售票操作流程等作出了规定，旨在实现系统间的互通互联、数据共享以及实现全省汽车客运站的联网售票。 广东省汽车客运站场数据联网及售票接口技术规范1范围本规范规定了广东省汽车客运站场数据联网的技术要求、接口方式、数据格式、传送方式、数据质量等内容，并对联网售票的操作流程作了相应的规范，以适应广东省汽车客运站场数据联网及联网售票业务的数据交换需求。本规范适用于汽车客运站智能系统、区域联网系统与省级联网中心平台的数据联网，以及通过省级联网中心平台与客票代售机构进行的联网售票交易。2规范性引用文件下列文件中的条款通过本规范的引用而成为本规范的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本规范，然而，鼓励根据本规范达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本规范。GB2312信息交换用汉字编码字符集基本集GB/T8566-2007信息技术软件生存周期过程GB/T13502-1992信息处理程序构造及其表示的约定GB/T14394-2008计算机软件可靠性和可维护性管理GB/T16260.1-2006软件工程产品质量第一部分：质量模型GB/T17544-1998信息技术软件包质量要求和测试GB/T18492-2001信息技术系统及软件完整性级别GB/T18493-2001信息技术软件生存周期过程指南《广东省道路运政管理信息系统管理规定（试行）》《广东省汽车客运站站级验收标准（试行）》3术语和缩略语3.1术语3.1.1省运政系统指广东省道路运政管理信息系统。3.1.2省级联网中心平台指广东省汽车客运站场数据联网中心平台，全省汽车客运站场通过该平台实现与省运政系统的数据联网。3.1.3站务系统指广东省各汽车客运站使用的客运站场智能管理系统。3.1.4区域联网系统指在某特定区域（地市行政区域或企业集团）内已经实现汽车客运站数据联网的管理系统。3.1.5车牌指公安交通管理部门颁发的机动车车牌号，如“粤A12345”。36 1.1.1车牌颜色指车牌的颜色，分为：黄色、蓝色、白色、黑色。1.1.2传输控制协议/互联网络协议（TCP/IP）一种网络通信协议，规范了网络上的所有通信设备，尤其是一个主机与另一个主机之间的数据往来格式以及传送方式,也是计算机数据打包和寻址的标准办法。1.1.3车辆运行轨迹播放营运车辆运行轨迹实时动态图。1.1.4车辆地理位置数据营运车辆当前所处的地理位置信息，例如：深圳市南山区滨海大道。1.1.5数据上报指站务系统（区域联网系统）根据本规范的要求向省级联网中心平台提交数据。1.1.6数据请求指站务系统（区域联网系统）向省级联网中心平台请求数据，或省级联网中心平台向站务系统（区域联网系统）请求数据。1.1.7数据提供者指提供数据的主体，包括站务系统、区域联网系统和省级联网中心平台。1.1.8线路种类指客运线路的种类，分为：省际、市际、县际、县内、港澳、国际。1.1.9班次类型指客运班次的类型，分为：正班、加班、顶班。1.1.10发班模式指发班的模式，分为：定时、不定时。1.1.11班次种类指客运班次的种类，分为：始发、配客。1.1.12客运类别指客运的类别：分为：直达、普通。1.1.13班线种类指客运班线的种类：分为：一类、二类、三类、四类。1.1.14车辆等级指车辆的装备等级，分为：高三级、高二级、高一级、中级、普通级。1.1.15车辆类型指客运车辆的类型，分为：特大型、大型、中型、小型。1.1.16车辆座型指车辆座位的类型，分为：座位、卧铺。1.1.17全省班次ID号全省集中班次信息的ID号，全省唯一，编码规则为：2位地市代码+2位站场码+4位流水号+识别码，由省级联网中心平台统一分配。1.1.18站务系统班次号站务系统中的班次编号，站场内部唯一，具体编码规则由客运站根据需要自行设定。1.1.19联网售票条码编号联网售票时打印在客票上的条码编号，编码规则为：6位站场代码+4位日期+6位流水号，条码标准应符合CODE39。1.1.20站场名称线路起讫站点的名称，站场名称分为全称和简称，由省级联网中心平台提供。36 1.1.1站场代码客运站场的唯一编码，采用全省统一的6位站场代码确定站场的唯一，由省级联网中心平台提供。1.1.2客票代售机构通过省级联网中心平台从事公路客票代售业务的企业和经营单位，包括代售异站客票的客运站。代售机构的基本档案由省级联网中心统一管理。1.1.3自助取票终端通过省级联网中心平台向公众提供电子客票纸质出票服务的自助取票设备。1.1.4数据实体是指各类数据传输对象。如：客运车辆基本档案。1.1.5最近更新时间指数据最后一次更新时间，精确到秒，格式为：yyyyMMddHHmmss。1.2缩略语TCP传输控制协议(TransmissionControlProtocol)XML可扩展的标记语言（eXtensibleMarkupLanguage）2系统要求2.1系统结构系统结构示意图如图1所示。图1系统结构示意图36 说明：（1）在汽车客运站或区域联网机构部署前置服务器，站务系统（或区域联网系统）与前置服务器进行连接。（2）在省级联网中心平台和站务系统（或区域联网系统）的前置机部署数据接口服务，通过数据接口服务通信实现数据的上报、下发以及联网售票。（3）在省级联网中心平台的前置机部署数据库，同时兼容WebService接口和数据库视图两种数据采集模式；（4）在WebService接口模式下，省级联网中心平台和站务系统（或区域联网系统）的前置机通过数据接口服务通信实现数据的上报，汽车客运站（或联网机构）负责按要求将数据上报到本单位的前置服务器。（5）在数据库视图模式下，省级联网中心平台通过部署在前置机的数据视图抓取服务，实现客运站业务数据的定时采集。汽车客运站（或联网机构）负责按要求在生产数据库建立数据视图，并与前置服务器进行连接。1.1技术要求1.1.1传输要求（1）三级及以上汽车客运站（或联网机构）应支持7×24h持续稳定的数据交换。（2）系统之间支持断点续传，在网络恢复正常时能相互及时将通信网络故障期间未传输的数据重新上传。1.1.2网络要求（1）三级及以上汽车客运站（或联网机构）必须通过互联网+VPN或专线的方式实时与省级联网中心平台联通。（2）在没有外部因素影响的情况下，网络故障恢复时间不超过30分钟。（3）支持TCP/IP网络协议。1.1.3质量要求（1）真实性：对本规范规定的数据视图提供内容，数据提供者必须保证视图数据的真实性和唯一性。（2）实时性：对本规范规定数据接口内容，在网络联通的情况下，应按数据交换的要求及时提供数据；数据提供者需在接收数据请求1秒内作出响应。（2）完整性：必须按照本规范规定格式和内容上传数据；1.1.4存储要求省级联网中心平台支持存储接入的站务系统（或区域联网系统）报送的全部历史数据，存储容量不少于3年的历史数据。2接口协议说明2.1接口方式本规范采用WebService和数据库视图两种方式来实现省级联网中心平台与站务系统（或区域联网系统）的数据交换。36 1.1.1WebService1.1.1.1实现机制图2接口使用模式对于数据请求，由站务系统（或区域联网系统）根据本规范的要求向省级联网中心平台提交申请关键字，省级联网中心平台根据请求的内容返回相应的数据；或由省级联网中心平台根据本规范的要求向站务系统（或区域联网系统）提交申请关键字，站务系统（或区域联网系统）根据请求的内容返回相应的数据。对于数据上报，由站务系统（或区域联网系统）根据本规范的要求向省级联网中心平台提交有关数据，省级联网中心平台根据实际业务的要求返回相应的结果。1.1.1.2数据类型说明统一通过字符串的格式传递数据，具体的数据格式要求见数据内容中的数据项格式定义。1.1.1.3数据文件说明数据体文件为XML格式文件，编码方式为GB2312。数据体文件由数据头和数据内容两个部分组成。具体格式见表1。表1数据文件定义数据头数据内容报文头报文参数请求结果1.1.2数据库视图站务系统（或区域联网系统）按要求在生产数据库建立数据视图，由前置服务器的接口服务负责调用执行。1.1.2.1实现机制客运站在生产数据库建立相关数据视图,省前置机数据抓取服务定期从站务系统数据库视图抓取符合规范的数据，存储在前置机数据库,同时上报至省联网中心平台。1.2基本编码定义基础信息编码定义见表2。36 表2全省地市行政区划及代码对应表地市行政区划代码地市行政区划代码地市行政区划代码广州4401GZ肇庆4412ZQ阳江4417YJ深圳4403SZ江门4407JM清远4418QY珠海4404ZH茂名4409MM东莞4419DG汕头4405ST惠州4413HZ中山4420ZS佛山4406FS梅州4414MZ潮州4451CZ韶关4402SG汕尾4415SW揭阳4452JY湛江4408ZJ河源4416HY云浮4453YF1数据联网内容1.1一般定义此部分内容描述了客运站与省级联网中心平台之间进行数据上报和下发等数据交换业务的操作规范。数据源及数据提供者、数据使用者的一般规定见表3。表3数据源、数据提供者和数据使用者序号数据源数据提供者数据使用者1本省运输企业基本档案省级联网中心平台站务系统、区域联网系统2外省运输企业基础档案省级联网中心平台站务系统、区域联网系统3本省客运班车基本档案省级联网中心平台站务系统、区域联网系统4外省客运班车基本档案省级联网中心平台站务系统、区域联网系统5本省汽车客运站档案省级联网中心平台站务系统、区域联网系统6外省汽车客运站档案省级联网中心平台站务系统、区域联网系统7省内运行线路档案省级联网中心平台站务系统、区域联网系统8省际运行线路档案省级联网中心平台站务系统、区域联网系统9本省地域行政档案省级联网中心平台站务系统、区域联网系统10外省地域行政档案省级联网中心平台站务系统、区域联网系统11本省从业人员基本档案省级联网中心平台站务系统、区域联网系统12本省车辆地理信息省级联网中心平台站务系统、区域联网系统13本省车辆运行轨迹播放省级联网中心平台站务系统、区域联网系统14班次信息（含票价信息）站务系统、区域联网系统省级联网中心平台15发班计划站务系统、区域联网系统省级联网中心平台16发班信息站务系统、区域联网系统省级联网中心平台1.2本省运输企业基本档案1.2.1访问规则申请关键字：运输企业名称关键字或经营许可证号或辖区市，例如：新锦湖。返回结果：运输企业基本档案。最多返回10条数据，站务系统根据需要进行筛选。1.2.2数据内容序号数据项名称数据长度允许为空数据格式描述1企业代码10否36 全省统一编码，格式为：2位地区代码+6位流水号2企业名称80否3经营许可证字4否4经营许可证号20否5经营范围500否6发证机关80否7辖区市10否8辖区县10是9状态8否营业、停业、整改、歇业、注销10备注255是1.1外省运输企业基础档案1.1.1接口方式采用WebService接口方式。1.1.2访问规则申请关键字：外省运输企业名称关键字，例如：运德。返回结果：外省运输企业基本档案。最多返回10条数据，站务系统根据需要进行筛选。1.1.3数据内容序号数据项名称数据长度允许为空数据格式描述1企业代码10否全省统一编码，格式为：2位地区代码+6位流水号2企业名称80否3经营许可证字4否4经营许可证号20否5经营范围500否6发证机关80否7辖区省20否8辖区市20否9辖区县20是10状态8否营业、停业、整改、歇业、注销11备注255是1.2本省客运班车基本档案1.2.1接口方式采用WebService接口方式。1.2.2访问规则申请关键字：车牌号+车牌颜色，例如：粤A12345（黄色）；每次只能请求一辆车的数据。36 返回结果：返回车辆基本档案。1.1.1数据内容序号数据项名称数据长度允许为空数据格式描述1车牌号20否2车牌颜色10否3座位数2否4载客座位数2否5经营范围80否6厂牌20否7型号20否8车辆等级20否高三级、高二级、高一级、中级、普通级9车辆类型20否特大型、大型、中型、小型10座型20否座位、卧铺11技术等级20否壹级、贰级、叁级12道路运输证字4否13道路运输证号10否14发证机关8015审验有效期8否yyyyMMdd16下次二级维护日期8是yyyyMMdd17企业代码10否18企业名称80否19经营线路类型20是省际、市际、县际、县内、港澳、国际、旅游包车20标志牌号码10否21标志牌牌别10否直达、普通22标志牌有效期8否yyyyMMdd23起点地20否24起点站50否25起点站代码8否26终点地20否27终点站50否28终点站代码8否29途经线路100是30途经停靠站点100是31起点地配客点100是32终点地配客点100是33备注255是1.2外省客运班车基本档案1.2.1接口方式采用WebService接口方式。36 1.1.1访问规则申请关键字：车牌号+车牌颜色，例如：湘A12345（黄色）；每次只能请求一辆车的数据。返回结果：返回车辆基本档案。1.1.2数据内容序号数据项名称数据长度允许为空数据格式描述1车牌号20否2车牌颜色10否3座位数2否4载客座位数2否5经营范围80否6车辆等级20否7车辆类型20否8座型20否9技术等级20否10道路运输证字4否11道路运输证号15否12发证机关80否13审验有效期8否yyyyMMdd14企业名称80否15标志牌号码20否16标志牌牌别10否直达、普通17标志牌有效期8否yyyyMMdd18本省地20否19本省站50否20本省站代码10否21外省地20否22外省站50否23途经线路100否24沿途停靠站点100是25本省配客点100是26备注255是1.2本省汽车客运站档案1.2.1接口方式采用WebService接口方式。1.2.2访问规则申请关键字：站场代码或站场名称关键字或辖区市+辖区县。返回结果：符合查询条件的所有汽车客运站数据。1.2.3数据内容序号数据项名称数据长度允许为空数据格式描述1站场代码8否全省统一站场代码2站场简称20否全省统一简称36 3站场名称80否4经营单位编码20205经营单位名称1001006站场类别8否配客点、客运站7站场级别8否一级、二级、三级、四级、五级8辖区市10否9辖区县10是10辖区镇10是11备注255是1.1外省汽车客运站档案1.1.1接口方式采用WebService接口方式。1.1.2访问规则申请关键字：站场代码或站场名称关键字或辖区省+辖区市+辖区县。返回结果：符合查询条件的所有汽车客运站数据。1.1.3数据内容序号数据项名称数据长度允许为空数据格式描述1站场代码8否全省统一站场代码2站场简称20否全省统一简称3站场名称80否4经营单位编码20205经营单位名称1001006站场类别8否配客点、客运站7站场级别8否一级、二级、三级、四级、五级8辖区省20否9辖区市20否10辖区县20是11辖区镇10是12备注255是1.2省内运行线路档案1.2.1接口方式采用WebService接口方式。1.2.2访问规则申请关键字：站场代码，只能请求已经批准进入本站的运行线路数据。返回结果：进入请求站场的运行线路数据。1.2.3数据内容序号数据项名称数据长度允许为空数据格式描述1线路代码20否2线路名称100否36 3起点地20否4起点站50否5起点站代码8否6终点地20否7终点站50否8终点站代码8否9途经线路100否10沿途停靠站点100否11线路种类8否一类、二类、三类、四类12线路类型8否省际、市际、县际、县内、港澳、国际13客运类别8否普通、直达14里程6否单位：公里15日发班次10否1.1本省地域行政档案1.1.1接口方式采用WebService接口方式。1.1.2访问规则申请关键字：地市名称，例如：广州返回结果：请求地市的县、镇辖区数据。1.1.3数据内容序号数据项名称数据长度允许为空数据格式描述1地域ID号20否2地域名称20否3辖区市20否4辖区县20是5辖区镇20是6辖区村20是7行政区划20否8行政级别20否省、市、县、镇、村9地域代码10否1.2外省地域行政档案1.2.1接口方式采用WebService接口方式。1.2.2访问规则申请关键字：省名称，例如：湖南返回结果：请求省的市、县辖区数据。1.2.3数据内容序号数据项名称数据长度允许为空数据格式描述1地域ID号20否2地域名称20否36 3辖区省20否4辖区市20是5辖区县20是6行政级别20否省、市、县、镇、村7行政区划20否8地域代码10否1.1本省从业人员基本档案1.1.1接口方式采用WebService接口方式。1.1.2访问规则申请关键字：身份证号码或从业资格证号，每次只能请求一个人的数据。返回结果：从业人员的基本档案。1.1.3数据内容序号数据项名称数据长度允许为空数据格式描述1姓名20否2性别4否3从业资格证号20否4从业人员类别100否5从业资格类别100否6首次领证时间8否yyyyMMdd7从业资格证有效期8否yyyyMMdd8发证机关80否9准驾车型10否10服务单位代码20是11服务单位名称80是12备注255是1.2本省车辆地理信息服务1.2.1接口方式采用WebService接口方式。1.2.2访问规则申请关键字：车牌号+车牌颜色，每次只能请求一辆车的数据。返回结果：车辆地理信息位置，例如：深圳市南山区滨海大道。1.2.3数据内容序号数据项名称数据长度允许为空数据格式描述1车牌号20否2车牌颜色10否3地理位置100否4经度10否5纬度10否6速度10否单位：公里/小时36 1.1本省车辆运行轨迹播放1.1.1接口方式采用WebService接口方式。1.1.2访问规则申请关键字：车牌号+车牌颜色，一次请求最多20辆车的数据。返回结果：返回携带车辆信息的运行轨迹服务链接URL，可在浏览器中打开。1.1.3数据内容无。1.2班次信息1.2.1接口方式采用数据视图的方式。1.2.2访问规则配客班必需报送班次ID号。返回结果：接收成功标识,对于第一次报送的班次信息省级联网中心平台将返回全省统一的班次ID号。1.2.3数据内容序号数据项名称数据长度允许为空数据格式描述1报送站代码6否全省统一站场代码2报送站名称80否3班次ID10是班次变更和配客班不允许为空4站务系统班次号20否5线路名称20否7客运类别10否直达、普通8线路种类20否省际、市际、县际、县内、港澳、国际9班次种类20否始发、配客10班次类型20否正班、加班11发班模式10否定时、非定时12首班时间4是HHmm13末班时间4是HHmm14发班间隔时间4是HHmm15发班时间4是HHmm16终到省20是17终到市20是18终到县20是19终到镇20是20终到村20是21终到站代码20是省内客运站不可为空，省外可选22终到站名称50否36 23班次有效期起20否yyyyMMdd24班次有效期止20否yyyyMMdd25班次状态10否正常、停班以下数据项可循环重复26企业代码10否不可为空27企业名称80否28车牌号20是29核定座位数2否30是否商务大巴2否是、否31车辆类型10否特大型、大型、中型、小型32座型10否座位、卧铺33车辆等级10否高三级、高二级、高一级、中级、普通级以下数据项可循环重复34中途站点简称100否全省统一简称35中途站点代码10否全省统一站场代码36行驶时间6否单位：小时37行驶里程10否单位：公里38运价10否单位：元39单车单程车辆通行费10否单位：元40单座车辆通行费10否单位：元41燃油附加费10否单位：元42站务费10否单位：元43其他费用金额10否单位：元44运费10否单位：元45全票上限价10否单位：元46全票执行价10否单位：元47半票执行价10否单位：元48学生票价10否单位：元49残疾军人票价10否单位：元50执行有效期起8否yyyyMMdd51执行有效期止8否yyyyMMdd52备注255是1.1发班班次1.1.1接口方式采用数据视图的方式。1.1.2访问规则数据要求：视图数据必须与生产库数据保持一致。36 1.1.1数据内容序号数据项名称数据长度允许为空数据格式描述1报送站代码6否全省统一站场代码2报送站名称80否3班次ID10否临时加班可为空4站务系统班次号20否5线路名称20否6客运类别10否直达、普通7线路种类20否省际、市际、县际、县内、港澳、国际、包车8班次种类20否始发、配客9班次类型20否正班、加班10发班模式10否定时、非定时11首班时间4是HHmm12末班时间4是HHmm13发班间隔时间4是HHmm14发班时间4是HHmm15发班日期8否yyyyMMdd16终到省20否17终到市20否18终到县20是19终到镇20是20终到村20是21终到站代码20是省内客运站不可为空，省外可选22终到站名称50否23班次状态20否售票、检票、发班、停班、停售24总票数10否25已售票总数10否26剩余票总数10否27可售票总数10否28可售免票儿童数10否29企业代码10是30企业名称100是31车牌号20是32是否商务大巴2是是、否33车辆类型10是特大型、大型、中型、小型34座型10是座位、卧铺35车辆等级10是36 高三级、高二级、高一级、中级、普通级以下数据项可重复36站点（地）简称100否全省统一简称37站点（地）代码10否全省统一站场代码38行驶时间6否单位：小时39行驶里程10否单位：公里40全票上限价10否单位：元41全票执行价10否单位：元42半票执行价10否单位：元43学生票价10否单位：元44残疾军人票价45已售全票数2否46已售半票数2否47免票数2否48已售学生票数2否49已售残疾军人票数50备注255是1.1发班信息1.1.1接口方式采用数据视图抓取的方式。1.1.2访问规则数据要求：客运站提供数据视图，由视图抓取服务根据最后更新时间主动抓取。返回结果：是否成功。1.1.3数据内容序号数据项名称数据长度允许为空数据格式描述1报送站代码6否全省统一站场代码2报送站名称80否3车辆IC卡号20否4车牌号20否5车牌颜色10否6企业代码10否7企业名称80否8班次ID号7否9站务系统班次号20否10发班日期8否yyyyMMdd11进站时间4否HHmm12出站时间4否HHmm13安检结果6否合格、不合格14本站上客人数2否15其中：省联网售票人数2否通过省联网平台36 购票的人数16进站时总人数2否17免票人数2否18免票儿童人数2否19出站时总人数2否20记录人20否21记录时间12否yyyyMMddHHmm22备注255是23安全监管报送标记2否如通过本接口报送安全监管信息,则该值为“是”，且(24~39,45项)信息要按照标准报送，否则可为空。(是、否)24道路运输证号40否25座位2否26车辆等级10否高三级、高二级、高一级、中级、普通级27技术等级20否壹级、贰级、叁级28审验有效期8否29标志牌号码40否30线路名称100否31途经线路255是32配客站点255是33终到站80否终到站名称34班次种类20否始发、配客35班次类型20否正班、加班36发班模式20否定时、不定时37行驶证有效性8否38是否配载危险物品2否39危险物品名称255是以下数据项可重复40终到站代码10否到站编码41终到站简称80否到站名称42终到站人数10否到站人数以下数据项可重复43驾驶员姓名20否44驾驶员从业资格证号20否45驾驶证有效性2否是、否36 1联网售票操作此部分描述了通过省级联网中心平台实现联网售票、联网退票、票务交易查询的交易操作规范，不适用于区域联网系统内的客运站与本区域联网系统的相关操作。1.1联网售票流程1.1.1一般定义联网售票是指客票代售票机构通过省联网中心平台与联网客运站进行的客票代售业务。联网售票流程如图3所示。图3联网售票流程示意图流程说明：联网售票交易分为查询、锁位、售票、确认四个操作步骤。在某些异常情况下，可以对已售客票进行废票操作。1.1.2接口定义1.1.2.1班次查询1.1.2.1.1接口说明用于交易前查询票源站的班次实时信息，以确认某笔交易请求是否应该受理。36 1.1.1.1.1访问规则接口可适应不同的应用场景，可传入目的地编码或中文。如果指定发车时间，则只显示当天指定时间之后的班次，否则显示当天所有班次。1.1.1.1.2数据内容1.1.1.1.2.1请求内容序号数据项名称数据长度允许为空数据格式描述1发车站20否发车站编码2乘车站编码20是配客点3请求方编码20否客票代售机构编码4操作地址20是操作地址5班次日期10否yyyyMMddyyyyMMdd6终到站50否站点编码或中文7座位类型10是座/卧8发班时间4是HHmmHHmm,显示当天指定时间之后的班次。9运营方式20是直达/普通10班次号10是为空返回所有匹配记录，指定班次号则返回相应班次号的班次信息。1.1.1.1.2.2返回结果序号数据项名称长度可空数据格式描述1班次ID20否2站务系统班次号20否3班次日期10否yyyyMMdd4始发站名称50否5乘车站代码20否区别车站下属不同配客点。6乘车站名称20否7经营单位代码20否8经营单位名称50否9车牌号码20否10车牌颜色10否11发班时间5否HHmm12班次种类20否始发/配客13发班模式20否定时班/非定时班/加班14终到地50否15终到站代码50否终点站编码16终到站名称50否终点站名称17运营方式20否直达或普通18是否流水班2否False/True(流水班)19流水班首发5否20流水班末班5否36 21流水发班间隔5否22途经站点1000否23里程10否24座位数2否25全票价10否26半票价10否27学生票价10否28残疾军人票价10是29车辆类型20否30车辆等级20否31剩余车票10否32剩余座位列表120是每个座位用3位数字表示33剩余免票儿童人数2否34班次状态20否35到站编码20否站点的编码，方便锁票时调用(查询时传入有可能是中文)36到站名称50否37备注255是1.1.1.1锁票1.1.1.1.1接口说明用于交易过程中给指定座位添加锁定标志，避免在支付或收款时该座位被他人锁定或抢售，确保支付或收款后指定座位可以成功售出。1.1.1.1.2访问规则锁票前获取订单号。订单号用于标识本次操作的业务信息，锁票时必须传入中心返回的订单号。中心将订单号作为后续业务跟踪和对帐辅助依据。如果两次或两次以上锁票属同一笔业务，则可用同一订单号，否则需重新获取新的订单号。订单号从生成的时刻起，5分钟后失效，如果两次或两次以上锁票属同一笔业务，请在5分钟内完成或分为两次进行。锁票成功后，请在约定的时间内完成后续交易操作(默认窗口售票模式锁票时间保留5分钟，其他方式锁票时间保留20分钟)。超过约定时间，客运站可以将座位解锁，导致此次交易自动终止。如果客户放弃购票，请主动及时将座位解锁，避免座位被无意义锁定而无法售出。注意：锁票时传入的站点编码请使用查询时返回的编码。1.1.1.1.3数据内容1.1.1.1.3.1请求内容序号数据项名称数据长度允许为空数据格式描述1发车站20否发车站编码2乘车点20是配客班必须传入乘车点编码36 3请求方编码20否代售机构编码4操作地址20是5班次日期10否yyyyMMdd6班次号20否站务系统班次号7到达站50否8操作员工号/操作终端编号20否代售机构9操作员姓名/操作终端名称40否代售机构10订单号20否11业务类型2否7网上售票，8自助售票，9手机售票,10电话售票,11窗口售票12事务ID36否同报文头事务ID13取票人手机号20是非窗口售票使用14取票人姓名20是非窗口售票使用15取票人证件类别20是非窗口售票使用用:身份证/军官证/通行证等16取票人证件号码20是非窗口售票使用以下数据项可以重复17乘车人姓名20是针对学生票/残军票18乘车人证件类别20是针对学生票/残军票19乘车人证件号码20是针对学生票/残军票用20票型1否1全，2半，3学，4残军21票数2否22免票儿童人数2否23座位列表120是每个座位用3位数字表示(暂不支持指定座位)1.1.1.1.1.1返回结果序号数据项名称长度可空数据格式描述1座位号3否2票型1否3票价9否4班次ID20否5站务系统班次号20否6班次日期10否yyyyMMdd7发班时间5否HHmm8到站编码20否9到站名称50否10操作员工号/操作终端编号20否代售机构11操作员姓名/40否代售机构36 操作终端名称12操作时间20否yyyyMMddHHmmss13订单号20否14事务ID36否锁票时的事务ID15说明255是1.1.1.1提交1.1.1.1.1接口说明用于收款或用户支付后将车票真正售出，同时返回完整的车票信息。1.1.1.1.2访问规则如果调用提交时返回失败信息，需主动将锁定的座位释放。如果调用时返回超时错误，请尝试重新提交此业务，建议在5分钟内进行1－3次尝试。如果用户通过银联等方式支付，请在支付后调用此接口并将支付方生成的支付ID传入，用于对帐时进行业务比对。1.1.1.1.3数据内容1.1.1.1.3.1请求内容序号数据项名称数据长度允许为空数据格式描述1发车站20否发车站编码2请求方编码20否代售机构编码3操作地址20是4操作员工号/操作终端编号20否代售机构5操作员姓名/操作终端名称40否代售机构6事务ID36否锁票事务ID，同报文头事务ID7支付类型2是现金/信用卡/网银…8订单号20否9支付单号是支付方生成，对帐用。10备注是1.1.1.1.3.2返回结果序号数据项名称数据长度允许为空数据格式描述1所属站20否发车站编码2所属站名50否3乘车站编码20否4乘车站50否乘车站名称5代售机构20否客票代售机构编码6日期10否yyyyMMdd7班次号20否班次号8班次时间5否HHmm9到达站代码20否到达站编码36 10到达站名50否到达站名称11里程10否12业务类型2否7网上售票，8自助售票，9手机售票,10电话售票,11窗口售票13候车厅50否14检票口50否15停车位50否16操作员工号/操作终端编号20否代售机构17售票员姓名/操作终端名称50否代售机构18售票时间20否yyyyMMddHHmmss19订单号20否20事务ID36否锁票时的事务ID21取票人手机号20是非窗口售票使用以下数据项可以重复22票型1否1全，2半，3学，4残军23票价10否24座位2否25条码20否26免票儿童2否27打印备注255Y28备注255Y1.1.1.1确认1.1.1.1.1接口说明用于售票提交成功后，客票代售机构向中心发送确认信息，确认此次售票已完成。如果在锁票后20分钟内中心收不到确认信息，则会向票源站发出业务查询，如果客运站系统返回错误信息，则中心会将此笔业务取消。1.1.1.1.2访问规则无。1.1.1.1.3数据内容1.1.1.1.3.1请求内容序号数据项名称数据长度允许为空数据格式描述1发车站编码20否2请求方编码20否3操作地址20是4操作员工号/操作终端编号20否代售机构5操作员姓名/操作终端名称40否代售机构36 6事务ID36否GUID格式锁票事务ID，同报文头事务ID7条码20否条码8票号20否代售机构出票时使用（暂不支持代售机构出票）1.1.1.1.1.1返回结果无1.1.1.2废票1.1.1.2.1接口说明用于特殊情况下对已售客票的作废处理，将指定的车票作废并释放座位。1.1.1.2.2访问规则由于代售方操作原因，导致需要按相关业务规范在5分钟内发起废票请求，由客运站作废指定车票并释放座位，该客票交易取消。废票仅限于在窗口代售业务中出现的某些特殊情况，且必须在规定时间内进行，超过约定时间，则废票操作无法进行。一次操作只能作废同一车站且同一订单的车票。1.1.1.2.3数据内容1.1.1.2.3.1请求内容序号数据项名称数据长度允许为空数据格式描述1发车站20否发车站编码2请求方编码20否代售机构编码3操作地址20是4操作员工号/操作终端编号20否代售机构5操作员姓名/操作终端名称40否代售机构6订单号20否原订单号7车票条码列表1000否一次最多可传40个条码，用“，”(半角逗号)分隔8事务ID36否客户按GUID规则生成新的ID9说明255是1.1.1.2.3.2返回内容序号数据项名称数据长度允许为空数据格式描述1错误号20否中心统一错误响应码2错误信息255是36 1.1联网取票流程1.1.1一般定义联网取票是指通过省联网售票平台完成的售票交易的电子客票订单，可以通过自助取票终端和客运站窗口办理纸质客票的出票，并向发车站发送已出票信息。联网取票流程如图4所示。图4联网取票流程示意图1.1.2接口定义1.1.2.1取票记录报送1.1.2.1.1接口说明用于客运站将已取票的客票信息报送省联网中心。1.1.2.1.2访问规则客运站在取出后实时报送省联网中心。数据请求：取票后实时上报。返回结果：无。1.1.2.1.3数据内容1.1.2.1.3.1请求内容序号数据项名称数据长度允许为空数据格式描述1所属站20否发车站编码2所属站名50否36 3乘车站编码20否4乘车站50否乘车站名称5代售机构20否客票代售机构编码6日期10否yyyyMMdd7班次号20否班次号8班次时间5否HHmm9到达站20否到达站编码10到达站名50否到达站名称11里程10否12业务类型2否7网上售票，8自助售票，9手机售票,10电话售票,11窗口售票13候车厅50否14检票口50否15停车位50否16操作员工号/操作终端编号20否代售机构17售票员姓名/操作终端名称50否代售机构18售票时间20否yyyyMMddHHmmss19订单号20否20事务ID36否锁票时的事务ID13取票人手机号20是14取票人姓名20是15取票人证件类别20是16取票人证件号码20是以下数据项可以重复17乘车人姓名20是针对学生票/残军票18乘车人证件类别20是针对学生票/残军票19乘车人证件号码20是针对学生票/残军票用22票型1否1全，2半，3学，4残军23票价10否24座位2否25条码20否26免票儿童2否27是否已取票2否是/否28取票时间20否yyyyMMddHHmmss36 29打印备注255Y30备注255Y1.1.1.1.1.1返回结果序号数据项名称数据长度允许为空数据格式描述1错误号20否中心统一错误响应码2错误信息255是1.1.1.2车票查询1.1.1.2.1接口说明用于通过省联网售票平台查询某位旅客的已成交、待取票的订单、客票信息。1.1.1.2.2访问规则接口可适应不同的应用场景，包括二代身份证读卡、证件号（身份证、岭南通或其他证件）加密码、二维码、岭南通读卡多种取票方式。1.1.1.2.3数据内容1.1.1.2.3.1请求内容序号数据项名称数据长度允许为空数据格式描述1请求方编码20否代售机构编码2操作地址20是3操作员工号/操作终端编号20否代售机构4操作员姓名/操作终端名称40否代售机构5发车站20否发车站编码6取票方式10否身份证读卡订单号+取票密码二维码岭南通7取票人姓名20是非普通全票时采用乘车人信息8取票人证件类别20是非普通全票时采用乘车人信息8取票人证件号码20是非普通全票时采用乘车人信息9取票人手机号20是10取票密码20是取票方式为取票密码时不能为空11订单号20是12车票条码20是取票方式为二维码时不能为空13说明255是36 1.1.1.1.1.1返回结果序号数据项名称数据长度允许为空数据格式描述1所属站20否发车站编码2所属站名50否3乘车站编码20否4乘车站50否乘车站名称5代售机构20否客票代售机构编码6日期10否yyyyMMdd7班次号20否班次号8班次时间5否HHmm9到达站20否到达站编码10到达站名50否到达站名称11里程10否12业务类型2否7网上售票，8自助售票，9手机售票,10电话售票,11窗口售票13候车厅50否14检票口50否15停车位50否16操作员工号/操作终端编号20否代售机构17售票员姓名/操作终端名称50否代售机构18售票时间20否yyyyMMddHHmmss19订单号20否20事务ID36否锁票时的事务ID13取票人手机号20是14取票人姓名20是15取票人证件类别20是16取票人证件号码20是以下数据项可以重复17乘车人姓名20是针对学生票/残军票18乘车人证件类别20是针对学生票/残军票19乘车人证件号码20是针对学生票/残军票用22票型1否1全，2半，3学，4残军23票价10否24座位2否25条码20否26免票儿童2否27是否已取票2否是/否36 28取票时间20否yyyyMMddHHmmss29打印备注255Y30备注255Y1.1.1.1出票确认1.1.1.1.1接口说明用于车票打印成功后，取票终端发送取票确认信息，确认此次取票已完成。1.1.1.1.2访问规则车票打印后实时发送。1.1.1.1.3数据内容1.1.1.1.3.1请求参数序号数据项名称数据长度允许为空数据格式描述1发车站20否发车站编码2请求方编码20否3操作地址20是4操作员工号/操作终端编号20否5操作员姓名/操作终端名称40否6取票人姓名20是7取票人证件类型20是8取票人证件号码20是9取票方式10否身份证读卡取票密码二维码岭南通10订单号20否11车票条码1000否一次最多可传40个条码，用“，”(半角逗号)分隔12车票票号20否取票时的客票发票号码13取票时间20否yyyyMMddHHmmss14说明255是1.1.1.1.3.2返回参数序号数据项名称数据长度允许为空数据格式描述1错误号20否中心统一错误响应码2错误信息255是1.2联网退票流程1.2.1一般定义联网退票是指客票代售机构通过省联网中心平台与联网客运站进行的已售客票的代退票业务。36 车票售出后，可按相关业务规范在规定时间内办理退票，并收取一定的手续费。退票可在发车站退票窗口办理，也可由客票代售机构代办。联网退票流程如图5所示。图5联网退票流程示意图1.1.1接口定义1.1.1.1手续费查询1.1.1.1.1接口说明代售方退票时先查询手续费。车票售出后，在不同时间段退票将按《广东省汽车客运站收费实施细则》的规定收取不同的手续费，所以在退票前必须先到联网中心平台获取手续费，才能准确计算应退给乘客的票款。1.1.1.1.2访问规则由于车票售出后，在不同时间段退票将收取不同的手续费，所以有乘客要求退票时，应尽快在获取手续费后将车票退掉。1.1.1.1.3数据内容1.1.1.1.3.1请求内容序号数据项名称数据长度允许为空数据格式描述1发车站20否发车站编码2请求方编码20否代售机构编码3操作地址20是4操作员工号/操作终端编号20否代售机构36 5操作员姓名/操作终端名称40否代售机构6订单号20否网上、手机退票用7车票条码列表1000否一次最多可传40个条码，用“，”(半角逗号)分隔8说明255是1.1.1.1.1.1返回结果序号数据项名称数据长度允许为空数据格式描述1订单号20否2条码20否3退票费率5否0～1之间的小数4退票手续费9否5代办手续费9否1.1.1.2退票请求1.1.1.2.1接口说明用于查询手续费后，进行退票操作，同时返回完整的退票信息。1.1.1.2.2访问规则如果出现退票失败，可隔一段时间后再尝试。如果多次尝试还不能成功退票，应按标准先依照之前的查询结果扣除相应手续费后，将剩余票款退还给乘客，事后再和发车站协商。1.1.1.2.3数据内容1.1.1.2.3.1请求内容序号数据项名称数据长度允许为空数据格式描述1发车站20否发车站编码2请求方编码20否3操作地址20是4操作员工号/操作终端编号20否5操作员姓名/操作终端名称40否6车票条码1000否一次最多可传40个条码，用“，”(半角逗号)分隔7退票费率5否0－1之间的小数8退票手续费9否9代办手续费910退款类型2是现金/信用卡/网银…11订单号20是支付方生成的退款订单号码，对帐用。12票款金额10是原订单票款金额13说明255是36 1.1.1.1.1.1返回结果序号数据项名称数据长度允许为空数据格式描述1错误号20否中心统一错误响应码2错误信息255是1.2票务交易查询票务交易查询是指客票代售机构、票源站可以通过省级联网中心平台对已发生的票务交易数据进行查询。1.2.1代售方查询1.2.1.1交易明细1.2.1.1.1接口说明代售方查询交易明细情况。1.2.1.1.2访问规则代售方随时可以查询某个时间段内的所有交易明细，也可以查询具体某笔订单的交易完成情况。交易日期跨度不能大于一个月。只能查询本方交易数据，即传入的请求方编码和本站编码或代售机构编码必须相同。1.2.1.1.3数据内容1.2.1.1.3.1请求内容序号数据项名称数据长度允许为空数据格式描述1请求方编码20否请求方编码2操作地址20是3交易日期起20否yyyyMMdd4交易日期止20否yyyyMMdd5订单号20是6事务ID36是1.2.1.1.3.2返回结果序号数据项名称数据长度允许为空数据格式描述1事务ID36否GUID格式2交易状态20否完成/未完成3订单号20否4所属站20否发车站编码5所属站名50否6操作方20否代售方编码7操作员工号/操作终端编号20是代售机构8操作员姓名/操作终端名称40是代售机构9操作地址20否10操作时间20否yyyyMMddHHmmss36 11交易类型20否代售/代订/代退12班次号20否班次号13交易金额10否14支付类型20否15支付单号20否16备注255是1.1.1.1交易汇总1.1.1.1.1接口说明代售方查询交易汇总情况。返回按日期交易汇总结果。1.1.1.1.2访问规则代售方随时可以查询交易汇总情况。交易日期跨度不能大于一个月。只能查询本方交易数据，即传入的请求方编码和本站编码或代售机构编码必须相同。1.1.1.1.3数据内容1.1.1.1.3.1请求内容序号数据项名称数据长度允许为空数据格式描述1请求方编码20N请求方代售机构编码2操作地址20Y3交易日期起20NyyyyMMdd4交易日期止20NyyyyMMdd1.1.1.1.3.2返回结果序号数据项名称数据长度允许为空数据格式描述1日期20否yyyyMMdd2交易状态20否完成/未完成3所属站20否发车站编码4所属站名50否5操作方20否代售机构编码6操作地址20否7交易类型20否代票/订票/代退/8交易数量20否9交易金额50否10支付类型20否11备注255是1.1.2票源站查询1.1.2.1代售明细1.1.2.1.1接口说明票源站查询其他代售方代售本站车票的情况。1.1.2.1.2访问规则票源站随时可以查询其他代售方代售本站车票的明细情况。36 可以查询某个时间段内的所有交易明细，也可以查询具体某笔订单的交易完成情况。交易日期跨度不能大于一个月。只能查询本站代售数据，即传入的发车站编码和本站编码必须相同。1.1.1.1.1数据内容1.1.1.1.1.1请求内容序号数据项名称数据长度允许为空数据格式描述1发车站编码20否请求站编码2配客点编码20是3交易日期起20否yyyyMMdd4交易日期止20否yyyyMMdd5订单号20是6事务ID36是1.1.1.1.1.2返回结果序号数据项名称数据长度允许为空数据格式描述1交易ID36否GUID格式2交易状态20否完成/未完成3订单号20否4操作方20否代售机构编码5操作地址20否6操作员工号/操作终端编号20否代售机构7操作员姓名/操作终端名称40否代售机构8操作时间20否yyyyMMddHHmmss9交易类型20否10班次号20否11交易金额50否12支付类型20否13支付单号20否14备注255是1.1.1.2代售汇总1.1.1.2.1接口说明票源站查询其他代售方代售本站车票汇总情况。返回按日期代售汇总结果。1.1.1.2.2访问规则票源站随时可以查询其他代售方代售本站车票的情况。交易日期跨度不能大于一个月。只能查询本站代售数据，即传入的发车站编码和本站编码必须相同。1.1.1.2.3数据内容1.1.1.2.3.1请求内容序号数据项名称数据长度允许为空数据格式描述1发车站编码20否请求站编码36 2配客点编码20是3交易日期起20否yyyyMMdd4交易日期止20否yyyyMMdd1.1.1.1.1.1返回结果序号数据项名称数据长度允许为空数据格式描述1日期20否yyyyMMdd2交易状态20否完成/未完成3操作方20否代售机构编码4操作地址20否5交易类型20否售票/订票6交易数量20否7交易金额50否8支付类型20否9备注255是36 附录：《广东省汽车客运站场数据联网及售票接口技术规范》修订说明根据省厅《关于印发珠江三角洲地区客运联网售票工作方案的通知（粤交运[2014]1588号）》，结合《广东省交通运输厅转发交通运输部关于印发汽车客运站营运客车安全例行检查及出站检查工作规范的通知》（粤交运〔2013〕47号）2份文件的要求，为配合珠三角地区二级以上客运站自助取票设备安装部署工作，同时,为解决目前全省联网售票数据质量及接口质量不高,交易成功率较低的问题，我厅在《广东省汽车客运站场数据联网及售票接口技术规范（2012年11月修订）》（以下简称“《接口规范》”）基础上，对原《接口规范》的部分内容进行了补充和完善。本次《接口规范》修改内容，主要包括以下几个方面：一、在“4.1系统结构”中，按新的数据视图采集方案对规范内容作了修改，以实现省级联网售票平台数据交换业务的优化，提升全省联网售票的业务的数据质量和交易成功率。二、在“5.1接口方式”中，就新的数据抓取模式，增加了“5.1.2数据库视图抓取”接口方式的说明，以便于理解。三、根据各项数据的不同交换方式，在“6.数据联网内容”部分，对每项数据内都增加了接口方式说明；其中“6.14班次信息”、“6.15发班班次”、“6.16发班信息”采取数据视图模式。四、在“7.联网售票操作”部分，增加了“7.2联网取票流程”。对自助机联网取票的业务流程及数据交换方式作了约定。2014年12月20日36'