Teknik Temel
GİB Referansı
e-Bilet paketleri, kullanım yöntemi, teknik gereksinimler, rapor türleri ve resmî kaynaklar.
GİB Paketi
GİB, karayolu/denizyolu, etkinlik, havayolu ve e-Yolcu Listesi raporlarını ayrı teknik kılavuzlarla tanımlar. Bir rapor ZIP'i aynı adlı rapor XML'ini taşır ve e-Bilet web servisine dosya eki olarak iletilir.
| Rapor ailesi | Temel içerik | Bu rehberdeki platform kapsamı |
|---|---|---|
| Karayolu/Denizyolu e-Bilet Raporu | Geçerli biletler, iptal kayıtları, hizmet/ödeme ve bilet erişim bilgileri | Karayolu e-Bileti için açıklanır |
| e-Yolcu Listesi Raporu | Sefer, araç, araç işleten, hasılat ve koltuk/yolcu kayıtları | e-Yolcu Listesi için açıklanır |
| Etkinlik e-Bilet Raporu | Etkinlik, organizatör, bilet ve iptal bilgileri | Resmî GİB gereksinimi gösterilir; otomatik platform raporlaması mevcut destek taahhüdüne dahil değildir |
| Havayolu e-Bilet Raporu | Uçuş, yolcu, satış/iade, tutar ve referans bilgileri | Resmî GİB gereksinimi gösterilir; otomatik platform raporlaması ve iade referans aktarımı mevcut destek taahhüdüne dahil değildir |
Kullanım Yöntemi
Entegratör bilet veya yolcu listesi request'ini VBT API'ye gönderir. Platform imzalı belge çıktısını hazırlar ve destek kapsamındaki belgeleri ilgili rapor döneminin paketine alır. GİB rapor ZIP'i platform tarafından sendDocumentFile metoduyla iletilir; paket sonucu getBatchStatus metoduyla sorgulanır.
sendDocumentFile çağrısı değildir. FTP, bilet veya yolcu listesi dosyalarının firmaya teslim edilmesini sağlar; GİB rapor sonucu ayrı izlenir.Teknik Gereksinimler
| Gereksinim | GİB sözleşmesi | Entegrasyon etkisi |
|---|---|---|
| Paket biçimi | ZIP; içinde paketle aynı adı taşıyan rapor XML'i | Entegratör bilet request'inde ZIP üretmez; platformun rapor sonucunu izler. |
| Dosya boyutu | Web servisi kılavuzunda paket için en fazla 5 MB | Raporlar gerektiğinde parçalara ayrılabilir. |
| Karakter kodlaması | UTF-8 XML | Türkçe karakterler ve metin alanları UTF-8 olarak korunur. |
| İmza | Zaman damgalı mali mühür/elektronik imza gereksinimleri | Belge ve rapor imza süreçleri platform tarafından yürütülür. |
| Paket gönderimi | sendDocumentFile | Başarılı taşıma cevabı nihai işleme sonucu değildir. |
| Paket durumu | getBatchStatus | GİB terminal sonucu ayrıca sorgulanır. |
Bilet Erişim Adresi
GİB'in güncel karayolu, etkinlik ve havayolu rapor kılavuzları raporlanan bilet için erişim adresi ister. Platform rapor çıktısında bu alanı belge UUID'siyle ilişkilendirilmiş görüntüleme adresinden üretir. Entegratör, request içinde ayrıca rapor URL'si göndermemelidir.
Rapor Sonucunun Anlamı
Belgenin `raporlandı` olarak görünmesi, GİB paketinin kabul edildiği anlamına gelmez. İlk durum belgeyi rapor paketine bağlar; GİB sonucu paket sorgusunun terminal cevabıyla kesinleşir.
| Aşama | Gözlenebilir sonuç | Kaynak sistem kararı |
|---|---|---|
| Belge kaydı | Bilet numarası ve UUId döndü | Belge kimliğini sakla, PDF durumunu izle |
| PDF hazır | İmzalı PDF bağlantısı kullanılabilir | Çıktıyı arşivle; GİB rapor sonucunu başarılı varsayma |
| Rapor paketine alındı | Bilet/liste durumu raporlandı | GİB paket sonucu için ayrı izleme yap |
| GİB başarılı | Paket durum kodu başarılı | Rapor mutabakatını kapat |
| GİB hatalı | Paket hata kodu ve açıklaması | Yeni belge üretmeden önce paket/belge kimliğiyle hata nedenini incele |
Resmî Kaynaklar
| Kaynak | Kapsam |
|---|---|
| GİB e-Bilet Mevzuat ve Teknik Mimari | Güncel kılavuz ve paketlerin ana yayın sayfası |
| e-Bilet Web Servisi Kılavuzu | sendDocumentFile, getBatchStatus, güvenlik ve hata kodları |
| Karayolu/Denizyolu Rapor Kılavuzu | Karayolu bilet raporu alanları ve kuralları |
| e-Yolcu Listesi Rapor Kılavuzu | Sefer, araç, yolcu ve koltuk raporu |
| Etkinlik Rapor Kılavuzu | Etkinlik bileti ve iptal raporu |
| Havayolu Rapor Kılavuzu | Satış/iade, uçuş, tutar ve referans alanları |
| e-Bilet Rapor Özeti Kılavuzu | Rapor özeti kapsamı |