ApivomApivom
Demo Alın

AB EORI Numarası Doğrulama API

Ekonomik Operatör Kayıt ve Kimlik (EORI) numaralarını Avrupa Komisyonu'nun gümrük sicilinde (DG TAXUD) fiyatlandırılmış bir REST geçidi üzerinden doğrulayın: SOAP zarfını JSON dizesi olarak gönderin; geçerlilik ile üye devletin yayımladığı durumlarda ad ve adres dönsün — çağrı başına 10 numaraya kadar.

Neler yapabilirsiniz

  • Bir EORI numarasını AB'nin canlı Ekonomik Operatör Sistemi'nde kontrol eder; durum 0 (geçerli) veya 1 (geçersiz) döner
  • Veren üye devlet yayımlamaya izin verdiğinde operatörün adını ve adresini döndürür
  • Tek istekte 10 EORI numarasına kadar; DG TAXUD'un yayımlanmış sınırı saniyede 100 istek
  • SOAP 1.1 validateEORI işlemi JSON gövdeye sarılı — diğer tüm Apivom Atlas kaynaklarıyla aynı x-api-key, bakiye ve kayıt
  • Kiracıya özel API anahtarı, tekrarlanan kontroller için sunucu tarafı önbellek, Atlas portalında tam istek/yanıt günlüğü

Kullanım senaryoları

  • İlk seferde geçen gümrük beyannameleri — Gönderici ve alıcının EORI numaralarını sevkiyat rezerve edilirken doğrulayın; beyanname geçersiz veya süresi dolmuş bir numara yüzünden sınırda reddedilmesin.
  • İhracatçı ve ithalatçı onboarding'i — Yeni müşterinin verdiği EORI'yi kontrol edin; dönen ad ve adresi KYB'nin parçası olarak VIES KDV sonucunun yanında saklayın.
  • Pazar yeri ve 3PL uyumu — Sınır ötesi gönderi yapan satıcıların EORI numaralarını zamanlanmış olarak yeniden doğrulayın; doğrulanmayanları koli alıkonulmadan işaretleyin.
  • Ticari ana verinin toplu temizliği — Mevcut iş ortağı kayıtlarını onar onar servisten geçirin; ERP'nizdeki bayat EORI numaralarını düzeltin ya da emekliye ayırın.

Avrupa Birliği'nde gümrük beyannamesi veren her işletmenin bir EORI numarası vardır; nakliye komisyoncuları, gümrük müşavirleri, pazar yerleri ve ihracatçılar mal hareket etmeden önce bir iş ortağının numarasının gerçek olduğunu bilmek ister. Avrupa Komisyonu'nun EORI doğrulama servisi (DG TAXUD) bu soruyu yanıtlar, ancak yalnızca SOAP üzerinden. Apivom Atlas bunu fiyatlandırılmış bir geçit rotası olarak sunar: validateEORI işleminin SOAP 1.1 zarfını JSON isteğin içinde rawBody dizesi olarak gönderirsiniz; Atlas doğru içerik türü ve boş SOAPAction ile ec.europa.eu'ya olduğu gibi iletir; XML yanıt istek tarihi ve her numara için EORI, durum kodu ve açıklaması ile üye devlet yayımlıyorsa operatörün adı ve adresiyle döner. Bir zarfa 10 numaraya kadar sığar. Her başarılı çağrı rota fiyatını ön ödemeli bakiyenizden düşer; aynı doğrulamanın tekrarı önbellekten ücretsiz döner ve her istek ile yanıt Atlas portalınızda kaydedilir — VIES KDV doğrulaması ve ulusal şirket sicilleriyle aynı anahtar.

Kod örneği

YOUR_KEY yerine Apivom Atlas'ta verilen API anahtarınızı yazın ve sunucu tarafınızdan çalıştırın.

curl -X POST https://atlas.apivom.com/eu-eori-soap/api/v1/query/validate-eori \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rawBody":"<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\"><soapenv:Body><eor:validateEORI xmlns:eor=\"http://eori.ws.eos.dds.s/\"><eor:eori>DE123456789012345</eor:eori></eor:validateEORI></soapenv:Body></soapenv:Envelope>"}'
Kimlik doğrulama

Apivom Atlas'ta verilen kiracıya özel API anahtarı (x-api-key başlığı). Kaynak tarafında hesap veya kimlik bilgisi gerekmez — açık kaynak sunucu tarafında çağrılır; ön ödemeli bakiye, sorgu başına fiyat.

Sık sorulan sorular

İstek gövdesi neden JSON içinde XML?

DG TAXUD EORI doğrulamasını yalnızca SOAP web servisi olarak sunar. Atlas her kaynak için tek bir çağrı biçimi tutar — x-api-key ile JSON POST — bu yüzden SOAP zarfı rawBody dizesi olarak taşınır ve gönderdiğiniz gibi iletilir. eori öğeleri örnekteki gibi http://eori.ws.eos.dds.s/ ad alanıyla nitelenmelidir.

Durum 0 ve 1 ne anlama gelir, adres neden bazen boş?

Durum 0 geçerli, durum 1 geçersizdir; her ikisi statusDescr metni taşır. Ad ve adres yalnızca numarayı veren üye devlet yayımlanmasına izin verdiğinde döner; adı ve adresi boş olan geçerli bir numara yine geçerlidir.

Bu API ile KDV numarası da kontrol edebilir miyim?

Hayır — EORI ve KDV farklı sicillerdir. AB KDV numaraları için Apivom Atlas VIES kaynağını kullanın; birçok müşteri onboarding sırasında aynı iş ortağı için ikisini birden çağırır.

API nasıl ücretlendirilir?

Ön ödemeli ve sorgu başına: Apivom Atlas'ta bakiye yüklersiniz, başarılı her sorgu orada gösterilen rota fiyatını bakiyeden düşer. Aynı parametrelerle tekrarlanan sorgular sunucu tarafı önbellekten ücretsiz döner (yanıtta "cached": true); ?force=true ile rota fiyatına güncel veri çekebilirsiniz. HTTP 402 bakiyenin yüklenmesi gerektiğini gösterir.

Kimlik doğrulama nasıl çalışır, kullanımımı nereden izlerim?

Her istek, x-api-key başlığında kiracı API anahtarınızı taşır; anahtarlar Apivom Atlas'ta oluşturulur ve dilediğinizde yenilenir. Portal her sorguyu tam istek/yanıt içeriğiyle kaydeder; finans ve mühendislik aynı denetim izini paylaşır.

Diğer Atlas entegrasyonları

AI entegrasyon rehberi (llms.txt)

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