ApivomApivom
Demander une démo

API de validation des numéros EORI (UE)

Validez les numéros EORI (Economic Operators Registration and Identification) dans le registre douanier de la Commission européenne (DG TAXUD) via une passerelle REST tarifée : envoyez l'enveloppe SOAP comme chaîne JSON et recevez validité, nom et adresse lorsque l'État membre les publie — jusqu'à 10 numéros par appel.

Disponible via Apivom Atlas1 routes d’API · 0 lecture seule

Ce que vous pouvez faire

  • Vérifie un numéro EORI dans le système des opérateurs économiques de l'UE en direct et renvoie le statut 0 (valide) ou 1 (non valide)
  • Renvoie le nom et l'adresse de l'opérateur lorsque l'État membre émetteur a consenti à leur publication
  • Jusqu'à 10 numéros EORI par requête ; limite publiée par la DG TAXUD : 100 requêtes par seconde
  • Opération SOAP 1.1 validateEORI encapsulée dans un corps JSON — mêmes x-api-key, solde et journalisation que toute autre source Apivom Atlas
  • Clé API par tenant, cache serveur pour les vérifications répétées, journal complet requête/réponse dans le portail Atlas

Cas d'usage

  • Des déclarations en douane acceptées du premier coup — Validez les numéros EORI de l'expéditeur et du destinataire pendant la réservation de l'envoi, pour que la déclaration ne soit pas rejetée à la frontière pour un numéro invalide ou expiré.
  • Onboarding des exportateurs et importateurs — Vérifiez l'EORI fourni par un nouveau client et conservez le nom et l'adresse renvoyés à côté de son résultat TVA VIES dans votre dossier KYB.
  • Conformité des places de marché et 3PL — Revalidez périodiquement les numéros EORI des vendeurs qui expédient à l'international et signalez ceux qui cessent d'être valides avant qu'un colis ne soit bloqué.
  • Nettoyage en masse des données partenaires — Passez vos fiches partenaires existantes dans le service dix numéros à la fois et corrigez ou retirez les EORI périmés de votre ERP.

Toute entreprise qui dépose une déclaration en douane dans l'Union européenne a besoin d'un numéro EORI, et transitaires, commissionnaires en douane, places de marché et exportateurs doivent savoir que le numéro d'un partenaire est réel avant que la marchandise ne bouge. Le service de validation EORI de la Commission européenne (DG TAXUD) répond à cette question, mais uniquement en SOAP. Apivom Atlas l'expose comme route de passerelle tarifée : vous postez l'enveloppe SOAP 1.1 de l'opération validateEORI comme chaîne rawBody dans une requête JSON, Atlas la transmet telle quelle à ec.europa.eu avec le bon type de contenu et un SOAPAction vide, et la réponse XML revient avec la date de la requête et, par numéro, l'EORI, un code et un libellé de statut, ainsi que le nom et l'adresse de l'opérateur lorsque l'État membre les publie. Une enveloppe accepte jusqu'à 10 numéros. Chaque appel réussi débite le prix de la route de votre solde prépayé ; une validation identique répétée est servie gratuitement depuis le cache, et chaque requête et réponse est journalisée dans votre portail Atlas — une seule clé aux côtés de la validation TVA VIES et des registres d'entreprises nationaux.

Exemple de code

Remplacez YOUR_KEY par la clé API délivrée dans Apivom Atlas et exécutez la commande depuis votre backend.

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>"}'
Authentification

Clé API par tenant (en-tête x-api-key) émise dans Apivom Atlas. Aucun compte ni identifiant amont n'est requis — la source publique est appelée côté serveur ; solde prépayé, prix à la requête.

Questions fréquentes

Pourquoi le corps de la requête est-il du XML dans du JSON ?

La DG TAXUD ne propose la validation EORI qu'en service web SOAP. Atlas garde une seule convention d'appel pour toutes les sources — POST JSON avec votre x-api-key — l'enveloppe SOAP voyage donc dans la chaîne rawBody et est transmise exactement telle que vous l'envoyez. Les éléments eori doivent être qualifiés par l'espace de noms http://eori.ws.eos.dds.s/, comme dans l'exemple.

Que signifient les statuts 0 et 1, et pourquoi l'adresse est-elle parfois vide ?

Le statut 0 signifie valide, le statut 1 non valide, chacun avec un libellé statusDescr. Nom et adresse ne sont renvoyés que si l'État membre émetteur autorise leur publication ; un numéro valide sans nom ni adresse reste valide.

Puis-je aussi vérifier un numéro de TVA avec cette API ?

Non — EORI et TVA sont des registres distincts. Utilisez la source VIES d'Apivom Atlas pour les numéros de TVA intracommunautaire ; de nombreux clients appellent les deux pour le même partenaire lors de l'onboarding.

Comment l'API est-elle facturée ?

En prépayé et à la requête : vous créditez un solde dans Apivom Atlas et chaque requête réussie débite le prix de la route affiché. Les requêtes identiques répétées sont servies gratuitement depuis le cache serveur ("cached": true dans la réponse) ; ajoutez ?force=true pour rafraîchir au prix de la route. Un HTTP 402 signifie que le solde doit être rechargé.

Comment s'authentifier et où suivre ma consommation ?

Chaque requête porte la clé API de votre tenant dans l'en-tête x-api-key ; les clés sont émises et renouvelées dans Apivom Atlas. Le portail journalise chaque requête avec la charge utile complète, pour une piste d'audit partagée entre finance et ingénierie.

Autres intégrations Atlas

Guide d’intégration pour l’IA (llms.txt)

Markdown lisible par machine : donnez-le à votre assistant IA comme instructions d’intégration.

Guide d’intégration pour l’IA (llms.txt)Demander un accès