DB4401T 60-2020 公路客運站場聯(lián)網(wǎng)售票數(shù)據(jù)接口技術(shù)規(guī)范

L70DB4401代替DBJ440100/T192—2013廣州市市場監(jiān)督管理局發(fā)布DB4401/T60－2020前言 2規(guī)范性引用文件 3術(shù)語和縮略語 3.1術(shù)語 3.2縮略語 34系統(tǒng)要求 34.1開發(fā)要求 34.2系統(tǒng)運行要求 34.3網(wǎng)絡(luò)要求 34.4數(shù)據(jù)上傳要求 34.5數(shù)據(jù)質(zhì)量要求 34.6數(shù)據(jù)儲存要求 45基本編碼 45.1漢字編碼 45.2聯(lián)網(wǎng)售票系統(tǒng)客運站場代碼 45.3到站信息編碼 46接口規(guī)范 46.1數(shù)據(jù)訪問 46.1.1本省運輸企業(yè)基本檔案 46.1.1.1訪問規(guī)則 46.1.1.2數(shù)據(jù)內(nèi)容 46.1.2外省運輸企業(yè)基本檔案 56.1.2.1訪問規(guī)則 56.1.2.2數(shù)據(jù)內(nèi)容 56.1.3本省客運班車基本檔案 66.1.3.1訪問規(guī)則 66.1.3.2數(shù)據(jù)內(nèi)容 66.1.4外省客運班車基本檔案 76.1.4.1訪問規(guī)則 76.1.4.2數(shù)據(jù)內(nèi)容 76.1.5本省汽車客運站場檔案 86.1.5.1訪問規(guī)則 86.1.5.2數(shù)據(jù)內(nèi)容 86.1.6外省汽車客運站場檔案 9DB4401/T60－20206.1.6.1訪問規(guī)則 96.1.6.2數(shù)據(jù)內(nèi)容 96.1.7省內(nèi)運行線路檔案 6.1.7.1訪問規(guī)則 6.1.7.2數(shù)據(jù)內(nèi)容 6.1.8本省地域行政檔案 6.1.8.1訪問規(guī)則 6.1.8.2數(shù)據(jù)內(nèi)容 6.1.9外省地域行政檔案 6.1.9.1訪問規(guī)則 6.1.9.2數(shù)據(jù)內(nèi)容 6.1.10駕駛員基本檔案 6.1.10.1訪問規(guī)則 6.1.10.2數(shù)據(jù)內(nèi)容 6.2數(shù)據(jù)上傳 6.2.1班次信息 6.2.1.1上傳規(guī)則 6.2.1.2數(shù)據(jù)內(nèi)容 6.2.2發(fā)班信息 6.2.2.1上傳規(guī)則 6.2.2.2數(shù)據(jù)內(nèi)容 6.2.3車輛安檢信息 6.2.3.1上傳規(guī)則 6.2.3.2數(shù)據(jù)內(nèi)容 6.2.4到站站點信息 6.2.4.1訪問規(guī)則 6.2.4.2數(shù)據(jù)內(nèi)容 6.3聯(lián)網(wǎng)售票 6.3.1聯(lián)網(wǎng)售票流程 6.3.1.1流程分類 6.3.1.2售票流程 6.3.1.3退票流程 6.3.1.4廢票流程 6.3.2班次查詢 6.3.2.1接口說明 6.3.2.2訪問規(guī)則 6.3.2.3請求內(nèi)容 6.3.2.4返回內(nèi)容 6.3.3票價信息 6.3.3.1接口說明 6.3.3.2訪問規(guī)則 6.3.3.3請求內(nèi)容 6.3.3.4返回內(nèi)容 DB4401/T60－20206.3.4鎖定座位 6.3.4.1接口說明 6.3.4.2訪問規(guī)則 6.3.4.3請求內(nèi)容 6.3.4.4返回內(nèi)容 6.3.5取消鎖位 6.3.5.1接口說明 6.3.5.2訪問規(guī)則 6.3.5.3請求內(nèi)容 6.3.5.4返回內(nèi)容 6.3.6售票更新 6.3.6.1接口說明 6.3.6.2訪問規(guī)則 6.3.6.3請求內(nèi)容 6.3.6.4返回內(nèi)容 6.3.7提交確認 6.3.7.1接口說明 6.3.7.2訪問規(guī)則 6.3.7.3請求內(nèi)容 6.3.7.4返回內(nèi)容 6.3.8取退票費率 6.3.8.1接口說明 6.3.8.2訪問規(guī)則 6.3.8.3請求內(nèi)容 6.3.8.4返回內(nèi)容 6.3.9退票 6.3.9.1接口說明 6.3.9.2訪問規(guī)則 6.3.9.3請求內(nèi)容 6.3.9.4返回內(nèi)容 6.3.10廢票 6.3.10.1接口說明 6.3.10.2訪問規(guī)則 6.3.10.3數(shù)據(jù)內(nèi)容 6.3.10.4返回內(nèi)容 6.4電子客票 6.4.1電子客票流程 6.4.1.1售票流程 6.4.1.2廢票流程 6.4.2班次查詢 6.4.2.1接口說明 6.4.2.2訪問規(guī)則 6.4.2.3請求內(nèi)容 DB4401/T60－20206.4.2.4返回內(nèi)容 6.4.3取票價 6.4.3.1接口說明 6.4.3.2訪問規(guī)則 6.4.3.3請求內(nèi)容 6.4.3.4返回內(nèi)容 6.4.4申請訂單 6.4.4.1接口說明 6.4.4.2訪問規(guī)則 6.4.4.3請求內(nèi)容 6.4.4.4返回內(nèi)容 6.4.5提交訂單 6.4.5.1接口說明 6.4.5.2訪問規(guī)則 6.4.5.3請求內(nèi)容 6.4.5.4返回內(nèi)容 6.4.6作廢訂單 6.4.6.1接口說明 6.4.6.2訪問規(guī)則 6.4.6.3請求內(nèi)容 6.4.6.4返回內(nèi)容 6.4.7確認訂單 6.4.7.1接口說明 6.4.7.2訪問規(guī)則 6.4.7.3請求內(nèi)容 6.4.7.4返回內(nèi)容 附錄A（規(guī)范性附錄）聯(lián)網(wǎng)售票系統(tǒng)客運站場代碼表 附錄B（規(guī)范性附錄）省外主要到站信息編碼表 DB4401/T60－2020本標準按GB/T1.1—2009給出的規(guī)則起草。本標準由DBJ440100/T192—2013《公路客運站場聯(lián)網(wǎng)售票數(shù)據(jù)接口技術(shù)規(guī)范》確認轉(zhuǎn)化而來，并代替DBJ440100/T192—2013《公路客運站場聯(lián)網(wǎng)售票數(shù)據(jù)接口技術(shù)規(guī)范》。本標準與DBJ440100/T192—2013相比，除編輯性修改外，主要技術(shù)變化如下：——修改了提出/歸口單位與起草單位名稱；——更新了規(guī)范性引用文件；——修改了第3部分術(shù)語和定義中關(guān)于車輛等級、車輛類型、技術(shù)等級的定義；——刪除了原3.1.10全省班次ID號；——修改了表24中序號8和9的原數(shù)據(jù)項名稱條形碼為聯(lián)網(wǎng)售票條碼編號。本標準由廣州市交通運輸局提出并歸口。本標準起草單位：廣州交通信息化建設(shè)投資營運有限公司、廣州市交通運輸局科技信息處。本標準主要起草人：劉本章、張孜、周紅全、于潔涵、董志國、林思、翁健、蔣園、廖修華。DBJ440100/T192—2013于2013年9月3日首次發(fā)布。1DB4401/T60－2020公路客運站場聯(lián)網(wǎng)售票數(shù)據(jù)接口技術(shù)規(guī)范本標準規(guī)定了廣州市公路汽車客運站場聯(lián)網(wǎng)售票的數(shù)據(jù)接口方式、數(shù)據(jù)格式、數(shù)據(jù)質(zhì)量要求等內(nèi)容，同時規(guī)范接入該系統(tǒng)的客運站場進行聯(lián)網(wǎng)售票的操作流程。本標準適用于廣州市行政區(qū)域內(nèi)公路客運站場聯(lián)網(wǎng)售票客運站場、售票代理點、電子客票商戶等進行客運車票的聯(lián)網(wǎng)售票。2規(guī)范性引用文件下列文件對于本文件的應用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB2312信息交換用漢字編碼字符集基本集GB/T8566信息技術(shù)軟件生存周期過程GB/T13502信息處理程序構(gòu)造及其表示的約定GB/T14394計算機軟件可靠性和可維護性管理GB/T18492信息技術(shù)系統(tǒng)及軟件完整性級別GB/Z18493信息技術(shù)軟件生存周期過程指南GB/T25000.1軟件工程軟件產(chǎn)品質(zhì)量要求與評價（SQuaRE）SQuaRE指南JT/T198-2016道路運輸車輛技術(shù)等級劃分和評定要求JT/T325-2018營運客車類型劃分及等級評定3術(shù)語和定義、縮略語3.1術(shù)語和定義下列術(shù)語適用于本文件。3.1.1聯(lián)網(wǎng)售票onlineticketing通過計算機及網(wǎng)絡(luò)通訊技術(shù)，建立一個中心平臺，各個客運站場、代理售票點及電子客票商戶都可通過中心平臺售賣聯(lián)網(wǎng)中所有客運站場的車票的行為。3.1.2票務中心ticketcenter負責公路客運站場聯(lián)網(wǎng)售票系統(tǒng)運行、維護、運營的組織實體，負責統(tǒng)一收集和管理聯(lián)網(wǎng)客運站場票務數(shù)據(jù)，并實現(xiàn)客運站場互售車票、代理售票過程中車票票款的結(jié)算。3.1.3站務系統(tǒng)stationservicesystem客運站場內(nèi)實現(xiàn)站務管理功能的軟件系統(tǒng)。站務系統(tǒng)一般包含調(diào)度、售票、檢票、安檢、信息公告等多個功能模塊。2DB4401/T60－20203.1.4本站售票stationticketing聯(lián)網(wǎng)售票中任何一方站場，售出自身站內(nèi)車票的行為。3.1.5異站票crossstationticket聯(lián)網(wǎng)售票中任何一方站場，售出非自身站內(nèi)的車票。3.1.6聯(lián)網(wǎng)模式networkingmode進行聯(lián)網(wǎng)售票的站務系統(tǒng)，在網(wǎng)絡(luò)正常運行情況下，實時與票務中心系統(tǒng)進行數(shù)據(jù)交換的一種站務系統(tǒng)運行模式。3.1.7本站模式stationmode進行聯(lián)網(wǎng)售票的站務系統(tǒng)，在網(wǎng)絡(luò)異常運行情況下，暫時不與票務中心系統(tǒng)進行數(shù)據(jù)交換，但能實現(xiàn)本站內(nèi)正常售票的一種站務系統(tǒng)運行模式。3.1.8票源站ticketsourcestation在售賣車票過程中，具有被售賣車票資源的客運站場。3.1.9電子客票E-ticket乘客通過互聯(lián)網(wǎng)、熱線電話、自助售票終端等渠道購買的聯(lián)網(wǎng)售票系統(tǒng)客票，該客票在售出時，不提供紙質(zhì)車票，一般是產(chǎn)生一串數(shù)字作為一個電子票號。乘客可憑電子票號或身份證到客運站場窗口或者自助取票終端設(shè)備打印紙質(zhì)車票。3.1.10站務系統(tǒng)班次號stationservicesystemshiftnumber站務系統(tǒng)中的班次編號，且為站場內(nèi)部唯一班次編號，具體編碼規(guī)則由客運站場根據(jù)需要自行設(shè)定。3.1.11聯(lián)網(wǎng)售票條碼編號onlineticketingcodenumber聯(lián)網(wǎng)售票時打印在客票上的條碼編號。3.1.12站場等級passengerstationgrade省交通廳按照客運站場的建設(shè)情況劃分的客運站場等級。主要分為：一級、二級、三級、四級、五級共五個等級。3.1.13車輛等級vehiclegrade客車等級。3.1.14車輛類型vehicletype客車類型。3.1.15車輛座型seattype客車的座位類型，分為：座位、臥鋪。DB4401/T60－20203.1.16技術(shù)等級technicalgrade依據(jù)道路運輸車輛的技術(shù)性能劃分的技術(shù)級別。注：按照交通部JT/T198-2016規(guī)定，道路運輸車3.2縮略語下列縮略語適用于本文件。Web服務：網(wǎng)絡(luò)服務（WebService）。用以支持網(wǎng)絡(luò)間不同機器的互動操作的軟件系統(tǒng)。網(wǎng)絡(luò)服務通常是由許多應用程序接口（API）所組成的，它們通過網(wǎng)絡(luò)，例如國際互聯(lián)網(wǎng)（Internet）的遠程服務器端，執(zhí)行客戶所提交服務的請求。4系統(tǒng)要求4.1開發(fā)要求站務系統(tǒng)應符合GB/T8566、GB/T13502、GB/T14394、GB/T18492、GB/Z18493和GB/T25000.1的相關(guān)要求。4.2系統(tǒng)運行要求4.2.1票務中心和聯(lián)網(wǎng)售票的客運站場在聯(lián)網(wǎng)模式下應支持7×24小時持續(xù)穩(wěn)定的數(shù)據(jù)交換。4.2.2當客運站場系統(tǒng)故障或客運站場到票務中心網(wǎng)絡(luò)故障導致客運站場進入本站售票模式時，應在故障排除后30分鐘內(nèi)將本站模式下的數(shù)據(jù)上傳到票務中心。4.3網(wǎng)絡(luò)要求客運站到票務中心的數(shù)據(jù)傳輸應根據(jù)實際需要配備網(wǎng)絡(luò)傳輸介質(zhì)，并配備備份傳輸線路。網(wǎng)絡(luò)故障恢復時間不宜超過30分鐘。4.4數(shù)據(jù)上傳要求數(shù)據(jù)上傳應符合下列要求：a）在網(wǎng)絡(luò)連通的情況下，對于上報數(shù)據(jù)，客運站場需在本地數(shù)據(jù)完成存儲后的2分鐘內(nèi)上報到票務中心；b）遇系統(tǒng)故障，存在手工檢票的，客運站場應在本站系統(tǒng)恢復正常之后的20分鐘內(nèi)通過事后補錄的方式將檢票數(shù)據(jù)上報到票務中心；c）遇特殊原因，需緊急疏散旅客，存在手工檢票的，客運站場應在本站恢復正常狀態(tài)之后的20分鐘內(nèi)通過事后補錄的方式將檢票數(shù)據(jù)上報到票務中心。4.5數(shù)據(jù)質(zhì)量要求數(shù)據(jù)質(zhì)量應符合下列要求：a）實時性：在網(wǎng)絡(luò)連通的情況下，應按數(shù)據(jù)接口要求及時提供數(shù)據(jù)；對于交易數(shù)據(jù)，數(shù)據(jù)提供者需在接收數(shù)據(jù)請求后3秒內(nèi)作出響應；b）完整性：必須按照本規(guī)范規(guī)定格式和內(nèi)容上傳數(shù)據(jù)；c）真實性：客運站場必須按照實際經(jīng)營情況上報本規(guī)范規(guī)定的上傳內(nèi)容，不得對本規(guī)范規(guī)定的內(nèi)容進行虛報、瞞報、修改。4DB4401/T60－20204.6數(shù)據(jù)存儲要求票務中心至少保存最近六個月售票交易明細數(shù)據(jù)，客運站場報送的檢票數(shù)據(jù)至少保留三年。5基本編碼5.1漢字編碼信息交換用的漢字編碼應符合GB2312的規(guī)定。5.2聯(lián)網(wǎng)售票系統(tǒng)客運站場代碼聯(lián)網(wǎng)售票系統(tǒng)客運站場代碼是售票業(yè)務中用于區(qū)分唯一客運站場的編號，由4位數(shù)字組成，由票務中心進行統(tǒng)一分配。聯(lián)網(wǎng)售票系統(tǒng)客運站場代碼見附錄A。5.3到站信息編碼到站信息編碼是客運站場對各個到站目的地名稱的編碼，采用6位數(shù)字組成，編碼內(nèi)容包含國內(nèi)所有縣級及以上行政區(qū)的數(shù)據(jù)，省內(nèi)城市到站信息編碼見表1，省外主要到站信息編碼見附錄B。表1省內(nèi)城市到站信息編碼6接口規(guī)范6.1數(shù)據(jù)訪問6.1.1本省運輸企業(yè)基本檔案6.1.1.1訪問規(guī)則輸入：運輸企業(yè)名稱關(guān)鍵字，或經(jīng)營許可證號，或所在轄區(qū)市。輸出：最多返回10條數(shù)據(jù)，站務系統(tǒng)根據(jù)自身業(yè)務需要進行篩選。6.1.1.2數(shù)據(jù)內(nèi)容本省運輸企業(yè)基本檔案的數(shù)據(jù)內(nèi)容應符合表2的規(guī)定。DB4401/T60－20206.1.2外省運輸企業(yè)基本檔案6.1.2.1訪問規(guī)則輸入：外省運輸企業(yè)名稱關(guān)鍵字。輸出：外省運輸企業(yè)基本檔案。最多返回10條數(shù)據(jù)，站務系統(tǒng)根據(jù)自身業(yè)務需要進行篩選。表2本省運輸企業(yè)基本檔案數(shù)據(jù)要求1否否2否否34否否4否否5否否本省交通廳發(fā)行的經(jīng)營許可證中規(guī)定車輛6否否7否否8否是98否否否是否是6.1.2.2數(shù)據(jù)內(nèi)容外省運輸企業(yè)基本檔案的數(shù)據(jù)內(nèi)容應符合表3的規(guī)定。表3外省運輸企業(yè)基本檔案數(shù)據(jù)要求1否否2否否34否否4否否5否否車輛所屬省交通廳發(fā)行的經(jīng)營許可證中規(guī)6否否7否否6DB4401/T60－2020表3外省運輸企業(yè)基本檔案數(shù)據(jù)要求（續(xù)）8否否9否是8否否否是否是6.1.3本省營運車輛基本檔案6.1.3.1訪問規(guī)則輸入：車牌號+車牌顏色，例如：粵A12345（黃色每次只能請求一輛車的數(shù)據(jù)。輸出：返回車輛基本檔案。6.1.3.2數(shù)據(jù)內(nèi)容本省營運車輛基本檔案的數(shù)據(jù)內(nèi)容應符合表4的規(guī)定。表4本省營運車輛基本檔案數(shù)據(jù)要求1否否2否否32否否42否否5否否6否否7否否8否否9否否否否否否4否否否否否8否否“yyyymmdd”。DB4401/T60－2020表4本省營運車輛基本檔案數(shù)據(jù)要求（續(xù)）期8否是否否否否否是否否否否8否否否否否否8否否否否否否8否否否是否是否是否是否是否是6.1.4外省營運車輛基本檔案6.1.4.1訪問規(guī)則輸入：車牌號+車牌顏色，例如：湘A12345（黃色每次只能請求一輛車的數(shù)據(jù)。輸出：返回車輛基本檔案。6.1.4.2數(shù)據(jù)內(nèi)容外省營運車輛基本檔案的數(shù)據(jù)內(nèi)容應符合表5的規(guī)定。表5外省營運車輛基本檔案數(shù)據(jù)要求1否否2否否32否否42否否8DB4401/T60－2020表5外省營運車輛基本檔案數(shù)據(jù)要求（續(xù)）5否否車輛所屬省交通廳發(fā)行的經(jīng)營許可證中規(guī)6否否車輛裝備等級，分為：高三級、高二級、7否否車輛類型，分為：特大型、大型、中型、8否否9否否4否否否否否否8否否否否否否否否8否否否否否否否否否否否否否否否是否是否是否是6.1.5本省汽車客運站場檔案6.1.5.1訪問規(guī)則輸入：站場名稱關(guān)鍵字，或轄區(qū)市+轄區(qū)縣。輸出：符合查詢條件的所有汽車客運站場數(shù)據(jù)。6.1.5.2數(shù)據(jù)內(nèi)容本省汽車客運站場檔案的數(shù)據(jù)內(nèi)容應符合表6的規(guī)定。DB4401/T60－2020表6本省汽車客運站場檔案數(shù)據(jù)要求18否否2否否3否否48否否指客運站場類別，分為：配客點、客運站58否否6否否7否是8否是9否是6.1.6外省汽車客運站場檔案6.1.6.1訪問規(guī)則輸入：站場名稱關(guān)鍵字，或轄區(qū)省+轄區(qū)市+轄區(qū)縣。輸出：符合查詢條件的所有汽車客運站場數(shù)據(jù)。6.1.6.2數(shù)據(jù)內(nèi)容外省汽車客運站場檔案的數(shù)據(jù)內(nèi)容應符合表7的規(guī)定。表7外省汽車客運站場檔案數(shù)據(jù)要求18否否2否否3否否48否否58否否6否否7否否8否是9否是否是DB4401/T60－20206.1.7省內(nèi)運行線路檔案6.1.7.1訪問規(guī)則輸入：站場代碼，只能請求己經(jīng)批準進入本站的運行線路數(shù)據(jù)。站場代碼由“本省汽車客運站場檔案”接口獲取。輸出：進入請求站場的運行線路數(shù)據(jù)。6.1.7.2數(shù)據(jù)內(nèi)容省內(nèi)運行線路檔案的數(shù)據(jù)內(nèi)容應符合表8的規(guī)定。表8省內(nèi)運行線路檔案數(shù)據(jù)要求1否否2否否3否否4否否58否否6否否7否否88否否9否否否否8否否8否否8否否6否否否否否是6.1.8本省地域行政檔案6.1.8.1訪問規(guī)則輸入：地市名稱。輸出：請求地市的縣、鎮(zhèn)轄區(qū)數(shù)據(jù)。6.8.1.2數(shù)據(jù)內(nèi)容本省地域行政檔案的數(shù)據(jù)內(nèi)容應符合表9的規(guī)定。DB4401/T60－2020表9本省地域行政檔案數(shù)據(jù)要求1否否2否否3否否4否是5否是6否是7否否8否否9否否否是6.1.9外省地域行政檔案6.1.9.1訪問規(guī)則輸入：省份名稱。輸出：請求省的市、縣轄區(qū)數(shù)據(jù)。6.1.9.2數(shù)據(jù)內(nèi)容外省地域行政檔案的數(shù)據(jù)內(nèi)容應符合表10的規(guī)定。表10外省地域行政檔案數(shù)據(jù)要求1否否2否否3否否4否是5否是6否否7否否8否否9否是6.1.10駕駛員基本檔案6.1.10.1訪問規(guī)則DB4401/T60－2020輸入：身份證號碼或從業(yè)資格證號，每次只能請求一個人的數(shù)據(jù)。輸出：駕駛員的基本檔案。6.1.10.2數(shù)據(jù)內(nèi)容駕駛員基本檔案的數(shù)據(jù)內(nèi)容應符合表11的規(guī)定。表11駕駛員基本檔案數(shù)據(jù)要求1否否24否否3否否4否否5否否68否否“yyyymmdd”。78否否8否否9否否否是否是否是否是6.2數(shù)據(jù)上傳數(shù)據(jù)上傳主要是通過在客運站場的后臺數(shù)據(jù)庫，建立相關(guān)生成數(shù)據(jù)的存儲過程及實體表，票務中心數(shù)據(jù)收集程序通過定時或者人工操作方式，從客運站場系統(tǒng)數(shù)據(jù)庫中收集數(shù)據(jù)。6.2.1班次信息6.2.1.1上傳規(guī)則票務中心每天凌晨0時到5時自動從客運站場收集當天及之后至少3天的班次信息數(shù)據(jù)。若當天班次發(fā)生變化時，客運站場應在10分鐘內(nèi)將班次變化信息上傳給票務中心。6.2.1.2數(shù)據(jù)內(nèi)容班次信息的數(shù)據(jù)內(nèi)容應符合表12的規(guī)定。DB4401/T60－2020表12班次信息數(shù)據(jù)要求18否否站務系統(tǒng)班次號，在同一個客運站場內(nèi)，班次2否否38否否4否否51否否61否否7否否81否否9否否客運站場關(guān)于該線路的途經(jīng)站點編碼，多個編否否班次座位信息的字符串表示方式，一個字符表否否班車允許起售時間，如果有多個起售時間，則否否班車停止售票時間，如果有多個止售時間，則6否否否否全票票價，對應途經(jīng)站點編碼，有多少途經(jīng)站否否否否6否否否否否是否否班次線路種類，分為：省際、市際、縣際、縣否否5是是DB4401/T60－2020表12班次信息數(shù)據(jù)要求（續(xù)）5是是5是是否是否是否是否是否是否否否否否否否否否是2否否否否否否否否否否否否6否否否否否否否否否否否否否否否否否否否否否否否否否否8否否8否否DB4401/T60－20206.2.2發(fā)班信息6.2.2.1上傳規(guī)則在客運站場的檢票系統(tǒng)中嵌入該接口，在班次發(fā)車時，即時調(diào)用此接口，將班車發(fā)班信息上報到中6.2.2.2數(shù)據(jù)內(nèi)容發(fā)班信息的數(shù)據(jù)內(nèi)容應符合表13的規(guī)定。表13發(fā)班信息數(shù)據(jù)要求1否否2否否3否是發(fā)班車輛檔次的文字描述，為營運方式、48否否5否否車輛計劃發(fā)班時間，格式“yyyy-mm-dd6否否74否否84否否9否否否否否是否否否否否否否否5否否6否否4否否4否否4否否4否否4否否否否否否進行登記的操作時間，格式“yyyymmdd否是DB4401/T60－2020表13發(fā)班信息數(shù)據(jù)要求（續(xù)）否否否否否否否否否否6.2.3車輛安檢信息6.2.3.1上傳規(guī)則車輛在24小時內(nèi)進行首次發(fā)班時，需進行車輛安檢，并且自動上報車輛安檢信息。6.2.3.2數(shù)據(jù)內(nèi)容車輛安檢信息的數(shù)據(jù)內(nèi)容應符合表14的規(guī)定。表14車輛安檢信息數(shù)據(jù)要求14否否2否否3否否4否否5否否6否否6.2.4到站站點信息6.2.4.1訪問規(guī)則6.2.4.1.1客運站場新增到站站點時，應建立站點編碼數(shù)據(jù)?？瓦\站場的站點編碼由站場自行維護，票務中心實現(xiàn)站點編碼的同步。6.2.4.1.2到站站點及編碼由客運站場自行編制，編碼必須唯一，且不能重復使用。6.2.4.1.3客運站場所有到站站點應映射到票務中心到站信息編碼表中，每一個站點編碼對應一個到站代碼，并且可以多對一。6.2.4.1.4客運站場站點編碼變更（新增、撤銷都應將站點編碼、站點名稱、對應的到站信息代碼上傳到票務中心。6.2.4.1.5票務中心省外主要到站信息編碼見附錄B。6.2.4.2數(shù)據(jù)內(nèi)容到站站點信息的數(shù)據(jù)內(nèi)容應符合表15的規(guī)定。(字節(jié))允許為空16否否到站站點編碼，為站務系統(tǒng)站點編碼。2否否到站站點名稱。36否否到站對應城市(縣)的行政區(qū)碼。44否否51是否是否屬于換乘大站，是、否。6是否撤銷1是否站點是否已撤銷，是、否。74否否站點信息所屬客運站場代碼。退票費率退票數(shù)據(jù)DB4401/T60－20206.3.2班次查詢6.3.2.1接口說明根據(jù)用戶輸入?yún)?shù)，查詢票務中心數(shù)據(jù)庫，返回符合查詢條件的班次信息。6.3.2.2訪問規(guī)則乘客在購買車票的時候調(diào)用該接口進行班次查詢。6.3.2.3請求內(nèi)容班次查詢的數(shù)據(jù)請求內(nèi)容應符合表16的規(guī)定。表16班次查詢請求數(shù)據(jù)要求18是否2否否乘客目的到站的代碼、名稱，或者到站名34否否45否是班車計劃發(fā)車時間，不填則表示查詢?nèi)?否是6否是7否是客運站場站務系統(tǒng)班次號。不填則查詢所6.3.2.4返回內(nèi)容班次信息的數(shù)據(jù)返回內(nèi)容應符合表17的規(guī)定。表17班次查詢返回數(shù)據(jù)內(nèi)容14是否要查詢班次所屬票源站代碼.28否否3否否45否否51否否61否否71否否DB4401/T60－2020表17班次查詢返回數(shù)據(jù)內(nèi)容（續(xù)）8否否發(fā)班車輛檔次的文字描述，為營運方式、96否否否否否否否否否否4否否否是否否否否否否否否否否否否否否否否否否否否5否否5否否5否否否否8否否8否否8否否8否否否否車輛類型，分為：特大型、大型、中型、否否車輛裝備等級，分為：高三級、高二級、6.3.3票價信息6.3.3.1接口說明根據(jù)用戶輸入?yún)?shù)，返回相應客運站場班次的票價信息。6.3.3.2訪問規(guī)則DB4401/T60－2020取票價的輸入?yún)?shù)，必須由班次查詢中獲得。6.3.3.3請求內(nèi)容票價信息的數(shù)據(jù)請求內(nèi)容應符合表18的規(guī)定。表18取票價信息請求數(shù)據(jù)要求18是否28是否36否否44是否5否否6.3.3.4返回內(nèi)容票價信息的數(shù)據(jù)返回內(nèi)容應符合表19的規(guī)定。表19取票價信息返回數(shù)據(jù)內(nèi)容18否否28否否38否否4否是5否是6否否78否否6.3.4鎖定座位6.3.4.1接口說明根據(jù)用戶需求輸入?yún)?shù)，鎖定票務中心數(shù)據(jù)庫的相應票源，并返回鎖定結(jié)果。6.3.4.2訪問規(guī)則只在售異地票時使用，售本地票無須再調(diào)用任何鎖票接口?？赏ㄟ^座位號指定要鎖定的座位。6.3.4.3請求內(nèi)容鎖定座位的數(shù)據(jù)請求內(nèi)容應符合表20的規(guī)定。DB4401/T60－2020表20鎖定座位請求數(shù)據(jù)要求18是否28否否34是否44否否53否是請求鎖定的指定座位?？蛇x參數(shù)，為空時表示不指定座位。指定座位號時，一次只61是否7否否8否否9否是否是否是1是否6.3.4.4返回內(nèi)容鎖定座位的數(shù)據(jù)返回內(nèi)容應符合表21的規(guī)定。表21鎖定座位返回數(shù)據(jù)內(nèi)容1否否返回實際鎖定的座位號，多個座位用‘,’21是否3否否4否否5否否6否否6.3.5取消鎖位6.3.5.1接口說明DB4401/T60－2020取消前面的所有鎖票操作，或指定座位解鎖。6.3.5.2訪問規(guī)則售票流程中，調(diào)用該接口取消前面的所有鎖票請求。同時，客戶端鎖定的座位有時間限制，鎖定座位后超過3分鐘未提交售票的，系統(tǒng)后臺應自動取消鎖位。6.3.5.3請求內(nèi)容取消鎖位的數(shù)據(jù)請求內(nèi)容應符合表22的規(guī)定。表22取消鎖位請求數(shù)據(jù)要求13否否24是否6.3.5.4返回內(nèi)容取消鎖位的數(shù)據(jù)返回內(nèi)容應符合表23的規(guī)定。表23取消鎖位返回數(shù)據(jù)內(nèi)容11是否6.3.6售票更新6.3.6.1接口說明更新票務中心數(shù)據(jù)庫、票源站數(shù)據(jù)庫的售票信息，產(chǎn)生車票防偽碼。6.3.6.2訪問規(guī)則售票更新提交售票數(shù)據(jù)到客運站場數(shù)據(jù)庫，實現(xiàn)多方數(shù)據(jù)庫的數(shù)據(jù)同步。6.3.6.3請求內(nèi)容售票更新的數(shù)據(jù)請求內(nèi)容應符合表24的規(guī)定。6.3.6.4返回內(nèi)容售票更新的數(shù)據(jù)返回內(nèi)容應符合表25的規(guī)定。DB4401/T60－2020表24售票更新請求數(shù)據(jù)要求14是否24是否34否否48否否58否否62否否78否否8號否否9否否6否否5否否1是否1是否4是否8否否否否否是否是8否否表25售票更新返回數(shù)據(jù)內(nèi)容1否否每一張車票對應一個防偽碼，多個防偽碼6.3.7提交確認6.3.7.1接口說明DB4401/T60－2020客戶端調(diào)用售票、重打印、廢票、退票等接口操作，在取得返回值或者在成功完成其它后續(xù)操作之后，至少保證成功寫入本地數(shù)據(jù)庫，調(diào)用該接口進行確認。6.3.7.2訪問規(guī)則當調(diào)用中心售票、退票、廢票等接口返回非“0”值時，調(diào)用該接口，通知中心，接收的是非“0”值。調(diào)用中心售票、退票、廢票等接口返回“0”值時，繼續(xù)往下處理，如果更新本地數(shù)據(jù)庫失敗，不調(diào)用確認接口；如果成功則調(diào)用確認接口。6.3.7.3請求內(nèi)容提交確認的數(shù)據(jù)請求內(nèi)容應符合表26的規(guī)定。表26售票確認請求數(shù)據(jù)要求1否否操作是對多票的，則每個票號/條形碼1021是否31是否6.3.7.4返回內(nèi)容6.3.8取退票費率6.3.8.1接口說明退票時，票務中心收取全市統(tǒng)一的退票費率。6.3.8.2訪問規(guī)則該接口只是在非發(fā)車站退票時調(diào)用，應按照全市統(tǒng)一的退票費率收取退票手續(xù)費。系統(tǒng)自動根據(jù)售票時間計算費率，并返還給代理點。6.3.8.3請求內(nèi)容取退票費率的數(shù)據(jù)請求內(nèi)容應符合表27的規(guī)定。表27取退票費率請求數(shù)據(jù)要求1否否DB4401/T60－20206.3.8.4返回內(nèi)容取退票費率的數(shù)據(jù)返回內(nèi)容應符合表28的規(guī)定。表28取退票費率返回數(shù)據(jù)內(nèi)容18否否6.3.9退票6.3.9.1接口說明將已售出的票退掉，退票時，按照一定的退票費率收取退票手續(xù)費。6.3.9.2訪問規(guī)則退票只能在售票站和票源站進行操作，其他第三方均不能進行退票操作。在網(wǎng)絡(luò)故障時只能在票源站退票。6.3.9.3請求內(nèi)容退票的數(shù)據(jù)請求內(nèi)容應符合表29的規(guī)定。表29退票請求數(shù)據(jù)要求14是否2否否38否否48否否58否否6.3.9.4返回內(nèi)容DB4401/T60－2020退票的數(shù)據(jù)返回內(nèi)容應符合表30的規(guī)定。表30退票返回數(shù)據(jù)內(nèi)容11否否6.3.10廢票6.3.10.1接口說明將已售出的車票作廢。6.3.10.2訪問規(guī)則廢票操作只能在售票站和票源站進行。6.3.10.3數(shù)據(jù)內(nèi)容廢票的數(shù)據(jù)請求內(nèi)容應符合表31的規(guī)定。表31廢票請求數(shù)據(jù)要求14否否2否否38否否48否否“yyyymmddHhmm”。6.3.10.4返回內(nèi)容廢票的數(shù)據(jù)返回內(nèi)容應符合表32的規(guī)定。表32廢票返回數(shù)據(jù)內(nèi)容11是否6.4電子客票該部分接口適用于操作界面，方便乘客自助購票并且通過網(wǎng)上銀行、電話銀行、銀行卡等非即時到帳的支付方式進行的電子客票售票。電子客票接口使用Web服務的方式給電子客票客戶端/網(wǎng)站提供電子售票的相關(guān)服務請求。6.4.1電子客票流程電子客票提供售票、廢票兩個操作。6.4.1.1售票流程在商戶售賣電子客票時發(fā)生，其流程見圖4。圖4電子客票售票流程6.4.1.2廢票流程商戶在提交售票45分鐘之內(nèi)，若乘客未成功支付票款，商戶應發(fā)起廢票操作，以解除商戶鎖定的車票，其流程見圖5。號(字節(jié))允許為空14是否代理點編號由票務中心統(tǒng)一分配。2查詢?nèi)掌?是否3到站否否44是否“0000”表示查詢所有站班次。5班次時間5否是天符合條件的班次，格式“hh:mm”。6簽名否否用戶對數(shù)據(jù)的簽名。DB4401/T60－2020表34電子商戶班次查詢返回內(nèi)容14否否28否否3否否45是否51是否61是否71是否8否發(fā)班車輛檔次的文字描述，為營運方96否否否否否否否否否否4否否否是6.4.3取票價6.4.3.1接口說明根據(jù)電子商戶的請求內(nèi)容，返回相應客運站場班次的票價信息。6.4.3.2訪問規(guī)則取票價的輸入?yún)?shù)，必須由班次查詢中獲得。6.4.3.3請求內(nèi)容取票價的數(shù)據(jù)請求內(nèi)容應符合表35的規(guī)定。表35電子商戶取票價數(shù)據(jù)請求18是否28否否36否否44是否5否否DB4401/T60－20206.4.3.4返回內(nèi)容取票價的數(shù)據(jù)返回內(nèi)容應符合表36的規(guī)定。表36電子商戶取票價返回數(shù)據(jù)內(nèi)容18否否28否否38否否4否是5否是6否否客運站場數(shù)據(jù)庫的當前班次座位圖信78否否6.4.4申請訂單6.4.4.1接口說明電子商戶將乘客信息、程序選擇的需要購買的班次數(shù)據(jù)、購票請求內(nèi)容提交到接口，產(chǎn)生一個訂單6.4.4.2訪問規(guī)則一個訂單的車票只能是同一個票源站，同一趟班次。6.4.4.3請求內(nèi)容申請訂單的數(shù)據(jù)請求內(nèi)容應符合表37的規(guī)定。表37電子商戶申請訂單數(shù)據(jù)請求14是否28是否34否否訂票張數(shù)，一個訂單最多購買5張車48否否58否否6是否7否否8否否DB4401/T60－20206.4.4.4返回內(nèi)容申請訂單的數(shù)據(jù)返回內(nèi)容應符合表38的規(guī)定。表38電子商戶申請訂單返回數(shù)據(jù)內(nèi)容1是否交易訂單號，是后面訂單交易中的唯2否否申請訂單成功之后，接口已經(jīng)在客運站后臺鎖定指定的座位，并返回座位6.4.5提交訂單6.4.5.1接口說明在乘客確認需要訂票時產(chǎn)生，提交訂單。6.4.5.2訪問規(guī)則提交的訂單號必須由該商戶申請訂單時產(chǎn)生的訂單號。6.4.5.3請求內(nèi)容提交訂單的數(shù)據(jù)請求內(nèi)容應符合表39的規(guī)定。表39電子商戶提交訂單數(shù)據(jù)請求1是否2是否6.4.5.4返回內(nèi)容提交訂單的數(shù)據(jù)返回內(nèi)容應符合表40的規(guī)定。表40電子商戶提交訂單返回數(shù)據(jù)內(nèi)容1是否26是否3是否48是否DB4401/T60－20206.4.6作廢訂單6.4.6.1接口說明在乘客訂票但是沒有成功支付車票票款時，作廢訂單所訂車票。6.4.6.2訪問規(guī)則作廢訂單必須在提交訂單后40分鐘內(nèi)執(zhí)行。6.4.6.3請求內(nèi)容作廢訂單的數(shù)據(jù)請求內(nèi)容應符合表41的規(guī)定。表41電子商戶作廢訂單數(shù)據(jù)請求1是否2是否6.4.6.4返回內(nèi)容作廢訂單的數(shù)據(jù)返回內(nèi)容應符合表42的規(guī)定。表42電子商戶作廢訂單返回數(shù)據(jù)內(nèi)容111否6.4.7確認訂單6.4.7.1接口說明商戶在提交訂單、作廢訂單等交易完成后，應通過確認訂單對票務中心進行確認。6.4.7.2訪問規(guī)則調(diào)用成功，返回成功信息，失敗則返回相應錯誤代碼。6.4.7.3請求內(nèi)容確認訂單的數(shù)據(jù)請求內(nèi)容應符合表43的規(guī)定。表43電子商戶確認訂單數(shù)據(jù)請求1是否2是否DB4401/T60－20206.4.7.4返回內(nèi)容DB4401/T60－2020（規(guī)范性附錄）聯(lián)網(wǎng)售票系統(tǒng)客運站場代碼表表A.1是已接入廣州市公路客運站場聯(lián)網(wǎng)售票系統(tǒng)的客運站場代碼表，若有新接入客運站場，應由票務中心（廣州市公路客運站場聯(lián)網(wǎng)售票票務管理中心）統(tǒng)一分配站場代碼。表A.1聯(lián)網(wǎng)售票系統(tǒng)客運站場代碼表DB4401/T60－2020（規(guī)范性附錄）省外主要到站信息編碼表表B.1是票務中心（廣州市公路客運站場聯(lián)網(wǎng)售票票務管理中心）擬定的省外主要到站信息編碼表，各聯(lián)網(wǎng)售票的客運站場系統(tǒng)的所有到站信息都應向該表的信息編碼進行映射（可多對一）。表B.1省外主要到站信息編碼表DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）承德市圍場滿族蒙古族DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）內(nèi)蒙古自治區(qū)呼和浩特內(nèi)蒙古自治區(qū)鄂爾多斯包頭市達爾罕茂明安聯(lián)DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）錫林郭勒盟東烏珠穆沁旗錫林郭勒盟西烏珠穆沁旗旗烏蘭察布市察哈爾右翼旗烏蘭察布市察哈爾右翼旗烏蘭察布市察哈爾右翼內(nèi)蒙古自治區(qū)錫林郭勒DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）阜新市阜新蒙古族自治縣朝陽市喀喇沁左翼蒙古DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）白山市長白朝鮮族自治縣松原市前郭爾羅斯蒙古吉林省延邊朝鮮族自治延邊朝鮮族自治州延吉市延邊朝鮮族自治州圖們市延邊朝鮮族自治州敦化市延邊朝鮮族自治州琿春市延邊朝鮮族自治州龍井市延邊朝鮮族自治州和龍市延邊朝鮮族自治州汪清縣延邊朝鮮族自治州安圖縣DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）大慶市杜爾伯特蒙古族DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）宜昌市長陽土家族自治縣宜昌市五峰土家族自治縣DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）恩施土家族苗族自治州恩施土家族苗族自治州湖北省恩施土家族苗族恩施土家族苗族自治州恩施土家族苗族自治州恩施土家族苗族自治州恩施土家族苗族自治州恩施土家族苗族自治州恩施土家族苗族自治州DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）河池市羅城仫佬族自治縣河池市環(huán)江毛南族自治縣DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）重慶市石柱土家族自治縣重慶市秀山土家族苗族重慶市酉陽土家族苗族重慶市彭水苗族土家族DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）DB4401/T60－2020表B.1省外主要到站信息編碼表（續(xù)）四川省阿壩藏族羌族自阿壩藏族羌族自治州汶阿壩藏族羌族自治州理縣阿壩藏族羌族自治州茂縣阿壩藏族羌族自治州松阿壩藏族羌族自治州九阿壩藏族羌族自治州金阿壩藏族羌族自治州小阿壩藏族羌族自治州黑阿壩藏族羌族自治州馬阿壩藏族羌族自治州壤阿壩藏族羌族自治州阿阿壩藏族羌族自治州若阿壩藏族羌族自治州紅DB4401/T