Rechercher une entreprise néerlandaise par nom via l'API KVK

Un client vous dit travailler chez « Bakkerij De Gouden Korst ». Vous cherchez ce nom dans le registre néerlandais du commerce et obtenez sept résultats. Deux sont radiés, trois se trouvent dans une autre ville et un est orthographié légèrement différemment. Lequel est le bon ? Un nom ressemble à une simple requête, mais c’est la manière la plus difficile de retrouver une entreprise néerlandaise.

Cet article explique comment fonctionne la recherche par nom, pourquoi elle échoue si souvent et comment construire un champ de recherche qui aboutit à un numéro KVK plutôt qu’à une supposition.

Pourquoi la recherche par nom est plus difficile qu’il n’y paraît

Une entreprise du registre a généralement plus d’un nom. Il y a la dénomination statutaire de l’acte constitutif, et un ou plusieurs noms commerciaux qu’elle utilise publiquement. Ce qui figure sur la devanture n’est pas forcément ce qui figure dans l’acte. La différence est expliquée sur notre page consacrée au nom commercial et à la dénomination statutaire.

À cela s’ajoutent les différences d’orthographe habituelles. « B.V. », « BV » et « bv » sont identiques pour une personne, mais pas toujours pour une fonction de recherche. Il en va de même pour « De Gouden Korst » face à « Gouden Korst, De », une esperluette face au mot « en », et les accents.

Et puis il y a simplement beaucoup d’entreprises dont le nom est presque identique. Un nom est une étiquette, pas une identité. Le numéro KVK est une identité, et c’est celui-ci que vous voulez obtenir au final.

Rechercher avec l’API KVKBase

Le point d’accès de recherche interroge les noms et les noms commerciaux et renvoie une liste paginée. Chaque résultat contient le numéro KVK, le nom, la ville et l’indication de l’activité de l’entreprise. Une recherche coûte 1 jeton. Tous les paramètres figurent dans la documentation de l’API.

curl "https://api.kvkbase.nl/v1/search?q=gouden%20korst&pageSize=10" \
  -H "Authorization: Bearer your_api_key"

La réponse ressemble à ceci :

{
  "results": [
    { "kvkNumber": "12345678", "name": "Bakkerij De Gouden Korst B.V.", "city": "Zwolle", "isActive": true },
    { "kvkNumber": "23456789", "name": "Gouden Korst Beheer B.V.", "city": "Zwolle", "isActive": true }
  ],
  "total": 2,
  "page": 1,
  "pageSize": 10
}

La requête doit compter au moins deux caractères. Pour un champ où l’utilisateur est en train de saisir, il existe aussi le point d’accès d’autocomplétion, qui renvoie une courte liste d’au plus huit suggestions : vous pouvez l’appeler à chaque frappe sans parcourir une longue liste de pages.

Choisir le bon résultat

La chose la plus risquée est de prendre automatiquement le premier résultat. Cela fonctionne dans la démo et échoue dès la première entreprise au nom courant. Servez-vous des données supplémentaires dont vous disposez déjà pour filtrer, et laissez une personne trancher quand un doute subsiste.

Quelques signaux qui fonctionnent bien en pratique : la ville ou le code postal du formulaire, le fait que l’entreprise soit active, et un élément dérivé comme le domaine de l’adresse e-mail. S’il ne reste qu’un seul résultat après filtrage, vous pouvez le proposer. S’il y en a plusieurs, affichez tous les candidats avec la ville à côté du nom, car on reconnaît une adresse plus vite qu’un numéro.

import requests

HEADERS = {"Authorization": "Bearer your_api_key"}

def find_company(name: str, city: str | None = None) -> list[dict]:
    r = requests.get(
        "https://api.kvkbase.nl/v1/search",
        params={"q": name, "pageSize": 20},
        headers=HEADERS,
        timeout=10,
    )
    r.raise_for_status()
    hits = [c for c in r.json()["results"] if c["isActive"]]
    if city:
        hits = [c for c in hits if c["city"].lower() == city.lower()]
    return hits

Enregistrez ensuite toujours le numéro KVK, pas le nom. À partir de là, vous n’avez plus jamais besoin de chercher cette entreprise par nom, et vous pouvez utiliser le numéro pour récupérer ses données.

Un champ de recherche discret

Si vous construisez un champ de recherche pour des clients, vous voulez qu’il paraisse rapide et génère peu d’appels inutiles. Quelques règles aident.

Attendez qu’au moins deux ou trois caractères soient saisis et ajoutez un court délai (un anti-rebond d’environ 250 millisecondes), pour ne pas envoyer une requête à chaque lettre. Annulez la requête précédente quand une nouvelle démarre, sinon une ancienne réponse peut s’afficher au-dessus d’une plus récente.

Affichez la ville à côté de chaque suggestion, et de préférence l’indication de l’activité de l’entreprise. Laissez l’utilisateur confirmer, puis remplissez seulement alors le reste du formulaire avec les données du numéro KVK choisi. C’est plus rapide que de saisir à la main et cela ne produit aucune variante d’orthographe. Le fonctionnement dans un tunnel de paiement est expliqué dans remplir automatiquement les données d’entreprise à partir d’un numéro KVK.

À quoi ne pas s’attendre

La recherche par nom n’est pas une correspondance approximative qui rattrape une faute de trois lettres. Une requête très éloignée du nom enregistré renvoie peu de résultats, voire aucun. Pour un travail d’import ou de rapprochement, normalisez d’abord le nom : retirez les suffixes de forme juridique comme « B.V. », supprimez la ponctuation et, si nécessaire, réessayez avec un terme plus court.

Certaines entreprises n’apparaîtront pas parce qu’elles ne figurent pas dans le registre. Les entreprises étrangères n’ont pas de numéro KVK, et une société de personnes ou une association peut être connue sous un autre nom que celui que vous attendez. Considérez donc « aucun résultat » comme une raison de vérifier à la main, pas comme la preuve que l’entreprise n’existe pas.

D’un nom à une base de données propre

La recherche par nom est un début, pas une fin. L’objectif est que chaque entreprise de votre système ait un numéro KVK, afin de pouvoir travailler avec sans tracas. Si vous avez déjà une base remplie de noms épars, c’est exactement le nettoyage décrit dans dédoublonner les entreprises de votre CRM. Les bases sont détaillées dans notre guide complet de la recherche par numéro KVK.

Envie d’essayer ? Créez un compte KVKBase, recherchez le nom de votre propre entreprise et voyez combien de résultats vous obtenez.