QNB eSolutions Hesabıyla Kantar e-İrsaliye Kurulumu: Adım Adım

Başlamadan önce elinizde ne olmalı?

Kurulumu yapan kişinin iki şeye ihtiyacı vardır: QNB'den alınmış kullanıcı adı ve şifre ile gönderen firmanın resmî bilgileri. Hesabın nasıl edinildiği, sözleşme ve ücret konuları QNB ile firmanız arasındadır ve bu rehberin konusu değildir. Genel akışı ve entegratör seçimini Kantar e-İrsaliye entegratörleri yazısında ele aldık; bu yazı hesabın elinizde olduğunu varsayar. Büyük resim için kümenin ana yazısı olan QNB eSolutions kantar e-İrsaliye entegrasyonu yazısına bakabilirsiniz.

Hangi alanlar girilir?

QNB ayar ekranı iki gruba ayrılır: zorunlu alanlar ve isteğe bağlı alanlar.

Hazır varsayılanlarla gelen alanları, ne değiştirdiğinizi bilmiyorsanız olduğu gibi bırakmak en güvenli yoldur.

Test ve canlı ortam nasıl ayrılır?

Test Ortamı işareti, STEQAR'ın hangi adres kümesine bağlanacağını belirler: işaret açıksa test adresleri, kapalıysa canlı adresler kullanılır. Test Birimi ayarı yalnızca test ortamı açıkken anlam taşır ve test birimleri arasında seçim yapar. Üç şey birbirini tutmak zorundadır: işaret, oturum servisi adresi ve belge servisi adresi. İşaret ile adres tutarsızsa ya da iki servis farklı ortamlarda ise kurulum reddedilir ve QNB'ye hiçbir çağrı yapılmaz. Bu denetim, test sırasında yanlışlıkla gerçek ortama ya da tersine gidilmesini önlemek içindir. Servis adreslerinin kendisini bu yazıda vermiyoruz; adresleri QNB'den almanız ve ayara yazmanız gerekir.

Bağlantı testi

Kurulumu bitirince bağlantı testini çalıştırın. Test, QNB'ye giriş yapmayı dener ve işlem bitince oturumu kapatır. Giriş açılırsa bağlantı başarılı sayılır. Giriş açılamazsa STEQAR neden olduğunu ayrıntılandırmadan bağlantı kurulamadı der; kullanıcı adı, şifre, ortam ya da ağ sorunu bu mesajın arkasında olabilir. Bu sade mesaj bilinçlidir: kimlik bilgileri ve oturum ayrıntıları ekrana ya da günlüğe taşınmaz. Başarısız bir testte önce kullanıcı adı ile şifreyi, sonra Test Ortamı işareti ile adresleri, en sonda ağ erişimini gözden geçirmek mantıklı bir sıradır.

Gönderim öncesi denetimler

Ayarlar tamam olsa bile her gönderimden önce STEQAR birkaç şeyi kontrol eder ve herhangi biri eksikse QNB'ye çağrı yapmaz:

• Gönderen bilgisi. Gönderen firma VKN'si tanımlı değilse gönderim yapılmaz ve ayar eksikliği bildirilir.
• Numara kararı. Numara geçersizse gönderim yapılmaz. Numarayı QNB atadığı için belge numarası alanı boş gider; bu akışı numara ve bekleme yazısında anlattık.
• Belge kimliği. Kimlik (ETTN) kurulamazsa gönderim başlamaz.
• Belge üretimi. UBL-TR belge üretilemezse gönderim yapılmaz ve neden operatöre bildirilir.

Bu denetimler, hatalı bir belgenin QNB'ye gitmeden önce yakalanmasını sağlar. Sonuç iletisinde ayar ya da veri eksikliğini görürseniz düzeltme kantarda yapılır; QNB tarafında yapılacak bir şey yoktur.

Kurulum bittikten sonra ilk belge

İlk gerçek belgeleri durum ekranından yakından izleyin. Alıcının e-İrsaliye mükellefi olmadığı durumda belgenin GİB sanal kutusuna kesildiğini ve kâğıt çıktı notunun yazıldığını alıcı yazısında bulabilirsiniz. Kurulum sonrası günlük işleyiş ise Kantardan otomatik e-İrsaliye nasıl kesilir? yazısında anlatıldığı gibidir. Muhasebe tarafındaki firma ve ürün eşleşmeleri için Kantar muhasebe entegrasyonu yazısı işinize yarar. Kurulumda takılırsanız bizimle iletişime geçin.

Şifre ve oturum nasıl korunur?

Kurulumda girdiğiniz şifre günlüğe, sonuç iletisine ve ham yanıt kaydına yazılmaz. Kimlik ya da oturum hatası olursa STEQAR ayrıntı vermeden genel bir hata koduyla bildirir; bu yüzden hata mesajından şifrenin kendisini ya da oturum bilgisini okuyamazsınız. Oturum bir kez açılır ve aynı oturum sonraki çağrılarda yeniden kullanılır; her çağrıda yeniden giriş yapılmaz. Bağlantı testinde ise oturum işlem sonunda kapatılır. Bu yaklaşım hem QNB'ye gereksiz giriş denemesi yapmaz hem de kimlik bilgisinin ekrana taşınmasını önler. Şifreyi değiştirdiğinizde ayarı da güncellemeniz gerekir; aksi hâlde bağlantı testi başarısız olur.

Sık yapılan kurulum hataları

• Eksik gönderen bilgisi. Gönderen VKN'si ya da unvanı boş bırakılırsa ilk gönderimde ayar eksikliği bildirilir.
• Ortam tutarsızlığı. Test Ortamı işareti açıkken canlı adres, kapalıyken test adresi girilirse kurulum reddedilir.
• Şahıs firmasında ad ve soyad. Gönderen bir şahıssa ad ve soyad ayrı alanlara yazılır; unvan alanına birleşik yazmak yeterli olmaz.
• Hazır değerleri değiştirmek. ERP Kodu gibi hazır varsayılanla gelen alanlar, QNB tarafıyla uyumlu olduğunu bilmeden değiştirilmemelidir.

Bu hataların hiçbiri belgeyi QNB'ye göndermeden önce fark edilmez diye bir şey yoktur; tersine, kurulum denetimi ve gönderim öncesi denetimler tam bu yüzden vardır. Hatayı kantarda görür, düzeltir ve yeniden denersiniz.

İki zorunlu bilgi grubu, bir ortam işareti ve bir bağlantı testi: kurulum bu kadardır; geri kalanı gönderimden önceki denetimler yakalar.

Sık sorulan sorular

QNB eSolutions kurulumunda hangi alanlar zorunludur?

QNB kullanıcı adı ve şifresi zorunludur. Gönderen firma için VKN ya da TCKN ile unvan da zorunludur; şahıs firmasında gönderen adı ve soyadı ayrı alanlara yazılır. Vergi dairesi, il, ilçe, adres ve posta kodu isteğe bağlıdır.

Test Ortamı işareti ne işe yarar?

İşaret, STEQAR'ın test ya da canlı adres kümesinden hangisini kullanacağını seçer. İşaret ile adres tutarsızsa ya da oturum ve belge servisleri farklı ortamlarda ise kurulum reddedilir ve QNB'ye hiçbir çağrı yapılmaz.

Bağlantı testi neyi sınar?

Bağlantı testi QNB'ye giriş yapmayı dener ve işlem bitince oturumu kapatır. Giriş açılamazsa ayrıntı verilmeden bağlantı kurulamadı denir.

Gönderim öncesinde hangi denetimler yapılır?

QNB'ye çağrı yapılmadan önce gönderen firma bilgisinin tanımlı olduğu, numara kararının verilebildiği ve belge kimliğinin kurulabildiği kontrol edilir. UBL-TR belge üretilemezse gönderim yapılmaz ve nedeni bildirilir.