道路客運電子客票系統技術規范2020-04-28發布2020-07-01實施I Ⅲ 12規范性引用文件 1 1 1 2 2 24.2部級電子客票系統功能 3 4 6 6 6 7 75.5電子客票二維碼 95.6電子客票條形碼 5.7報銷憑證 6系統關鍵業務流程 6.1部級電子客票系統關鍵業務流程 6.2省級電子客票系統關鍵業務流程 7系統接口 7.1接口規范 257.2報文結構 277.3接口內容 7.4數據傳輸及存儲要求 8系統安全 附錄A(規范性附錄)道路客運電子客票信息內容 Ⅲ本標準按照GB/T1.1—2009給出的規則起草。1JT/T979.2—2015道路客運聯網售票系統第2部分：信息數據元JT/T979.2—2015、GB/T18284—2000、GB/T12905中界定的以及下列術語和定義適用于本2電子客票二維碼electronictwo-dimensioncode以二維碼形式承載的電子客票信息數據編碼。電子客票狀態electronicticketstatus在道路客運業務流程中反映電子客票使用情況的標識。下列縮略語適用于本文件。APP——應用程序(Application)MQ——消息隊列(MessageQueue)4系統架構及功能a)部級電子客票系統：接入省級電子客票系統，用于全國道路客運電子客票信息資源共享交換。3用和管理。圖2所示。電子客票管理部級電子客票應用系系統。實現在部級道路客運聯網售票系統購買和使用電子客票。與其他交通運輸方式進行聯程運輸時，實現道路客運電子客票的購買和使用。45b)業務數據庫：存儲電子客票數據記錄等。c)主題數據庫：存儲電子客票監控數據、運行及統計分析數據等。4.3.2核心交易系統電子客票生成根據訂單和支付結果等信息生成一張電子客票。電子客票退票按照退票規則完成乘客已購有效電子客票的退票操作。電子客票改簽按照改簽規則完成乘客已購有效電子客票的改簽操作。電子客票檢票通過識別乘客電子客票憑證或有效身份證件等，驗證乘客電子客票。電子客票銷票對已售電子客票作廢處理并釋放座位。4.3.3前端管理系統電子票號管理電子票號管理應實現如下功能：a)按照規則生成電子票號；b)電子客票使用方向省級電子客票管理中心申請電子票號；c)省級電子客票管理中心審批和發放電子票號資源，并上報部級電子客票系統。使用用戶管理使用用戶管理應實現如下功能：a)對新申請用戶進行審核、權限分配和權限變更等；67a)唯一性：電子客票系統提供的電子票b)實用性：電子客票號由具有電子客票實際業務屬性代碼組合編碼而成，保證電子客票號具有電子客票號應采用字符型編碼，長度為22位，編碼結構如圖4所示。電子客票號由客運站電子客票號編碼要求見表1,各客運站可根據實際情況在電子客票憑證上截取顯示，如只顯19由6位中華人民共和國行政區劃代碼和3位站(點)順序號組成2238425默認為“0”電子客票憑證所包含的信息內容如表2所示。8電子客票票面信息電子客票號姓名乘客姓名到達站到達站名稱發車時間本班次發車時間檢票口車票類型等車票類型車輛類型該班次的車輛類型條碼信息保險信息乘客所購買保險的費用電子客票紙質乘車憑證示例見圖5。各省根據實際情況可在該紙質乘車憑證模板下方增加底聯，a)道路客運電子客票紙質乘車憑證b)乘車憑證名稱為“道路客運電子客票乘車憑證”,行間距為24磅，字符間距為0.56mm。該行c)電子客票號行間距為24磅，顯示的位數可根據實際情況自行規定，采用單倍行距。該行上邊緣線距離紙質乘車憑證上邊緣線11.5mm。d)姓名和證件號碼在同一行，采用單倍行距。姓名和證件號碼之間空兩格。該行上邊緣線距離紙質乘車憑證上邊緣線15.5mm。9電子客原號：1100211321187008南天門站六里橋站發車時間檢票口網購1保險號：1026383625736355e)起點站行距為單倍行距，其所在的文本框大小為12mm×25mm。該文本框的左邊緣線距離紙質乘車憑證左邊緣5mm,上邊緣線距離紙質乘車憑證上邊緣線22mm。f)到達站行距為單倍行距，其所在的文本框大小為12mm×25mm。該文本框的左邊緣線距離紙質乘車憑證左邊緣50mm,上邊緣線距離紙質乘車憑證上邊緣線22mm。g)起點站和到達站之間插入的帶指向箭頭的連線的線型為實線，粗細為1.25磅，長度為20mm,水平放置，其左端距離紙質乘車憑證左邊緣線30mm,距離紙質乘車憑證上邊緣線28mm。邊緣線22mm,其左邊緣距離起點站所在文本框右邊緣線2mm。車輛類型和攜童數等信息用一個表格表示，內容采用單倍行距，表大小為48mm×72mm,其左邊緣線距離紙質乘車憑證左邊緣線4mm,右邊緣線距離紙質乘車憑證右邊緣線4mm,上邊緣線距離紙質乘車憑證上邊緣線37mm。j)條形碼所在的文本框大小為11mm×68mm,其左邊緣線距離紙質乘車憑證左邊緣線6mm,上邊緣線距離紙質乘車憑證上邊緣線88mm。k)保險號和保費所在的文本框大小為11mm×60mm,其左邊緣線距離紙質乘車憑證左邊緣線6mm,上邊緣線距離紙質乘車憑證上邊緣線102mm。1)“說明：此憑證僅供乘客檢票乘車使用，不作為報銷憑證”等必要說明所在的文本框大小為m)二維碼大小為16mm×16mm,其右邊緣線距離紙質乘車憑證右邊緣線4mm,上邊緣線距離紙質乘車憑證上邊緣線4mm。電子客票二維碼應按照GB/T18284-2000的快速響應矩陣碼規定的QRCODE版本5編碼方式設電子客票二維碼應能通過電子客票識讀設備讀取其包含的信息并滿足各業務場景的使用要求，信息內容見表3,其糾錯級別不應低于GB/T18284—2000中規定的M級別。電子客票二維碼應對實名制要求及說明1電子客票號293到達站代碼9465客票類型1按照附錄A表A.1電子客票信息內容中車票類型的規定664位整數加2位小數(不包含小數點，整數位不足在數字前補0)788發車時間492姓名按照JT/T979.2—2015中的規定2按照JT/T979.2—2015中6的規定按照JT/T979.2—2015中6的規定3用于擴展應用電子客票條形碼技術要求應符合GB/T18347的規定。業務規則客票系統轉發生成電子客票請求；b)部級電子客票系統收到請求后，應轉發至B省級電子客票系統；統應將電子客票信息發送給乘客。乘客通過部級道路客運聯網售票系統購買A省的電子客票時，應通過部級電子客票系統進行中轉。道路客運與其他交通運輸方式進行聯程運輸生成電子客票時，應通過部級電子客票系統進行a)其他交通運輸方式電子客票系統通過部級電子客票系統請求生成A省的電子客票；b)部級電子客票系統向A省級電子客票系統轉發請求信息；c)A省級電子客票系統返回生成的電子客票信息；d)部級電子客票系統存儲并轉發電子客票信息給其他交通運輸方式電子客票系統。6.2省級電子客票系統關鍵業務流程6.2.1電子客票號申領業務規則電子客票號申領應按以下規則進行：a)電子客票使用方在剩余票號資源滿足申請條件時，才可提出申領；b)審批方查驗申請方資質和剩余票號資源數量，滿足規定條件后才可下發票號資源；c)審批的電子客票票號段資源數量不超過規定的最大數量；d)申領信息上報給部級電子客票系統；e)發放票號資源出現錯誤時，可申請補發或自動重發。用方，審核不通過的應返回申領失敗消息；否是客票更改為“已換紙票”狀態。運聯網售票系統應向省級電子客票系統請求生成電子客票；否是圖10線上電子客票出票流程客運站窗口電子客票出票的業務流程見圖11,要求如下：客運站售票管理信息系統；e)省級電子客票系統應將加密后的電子客票信息上傳至部級電子客票系統。是否圖11客運站窗口電子客票出票流程b)省級電子客票系統應查詢該電子客票是否為“正常售出”狀態，如果不是“正常售出”狀態，應向省級道路客運聯網售票系統返回退票失敗信息，再由省級道路客運聯網售票系統向線上售否是圖12線上電子客票退票流程客運站窗口電子客票退票的業務流程見圖13,要求如下：狀態為“已退票”狀態，并返回退票成功信息；d)退票成功后，應將狀態變更信息同步給汽車客運站售票管理信息系統并通知乘客，同時同步上傳至部級電子客票系統。圖13客運站窗口電子客票退票流程e)省級電子客票系統應根據乘客新的行程信息重新生成電子客票，并將電子客票信息同步至部級電子客票系統和汽車客運站售票管理信息系統；f)由線上售票渠道將新的電子客票憑證發送給乘客。否是否圖14線上改簽流程窗口改簽流程a)乘客在窗口提交改簽申請，相關信息通過省級道路客運聯網售票系統流轉至省級電子客票系統；審核不通過應拒絕申請；c)省級電子客票系統將原電子客票狀態更改為“已改簽”,同時將狀態變更信息發送給汽車客運站售票管理信息系統和部級電子客票系統；d)汽車客運站售票管理信息系統接收到狀態變更信息后應釋放座位；e)省級電子客票系統根據乘客新的行程信息重新生成電子客票，并實時將電子客票信息同步至部級電子客票系統和汽車客運站售票管理信息系統；f)由汽車客運站售票管理信息系統將新的電子客票信息發送給乘客。圖15窗口改簽流程電子客票檢票應按以下規則進行：3)乘客可憑居民身份證到配備二代身份證信息讀取設備的客運站校驗乘車人電子客票信自助終端檢票份證號、電子客票號等信息);否是圖16自助終端檢票流程否正確；“已檢票”圖17人工檢票流程e)統計電子客票狀態標注為“已檢票”的電子客票，形成班車路單。省級道路客運聯網省級道路客運聯網請求銷票失敗信息銷票返回銷票接收電子客票客票狀態接收銷票成功接收銷票失敗信息返回銷票失敗信息成功信息發送銷票請求圖18電子客票銷票流程票管理信息系統和部級電子客票系統；d)汽車客運站售票管理信息系統應釋放座位。6.2.7客票信息查詢業務規則電子客票系統信息查詢應按以下規則進行：b)客運站管理員可在省級電子客票系統前端界面按照電子客票號、班次、起點站、到達站、途經站、發車時間、乘客姓名、有效證件號碼等不同條件組合檢索本站始發或到達的電子客票c)乘客可以通過省級道路客運聯網售票系統前端界面按班次、起點站、到達站、發車時間、乘客姓名、有效證件號碼等不同條件組合檢索自己購買的電子客票信息。業務流程電子客票信息查詢業務流程如圖19所示，要求如下：a)用戶可在電子客票查詢系統填寫查詢條件；否否是是b)電子客票系統應判斷是否具有查詢權限，如果沒有，則返回錯誤信息；電子發票申請的業務流程見圖20,要求如下：票，如不可開則返回開票失敗消息；否是圖20電子發票開具流程接口請求響應主要通用狀態碼見表4,接口請求響應通用狀態碼應使用HTTP協議中規范的狀未授權訪問不可識別服務器拒絕訪問指定的資源未找到響應超時550錯誤碼是本標準自定義的錯誤碼，表示產生了可以預見的業務錯誤。560錯誤碼是本標準自定義的錯誤碼，表示產生了不可預見的業務異常。錯誤碼范圍系統編碼系統10000:成功系統用戶系統異常實時交易接口11001:電子客票號獲取失敗11002:電子客票信息生成失敗11003:電子客票號不足11004:該站不支持出電子客票11005:此訂單已出電子客票11040:部級系統無此服務上傳紙票信息12001:電子客票號獲取失敗12002:電子客票信息生成失敗12040:部級系統無此服務電子客票狀態變更13001:查無此票13002:此請求已經過期13003:當前客票狀態無法更改13004:更改狀態失敗13040:部級系統無此服務申請電子發票14001:查無此票14002:未到開票時間14003:無法核實電子客票狀態14004:此票狀態不可開具發票14005:系統異常，無法開具發票14006:已經申請開具發票，請勿重復操作14007:暫不支持開具電子發票14040:部級系統無此服務電子客票驗真15001:查無此票道路客運電子客票系統傳輸協議應采用HTTP協議。道路客運電子客票系統服務接口應對電子客票系統的數據格式和外部系統的數據格式進行轉換和道路客運電子客票系統支持HTTP的POST方式進行連接。POST方式用于請求源服務器接HTTP消息報頭中Accept規范見表6。<?xmlversion="1.0"encoding="UTF-8"?><!-公共請求信息--><?xmlversion="1.0"encoding="UTF-8"<!-公共返回信息-->按照道路客運電子客票系統三級架構及其與道路客運聯網售票系統之間電子客票系統主要接口及其規定如表7所示。實時/非實時1出票接口電子客票系統實時2退票接口電子客票系統實時3檢票接口電子客票系統實時4查詢接口電子客票系統實時5狀態查詢接口電子客票系統實時6銷票接口電子客票系統實時7電子發票開具接口電子客票系統實時請求內容電子客票出票接口請求內容見表8,座位信息內容見表9。約束公共請求信息訂單號唯一標識一個訂單按照JT/T979.2—2015中的規定M按照JT/T979.2—2015中9的規定M按照JT/T979.2—2015中的規定M按照JT/T979.2—2015中的規定M表8(續)約束到達站代碼按照JT/T979.2—2015中5.6M到達站名稱按照JT/T979.2—2015中的規定M按照JT/T979.2—2015中5.6.1.M班次性質 按照JT/T979.2—2015中5.6MM按照JT/T979.2—2015中0客車類型按照JT/T979.2—2015中5.60客車等級M按照JT/T979.2—2015中5.5.1.M售票時間按照JT/T979.2—2015中0的規定M發車日期M發車時間班次發車時間hhmmssM按照JT/T979.2—2015中1的規定0操作人員姓名按照JT/T979.2—2015中按照JT/T979.2—2015中2的規定0此屬性為集合，見表9M約束乘客姓名按照JT/T979.2—2015中的規定M身份證件類型按照JT/T979.2—2015中6的規定M身份證件號碼按照JT/T979.2—2015中6的規定M車票類型M座位類型按照JT/T979.2—2015中5.6M座位號為空表示不指定座位號按照JT/T979.2—2015中0的規定M按照JT/T979.2—2015中3的規定0按照JT/T979.2—2015中4的規定MM按照JT/T979.2—2015中7的規定0M實際出售的票價M返回內容電子客票出票接口返回內容見表10,電子客票信息內容見表11。表10電子客票出票接口返回內容約束公共返回信息M訂單號按照JT/T979.2—2015中5.7.2.M電子客票信息列表詳細內容見表11M表11電子客票信息內容約束電子客票號唯一標識電子客票M電子客票狀態按照JT/T979.2—2015中2的規定M乘客姓名按照JT/T979.2—2015中5.1.1.M身份證件類型按照JT/T979.2—2015中6的規定M身份證件號碼按照JT/T979.2—2015中6的規定M按照JT/T979.2—2015中的規定0按照JT/T979.2—2015中5.0到達站代碼按照JT/T979.2—2015中5.60到達站名稱按照JT/T979.2—2015中的規定0發車日期0發車時間0按照JT/T979.2—2015中的規定0座位號按照JT/T979.2—2015中0的規定00請求內容電子客票退票接口的請求內容見表12。約束公共請求信息M訂單號唯一標識一個訂單按照JT/T979.2—2015中5.7.2.M電子客票號唯一標識一張電子客票M身份證件類型按照JT/T979.2—2015中6的規定0身份證件號碼按照JT/T979.2—2015中60乘客姓名按照JT/T979.2—2015中的規定0按照JT/T979.2—2015中5.7M表12(續)約束按照JT/T979.2—2015中5.7M—按照JT/T979.2—2015中5.M操作人員姓名具體經辦售票交易的操作人姓名按照JT/T979.2—2015中具體經辦售票交易的按照JT/T979.2—2015中2的規定M售票時間按照JT/T979.2—2015中0的規定0退票時間按照JT/T979.2—2015中的規定M返回內容電子客票退票接口的返回內容見表13。表13電子客票退票接口返回內容約束公共返回信息M訂單號唯一標識一個訂單按照JT/T979.2—2015中的規定M電子客票號唯一標識一張電子客票按照5.2的規定M身份證件號碼按照JT/T979.2—2015中6的規定0電子客票狀態按照JT/T979.2—2015中2的規定M按照JT/T979.2—2015中的規定0請求內容電子客票檢票接口的請求內容見表14。表14電子客票檢票接口請求內容約束公共請求信息M電子客票號唯一標識一張電子客票按照5.2的規定M按照JT/T979.2—2015中5.4.2的規定0唯一標識一個客運站按照JT/T979.2—2015中5.4.1的規定M乘客姓名按照JT/T979.2—2015中的規定M檢票時間M檢票口M1位字符M20位字符串0表14(續)約束1位字符M身份證件類型按照JT/T979.2—2015中6的規定M身份證件號碼按照JT/T979.2—2015中6的規定M約束公共返回信息M電子客票號唯一標識一張電子客票M電子客票狀態按照JT/T979.2—2015中2的規定0乘客姓名按照JT/T979.2—2015中身份證件類型按照JT/T979.2—2015中6的規定0身份證件號碼按照JT/T979.2—2015中60按照JT/T979.2—2015中5.7M發車日期M發車時間M實際票價00按照JT/T979.2—2015中5.M按照JT/T979.2—2015中5.M到達站代碼按照JT/T979.2—2015中5.6M到達站名稱按照JT/T979.2—2015中5.7M約束公共請求信息M電子客票號唯一標識一張電子客票按照5.2的規定M乘車人姓名按照JT/T979.2—2015中的規定M身份證件類型按照JT/T979.2—2015中6的規定M身份證件號碼按照JT/T979.2—2015中6的規定M返回內容電子客票查詢接口的返回內容見表17。表17電子客票查詢接口返回內容約束公共返回信息M電子客票號唯一標識一張電子客票M乘客姓名按照JT/T979.2—2015中5.1.1.M身份證件類型按照JT/T979.2—2015中6M身份證件號碼按照JT/T979.2—2015中6M車票類型按照JT/T979.2—2015中的規定M電子客票狀態按照JT/T979.2—2015中2的規定M按照JT/T979.2—2015中的規定M發車日期按照JT/T979.2—2015中的規定M發車時間M按照JT/T979.2—2015中5.M按照JT/T979.2—2015中5.0到達站代碼按照JT/T979.2—2015中5.6M到達站名稱按照JT/T979.2—2015中5.70班次性質按照JT/T979.2—2015中5.60按照JT/T979.2—2015中客車類型按照JT/T979.2—2015中5.3.20的規定0客車等級按照JT/T979.2—2015中5.3.21的規定000實際出售的票價M請求內容電子客票狀態查詢接口的請求內容見表18。表18電子客票狀態查詢接口請求內容約束公共請求信息電子客票號唯一標識一張電子客票M返回內容表19電子客票狀態查詢接口返回內容約束公共返回信息電子客票號唯一標識一張電子客票按照5.2的規定M電子客票狀態按照JT/T979.2—2015中2的規定M電子客票銷票接口的請求內容見表20。表20電子客票銷票接口請求內容約束公共請求信息M訂單號按照JT/T979.2—2015中5.7.2.M電子客票號M按照JT/T979.2—2015中5.具體經辦售票交易的按照JT/T979.2—2015中2的規定M按照JT/T979.2—2015中2的規定M表21電子客票銷票接口返回內容約束公共返回信息M訂單號唯一標識一個訂單的號碼按照JT/T979.2—2015中5.7.2.M電子客票號唯一標識一張電子客票的號碼M電子客票狀態按照JT/T979.2—2015中2的規定M請求內容電子發票開具接口的請求內容見表22。表22電子發票開具接口請求內容約束公共請求信息電子票號唯一標識電子客票的號碼按照5.2的規定M申請開票時間乘客申請開票的時間M發票抬頭類型20位字符串M100位字符串M企業稅務登記證上的號碼20位字符串0電話48位字符串0100位字符串0賬號20位字符串050位字符串0電子郵箱能同時為空100位字符串0返回信息內容電子發票開具接口返回信息內容見表23。約束公共返回信息M電子發票號唯一標識電子發票按照JT/T979.2—2015中的規定M開票時間稅局開票的時間M返回信息160位字符串0電子發票鏈接200位字符串0b)通信協議：采用H