ApivomApivom
Demo Alın

AB KDV Doğrulama API (VIES SOAP)

Avrupa Komisyonu'nun özgün VIES SOAP web servisleri — checkVat, nitelikli kontroller ve checkStatus — SOAP sözleşmesinde kalması gereken sistemler için Apivom Atlas geçidinde JSON rotaları olarak sarmalanmıştır.

Neler yapabilirsiniz

  • checkVatService: herhangi bir AB KDV numarası için geçerlilik, ad ve adres; REST API ile aynı veri
  • Talep eden KDV numaranızla nitelikli kontroller denetim kanıtı için danışma numarası döndürür
  • checkStatusService: her üye ülke veritabanının erişilebilirliği
  • Entegrasyon testleri için ayrılmış numaralı test servisi ucu
  • SOAP zarfları Apivom Atlas tarafından oluşturulur ve ayrıştırılır — sistemleriniz düz JSON gönderir ve alır

Kullanım senaryoları

  • Eski ERP uyumluluğu — VIES SOAP sözleşmesine göre sertifikalanmış vergi motorlarını ve ERP bağlayıcılarını çalışır tutun; taşıma, yeniden deneme ve kaydı Apivom Atlas'a taşıyın.
  • Yedek doğrulama — REST ucu yavaşladığında SOAP rotasını ikincil yol olarak kullanın; ikisi de aynı ulusal sicillere ulaşır.

REST API'den önce VIES yalnızca SOAP web servisi olarak sunuluyordu ve birçok ERP ve vergi motoru hâlâ SOAP sözleşmesini kullanır. Apivom Atlas üç SOAP servisini — checkVatService, checkVatTestService ve checkStatusService — JSON alıp döndüren geçit rotaları olarak kaydeder; SOAP zarfını Atlas oluşturur, ec.europa.eu'yu çağırır ve yanıtı ayrıştırır. Sonuç REST rotasıyla aynıdır: geçerlilik, üye ülkenin yayımladığı ölçüde tacir adı ve adresi, istek tarihi ve nitelikli kontrollerde danışma numarası. Aşağı akış bir sistem veya mevcut bir sertifikasyon SOAP yanıt alanlarına bağlıysa bu varyantı seçin; aksi halde VIES REST entegrasyonunu kullanın.

Kimlik doğrulama

Tanımlı Apivom kiracıları için Atlas geçidi üzerinden kullanılabilir (Apivom Iris bu yolu kullanır); Atlas portalında henüz self-servis değildir. Kiracınız için etkinleştirmek üzere bize ulaşın.

Sık sorulan sorular

SOAP mu REST VIES entegrasyonu mu kullanmalıyım?

Mevcut bir sistem SOAP yanıt yapısına bağlı değilse REST kullanın. İkisi de aynı üye ülke veritabanlarından aynı geçerlilik, ad, adres ve danışma verisini döndürür.

SOAP zarflarını kendim mi oluşturmalıyım?

Hayır. Apivom Atlas ülke kodu, KDV numarası ve isteğe bağlı talep eden alanlarını içeren JSON gövdeyi kabul eder, SOAP isteğini oluşturur ve ayrıştırılmış JSON yanıtı döndürür.

Bu API'yi Atlas portalından self-servis satın alabilir miyim?

Henüz değil. Bu kaynak, tanımlı kiracılar için Atlas geçidinde ve Apivom Iris içinde çalışır; sorgu başına portal fiyatı yayımlanmadı. Erişim talep edin, kiracınız için kayıt ve kota görünürlüğüyle etkinleştirelim.

Diğer Atlas entegrasyonları

AI entegrasyon rehberi (llms.txt)

Makine tarafından okunabilir markdown — AI asistanınıza entegrasyon talimatı olarak verin.