Guide · Onboarding

Pré-remplir un formulaire société à partir d’un numéro de TVA

Un client professionnel qui s’inscrit ne devrait saisir qu’une chose : son numéro de TVA. Le nom, la forme juridique et l’adresse sont déjà dans un registre officiel. Les lui faire retaper, c’est lui demander d’y introduire des erreurs.

Un champ saisi, le reste rempli depuis le registre.

Le bloc société

Toute inscription B2B, tout tunnel de commande, tout référencement fournisseur demande les mêmes six champs : raison sociale, forme juridique, rue, code postal, ville, numéro de TVA. Ils sont saisis par quelqu’un qui veut en avoir fini, souvent sur un téléphone.

C’est là que les formulaires B2B perdent du monde, et là que se joue la qualité de la facture, de la fiche CRM et de l’export comptable.

Ce que ça change

Un champ au lieu de six fait passer l’étape d’une minute environ à quelques secondes. Sur une inscription déjà longue, c’est la réduction d’abandon la moins chère à obtenir.

L’effet plus lent compte davantage. Quand le nom et l’adresse viennent du registre plutôt que d’un clavier, la facture part à la bonne entité juridique, et le CRM cesse de contenir quatre fois la même société parce que quelqu’un a écrit « SARL » de trois façons.

La recherche dit aussi quelque chose du numéro lui-même. Un numéro qui ne résout vers rien mérite d’être signalé avant la première facture hors taxe plutôt qu’après.

Où est la difficulté

Il n’existe pas une méthode, mais une par pays. Certains publient tout leur répertoire des entreprises en fichiers de plusieurs gigaoctets, la dénomination dans l’un et l’adresse dans l’autre. D’autres exposent leur propre service, avec son format de requête et sa façon de dire « introuvable ». Et dans quelques-uns, aucun registre ne restitue la société derrière un numéro de TVA. Obtenir le nom et l’adresse d’une entreprise reprend tout cela pays par pays.

Multipliez par le nombre de pays où vous vendez, puis ajoutez ce qui est partout pareil :

  • Le numéro de TVA est rarement le numéro d’entreprise. Parfois le même identifiant, parfois il s’en déduit, parfois aucun rapport. Il n’y a pas une règle de jointure à écrire.
  • Le nom n’est pas toujours divulgué. Quelques États membres ne publient que la validité, et le formulaire doit fonctionner quand le nom revient vide.
  • L’adresse arrive en texte libre, dans une convention différente par pays. La découper en line1 / postalCode / city est un travail à part entière.
  • La saisie est sale. Espaces, points, tirets, préfixe pays recopié ou omis, minuscules.
  • Une clé de contrôle juste ne prouve rien. Elle reste juste pour une société radiée depuis dix ans. La validation hors ligne dit que le numéro est bien formé, et s’arrête là.
  • Les sources tombent. Pas souvent, pas jamais, pas quand ça vous arrange. Un formulaire qui attend la réponse pour autoriser la soumission casse pendant la fenêtre de maintenance de quelqu’un d’autre.

Un seul appel, tous les pays

Un point d’entrée, une enveloppe, les mêmes noms de champs, quel que soit le pays du numéro. Vatlas répond de la même façon pour tous les pays qu’il couvre, et les pages pays en donnent la liste à jour.

curl "https://api.vatlas.dev/v1/lookup/FR68005420120" \
  -H "Authorization: Bearer $VATLAS_KEY"

Réponse :

200 OK

{
  "data": {
    "vatNumber": "FR68005420120",
    "countryCode": "FR",
    "nationalNumber": "68005420120",
    "nationalId": "005420120",
    "name": "SOCIETE DES SUCRERIES DU MARQUENTERRE",
    "legalForm": "Autre SA à conseil d'administration",
    "status": "active",
    "address": {
      "line1": "32 CHEMIN DES GARENNES",
      "line2": null,
      "postalCode": "80120",
      "city": "SAINT-QUENTIN-EN-TOURMONT",
      "country": "FR"
    }
  },
  "meta": {
    "source": "SIRENE",
    "sourceDate": "2026-09-01",
    "sourceSince": "2026-06-01",
    "sourceUpdatedAt": "2026-02-13T11:07:03.000Z"
  }
}

Tout ce dont le formulaire a besoin est déjà séparé : un champ de réponse par champ de formulaire, rien à parser. Le bloc meta nomme le registre qui a répondu et la date, ce que vous conservez s’il faut un jour justifier la fiche.

Concevoir le formulaire

  • Normalisez à l’entrée. Majuscules, espaces et ponctuation retirés, préfixe pays accepté présent ou absent. Une seule fois, pour que le reste du code ne voie qu’une forme.
  • Appelez depuis votre serveur. La clé d’API identifie votre compte et appartient derrière une route à vous, pas dans un bundle front. C’est aussi là que vous temporisez un champ qui se déclenche à chaque sortie de focus.
  • Remplissez et laissez modifiable. Les registres sont en retard sur la réalité, et la personne au clavier connaît sa société mieux qu’un fichier publié le mois dernier.
  • Laissez le formulaire partir dans tous les cas. Délai court, la recherche n’est qu’une assistance. Un nom vide n’est pas une erreur : dans quelques pays c’est la réponse complète.
  • Distinguez trois issues à l’écran. Rempli depuis le registre, aucune société trouvée, pas de réponse pour l’instant. La deuxième est un avertissement léger à côté du champ. La troisième est votre problème, pas celui du client.
  • Conservez ce que le registre a dit, et quand. Si l’exonération est contestée plus tard, la réponse est un enregistrement daté.

Auto-compléter n’est pas vérifier. Remplir un formulaire est un confort et peut se faire depuis une réponse déjà connue. Décider de ne pas facturer la TVA est un acte juridique, qui mérite une vérification faite à ce moment-là et dont la preuve est conservée. Faites les deux, et gardez-les distincts.

Après le formulaire

Une fiche société est vraie le jour où elle est saisie, puis cesse de l’être. Vatlas peut suivre les sociétés déjà intégrées et vous rappeler quand un registre change d’avis, pour que la correction arrive avant qu’une facture parte au mauvais endroit : voir le suivi de société. Pour l’historique de ce que chaque registre a dit au fil du temps, il y a le détail de chaque source.

Ce que nous ne promettons pas. Certaines administrations divulguent la validité et pas le nom : l’auto-complétion n’y remplira pas la raison sociale, et c’est une issue que le formulaire doit savoir traiter, pas une panne. Quand une réponse ne repose pas sur un registre officiel, status et meta le disent, plutôt que de laisser un champ se remplir comme si de rien n’était. Et la couverture n’est pas le monde entier : les pages pays disent ce qu’elle est aujourd’hui, pays par pays.

Questions fréquentes

L’auto-complétion par numéro de TVA, en bref

Peut-on remplir le nom et l’adresse d’une société à partir du seul numéro de TVA ?

Dans la plupart des pays, oui. Un registre officiel détient la raison sociale, la forme juridique et l’adresse du siège, et le numéro de TVA suffit à l’atteindre. Dans quelques États membres, l’administration ne publie que la validité du numéro : le nom revient alors vide, et le formulaire doit être conçu pour ce cas.

Pourquoi ne pas interroger moi-même le registre de chaque pays ?

C’est possible, et raisonnable pour un ou deux pays. Chaque pays devient alors une intégration séparée : sa propre API ou ses fichiers ouverts de plusieurs gigaoctets, ses noms de champs, ses quotas, ses indisponibilités, et une adresse en texte libre à découper. Ce qu’on achète avec une API unique, c’est une seule enveloppe pour tous.

L’auto-complétion vaut-elle vérification du numéro ?

Elle indique qu’une société a été trouvée, ce qui est un signal fort, et ce n’est pas une vérification documentée faite au moment où vous décidez de ne pas facturer la TVA. Faites la recherche pour le formulaire, et conservez un enregistrement daté de la vérification pour la facture.

Faut-il appeler l’API depuis le navigateur ?

Non. La clé d’API identifie votre compte et doit rester côté serveur. Placez une petite route proxy dans votre back-end et laissez le navigateur appeler celle-ci ; c’est aussi là que vous temporisez un champ qui se déclencherait sinon à chaque frappe.

Que doit faire le formulaire si la recherche échoue ?

Laisser passer le client. Déclenchez l’appel à la sortie du champ avec un délai court, et si aucune réponse n’arrive, laissez les champs vides et modifiables et autorisez la soumission. Une inscription bloquée parce qu’un registre tiers passe une mauvaise matinée est pire qu’une adresse saisie à la main.

Les champs pré-remplis doivent-ils être en lecture seule ?

Non. Les registres sont en retard sur la réalité, et la personne devant le formulaire en sait généralement plus sur sa propre société qu’un fichier publié le mois dernier. Pré-remplissez, montrez d’où vient la valeur, et laissez la corriger.

Pour combien de pays cela fonctionne-t-il ?

Un seul point d’entrée et une seule enveloppe, pour tous les pays que Vatlas couvre. Ce que chaque pays divulgue diffère, et les pages pays en donnent la liste à jour, un par un.

À lire ensuite

Mis à jour le 21 septembre 2026.

Créer une clé prend une minute

100 requêtes par mois gratuitement, sans carte bancaire. 5 000 par mois pour 29 € HT quand cela ne suffit plus.