標準格式
票證標準依運具、票證形式區分四種：
公車IC電子票證資料
公車非電子票證資料
軌道IC電子票證資料
軌道非電子票證資料
票證標準格式說明於下，填寫方式與範例等細節可參考【標準說明文件】的內容。
票證標準格式
描述公車IC電子票證資料，搭乘資訊ODFareRide、ODTapOnceFares以及StageFareRide依據路線刷卡機記錄之收費資料內容擇一對應格式填寫，採上下車（或上車）刷卡且刷卡機已記錄上下車（或上車）資訊者，不論計費方式，應優先以ODFareRide（或ODTapOnceFareRide）格式填寫，並依填寫內容註記搭乘資訊格式（FarePricingType）；搭乘資訊內容可在站牌（StopUID/StopName/StopSequence）、站位（StationUID/StationName）、組站位（StationGroupUID/StationGroupName）三種組合中擇一填寫；路線、站牌/站位/組站位資料依循交通部PTX平臺編訂之標準資料填寫。
<BusICTicketList>
欄位名稱 | 中文解釋 | 備註 |
UpdateTime | XML更新日期時間 | YYYY-MM-DD hh:mm:ss，資料產製時間。 |
BusICTickets | 公車IC電子票證資訊 | 包絡多筆 |
BusICTicket | 公車IC電子票證資料 | 單筆 |
< BusICTicket>
欄位名稱 | 中文解釋 | 備註 |
ID | 識別碼 | 使用者多元電子支付的識別碼，為： 電子票證卡號、信用卡號或電子支付的 識別編號，Ex: 電子票證卡號(10 進位格式):1323486284； 信用卡號:一律填寫 11111；電子支付識 別編號:1234565432123456(10 進位格式)。 |
IDType | 識別碼類別 | 標註識別碼的類別，此代碼： EasyCard:為電子票證-悠遊卡卡號； iPASS:為電子票證-一卡通卡號； icash:為電子票證-愛金卡卡號； HappyCash:為電子票證-有錢卡卡號； CreditCard:為信用卡卡號； PaymentID:電子支付識別編號。 |
HolderType | 身分別 | 支付工具持有者之身分別，此代碼： A-普通身分； B-學生身分； C-優待身分：C01-敬老優待、C02-愛心 優待、C09-其他優待（如軍人卡、警察 卡、孩童卡…等）； |
TicketType | 票種類型 | 1-單程票(IC卡單趟搭乘填寫單程票)； 2-來回票； 3-回數票； 4-定期票(1日、30天、60天...pass 類)； 5-團體票； 9-其他 |
SubTicketType | 票種次類型 | 選填欄位 選填欄位 票種類型下之次分類，用以註記機關、業者推動/提供之服務方案；由業管單位提出並負責管制；票種次類型由 ”#”、業管代碼、”-”、次類型代號 組成，填註時可為多個代碼組合，Ex:#TPE-1280#TRTC-MobilePayment，代表臺北市推動之1280定期票方案與臺北捷運之行動支付交易 |
PlateNumber | 搭乘車牌號碼 | 實際車牌號碼，Ex:702-FY |
RouteUID | 搭乘路線代碼 | 實際路線代碼(採用PTX唯一識別代碼)，Ex: KHH100 |
RouteName | 搭乘路線名稱 | 實際路線名稱，Ex:100 |
SubRouteUID | 搭乘附屬路線代碼 | 實際附屬路線代碼(採用PTX唯一識別代碼)，Ex: KHH100 |
SubRouteName | 搭乘附屬路線名稱 | 實際附屬路線名稱，Ex:100 |
Direction | 搭乘公車路線方向 | 0-去程； 1-返程； 2-迴圈。 |
FarePricingType | 公車搭乘資訊格式 | ODFares:上下車刷卡格式； ODTapOnceFares:上車刷卡格式； StageFares:區間收費格式 |
StopOrStation | 搭乘資訊註記 | 0-提供站牌資料； 1-提供站位資料； 2-提供組站位資料 |
下列搭乘資訊請依實際狀況擇一填寫，並請優先以ODFareRide為選項，以記錄完整旅次。
欄位名稱 | 中文解釋 | 備註 |
ODFareRide | 上下車刷卡搭乘資訊 | 上下車刷卡格式之搭乘資訊 |
ODTapOnceFareRide | 上車刷卡搭乘資訊 | 上車刷卡格式之搭乘資訊 |
StageFareRide | 區間收費搭乘資訊 | 區間收費格式之搭乘資訊 |
Price | 收費價格 | 原始計價費用，單位:新台幣(元) |
Discount | 優惠額度 | 依優惠折扣之金額，單位:新台幣(元) |
TransferCode | 轉乘代碼紀錄 | 選填欄位 記錄前次與本次所搭乘的運具代碼 01-捷運； 02-公車； 03-客運； 04-臺鐵； 05-高鐵； 06-單車； 07-渡輪； 選填欄位 選填欄位 08-輕軌； 09-停車場； 99-其他 如上一次使用運具為捷運，本次為公車，則填寫0102 |
DiscountInfo | 優惠資訊 | 選填欄位 優惠折扣內容描述代碼 01-身份優惠； 02-購票優惠； 03-活動優惠； 09-其他優惠；若該次搭乘有符合多種優惠情形，如同時享有身分、活動兩種優惠，則填寫0103 [註]：優惠大類區分: 身份優惠，依身分取得之優惠，如：學生、敬老、愛心、軍警…等 購票優惠，運輸業者提供之優惠，如：來回、回數、定期、團體、艙等(自由座…)、早鳥…等 活動優惠，政府政策/票卡公司/聯名業者提供之優待，如：市民卡、促銷、聯名刷卡…等 其他優惠，無法歸屬以上三類優惠者 |
PaymentPrice | 實際支付價格 | 此旅次之實際費用，單位:新台幣(元) [註]：原則上，實際支付價格(PaymentPrice) = 收費價格(Price) - 優惠額度(Discount) |
<ODFareRide>上下車刷卡格式搭乘資訊（依搭乘資訊註記，站牌、站位或組站位資料組合擇一填寫）
欄位名稱 | 中文解釋 | 備註 |
BoardingStopUID | 刷卡上車站牌代碼 | 實際刷卡站牌代碼(採用PTX唯一識別代碼)，Ex:ILA290596 |
BoardingStopName | 刷卡上車站牌名稱 | 實際刷卡站牌名稱，Ex: 慈濟 |
BoardingStopSequence | 刷卡上車站牌站序 | 由1開始，Ex:3 |
BoardingStationUID | 刷卡上車站位代碼 | 實際刷卡站位代碼(採用PTX唯一識別代碼)，Ex:ILA91887 |
BoardingStationName | 刷卡上車站位名稱 | 實際刷卡站位名稱，Ex:新店 |
BoardingStationGroupUID | 刷卡上車組站位代碼 | 實際刷卡組站位代碼(採用PTX唯一識別代碼)，Ex:TXG5100 |
BoardingStationGroupName | 刷卡上車組站位名稱 | 實際刷卡組站位名稱，Ex:水湳市場(中清路) |
BoardingTime | 刷卡上車時間 | YYYY-MM-DD hh:mm:ss， Ex:2017-05-30 17:32:10 |
DeboardingStopUID | 刷卡下車站牌代碼 | 實際刷卡站牌代碼(採用PTX唯一識別代碼)，Ex:ILA290536 |
DeboardingStopName | 刷卡下車站牌名稱 | 實際刷卡站牌名稱，Ex:新店 |
DeboardingStopSequence | 刷卡下車站牌站序 | 由1開始，Ex:14 |
DeboardingStationUID | 刷卡下車站位代碼 | 實際刷卡站位代碼(採用PTX唯一識別代碼)，Ex:ILA91932 |
DeboardingStationName | 刷卡下車站位名稱 | 實際刷卡站位名稱，Ex:慈濟 |
DeboardingStationGroupUID | 刷卡下車組站位代碼 | 實際刷卡組站位代碼(採用PTX唯一識別代碼)，Ex:TXG5733 |
DeboardingStationGroupName | 刷卡下車組站位名稱 | 實際刷卡組站位名稱，Ex:大道公廟(中清路) |
DeboardingTime | 刷卡下車時間 | YYYY-MM-DD hh:mm:ss， Ex:2017-05-30 18:01:50 |
<ODTapOnceFareRide>上車刷卡格式搭乘資訊（依搭乘資訊註記，站牌、站位或組站位資料組合擇一填寫）
欄位名稱 | 中文解釋 | 備註 |
BoardingTapOnceStopUID | 刷卡上車站牌代碼 | 實際刷卡站牌代碼(採用PTX唯一識別代碼)，Ex:ILA296014 |
BoardingTapOnceStopName | 刷卡上車站牌名稱 | 實際刷卡站牌名稱， Ex:礁溪轉運站 |
BoardingTapOnceStopSequence | 刷卡上車站牌站序 | 由1開始，Ex:1 |
BoardingTapOnceStationUID | 刷卡上車站位代碼 | 實際刷卡站位代碼(採用PTX唯一識別代碼)，Ex: ILA92651 |
BoardingTapOnceStationName | 刷卡上車站位名稱 | 實際刷卡站位名稱，Ex:礁溪轉運站 |
BoardingTapOnceStationGroupUID | 刷卡上車組站位代碼 | 實際刷卡組站位代碼(採用PTX唯一識別代碼)，Ex:TXG5100 |
BoardingTapOnceStationGroupName | 刷卡上車組站位名稱 | 實際刷卡組站位名稱，Ex:水湳市場(中清路) |
BoardingTapOnceTime | 刷卡上車時間 | YYYY-MM-DD hh:mm:ss， Ex:2017-05-30 17:32:10 |
<StageFareRide>區間收費格式搭乘資訊（依搭乘資訊註記，站牌、站位或組站位資料組合擇一填寫）
欄位名稱 | 中文解釋 | 備註 |
BoardingStageStopUID | 上車計費站牌代碼 | 刷卡計費站牌代碼(採用PTX唯一識別代碼)，Ex: THB-VO11-1266771 |
BoardingStageStopName | 上車計費站牌名稱 | 依據梯形票價表計費定義之站名 Ex:臺中 [註]：僅適用於使用計費站計費時之記錄(如公路客運多採用計費站計費模式) |
BoardingStageStopSequence | 上車計費站序資料 | 依據梯形票價表計費定義之站序，由1開始，Ex:1 [註]：僅適用於使用計費站計費時之記錄(如公路客運多採用計費站計費模式) |
BoardingStageStationUID | 上車計費站位代碼 | 刷卡計費站位代碼(採用PTX唯一識別代碼)，Ex: THB136597 |
BoardingStageStationName | 上車計費站位名稱 | 依據梯形票價表計費定義之站位名稱 Ex:臺中車站 [註]：僅適用於使用計費站計費時之記錄(如公路客運多採用計費站計費模式) |
BoardingStageStationGroupUID | 上車計費組站位代碼 | 刷卡計費組站位代碼(採用PTX唯一識別代碼)，Ex: TXG5100 |
BoardingStageStationGroupName | 上車計費組站位名稱 | 依據梯形票價表計費定義之組站位名稱，Ex:水湳市場(中清路) [註]：僅適用於使用計費站計費時之記錄(如公路客運多採用計費站計費模式) |
BoardingStageTime | 刷卡上車時間 | YYYY-MM-DD hh:mm:ss， Ex:2017-05-30 17:32:10 |
DeboardingStageStopUID | 下車計費站牌代碼 | 刷卡計費站牌代碼(採用PTX唯一識別代碼)，Ex: THB-VO11-157038 |
DeboardingStageStopName | 下車計費站牌名稱 | 依據梯形票價表計費定義之站名，Ex:中興 [註]：僅適用於使用計費站計費時之記錄(如公路客運多採用計費站計費模式) |
DeboardingStageStopSequence | 下車計費站牌站序 | 依據梯形票價表計費定義之站序， 由1開始，Ex:5 [註]：僅適用於使用計費站計費時之記錄(如公路客運多採用計費站計費模式) |
DeboardingStageStationUID | 下車計費站位代碼 | 刷卡計費站位代碼(採用PTX唯一識別代碼)，Ex:THB131588 |
DeboardingStageStationName | 下車計費站位名稱 | 依據梯形票價表計費定義之站名，Ex:竹山站 [註]：僅適用於使用計費站計費時之記錄(如公路客運多採用計費站計費模式) |
DeboardingStageStationGroupUID | 下車計費組站位代碼 | 刷卡計費組站位代碼 (採用PTX唯一識別代碼)，Ex:TXG5733 |
DeboardingStageStationGroupName | 下車計費組站位名稱 | 依據梯形票價表計費定義之組站位名稱，Ex:大道公廟(中清路) [註]：僅適用於使用計費站計費時之記錄(如公路客運多採用計費站計費模式) |
DeboardingStageTime | 刷卡下車時間 | YYYY-MM-DD hh:mm:ss， Ex:2017-05-30 18:01:50 |
Last updated