VKN Doğrulayıcı
10 HaneVKN doğrulayıcı: algoritma kurallarını kontrol eden ücretsiz web aracı.
Yardımcı Blog Yazıları
Tümünü görToplu VKN Doğrulama
Yüzlerce VKN numarasını tek seferde doğrulayın. Liste yapıştırın, sonuçları CSV olarak indirin.
VKN Doğrulayıcı Nasıl Çalışır?
VKN doğrulayıcı, format ve kontrol hanesi algoritmasını otomatik kontrol eder. VKN doğrulayıcı yalnızca format kontrolü yapar; gerçek kişi/kurum teyidi yapmaz.
- Uzunluk 10 hane.
- i=0..8 için
tmp = (A[i] + (9 − i)) mod 10 - Kontrol hanesi:
(10 − (sum mod 10)) mod 10
Araç yalnızca format doğrular; gerçek kişi/kurum teyidi yapmaz.
VKN Doğrulayıcı Kimler İçin?
- Yazılım geliştiriciler için: VKN doğrulayıcı ile istemci tarafı format kontrolü.
- QA ekipleri için: VKN doğrulayıcı ile test verisi geçerlilik kontrolü.
- Backend geliştiriciler için: VKN doğrulayıcı ile sunucu öncesi ön kontrol.
- Veri analistleri için: VKN doğrulayıcı ile veri kalitesi kontrolü.
VKN Doğrulayıcı: e-Fatura XML'i GİB'e göndermeden önce format sigortası
VKN doğrulayıcı, e-Fatura ve e-Arşiv XML zarflarındaki vergi kimlik numarasını GİB kapısına ulaşmadan önce denetleyen bir ön kontrol katmanıdır. Finans, muhasebe ve ERP ekipleri için amaç basit: UBL-TR şemasında gizlenmiş tek bir hane hatasının 509 No'lu VUK tebliği kapsamında reddedilmiş fatura olarak arşivlenmesini engellemek. Araç yalnızca format doğrular; GİB kayıtlarında mükellef aktif mi, e-fatura kullanıcısı mı sorgulamaz.
Hangi senaryolarda kullanılmalı?
- UBL-TR 1.2 zarfı imzalanmadan önce
AccountingSupplierPartyveAccountingCustomerPartyVKN alanlarının sağlaması. - Ticari hayattan senet/irsaliye kaynaklı XML dönüşümlerinde alan bozulmasını tespit.
- Outbox pattern uygulayan e-fatura gönderim kuyruğunda retry öncesi son kontrol.
- Entegratör değiştirirken legacy XML arşivinin geçerlilik taraması.
UBL-TR zarfında VKN nerede geçer?
Fatura zarfında satıcı için cac:AccountingSupplierParty/cac:Party/cac:PartyIdentification/cbc:ID alanı schemeID="VKN" niteliğiyle bulunur; alıcı için aynı yapı AccountingCustomerParty altında tekrarlanır. Doğrulayıcı önce schemeID değerinin VKN mi TCKN mi olduğunu ayırır, ardından 10 haneli VKN için checksum algoritmasını çalıştırır: her d[i] için t[i] = (d[i] + 9 − i) mod 10, ardından toplamın mod 10 tamamlayıcısı 10. haneyle eşleşmelidir. Bu eşleşmezse GİB 1190 hata kodu üretir.
Sık karşılaşılan tuzak: baştaki sıfırın kaybolması
Excel üzerinden hazırlanan müşteri listelerinde 0123456789 biçimindeki VKN, hücre sayısal formatlandığında 123456789 olarak XML'e düşer. Dokuz haneli bir değer UBL-TR şemasına göre sentaks olarak geçerli görünebilir ancak checksum başarısız olur. Aynı tuzak CSV'den SAP IDoc dönüşümünde de görülür; bu nedenle doğrulayıcı hane sayısını ve baştaki sıfırları açıkça raporlar.
Kod entegrasyonu / İleri adımlar
E-fatura pipeline'ına gömmek için Node.js kütüphanemiz ve Java kütüphanemiz VKN doğrulamasını tek çağrıda sunar; SQL tarafında arşiv taraması için SQL örneklerine göz atın. VKN'nin hukuki tanımı ve mükellefiyet tipleri için VKN Nedir rehberine, tebliğ 509 uygulama rehberi için genel rehber sayfasına bakabilirsiniz.
Sık Sorulan Sorular
İlgili VKN Araçları
Son güncelleme: