Nilvera'da alıcı sorgusu, vergi numarasıyla yapılır ve belge türü seçilmelidir: tür verilmezse sağlayıcı e-fatura kutularını getirir, e-irsaliye kutularını değil. Kayıtsız alıcıda hata değil, boş liste döner; belge de bu durumda GİB sanal posta kutusuna yönlendirilir.
Sorgu neden kritik?
E-irsaliye belgesi, alıcının GİB'deki e-irsaliye posta kutusuna teslim edilir. Alıcı kayıtlıysa kutusu bellidir; kayıtsızsa belge ortak sanal kutuya gider. İkisini ayıran, gönderimden önce yapılan alıcı sorgusudur. Hata burada yapılırsa belge yanlış kutuya ya da hiç ulaşmayacağı bir yere gider. Genel yaklaşım alıcı mükellef değilse kantar yazısındadır; burada Nilvera'ya özgü ayrıntılar var.
Belge türü tuzağı
Nilvera'nın mükellef sorgusu, belge türünü seçmenizi bekler: fatura ya da irsaliye. Tür verilmediğinde varsayılan olarak fatura türü kullanılır. Yan yana yaptığımız denemede aynı vergi numarası için iki tür farklı sayıda kayıt döndürdü ve iki listenin içeriği örtüşmedi.
| Sorgu | Gelen kayıtlar |
|---|---|
| Tür verilmedi | Fatura kutuları |
| Tür: fatura | Fatura kutuları |
| Tür: irsaliye | İrsaliye kutuları, çok daha az sayıda |
Pratik sonuç açıktır: tür belirtilmeden sorulursa alıcının fatura kutusu irsaliye kutusu sanılabilir. Bu, yanlış kutuya gönderim sınıfındaki hataların tipik bir örneğidir. Bu nedenle sorguda belge türü her zaman açıkça irsaliye olarak verilir. Kayıtlı kullanıcı listelerinin mantığı için e-irsaliye mükellef sorgulama yazısına bakabilirsiniz.
Kayıtsız alıcı sinyali
Alıcı e-irsaliye kullanıcısı değilse Nilvera hata döndürmez; başarılı bir yanıtla boş liste verir. Bu sinyal temizdir ama bir alışkanlığı değiştirir: karar durum koduna bakılarak değil, yanıtın içeriğine bakılarak verilir. Durum koduna bakan bir program, boş listeyi "sorun yok, alıcı kayıtlı" diye okuyabilir.
- Liste dolu. Alıcı kayıtlı; kutu bilgileri listeden alınır.
- Liste boş. Alıcı kayıtsız; belge sanal kutuya yönlendirilir.
- Sorgu hata verdi. Sonuç belirsiz; belge gönderilmez, operatör uyarılır.
Alıcı etiketi parametresi
Belge yüklenirken alıcının posta kutusu etiketi ayrı bir parametre olarak verilir. Denememizde, alıcı kayıtsızken belgenin içindeki etiket yanlış olsa bile, parametre doğru olduğu için belge kabul edildi. Yani karar parametreye bakılarak verildi. Etiketi belgenin içine de yazmaya devam ederiz; çünkü GİB şematronu ve diğer sağlayıcılar onu okur.
GİB sanal kutusu
GİB, kayıtsız alıcılar için ortak bir sanal posta kutusu işletir ve STEQAR'ın tüm entegratörlerde izlediği ortak kural bu kutuyu hedeflemektir. Nilvera'da bunu ölçtük: bizim kullandığımız ortak etiket kabul edildi ve belge GİB zarfı başarıyla tamamlanarak kapandı. Sağlayıcının kendi dokümanında farklı yazılmış bir etiket ise reddedildi; ret açıklamasının ayrıntı alanı doğru olanı söylüyordu. Hangi yazımın geçerli olduğunu her sağlayıcıda ayrıca ölçmek bu yüzden gerekir.
Kâğıt çıktı adımı ve hukuki sonuçlar için GİB düzenlemelerine ve mali müşavirinize başvurun. Hazırlık durumu için Nilvera rehber yazısına dönebilir, iletişim sayfasından demo isteyebilirsiniz; demo ücretsizdir.
Sık sorulan sorular
Nilvera'da alıcı sorgusunda neden belge türü seçilmeli?
Sorgu ucu, belge türü verilmezse varsayılan olarak e-fatura kullanıcılarını getirir. E-fatura ve e-irsaliye kutuları aynı değildir; türü seçmeden yapılan sorgu alıcının fatura kutusunu irsaliye kutusu sandırabilir.
Alıcı kayıtsızsa sorgu hata mı verir?
Hayır. Sağlayıcı kayıtsız alıcıda hata yerine başarılı yanıt ve boş liste döndürür. Karar, yanıtın gövdesine bakılarak verilir; durum koduna bakılarak verilmez.
Alıcı etiketini nasıl veriyoruz?
Belge yüklenirken alıcının posta kutusu etiketi ayrı bir parametre olarak gönderilir. Denememizde sağlayıcı kararını bu parametreye göre verdi; belgenin içindeki etiket tek başına belirleyici olmadı.
Sanal kutu etiketi dokümanda farklı yazılıyor, hangisi geçerli?
Sağlayıcının hata açıklamasında iki farklı yazım görünür. Denememizde GİB'in ortak sanal kutusu için bizim kullandığımız etiket kabul edildi, dokümandaki yazım ise reddedildi. Sağlayıcı başına ölçmek bu yüzden şarttır.
STEQAR bu sorguyu Nilvera üzerinden şimdi yapıyor mu?
Henüz değil. Sorgu davranışı sağlayıcı tarafında ölçüldü; STEQAR'ın Nilvera bağlantısı hazırlık aşamasındadır.
STEQAR, SCP Bilişim ve Otomasyon Sistemleri'nin geliştirdiği kantar programıdır; Türkiye genelinde uzaktan kurulum ve destek verir.