Quels pays l'API de validation de TVA prend-elle en charge ?

Les 27 États membres de l’UE, plus le Royaume-Uni (préfixe GB). Chaque pays a son propre modèle de format. L'API détecte le pays à partir du préfixe à deux lettres et valide par rapport à l'expression régulière correcte pour cette juridiction.

Est-ce que cela remplace le service VIES SOAP ?

Il remplace la partie validation du format. VIES confirme si un numéro spécifique est enregistré auprès d'une autorité fiscale nationale. Cette API valide instantanément la structure et le format, sans dépendre de la disponibilité du VIES. Utilisez les deux ensemble : vérifiez d'abord le format, puis recherchez le statut d'enregistrement VIES.

Le numéro de TVA est-il conservé après validation ?

Non. Le numéro est traité en mémoire et supprimé après la réponse. Rien n'est écrit sur le disque ou sur un système externe.

Puis-je valider les numéros de TVA britanniques après le Brexit ?

Les numéros de TVA britanniques (préfixe GB) suivent un modèle connu et peuvent être structurellement validés. Ils ne font plus partie du système EU VIES, mais la vérification du format fonctionne toujours.

Que se passe-t-il si j'omets le préfixe du pays ?

L'API nécessite le préfixe du pays à deux lettres (par exemple, "DE", "FR", "NL"). Sans cela, le point de terminaison renvoie une erreur expliquant que le code du pays est manquant ou non pris en charge.

Tutorial

API de validation du numéro de TVA : vérifiez les numéros d'identification fiscale de l'UE en un seul POST

29 mars 2026 | 5 min read

Validez les numéros de TVA pour les 27 États membres de l’UE avec un seul appel API. Renvoie la validité, le code du pays et le numéro formaté. Niveau gratuit, pas de XML SOAP.

EU flags in front of the European Parliament — Photo by Olga Subach on Unsplash

Vous vendez des logiciels à des entreprises en Europe. La législation fiscale européenne vous oblige à valider la TVA de l'acheteur ID avant d'appliquer l'autoliquidation (TVA 0%). Le service VIES officiel a une disponibilité peu fiable et renvoie SOAP XML. Vous avez besoin d’une alternative plus rapide et RESTful.

Le botoï /v1/validate/vat le point de terminaison valide les numéros de TVA pour les 27 membres de l'UE États et au Royaume-Uni. Envoyez un POST, obtenez une réponse JSON avec la validité, le code du pays et le numéro formaté. Aucune analyse XML. Aucun fichier WSDL. Pas de délais d'attente en raison d'un gouvernement surchargé serveurs.

L'appel API

Envoyez un numéro de TVA avec le préfixe du pays à deux lettres :

Réponse:

La valid le champ est true lorsque le numéro correspond au format attendu pour son pays. Le country_code et country les champs vous disent à quelle juridiction appartient le numéro.

Lorsqu'un numéro échoue à la validation

Si le numéro ne correspond pas au modèle attendu, valid revient false. La réponse inclut toujours le pays détecté :

Les numéros de TVA allemands nécessitent exactement 9 chiffres après le DE préfixe. Celui-ci en a 5. Votre interface peut afficher le nom du pays et le format attendu pour aider l'utilisateur à corriger son entrée.

Intégration de la caisse Stripe

Avant de créer une session de paiement Stripe, validez le numéro de TVA de l'acheteur. Si c'est valide, définissez le client à tax_exempt: "reverse" donc Stripe facture 0% de TVA. Si c'est invalide, rejetez le formulaire et demandez à l'acheteur de le corriger.

Cela évite deux problèmes courants : facturer la TVA à une entreprise qui devrait en être exonérée. (créant un casse-tête de remboursement) et accordant une exonération fiscale à quelqu'un avec un faux numéro de TVA (créant un problème d'audit).

Génération de factures avec TVA conditionnelle

Lors de la génération d'une facture, vous devez décider du taux de TVA. Les règles :

Vente B2B dans le même pays : facturez votre taux de TVA national.
Vente B2B transfrontalière avec un numéro de TVA valide : appliquer l'autoliquidation (0 %).
Numéro de TVA invalide ou manquant : facturez le tarif local de l'acheteur.

La country_code de la réponse de l'API entraîne cette logique :

Validation du formulaire d'inscription SaaS B2B

Ajoutez un champ de numéro de TVA à votre formulaire d'inscription et validez-le lors de la soumission. Si valide, remplissez automatiquement le liste déroulante des pays. S'il n'est pas valide, affichez une erreur avant que le formulaire n'atteigne votre backend.

Cela empêche les mauvaises données de votre système de facturation. Cela évite également à votre équipe financière de devoir manuellement vérifier les numéros de TVA une fois que le client s'est déjà inscrit et a commencé à utiliser le produit.

Format TVA par pays

Chaque pays de l'UE a un format différent pour les numéros d'identification TVA. L'API valide contre tous ces modèles :

La liste complète couvre les 27 États membres de l’UE ainsi que le Royaume-Uni. Les formats vont de 8 chiffres (Danemark, Luxembourg) à 12 chiffres (Suède). Certains pays incluent des lettres dans le corps du numéro (France, Espagne, Irlande).

Validation du format vs recherche VIES

Cette API valide le structure d'un numéro de TVA. Il confirme le préfixe, la longueur, et le modèle de caractère correspond aux règles de ce pays. Il ne remet pas en question la décision de la Commission européenne Base de données VIES pour confirmer que le numéro est activement enregistré.

Pour la plupart des flux de paiement, la validation du format est la bonne première étape. Il détecte les fautes de frappe, manquant préfixes et numéros composés instantanément, sans dépendre d'un service externe souvent en baisse. Si vous avez également besoin du statut d'enregistrement, appelez VIES une fois la vérification du format réussie. Cette approche en deux étapes réduit les appels VIES de 15 à 30 % (tous les formats invalides n'atteignent jamais le service lent).

Points clés

Le niveau gratuit couvre le développement et l’utilisation en production à faible volume. Pour les caisses à fort trafic flux, ajoutez votre clé API dans le Authorization: Bearer en-tête. Vérifiez le Documents sur l'API pour la référence complète du point final et le aire de jeux interactive pour tester les numéros de TVA dans votre navigateur.

FAQ

Quels pays l'API de validation de TVA prend-elle en charge ?: Les 27 États membres de l’UE, plus le Royaume-Uni (préfixe GB). Chaque pays a son propre modèle de format. L'API détecte le pays à partir du préfixe à deux lettres et valide par rapport à l'expression régulière correcte pour cette juridiction.
Est-ce que cela remplace le service VIES SOAP ?: Il remplace la partie validation du format. VIES confirme si un numéro spécifique est enregistré auprès d'une autorité fiscale nationale. Cette API valide instantanément la structure et le format, sans dépendre de la disponibilité du VIES. Utilisez les deux ensemble : vérifiez d'abord le format, puis recherchez le statut d'enregistrement VIES.
Le numéro de TVA est-il conservé après validation ?: Non. Le numéro est traité en mémoire et supprimé après la réponse. Rien n'est écrit sur le disque ou sur un système externe.
Puis-je valider les numéros de TVA britanniques après le Brexit ?: Les numéros de TVA britanniques (préfixe GB) suivent un modèle connu et peuvent être structurellement validés. Ils ne font plus partie du système EU VIES, mais la vérification du format fonctionne toujours.
Que se passe-t-il si j'omets le préfixe du pays ?: L'API nécessite le préfixe du pays à deux lettres (par exemple, "DE", "FR", "NL"). Sans cela, le point de terminaison renvoie une erreur expliquant que le code du pays est manquant ou non pris en charge.

Commencez a construire avec botoi

150+ endpoints API pour la recherche, le traitement de texte, la generation d'images et les utilitaires pour developpeurs. Offre gratuite, sans carte bancaire.

Voir la documentation API Voir tous les outils