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

Le bloc société

Toute inscription B2B, tout tunnel de commande, tout référencement fournisseur finit par demander 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, souvent en recopiant un document qu’il n’a pas sous les yeux.

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 qui demande déjà beaucoup, retirer cinq champs de son écran le plus long est la réduction d’abandon la moins chère à obtenir.

Le second effet est plus lent à se voir et 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. Les fautes de frappe ne restent pas dans le bloc société : elles voyagent jusqu’à l’export comptable, où quelqu’un les retrouve des mois plus tard.

La recherche dit aussi quelque chose du numéro lui-même. Un numéro qui résout vers une société existe ; 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é

Personne ne construit cela en un après-midi, parce qu’il n’existe pas une méthode. Il y en a une par pays. Trois exemples en donnent la forme.

• La France. Le numéro de TVA contient le SIREN : l’identifiant est donc gratuit. La donnée société qui se trouve derrière est publiée sous forme de fichiers ouverts de plusieurs gigaoctets, mis à jour mensuellement, avec la dénomination dans un fichier et l’adresse dans un autre. Obtenir une société suppose de les avoir toutes intégrées.
• La Pologne, la Roumanie, la Tchéquie. L’administration fiscale y expose sa propre API. Chacune a son URL, son format de requête, ses noms de champs, ses quotas et sa façon de dire « introuvable ». Trois pays, trois intégrations.
• L’Allemagne. Aucun registre n’y restitue la société derrière un numéro de TVA. La couverture qui existe vient d’ailleurs, et elle est plus mince qu’une entrée de registre.

Multipliez par le nombre de pays où vous vendez, puis ajoutez les difficultés qui sont partout les mêmes :

• Le numéro de TVA est rarement le numéro d’entreprise. Parfois c’est le même identifiant, parfois il s’en déduit, parfois les deux n’ont 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 : code postal avant ou après la ville, province suffixée, numéro de voie mêlé au libellé de rue. 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, et 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

C’est à cela que sert une API unique : un point d’entrée, une enveloppe, les mêmes noms de champs, quel que soit le pays du numéro. Vatlas couvre 32 codes, soit les 27 États membres, l’Irlande du Nord, et l’Australie, le Japon, Singapour et le Brésil.

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é : name et legalForm pour l’identité, address découpée en line1, line2, postalCode, city et country, nationalId pour l’identifiant national, et status. Le bloc meta nomme le registre qui a répondu et la date à laquelle il l’a dit, 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 jamais qu’une forme. Appelez ensuite depuis votre propre serveur. La clé d’API identifie votre compte et appartient derrière une route à vous, pas dans un bundle front ; cette route est aussi là que vous temporisez un champ qui se déclenche à chaque sortie de focus.

Remplissez les champs et laissez-les modifiables. Les registres sont en retard sur la réalité, une société qui a déménagé le mois dernier est encore à son ancienne adresse dans le fichier, et la personne au clavier en sait plus que le fichier. Verrouiller un champ pré-rempli transforme un confort en ticket de support.

Laissez le formulaire partir qu’une réponse soit arrivée ou non. Donnez un délai court à la recherche et traitez-la comme une assistance. Un nom vide n’est pas une erreur : dans quelques pays, c’est la réponse correcte et complète. Trois issues méritent d’être distinguées à l’écran : rempli depuis le registre, aucune société trouvée pour ce numéro, pas de réponse pour l’instant. La deuxième mérite un avertissement léger à côté du champ. La troisième est votre problème et pas celui du client, et devrait en avoir l’air.

Conservez ce que le registre a dit, et quand, à côté de la commande ou du compte. Si l’exonération est contestée plus tard, la réponse est un enregistrement daté.

Après le formulaire

Une fiche société est vraie le jour où elle est saisie, puis cesse de l’être. Les noms changent, les adresses changent, les sociétés sont radiées. Vatlas peut suivre les sociétés déjà intégrées et vous rappeler quand le 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 rapport détaillé.

À lire ensuite

• Obtenir le nom et l’adresse d’une entreprise
• Le numéro de TVA, pays par pays
• Documentation de l’API
• Tarifs

Mis à jour le 9 septembre 2026.