Intégrer le contrôle d’un numéro de TVA via VIES à l’entrée en relation des entreprises
Vendredi, vous examinez les refus de demandes de financement de petites entreprises quand plusieurs dossiers allemands apparaissent à la suite, tous marqués « Numéro de TVA non enregistré ». L’un des dirigeants a déjà appelé. Il explique que son numéro figure sur toutes les factures de l’entreprise et demande pourquoi sa demande a été bloquée. Vous avez ajouté le contrôle du numéro de TVA le mois dernier, après qu’un courtier a déposé une demande avec le numéro d’une autre entreprise. Le même motif apparaît maintenant pour des entreprises aux situations très différentes, et les demandes de lundi approchent. Que doit signifier cette réponse avant de déclencher une décision ?
VIES ne répond pas seulement par valide ou invalide
Une réponse VIES peut indiquer le statut d’enregistrement, fournir un nom enregistré ou signaler une erreur du registre. Le service VIES de la Commission européenne confirme si un numéro de TVA est enregistré, et la réponse peut inclure le nom enregistré. Lors de nos appels depuis notre machine, le 30 octobre 2026, nous avons vu des numéros enregistrés avec un nom, des numéros enregistrés dont le nom n’était pas communiqué, des numéros non enregistrés et des erreurs du registre.
Un numéro allemand était valide, mais le nom apparaissait sous la forme « --- ». Deux minutes plus tard, la réponse était MS_UNAVAILABLE. Une règle qui ne lit que valid accepterait la première réponse sans disposer d’un nom à comparer. Si une valeur valid absente est traitée comme invalide, un problème temporaire du registre peut entraîner un refus.
| réponse | exemple | statut HTTP | valid | nom enregistré | Règle : valid seul |
|---|---|---|---|---|---|
| enregistré, nom communiqué | IE6388047V | 200 | true | GOOGLE IRELAND LIMITED | passe |
| enregistré, nom non communiqué | DE811569869, ESB82846825 | 200 | true | --- | passe, rien à comparer |
| non enregistré | IE1234567X | 200 | false | --- | refuse |
| registre sans réponse, REST | DE811569869 | 200 | absent | absent, erreur MS_UNAVAILABLE | ne trouve pas valid |
| registre sans réponse, SOAP | DE811569869 | 200 | absent | erreur MS_UNAVAILABLE | ne trouve pas valid |
| registre occupé, interface web | LV40003009497 | 200 | false | ---, erreur MS_MAX_CONCURRENT_REQ | refuse |
Le type de réponse compte. Le statut d’enregistrement indique si le numéro figure dans la base de données nationale. Le nom peut aider à vérifier si le demandeur est bien l’entreprise enregistrée.
La page de statut ne classe pas chaque réponse
Classez chaque appel à partir de sa réponse. La page de statut sert uniquement de contexte. Lors de nos appels, l’interface web a renvoyé isValid à false avec MS_MAX_CONCURRENT_REQ pour un registre occupé. Pris seul, ce résultat fait passer un problème de registre pour un numéro non enregistré.
L’interface web utilise le point d’accès de la page VIES. Le contrat REST publié décrit une interface distincte. La page de statut contredisait également nos appels dans les deux sens : elle indiquait que l’Allemagne était disponible pendant que les appels allemands renvoyaient MS_UNAVAILABLE, et que la Lettonie était indisponible alors que les numéros lettons renvoyaient des réponses valides avec des noms.
La Commission précise que VIES récupère les informations dans les bases de données des États membres, sur lesquelles elle n’a aucun contrôle. La disponibilité peut varier selon le registre et l’appel.
Traitez les erreurs du service avant le statut d’enregistrement
Transmettez le code pays et le numéro de TVA de la demande à un service VIES publié, puis prévoyez une issue distincte pour les erreurs du service. Les interfaces publiées sont REST et SOAP. REST propose POST /check-vat-number, et SOAP propose checkVat. Aucune des deux interfaces ne nécessite de clé ni de compte.
Dans une source de données, transmettez le code pays et le numéro de la demande par le flux de décision. La source de données ajoute la réponse aux données de la décision, où les règles peuvent la classer. Recherchez d’abord une erreur, puis lisez valid : lors de nos appels allemands, REST a renvoyé le statut HTTP 200 avec MS_UNAVAILABLE et sans champ valid. Le paramètre de nouvelle tentative documenté pour REST couvre les problèmes de connexion et certains statuts HTTP. Il ne couvre pas les réponses HTTP 200 avec MS_UNAVAILABLE, que le flux de décision doit traiter.
Par exemple, une réponse d’erreur peut mener à une orientation vers un examen ou à une nouvelle tentative ultérieure. Si valid vaut false, le numéro n’est pas enregistré. Si valid vaut true, il l’est. Testez chaque branche et vérifiez qu’elle mène à la décision prévue avant le déploiement de l’intégration.
Vérifiez séparément le nom enregistré
Un numéro valide peut appartenir à une autre entreprise. Comparez le nom enregistré avec la raison sociale indiquée dans la demande, et créez deux valeurs distinctes pour la table de décision : le statut d’enregistrement et la vérification du nom.
Nos appels vers l’Allemagne et l’Espagne ont renvoyé des numéros valides, mais le nom et l’adresse apparaissaient sous la forme « --- ». Les valeurs de correspondance du nom étaient NOT_PROCESSED, donc aucun nom ne pouvait être comparé. Classez « --- » comme un nom non communiqué.
À titre d’exemple, la vérification du nom peut renvoyer « correspondance » si le nom reçu contient celui de l’entreprise figurant dans la demande, « non communiqué » si le nom est vide ou vaut « --- », et « différence » s’il ne correspond pas. Une différence doit être examinée par une personne. Si VIES ne communique pas le nom, recherchez la raison sociale dans le registre des entreprises concerné. Pour une demande britannique, la recherche dans Companies House est un exemple de vérification dans un registre.
| statut TVA | vérification du nom | décision | motif |
|---|---|---|---|
| indisponible | tous | refer | VAT_CHECK_UNAVAILABLE |
| invalide | tous | decline | VAT_NOT_REGISTERED |
| valide | différence | refer | VAT_NAME_MISMATCH |
| valide | non communiqué | refer | VAT_NAME_NOT_DISCLOSED |
| valide | correspondance | pass | OK |
Une différence doit être examinée par une personne. Si le nom n’est pas communiqué, recherchez-le dans le registre des entreprises concerné. VIES est une source d’information parmi d’autres pour le financement des PME.
Vérifiez les conditions avant de mettre une réponse en cache
Avant d’activer un cache, demandez à un juriste d’examiner les conditions de VIES au regard de l’usage prévu. Elles restreignent la retransmission et les autres usages, et interdisent expressément la copie ou la reproduction du contenu. Demandez à un juriste de confirmer que l’intégration et les choix de stockage envisagés sont autorisés.
Un autre risque est d’ordre technique. La documentation sur la mise en cache des sources de données décrit le stockage des réponses analysables dont le statut HTTP est inférieur à 400. Une réponse REST avec un statut HTTP 200 et un corps analysable peut donc stocker une erreur comme MS_UNAVAILABLE au même titre qu’une réponse ordinaire.
Prévoyez les issues avant l’arrivée des demandes de lundi
Avant l’arrivée des demandes de lundi, définissez les issues possibles pour le contrôle :
- Appelez le contrat REST publié ou le service SOAP avec le code pays et le numéro de TVA de la demande. La page web VIES utilise un point d’accès distinct.
- Recherchez une erreur avant de lire
valid. Orientez une erreur vers une issue distincte, par exemple un examen ou une nouvelle tentative ultérieure. Réservez le refus au cas où le numéro est confirmé comme non enregistré. - Effectuez l’appel et lisez sa réponse. Appuyez-vous sur la réponse de chaque appel pour déterminer s’il a abouti. La page de statut donne un aperçu de la disponibilité du service.
- Comparez le nom enregistré avec celui de l’entreprise figurant dans la demande. Prévoyez une issue distincte, à examiner par une personne, si un numéro valide est associé à un autre nom.
- Classez « --- » comme un nom non communiqué. Vérifiez le nom dans le registre des entreprises concerné.
- Avant de mettre en cache les réponses VIES obtenues par REST, demandez à un juriste d’examiner les conditions et de valider l’usage prévu. Tenez compte des réponses d’erreur HTTP 200 qu’un cache pourrait stocker comme des réponses ordinaires.
- Conservez la réponse de validation avec la décision, selon les modalités approuvées par le juriste, conformément à la recommandation de la Commission en cas de contrôle fiscal.
Questions fréquentes sur le contrôle VIES
Existe-t-il une API gratuite pour vérifier un numéro de TVA européen ?
Nos appels n’ont nécessité ni clé ni compte. La Commission ne publie aucun tarif pour le service. Vérifiez les conditions d’utilisation.
Que signifie MS_UNAVAILABLE et quelle décision prendre ?
MS_UNAVAILABLE signifie que le service de l’État membre ne répond pas ou n’est pas disponible. Lors de nos appels allemands, l’erreur était accompagnée du statut HTTP 200. Orientez-la vers une issue distincte, par exemple un examen ou une nouvelle tentative ultérieure, plutôt que vers un refus.
Un résultat VIES valide prouve-t-il l’identité de l’entreprise ?
Non. Un numéro valide peut appartenir à une autre entreprise. Comparez le nom enregistré avec celui de l’entreprise figurant dans la demande, et faites examiner toute différence par une personne.
VIES propose-t-il REST ou SOAP ? Quelle interface choisir ?
VIES publie des interfaces REST et SOAP. Choisissez le contrat publié pris en charge par votre intégration, puis testez la façon dont ses erreurs sont traitées dans le flux de décision.
Peut-on stocker et réutiliser les réponses VIES ?
Uniquement après examen des conditions par un juriste et validation de l’usage prévu. Les conditions restreignent la retransmission et les autres usages, et interdisent la copie ou la reproduction du contenu. Déterminez avec un juriste quel enregistrement de validation l’usage prévu autorise avant de stocker ou de réutiliser une réponse.
Combien de temps prend un appel VIES ?
Lors de nos appels du 30 octobre 2026, la plupart des réponses ont pris entre 0,4 et 0,8 seconde, et certaines ont été plus longues. Ces mesures proviennent d’un seul après-midi et ne constituent pas une garantie de service. Prévoyez une issue distincte pour les appels retardés ou en échec.