STEQAR, QNB eSolutions servisiyle çalışır. Tartım kapanınca belge hazırlanır, alıcının mükellefiyeti QNB'ye sorulur ve belge QNB'ye iletilir. Numarayı QNB atar; STEQAR numarayı sınırlı süre bekler, kayda yazar ve belgenin XML, HTML ve PDF görünümlerini arşive alır. Kayıttaki başarı, QNB'nin belgeyi kabul etmesidir; GİB tarafındaki sonraki durum QNB portalından izlenir.
QNB eSolutions bu akışta ne iş görür?
Kantar yazılımı e-İrsaliyeyi tek başına GİB'e ulaştıramaz; belge bir entegratör üzerinden gider. STEQAR bu iş için QNB eSolutions servisiyle çalışır. Görev paylaşımı basittir: tartım, firma, malzeme, plaka, şoför ve teslimat bilgisi kantarda tutulur ve belge verisine dönüşür; alıcının durumunun sorulması, belgenin alınması, numaranın verilmesi ve belgenin işlenmesi QNB tarafında yürür. Bu akışın ayırt edici yanı numaradır: belge numarasını STEQAR kurmaz, QNB atar.
Bir sorunun nerede çözüleceğini bu paylaşım belirler. Yanlış tartım değeri ya da eksik cari bilgisi kantarda düzeltilir; belgenin QNB tarafındaki akıbeti ise QNB hesabında sorulur. Entegratörden bağımsız genel akışı Kantardan otomatik e-İrsaliye nasıl kesilir? yazısında anlattık; burada yalnızca QNB'ye özgü kısımlara bakıyoruz.
Tartımdan belgeye adım adım
Bir tartım kapandığında zincir şu sırayla ilerler:
- Belge hazırlanır. Fiş ve irsaliye verisi; alıcı VKN ya da TCKN'si, plaka, şoför, teslimat adresi ve kalemlerle birlikte, ayarlardaki gönderen firma bilgilerine eklenir ve UBL-TR biçiminde belge oluşturulur.
- Alıcı sorgulanır. STEQAR, alıcının e-İrsaliye mükellefi olup olmadığını QNB'ye sorar.
- Belge iletilir. Belge QNB'nin istediği biçime çevrilip QNB'ye gönderilir; QNB bir belge kimliği döndürür.
- Numara beklenir. Numarayı QNB atıyorsa STEQAR, numara gelene ya da belge kesin başarısız olana kadar sınırlı süre bekler.
- Görünümler kaydedilir. Belgenin QNB'deki XML, HTML ve PDF görünümleri kantar kayıtlarına alınır.
Bu adımlar arka planda sırayla yürür; tartımı kapatan operatörün her adım için ayrıca işlem yapması gerekmez. Operatörün devreye girdiği yerler, alıcı kayıtsız olduğunda kâğıt çıktının teslimi ve bağlantı kesildiğinde bekleyen kaydın yeniden gönderilmesidir.
Kurulumda neler girilir?
Kurulum ekranında 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ı ile soyadı ayrı alanlara yazılır. ERP Kodu alanı isteğe bağlıdır ve hazır bir değerle gelir. Test Ortamı işareti, hangi adres kümesinin kullanılacağını belirler; işaret ile adres tutarsızsa kurulum reddedilir. Alan alan anlatım QNB eSolutions hesabıyla kantar e-İrsaliye kurulumu rehberinde.
Numarayı QNB verir
Kantar, numara alanında otomatik seçeneğini kullanır; belge numarası alanı QNB'ye boş gider ve QNB numarayı kendi varsayılan serisinden atar. Belge kimliği (ETTN) QNB'deki yerel tekil anahtardır ve ilk denemeden önce kayda yazılır. Numara asenkron atandığı için STEQAR sınırlı süre, aralıklı olarak QNB'ye sorar. Süre dolarsa kayıt numarasız başarı olarak görünür ve sonuç iletisi belgenin ETTN'ini gösterir. Ayrıntılar QNB'de e-İrsaliye numarası ve bekleme yazısında.
Alıcı e-İrsaliye mükellefi değilse
Gönderimden önce alıcı sorgulanır; sorgunun sonucu belgenin yolunu belirler:
| Sorgu sonucu | STEQAR ne yapar? |
|---|---|
| Alıcı mükellef | Belge QNB'ye iletilir; sanal kutu kullanılmaz. |
| Alıcı mükellef değil | Belge GİB'in sanal posta kutusuna kesilir; sonuç başarıdır ve kâğıt çıktı notu yazılır. |
| Sorgu sonuçlanmadı | Belge gönderilmez; sonuç iletisi gönderimin yapılmadığını söyler. |
Adımların ayrıntısı Alıcı e-İrsaliye mükellefi değilse QNB'de yazısında.
Gönderimden sonra belge arşivi
Gönderim başarılı olunca STEQAR belgenin QNB'deki son halini ayrı ayrı XML, HTML ve PDF olarak alıp kantar kayıtlarına yazar. Numarayı QNB atıyorsa indirme numara beklemesinden sonra yapılır. Kayıtlar ekranında Görüntüle ve PDF Kaydet ile açabilirsiniz. Bir görünüm alınamazsa gönderim yine başarılı kalır. Ayrıntılar QNB e-İrsaliye belgelerini kantardan görüntüleme yazısında.
İnternet kesilirse
İnternet yokken tartım, fiş ve plaka okuma sürer. Gönderilemeyen e-İrsaliye bekleyen ya da başarısız kayıt olarak durur ve bağlantı döndüğünde operatör yeniden gönderimi başlatır; kimlik aynı kaldığı için yanıt kaybolsa bile belge QNB'de kendi anahtarıyla aranır. Bu davranışı İnternet kesilince QNB e-İrsaliye yazısında topladık.
Durumlar ve başarının sınırı
QNB'nin dört parçalı durum bilgisini STEQAR tek bir sonuca çevirir: başarılı, beklemede, hatalı ya da iptal. Bilinmeyen ya da eksik bir yanıt asla başarılı sayılmaz. Sınıfların nasıl türetildiğini QNB e-İrsaliye durumları yazısında anlattık.
Kayıtta başarılı yazması, belgenin GİB tarafında tamamlandığı anlamına gelmez; başarı QNB'nin belgeyi kabul edip işlemesidir. Belge takibi yapan biri varsa durumu QNB portalından kontrol etmelidir. GİB kılavuzuna göre e-İrsaliye iptal edilemez; STEQAR de QNB üzerinden uzaktan iptal işlemi yapmaz.
Bu yazılar hangi sırayla okunmalı?
QNB ile yeni başlıyorsanız kurulum rehberinden, ardından numara ve alıcı yazılarından gitmek mantıklıdır. QNB'yi öteki seçeneklerle yan yana koymak için Kantar e-İrsaliye entegratörleri yazısına, e-İrsaliyenin e-Faturadan farkı için e-İrsaliye mi, e-Fatura mı? yazısına bakabilirsiniz. STEQAR başka e-İrsaliye entegratörleriyle de çalışır; hangi tesiste hangisinin kullanılacağı bir ayardır.
Alıcıyı gönderimden önce sorar, numarayı QNB'den alıp kayda yazar ve belgenin görünümlerini saklarız; belgenin GİB'deki sonraki durumu ise QNB portalında izlenir.
Sık sorulan sorular
QNB eSolutions ile kantardan e-İrsaliye nasıl gönderilir?
Tartım kapandığında STEQAR belgeyi hazırlar, alıcının e-İrsaliye mükellefi olup olmadığını QNB'ye sorar ve belgeyi QNB'nin istediği biçimde iletir. QNB belge kimliğini döndürür; numarayı QNB atıyorsa STEQAR numarayı sınırlı süre bekler, ardından belgenin XML, HTML ve PDF görünümlerini kantar kayıtlarına alır.
QNB'de e-İrsaliye numarasını kim verir?
Numarayı QNB verir. Kantar numara alanını boş gönderir, belge kimliğini (ETTN) yerel anahtar olarak kullanır ve QNB'nin atadığı numarayı kantar kaydına yazar. STEQAR numarayı kendisi üretmez ve yerel sayaç tutmaz.
Alıcı e-İrsaliye mükellefi değilse ne olur?
Alıcı sorgusu başarıyla sonuçlanır ve alıcı mükellef çıkmazsa belge GİB'in sanal posta kutusuna kesilir; sonuç başarıdır ve alıcıya kâğıt çıktı teslim edilmesi hatırlatılır. Sorgu sonuçlanmazsa belge hiç gönderilmez.
Kayıttaki başarılı sonuç belgenin GİB'de tamamlandığını gösterir mi?
Hayır. Başarılı sonuç, QNB'nin belgeyi kabul etmesi ve işleyip numara atamasıdır. Belgenin GİB tarafındaki sonraki durumu QNB portalından izlenir; kantar uygulaması bu durumu gönderimden sonra kendiliğinden sorgulamaz.
STEQAR, QNB eSolutions'ın yanı sıra başka e-İrsaliye entegratörleriyle de çalışır; EDM Bilişim, Turkcell e-Şirket, Orkestra e-Faturacım, Veriban ve e-Logo bu seçenekler arasındadır. Farkları Kantar e-İrsaliye entegratörleri yazımızda karşılaştırdık.