ApivomApivom
Demo Alın

AB KDV Doğrulama API

Resmi AB VIES servisinin üzerine yazılmış, üretim için hazır ücretsiz REST sarmalayıcı. Tek HTTP çağrısıyla herhangi bir AB KDV numarasını doğrulayın — JSON yanıtlar, edge önbellek, makul hız sınırları ve KVKK/GDPR uyumlu denetim kayıtları.

Genel API · ücretsiz katman

Resmi VIES kaynağı

ec.europa.eu/taxation_customs/vies tarafından desteklenir — AB'nin yetkili kaydı. 24 saatlik şeffaf edge önbelleği gecikmeyi azaltır.

SOAP değil JSON

VIES SOAP sunar; biz temiz REST + JSON ile sararız, böylece WSDL ile uğraşmak yerine dakikalar içinde entegre edebilirsiniz.

Hız sınırlı & anonim

Anonim katman: 3 sorgu/IP/gün. E-postanızı doğrulayın → 5 doğrulama/IP/gün. Daha yüksek katmanlar partnerler için mevcuttur.

KVKK/GDPR uyumlu

IP adresleri kayıttan önce SHA-256 ile hashlenir. Anonim akışta kalıcı kişisel veri yoktur.

Sahada kanıtlanmış

Üretimdeki müşteriye dönük /tools/eu-business-lookup aracını besler. Aynı kod yolu, aynı çalışma süresi garantileri.

Deneme için kayıt gerekmez

Değerlendirmek için doğrudan genel uç noktayı kullanın. Daha yüksek limit veya webhook için partner katmanı için bizimle iletişime geçin.

Uç noktalar

Tüm uç noktalar JSON kabul eder ve JSON döner. Hatalar RFC 7807 (problem+json) standardına uyar.

Temel URL: https://atlas.apivom.com

POST/eu-vat/lookup

Bir ülke + KDV numarasını doğrular. Anonim katmanda maskelenmiş şirket verisi döner.

POST/eu-vat/verify

Çift onay akışından gelen e-posta token'ını doğrular. Tam maskesiz kaydı açar.

POST/eu-vat/resend

Kullanıcı e-postayı kaybederse onay e-postasını yeniden gönderir. Aynı günlük IP limitine tabidir.

Hızlı başlangıç

Sıfırdan ilk doğrulanmış KDV numaranıza üç adım.

  1. Uç nokta listesini inceleyin

    Tüm uç noktalar yöntem ve yollarıyla yukarıda listelenir. Aşağıdaki curl örneği eksiksiz bir isteği gösterir.

  2. Bir lookup isteği gönderin

    /eu-vat/lookup uç noktasına country_code + vat_number POST edin. Anında maskeli sonuç + lookup ID alın.

  3. Maskeyi kaldırmak için e-postayı doğrulayın

    İsteğe bağlı çift onay: kullanıcı e-postasını yakalayın, onay gönderin, sonra token ile /eu-vat/verify çağırın — tam şirket verisi açılır.

curl -X POST 'https://atlas.apivom.com/eu-vat/lookup' \
  -H 'Content-Type: application/json' \
  -d '{ "country_code": "IE", "vat_number": "3515583EH" }'

Sıkça sorulan sorular.

Bu gerçekten ücretsiz mi?

Evet — anonim katman günlük kullanım için ücretsizdir (IP başına günde 3 sorgu). Yüksek hacimler için talep üzerine API anahtarlı partner uç noktaları mevcuttur.

Veriler ne kadar günceldir?

VIES gerçek zamanlı sorgulanır; başarılı yanıtlar hem uygulamanızı hem de yukarı yöndeki servisi korumak için edge'de 24 saat önbelleğe alınır.

Kontrol ettiğim KDV numaralarını saklıyor musunuz?

Doğrulanan sorguları (ülke kodu, KDV no, geçerlilik, zaman damgası) denetim amaçlı saklarız. IP'ler kayıttan önce hashlenir. Anonim çağrılar için kişisel veri saklamayız.

Şirket adı neden maskeli?

Kayıt otomasyonlu sıyırma (scraping) saldırılarını önlemek için anonim yanıtlarda ad ve adres kısmen maskelenir. Tam kaydı almak için e-postanızı doğrulayın.

VIES çalışmazsa ne olur?

Açık bir hata ile 503 alırsınız. Yukarı yöndeki servise ulaşılamadığında veri uydurmayız.

Partner anahtarı alabilir miyim?

Evet. İletişim sayfasından bize ulaşın ve beklenen hacim + entegrasyon kullanım senaryonuzu paylaşın.