Başlangıç
e-Bilet Nedir?
e-Bilet belge aileleri, teknik kimlikleri, entegrasyon kanalları ve uçtan uca yaşam döngüsüne giriş.
Temel Kavram
e-Bilet; karayolu, etkinlik ve havayolu taşımacılığı veya etkinlik katılımı için düzenlenen elektronik biletlerin oluşturulmasını, imzalı PDF çıktısının hazırlanmasını ve ilgili GİB rapor dönemine alınmasını kapsar. Karayolu seferlerinde biletlerden ayrı bir e-Yolcu Listesi belgesi de oluşturulabilir.
Entegrasyon, bileti kaydetmekle tamamlanmaz. Kaynak sistem; dönen bilet numarasını ve UUId değerini saklamalı, PDF durumunu sorgulamalı ve iptal edilen belgeleri kendi kayıtlarıyla mutabık tutmalıdır.
Belge Aileleri
| Belge ailesi | Temel kullanım | Ayırt edici bilgiler | Ayrıntı |
|---|---|---|---|
| Karayolu e-Bileti | Karayolu yolcu taşımacılığı bileti | Sefer, kalkış/varış, koltuk, yolcu ve hizmet tipi | Karayolu Senaryoları |
| e-Yolcu Listesi | Bir seferdeki bilet ve koltukların toplu bildirimi | Sefer, araç, araç işleten, liste numarası ve koltuk kayıtları | e-Yolcu Listesi Senaryoları |
| Etkinlik e-Bileti | Konser, spor, sinema veya benzeri etkinlik bileti | Etkinlik, organizatör, yer, tarih ve koltuk | Etkinlik Bileti Senaryoları |
| Havayolu e-Bileti | Havayolu yolcu taşımacılığı bileti | Uçuş, yolcu, rota, para birimi ve belge tipi | Havayolu Bileti Senaryoları |
Teknik Kimlikler
| Kimlik | Amaç | Entegratör davranışı |
|---|---|---|
TicketNumber | Biletin görünen belge numarası | Kaynak sistem üretmiyorsa desteklenen belge ailelerinde numara üretimi için ilgili seri/lokasyon kodunu gönderin. |
UUId | Belgenin uçtan uca teknik kimliği | Response'tan alınan değeri PDF, portal ve arşiv korelasyonu için saklayın. |
TicketExternalNumber | Kaynak sistemdeki tekil bilet referansı | Timeout ve mükerrer gönderim mutabakatında aynı değeri koruyun. |
PassengerListExternalNumber | Kaynak sistemdeki yolcu listesi referansı | Liste durumunu sorgulamak ve tekrarları önlemek için tekil tutun. |
Entegrasyon Kanalları
| Kanal | Ne zaman kullanılır? | Kapsam |
|---|---|---|
| REST Entegratör API | Yeni ERP ve kaynak sistem entegrasyonlarında | Bilet/liste oluşturma, desteklenen iptal işlemleri ve durum sorguları |
| VBT Portal | Operasyonel listeleme, PDF, e-posta, log ve rapor işlemlerinde | VBT tarafından sağlanan kullanıcı işlemleri |
| Legacy SOAP | Mevcut karayolu entegrasyonunun SOAP sözleşmesini koruması gerektiğinde | Karayolu bileti ve e-Yolcu Listesi |
| FTP teslimi | Firma için ayrıca dosya teslimi yapılandırıldığında | Karayolu bileti ve e-Yolcu Listesi arşiv paketleri; GİB gönderimi değildir |
Belge Yaşam Döngüsü
Bilet kaydı ile GİB rapor sonucu iki ayrı seviyedir. Biletin rapor paketine alınması, paketin GİB tarafından kabul edildiğini tek başına kanıtlamaz.
Token al ve korumalı çağrılarda VbtAuthorization header'ını gönder.
Karayolu, yolcu listesi, etkinlik veya havayolu request modelini kullan.
Tekil dış referansı gönder; dönen numara ve UUId değerini sakla.
Oluşturma response'unu PDF hazır sonucu kabul etme; belge durumunu sorgula.
Belge ailesinin desteklediği iptal işlemini aynı bilet kimliğiyle uygula.
Kaynak sistem, portal çıktısı ve gözlenebilir rapor durumlarını aynı kimliklerle ilişkilendir.
Okuma Sırası
Önce Destek Kapsamı ve API Temelleri sayfalarını okuyun. Ardından kullanacağınız belge ailesinin senaryo, alan kuralları, API ve request örnekleriyle devam edin. PDF ve GİB raporlama ayrımı PDF, İmza ve Teslim ile GİB Rapor Durumları sayfalarında açıklanır.