Referans
Sıkça Sorulan Sorular
Belge ailesi seçimi, API, PDF, iptal, durum, raporlama ve canlı kullanım hakkında sık sorulan sorular.
Konu ve Kaynak Rehberi
Yanıtı ayrıntılı sözleşme veya akış üzerinden doğrulamak için ilgili konu sayfasına geçin.
| Konu | Kaynak bölüm | Devam kaynağı |
|---|---|---|
| Kapsanan belge ve işlemler | Destek Kapsamı | e-Bilet Nedir? |
| Kimlik doğrulama, response ve tekrar | API Temelleri | Entegrasyon Sorumlulukları |
| Karayolu ve yolcu listesi | Karayolu Senaryoları | e-Yolcu Listesi Senaryoları |
| Etkinlik ve havayolu | Etkinlik Senaryoları | Havayolu Senaryoları |
| PDF, GİB raporu ve iptal | PDF, İmza ve Teslim | GİB Rapor Paketleri |
| Hata teşhisi | Sorun Giderme | Teknik Referans |
Kullanım ve Operasyon
e-Bilet rehberi hangi belge türlerini kapsar?
Karayolu e-Bileti, e-Yolcu Listesi, etkinlik e-Bileti ve havayolu e-Bileti kapsanır. İşlem desteği aile bazında Destek Kapsamı sayfasında ayrılır.
Bir bilet oluşturulduğunda hemen GİB'e gönderilmiş olur mu?
Hayır. Kayıt kabulü, imzalı PDF üretimi, rapor paketine alınma ve GİB paket sonucu ayrı aşamalardır.
PDF ne zaman indirilebilir?
Belge durumu SignedPdfCreated olduğunda imzalı PDF hazırdır.
Portal ile ERP entegrasyonu aynı şey mi?
Hayır. Portal VBT'nin operasyon ekranıdır; ERP entegrasyonu public REST sözleşmesini kullanır.
Firma FTP'sine bırakılan dosya GİB gönderimi midir?
Hayır. FTP, firmaya çıktı teslim kanalıdır. GİB gönderimi rapor ZIP'iyle ayrı web servisi üzerinden yapılır.
Karayolu bileti nasıl iptal edilir?
CancelHwTicket işlemi mevcut TicketExternalNumber ile çağrılır; sonuç durum sorgusuyla doğrulanır.
Etkinlik bileti nasıl iptal edilir?
CancelEventTicket işlemi mevcut bilet numarasıyla çağrılır.
Havayolu bileti nasıl iptal edilir?
Ayrı iptal endpointi yoktur. Yeni bir IADE belgesi oluşturulur ve kaynak satış biletine referans verilir.
e-Yolcu Listesi biletten önce gönderilebilir mi?
Gönderilmemelidir. Liste satırlarının referans verdiği karayolu biletleri önce oluşturulmalıdır.
Etkinlik ve havayolu GİB raporları otomatik oluşur mu?
Hayır. Otomatik GİB raporlaması bu iki belge ailesi için yayımlanmış entegrasyon sözleşmesine dahil değildir; raporlama ayrı proje kapsamıdır.
Teknik Entegrasyon
Kimlik doğrulama header'ı nedir?
Token alındıktan sonra ürün çağrılarında VbtAuthorization header'ı kullanılır. Ortak akış API Temelleri sayfasındadır.
İptal ve durum çağrılarında JSON body göndermeli miyim?
Hayır. Rehberde URI parametreli gösterilen işlemler body kabul etmez.
Timeout sonrası request'i tekrar gönderebilir miyim?
Önce mevcut kaydı harici numara veya belge numarasıyla sorgulayın. Kayıt yokluğu doğrulanmadan yeni kimlik üretmeyin.
TicketExternalNumber ne için kullanılır?
Kaynak ERP'nin değişmez iş kimliğidir; tekrar güvenliği ve ERP-platform mutabakatında kullanılır.
TicketNumber ile UUId aynı kimlik midir?
Hayır. TicketNumber belge numarası, UUId teknik tekil kimliktir.
TicketNumber göndermek zorunda mıyım?
Karayolu ve etkinlikte platform numara üretebilir; bu durumda LocationCode gönderilir. Havayolunda 13 karakterli TicketNumber zorunludur.
Karayolu modelindeki Passanger ve Deperture yazımları hata mı?
Alan adları eski dış sözleşmenin gerçek yazımıdır. JSON gönderiminde Passanger* ve DepertureNo korunmalıdır.
Yabancı karayolu yolcusu nasıl gönderilir?
PassangerIsTR=false, pasaport numarası dolu ve TCKN alanı boş gönderilir.
e-Yolcu Listesi numarasını platform üretebilir mi?
Evet. YolcuListesiNo boş, LocationCode dolu gönderilir ve response numarası saklanır.
Yabancı para havayolu bileti nasıl gönderilir?
DocumentCurrencyCode, pozitif CalculationRate ve her mali alanın ilgili *TRY karşılığı birlikte gönderilir.
IADE request'inde satış biletini nasıl bağlarım?
Yeni iade biletinin TicketReferenceNumber alanına satış bileti numarasını yazın. Bu alan API kaydında satış–iade ilişkisini kurar; GİB raporuna otomatik aktarım mevcut sözleşmenin parçası değildir.
HTTP 200 her zaman başarı anlamına gelir mi?
Hayır. HasError, Errors[], Data.IsSucceded ve mesajlar birlikte değerlendirilmelidir.
Reported durumu GİB kabulü müdür?
Hayır. Belgenin rapor paketine alındığını gösterir. GİB sonucu rapor paketinin ReportSuccessful durumuyla doğrulanır.
ServiceType ve PaymentType serbest metin midir?
Hayır. Teknik Referans sayfasındaki enum değerleri kullanılmalıdır.
SOAP ve REST'i aynı anda kullanabilir miyim?
Aynı ticari işlem için paralel kullanmayın. Geçişte tek kaynak kanal belirleyin ve kimlikleri koruyun.
Request örnekleri çalıştırılabilir mi?
JSON örnekleri gerçek request modellerini temel alır. Tarih, seri, kimlik, bilet numarası ve firma ayarlarını kendi test ortamınıza göre değiştirmeniz gerekir.