QNB eSolutions Entegrasyonu Ne Yapar?
Kısa cevap: Bu entegrasyon, fatura talep ettiğiniz her sefer için QNB eSolutions e-Arşiv servisine standart biçimli (UBL) bir fatura gönderir ve oluşan faturanın PDF'ini sistemde saklar. Fatura sefer satırından açılır.
QNB, e-Arşiv faturayı yapılandırılmış bir belge olarak kabul eder; bu nedenle belgedeki her alanın (firma unvanı, adres, vergi dairesi, tutar, KDV) eksiksiz ve geçerli olması gerekir. SeferBildirim bu belgeyi sefer kaydından ve entegrasyon kaydındaki firma bilgilerinden üretir.
Fatura akışının genel anlatımı: sefer bilgisinden e-fatura akışı.
Kurulum ve Firma Bilgileri
Entegrasyon SeferBildirim ekibi tarafından yönetici panelinden tanımlanır. QNB için kayıtta genel olarak şu bilgiler bulunur:
- ✓VKN ve ortam (test veya canlı)
- ✓QNB servis kullanıcı bilgisi (kullanıcı adı ve şifre; yalnızca güvenli kanaldan iletilmelidir)
- ✓Faturada görünecek firma unvanı
- ✓Firma adresi: sokak, bina numarası, ilçe, şehir ve posta kodu
- ✓Vergi dairesi
Adres ve unvan bilgilerinin eksik veya hatalı olması, QNB'nin şema doğrulamasında faturanın reddedilmesine yol açabilir. Bu yüzden bu alanları kurulumda birlikte kontrol ederiz.
Test ve Canlı Ortam
QNB'nin test ve canlı servisleri ayrıdır. Entegrasyon kaydındaki ortam seçimi, faturanın hangi servise gideceğini belirler. Canlıya geçmeden önce test ortamında örnek fatura üretip belge görünümünü kontrol etmek mümkündür.
Fatura Akışı
Fatura talebi verilir
Sefer satırındaki "Kes" düğmesine basılınca iş sıraya alınır ve arka planda işlenir; aynı sefer için sırada, işleniyor veya kesilmiş bir fatura varsa ikinci talep eklenmez.
Belge hazırlanır ve gönderilir
Seferin tutarı KDV dahil kabul edilerek %20 KDV ile ayrıştırılır; tek kalemli ("Transfer Hizmet Bedeli") fatura QNB'ye gönderilir. Notlara U-ETDS referans numarası, sefer tarihi, araç ve yolcunun pasaport/kimlik numarası yazılır.
Fatura numarası ve bağlantı alınır
QNB faturanın numarasını ve görüntüleme bağlantısını döndürür.
PDF servisten alınıp saklanır
Fatura oluşunca PDF belge, QNB servisinden ayrıca istenir ve SeferBildirim sunucusunda saklanır; panelde bu PDF açılır.
Yolcu adı ve soyadındaki özel karakterler (örneğin & veya tırnak) belgenin yapısını bozmayacak şekilde işlenir; böylece alışılmadık bir isim yüzünden fatura reddedilmez.
Hata Olursa
- ✓QNB'nin döndürdüğü hata, fatura işinin kaydında görülür.
- ✓QNB fatura işleri otomatik yeniden denenmez; bir hata sonrası yönetici, nedeni giderip işi yeniden kuyruğa alır.
- ✓PDF alınamazsa fatura yine oluşmuştur; panelde QNB görüntüleme bağlantısı kullanılır.
- ✓Fatura işinin hatası U-ETDS sefer bildirimini etkilemez.
Fatura PDF'i sistemde kayıtlı olduğu için plaka bazlı bildirime abone kullanıcılar fatura PDF'ini WhatsApp'ta alabilir; ayrıntı: plaka bazlı WhatsApp ve Telegram bildirimleri.
Sınırlar
- ✓Fatura talep düğmesi "kullanıcı" rolünde pasiftir; talebi yönetici veya firma yetkilisi verir.
- ✓Fatura kalemi standarttır; kalem adı özelleştirilemez.
- ✓Entegrasyon bir muhasebe programı değildir; faturanın hukuki kaydı QNB e-Arşiv'de oluşur.
- ✓Paket kapsamı ve fiyatlar için özellikler ve fiyatlar sayfasına bakın.
Not: Bu sayfa genel bilgilendirme amaçlıdır. Mevzuat, ekranlar ve süreçler değişebilir; güncel ve bağlayıcı bilgi için her zaman Ulaştırma ve Altyapı Bakanlığı kaynaklarını esas alın.
Sık Sorulan Sorular
QNB eSolutions entegrasyonu hangi faturayı keser?+
e-Arşiv fatura. Her sefer için tek kalemli ("Transfer Hizmet Bedeli") fatura, seferin tutarı üzerinden %20 KDV ile hazırlanır.
Firma bilgilerini kim girer?+
SeferBildirim ekibi yönetici panelinden girer; sizden unvan, adres, vergi dairesi ve servis bilgisi güvenli bir kanaldan istenir.
Adres eksikse ne olur?+
QNB belgeyi şema doğrulamasında reddedebilir ve fatura işi hata alır. Bu yüzden bilgileri kurulumda birlikte kontrol ederiz.
Fatura PDF'i nerede?+
Fatura oluşunca PDF servisten alınır ve SeferBildirim'de kayıtlı tutulur; sefer satırındaki "Fatura" bağlantısınden açılır.
Hata olursa otomatik yeniden denenir mi?+
QNB işleri otomatik yeniden denenmez; hata nedeni giderildikten sonra yönetici işi yeniden kuyruğa alır.
Test ortamı var mı?+
Evet. QNB'nin test ve canlı servisleri ayrıdır; entegrasyon kaydında hangisinin kullanılacağı seçilir.