Başlangıç
Destek Kapsamı
Belge ailesi, işlem, API kanalı, PDF ve GİB raporlama desteğinin sınırları.
Kapsam kuralı: Bu rehber yalnızca dış API'den çağrılabilen veya kullanıcı tarafından gözlenebilen davranışları destek sözleşmesi olarak gösterir. GİB standardında bulunması, bir işlemin platformda otomatik olarak desteklendiği anlamına gelmez.
Belge ve İşlem Matrisi
| Belge ailesi | Oluşturma | İptal | Durum sorgusu | Bu rehberdeki GİB rapor kapsamı | |
|---|---|---|---|---|---|
| Karayolu e-Bileti | REST ve legacy SOAP | Harici bilet numarasıyla desteklenir | Bilet numarasıyla desteklenir | Portal ve belge bağlantısı | Bilet ve iptal kayıtlarının rapor paketine alınması açıklanır |
| e-Yolcu Listesi | REST ve legacy SOAP | Ayrı iptal endpoint'i yoktur | Harici liste numarasıyla desteklenir | Portal ve belge bağlantısı | Yolcu listesi rapor paketine alınması açıklanır |
| Etkinlik e-Bileti | REST | Bilet numarasıyla desteklenir | Bilet numarası ve tarih aralığı sorguları | Portal ve belge bağlantısı | Otomatik GİB raporlaması mevcut public destek taahhüdüne dahil değildir |
| Havayolu e-Bileti | REST | Ayrı iptal endpoint'i yoktur | Bilet numarasıyla desteklenir | Portal ve belge bağlantısı | Otomatik raporlama ve IADE referans aktarımı mevcut public destek taahhüdüne dahil değildir |
API Kanal Matrisi
| İhtiyaç | Önerilen kanal | Sınır |
|---|---|---|
| Yeni ERP entegrasyonu | REST Entegratör API | Her belge ailesinin kendi request modeli ve endpoint'i kullanılır. |
| Mevcut karayolu SOAP entegrasyonunu sürdürme | Legacy SOAP | Etkinlik ve havayolu işlemlerini kapsamaz. |
| Operasyonel listeleme, PDF ve e-posta | VBT Portal | Portal endpointleri ERP entegrasyon sözleşmesinin yerine geçmez. |
| Dosyaların firmaya toplu teslimi | Yapılandırılmış FTP teslimi | Yalnız karayolu bileti ve yolcu listesi paketleri; GİB iletimi değildir. |
Durumların Anlam Sınırı
Belge durumları PDF ve rapor hazırlık aşamalarını, rapor durumları ise GİB paket sonucunu temsil eder. Kaynak sistem bu iki sonucu ayrı izlemelidir.
| Gözlenen durum | Kesin olarak neyi kanıtlar? | Neyi kanıtlamaz? |
|---|---|---|
Kuyrukta Bekliyor | Bilet veya listenin kaydedildiğini | PDF'in hazır olduğunu |
İmzalı ... PDF Dosyası Oluştu | İmzalı PDF çıktısının hazırlandığını | GİB raporunun kabul edildiğini |
... Raporlandı | Belgenin rapor paketine ilişkilendirildiğini | Paketin GİB tarafından başarılı işlendiğini |
| Rapor başarılı | GİB paket sorgusunun başarılı sonuçlandığını | Her belgenin kaynak ERP'de mutabık kapatıldığını |
Mevcut Kapsamın Dışında Kalanlar
- Gelen e-Bilet veya gelen yolcu listesi API akışı
- Etkinlik ve havayolu için legacy SOAP işlemleri
- Havayolu için ayrı bir iptal endpoint'i
- Yolcu listesi için ayrı bir iptal endpoint'i
- Etkinlik ve havayolu için otomatik GİB raporlaması
- Fiziksel dosya saklama yöntemi; entegratör yalnız erişilebilir çıktı sözleşmesini esas alır
Entegrasyon kararı: Kapsam dışı bir işleme ihtiyaç varsa mevcut endpoint adından veya GİB kılavuzundan hareketle çağrı üretmeyin. Çözüm Merkezi üzerinden ürün kapsamını doğrulayın.