Kısa cevap

Nilvera durum sorgusu salt okumadır ve belge kimliğiyle yapılır. Sürücü belge durumunu ve GİB durumunu birlikte okur: yalnızca belge hatalıysa sonuç hatalı, yalnızca GİB tarafı tamamlandıysa başarılıdır; geri kalan her şey, bilinmeyen durum dahil, bekleyen sayılır. Alıcı yanıtı ayrı bir bilgidir ve durumu değiştirmez.

Sorgu hangi anahtarla yapılır?

Durum sorgusu bir okuma işlemidir; Nilvera'da hiçbir şeyi değiştirmez. Sorgu için belgenin kimliği gerekir. Gönderim sırasında Nilvera'nın döndürdüğü belge kimliği saklanmışsa sorgu onunla yapılır. Saklanmış kimlik yoksa gönderimde kullanılan ETTN denenir. Bu saklama çalışma süresince geçerlidir; uygulama yeniden başladıktan sonra sorgu ETTN ile yapılır. Yalnızca belge numarası verilirse sorgu yapılmaz: ağ çağrısı hiç çıkmaz ve kayda, sorgunun belge kimliğiyle yapılabildiği yazılır. Sessiz bir boş sonuç üretilmez.

İki bilgi birlikte okunur

Nilvera iki ayrı bilgi verir. Birincisi belgenin Nilvera tarafındaki durumudur: bekliyor, başarılı, hatalı ya da bilinmiyor. İkincisi GİB tarafındaki işlemin ilerleyişidir. Bu iki bilgi birbirinin yerine geçmez. Bu yüzden sürücü bir sıra izler ve sonucu şu tabloya göre belirler:

Belge durumuGİB durumuSonuç
HatalıTamamlandıBekleyen. İki bilgi çelişiyor; çelişkiden başarı çıkarılmaz.
HatalıTamamlanmadı, bilgi yok ya da henüz oluşmadıHatalı
Hatalı değilTamamlandıBaşarılı
Bekliyor, bilinmiyor ya da başarılıTamamlanmadı, bilgi yok ya da henüz oluşmadıBekleyen

Son satır önemlidir. Belge durumu başarılı dese bile GİB tarafı tamamlanmadıysa sonuç bekleyen kalır. Tek bir bilgiye güvenmek, tamamlanmamış bir işlemi tamamlanmış göstermek demektir; sürücü bunu yapmaz. GİB durumunun henüz oluşmamış olması da hata değil, bekleme anlamındadır.

Bilinmeyen durum başarı sayılmaz

Yukarıdaki tabloda yer almayan her birleşim bekleyen sayılır. Sağlayıcı yeni bir durum değeri döndürürse ya da yanıt beklenen biçimde değilse sonuç sessizce başarıya çevrilmez; bekleyen kalır, olay günlüğe yazılır ve iletide belgenin sağlayıcıda işlendiği ama durumun henüz kesinleşmediği söylenir. Sağlayıcının kendi açıklama metni kullanıcıya gösterilmez; ekrandaki ileti STEQAR'ın çevrilmiş metnidir, ham açıklama yalnızca günlükte kalır. Yanıt beklenen yapıda değilse sürücü hata fırlatmaz; sonuç yine bekleyen olur. İptal durumu üretilmez: Nilvera üzerinden uzaktan iptal yapılmadığı için sürücü hiçbir sonucu iptal olarak etiketlemez.

Alıcı yanıtı ayrı bir eksendir

Alıcı belgeye yanıt verdiyse bu bilgi durum sorgusunda görünür ve iletiye eklenir. Alıcının belgeyi reddetmiş olması belgeyi hatalı ya da iptal saymak için gerekçe olmaz; yanıt ayrı bir bilgi olarak izlenir. Yanıt yoksa alan boş gelir ve sonuç etkilenmez. Yanıtı görünce yapılacak iş, portaldan içeriğine bakmak ve gerekirse alıcıyla iletişim kurmaktır.

Sorgu bir kez okur, yoklama yapmaz

Sürücü durumu kendi başına yoklamaz; her sorgu tek bir okumadır. Sonucun ilerleyip ilerlemediğini görmek için sorguyu yeniden çalıştırmak gerekir. Sorgunun sonucu belge durumunu, GİB durumunu ve varsa alıcı yanıtını taşır; sonucu yalnızca ilk ikisi belirler.

Gönderim başarısı ile durum başarısı

Gönderim sonucu ile durum sorgusu aynı şeyi söylemez. Gönderim sonucu, belgenin Nilvera'ya iletildiğini ve bir belge kimliği döndüğünü bildirir; GİB tarafındaki sonucu henüz içermez. Durum sorgusu bunun sonrasını okur. Nilvera belge kimliğini zaten kayıtlı bildirdiğinde de sonuç başarı sayılır, ama GİB tarafı doğrulanmadığı için kayıt bir uyarı taşır ve durumun sorgulanmasını önerir. Yani gönderimin başarılı olması ile durumun başarılı olması iki ayrı olaydır; ilki ikincisinin yerine geçmez ve uyarıyı gören operatörün ilk işi durumu sorgulamaktır.

Durum iletileri ne söyler?

Her sonucun ekranda kendi iletisi vardır. Başarılı sonuçta ileti GİB tarafındaki işlemin tamamlandığını bildirir. Bekleyen sonuçta ileti belgenin sağlayıcıda işlendiğini ve durumun henüz kesinleşmediğini söyler. Hatalı sonuçta ileti belgenin reddedildiğini bildirir ve yeniden göndermeden önce sağlayıcı portalinden doğrulamayı ister. Alıcı yanıtı varsa iletinin sonuna ayrı bir cümle olarak eklenir.

Sorgu hata verirse ne anlama gelir?

  • Belge bulunamadı. Bu bir ret değildir. Hatalı durum üretmez; ileti belgenin sağlayıcıda bulunamadığını söyler.
  • Kimlik reddedildi. Erişim anahtarı geçersiz ya da yetkisizdir. Hesap ve seri yazısındaki adımlarla yeni anahtar üretilip girilir.
  • Ağ sorunu. Sağlayıcıya ulaşılamadı. Durum bilinmiyor demektir; bağlantıyı kontrol edip sorguyu tekrarlayın.

Sonucu pratikte nasıl izlersiniz?

Gönderimden hemen sonra durumun bekleyen çıkması beklenen bir durumdur; ileti belgenin işlendiğini, durumun henüz kesinleşmediğini söyler. Bekleyen bir belgeyi yeniden göndermek yerine durumunu belirli aralıklarla sorgulayın. Sonuç başarılıya dönmezse portaldan belgeye bakın. Hatalı sonuç gelirse iletideki yönlendirmeyi izleyin: yeniden göndermeden önce portaldan doğrulayın. Gönderimdeki ret sınıfları için önizleme ve hata sınıfları yazısına, genel akışa Nilvera ile Kantardan e-İrsaliye rehberine bakabilirsiniz. Entegratör seçerken durum izleme farklarını Kantar e-İrsaliye entegratörleri yazısında karşılaştırabilirsiniz.

Operatör için kısa liste

  1. Sonuç bekleyense belgeyi yeniden göndermeyin; sorguyu bir süre sonra yineleyin.
  2. Sonuç hatalıysa önce sağlayıcı portalinden doğrulayın, sonra gerekirse yeniden gönderin.
  3. Belge bulunamadıysa kayıttaki belge kimliğini kontrol edin.
  4. Alıcı yanıtı görünüyorsa içeriğine portalden bakın.
Başarılı demek için iki bilgi gerekir; biri eksikse sonuç bekleyendir, bilinmeyen durum asla başarıya çevrilmez.

Sık sorulan sorular

Belge durumu başarılı gösteriyorsa sonuç başarılı sayılır mı?

Hayır. Sürücü belge durumu ile GİB durumunu birlikte okur. Belge durumunun başarılı demesi tek başına yetmez; GİB tarafındaki işlemin tamamlandığı bilgisi de gelmelidir. Yalnızca birincisi geldiyse sonuç bekleyen kalır.

Belge numarasıyla durum sorgulanabilir mi?

Hayır. Sorgu belge kimliğiyle yapılır; gönderimden saklanan Nilvera belge kimliği varsa o, yoksa ETTN kullanılır. Yalnızca numara verilirse ağ çağrısı yapılmaz ve kayıtta sorgunun neden yapılamadığı yazılır.

Alıcı yanıtı belgeyi hatalı yapar mı?

Hayır. Alıcı yanıtı belge durumundan ayrı bir bilgidir. Sorguda görünür ama alıcının reddi belgeyi hatalı ya da iptal saymaz.

Sorguda belge bulunamadı iletisi çıkarsa belge reddedilmiş midir?

Hayır. Bulunamadı bir ret değildir ve hatalı durum üretmez. Sorguda kullanılan kimlik sağlayıcıda kayıtlı değildir. Önce gönderim sonucunun kaydına ve belge kimliğine bakın.

Şeffaflık notu

STEQAR, Nilvera'nın yanı sıra başka e-İrsaliye entegratörleriyle de çalışır; EDM Bilişim, Turkcell e-Şirket, Orkestra e-Faturacım, Veriban, e-Logo, QNB eSolutions, eKüpSoft, Digital Planet, KolayBi ve VBT bu seçenekler arasındadır. Farkları Kantar e-İrsaliye entegratörleri yazımızda karşılaştırdık.

Kendi tartımınızda görün

Tartımdan e-İrsaliyeye otomatik akışı gösterelim.

Kantarınızda bir tartım yapalım, belgenin entegratöre gidişini birlikte izleyelim. İnterneti kapatıp kuyruğu da deneriz.