TaxID, AB'nin VIES KDV doğrulama servisini bir JSON REST API içinde sunuyor

Ne sunuldu

dev.to üzerinde duyurulan TaxID adlı servis, Avrupa Birliği KDV numaralarını gerçek zamanlı olarak doğrulayan bir REST API olarak tanıtıldı. Geliştiricilerin Avrupa Komisyonu'nun VIES servisiyle doğrudan iletişim kurmasını istemek yerine TaxID bir sarmalayıcı (wrapper) olarak çalışıyor: VIES kontrollerini bir JSON endpoint üzerinden sunuyor ve genellikle devlet sistemiyle birlikte gelen zorlukları — SOAP protokolü, XML payload'ları ve dalgalı kullanılabilirlik — üstleniyor.

Güvenilirlik sorunu

dev.to duyurusuna göre asıl motivasyon, doğrulama mantığının kendisinden çok güvenilirlik. VIES, AB üye devletlerindeki KDV numaraları için yetkili kaynaktır; ancak kullanılabilirliği dalgalanan yaşlanan bir SOAP endpoint'tir ve üye devletler bağımsız olarak devre dışı kalabilir. Onunla doğrudan entegle olan ekipler, XML ayrıştırma kodu bakımı yapmakta, tutarsız hata yanıtlarını çözmekte ve kendi yeniden deneme ile önbellekleme katmanlarını kurmaktadır.

TaxID bu yükü tek bir JSON çağrısının arkasına taşıyor. Yanıtlar tiplidir ve açık bir service_unavailable durumu içerir; böylece bir ödeme akışı, gerçekten geçersiz bir KDV numarası ile o anda erişilemeyen bir üye devlet kaydı arasındaki farkı anlayabilir ve işlemi başarısız kılmak yerine buna uygun şekilde yanıt verebilir.

API neleri kapsıyor

Duyuru çeşitli yetenekler listeliyor:

• Tüm AB üye devletleri için VIES üzerinden gerçek zamanlı KDV numarası doğrulama.
• Doğrulanan bir numara için, ilgili üye devlet bu veriyi sağlıyorsa şirket adı ve adres bilgileri.
• Ülkeye ve kategoriye göre AB KDV oranlarının sorgulanması.
• Geçersiz bir numarayı geçici olarak erişilemeyen bir üye devletten ayıran yapılandırılmış hata yönetimi.
• Ülke bazında VIES kullanılabilirliğini gösteren herkese açık bir durum sayfası.

Entegrasyon ve hedef kullanıcılar

Entegrasyon bilinçli olarak ince tutulmuş: bir API anahtarıyla kimlik doğrulaması yapın, bir KDV numarası gönderin, yapılandırılmış bir JSON yanıtı alın. Kurulacak bir SDK ya da yapılandırılacak bir SOAP client yok. Kullanıma hazır istek örnekleriyle birlikte belgeler taxid.dev adresinde yayımlandı.

Hedef kitle, AB'de B2B işlemleri yürüten mühendislik ekipleri; bu işlemlerde tahsil edilen KDV tutarı, müşterinin KDV numarasının gerçekten kayıtlı olup olmamasına bağlıdır. Duyuru, reverse-charge kuralları genellikle verginin muaf tutulabilmesi için doğrulanmış bir KDV numarası gerektirdiğinden Stripe'ı doğal bir yardımcı olarak öne çıkarıyor; ayrıca özel faturalandırma sistemleri, ERP entegrasyonları ve iç uyumluluk araçlarını olası kullanım alanları olarak gösteriyor.

Neden önemli

AB'ye B2B satış yapan herkes için KDV doğrulaması bir kolaylık değil, bir uyumluluk gereksinimidir. Doğrulanmamış bir numaraya dayanarak KDV'yi muaf tutmak bir uyumluluk riskidir; ancak onu doğrulamanın tek yetkili yolu olan VIES, sorunlu çıkmasıyla bilinen bir SOAP servisi. Yeniden denemeler, önbellekleme ve en önemlisi "bu numara geçersiz" ile "kayıt servisi çalışmıyor" arasındaki dürüst bir ayrım ekleyen bir sarmalayıcı, bir üye devletin endpoint'i sorun çıkardığında bile ekiplerin ödeme ve faturalandırmayı çalışır tutmasını sağlıyor.

Belirtilmesi gereken iki nokta var. Duyuru fiyatlandırmayı kapsamıyor; dolayısıyla büyük ölçekte maliyet belirsiz. Ayrıca TaxID bir devlet servisinin üzerine kurulmuş üçüncü taraf bir katman olduğundan, onu benimseyen ekipler faturalandırma akışları ile özel bir aracı arasında bir bağımlılık eklemiş oluyor; bu takasın değeri, aracının sarmaladığı sistemden daha güvenilir kalmasına bağlı.