Établissements néerlandais : numéro d'établissement ou KVK ?
KVKBase Team

Établissements néerlandais : numéro d'établissement ou KVK ?

Numéro KVK ou numéro d'établissement : quelle différence, et comment récupérer tous les établissements d'une entreprise via l'API ? Lisez le guide.

kvkapiétablissementsvestigingsnummeradresses

Tôt ou tard, tous ceux qui travaillent avec des données d’entreprises néerlandaises y sont confrontés : un client vous donne son numéro KVK, mais l’adresse de livraison est celle d’un établissement situé dans une autre ville. Ou bien votre CRM affiche trois fois la même société parce que quelqu’un a créé trois magasins comme autant de clients distincts. La cause est presque toujours la même distinction : une entreprise n’est pas la même chose qu’un établissement.

Début 2026, le registre néerlandais des entreprises comptait plus de 2,5 millions d’établissements (vestigingen). La plupart appartiennent à des entreprises n’ayant qu’une seule adresse, mais les chaînes de magasins, les franchisés, les installateurs et les prestataires de santé peuvent en avoir des dizaines. Cet article explique le lien entre le numéro KVK et le numéro d’établissement (vestigingsnummer), et comment récupérer tous les établissements d’une entreprise via l’API KVKBase.

Numéro KVK ou numéro d’établissement

Le numéro KVK comporte 8 chiffres et correspond à l’immatriculation de l’entreprise ou de la personne morale. Il reste le même aussi longtemps que la société existe, même en cas de déménagement ou de changement de nom commercial. C’est le numéro imprimé sur les factures et les sites web, et celui que la plupart des systèmes utilisent pour identifier une entreprise néerlandaise. Notre guide complet de la recherche par numéro KVK en détaille le format et les contrôles.

Le numéro d’établissement comporte 12 chiffres et correspond à un lieu physique où l’entreprise exerce son activité. Chaque établissement reçoit son propre numéro, avec sa propre adresse, ses propres noms commerciaux et ses propres activités. L’un d’eux est l’établissement principal (hoofdvestiging), les autres sont des établissements secondaires (nevenvestigingen). Quand un établissement déménage, son adresse change, mais le numéro KVK de l’entreprise reste le même.

Pensez à un arbre : le numéro KVK est le tronc, les établissements sont les branches. Un entrepreneur individuel peut aussi en avoir plusieurs, par exemple un coiffeur avec deux salons. L’inverse existe aussi : une fondation qui gère uniquement un patrimoine et n’exerce aucune activité commerciale figure au registre, mais n’a aucun établissement.

Quand avez-vous besoin des données d’établissements ?

Pour de nombreux cas d’usage, le numéro KVK suffit. Si vous voulez seulement savoir si une entreprise existe et est active, une recherche classique fait l’affaire. Les établissements deviennent importants dès que le lieu lui-même compte.

Prenons un grossiste qui fournit des restaurants. Le client commande sous un seul numéro KVK, mais les palettes doivent partir vers cinq restaurants différents. Si vous récupérez tous les établissements à la création du compte, le client peut choisir une adresse de livraison dans une liste au checkout, sans faute de frappe dans les codes postaux. Il en va de même pour une société de services qui envoie des techniciens sur des sites, ou pour un assureur qui établit une police par lieu.

C’est aussi important en vente et en marketing. Une chaîne de quarante magasins est un tout autre lead qu’une société avec un seul bureau, même si les deux sont des BV avec le même code SBI. Le nombre d’établissements est un indicateur fort de taille et de rayonnement, et les activités peuvent différer d’un lieu à l’autre : une entreprise de construction peut avoir un bureau à une adresse et un atelier à une autre. Notre article sur les codes SBI explique comment classer ces activités.

Récupérer tous les établissements via l’API

L’API KVKBase dispose d’un point de terminaison dédié aux établissements : GET /v1/lookup/{kvkNumber}/branches. Indiquez le numéro KVK et vous obtenez la liste des établissements, chacun avec son numéro d’établissement, son nom, son adresse, ses activités et un indicateur d’établissement principal. Un appel coûte 5 jetons.

const API_KEY = process.env.KVKBASE_API_KEY;

async function getBranches(kvkNumber) {
  const response = await fetch(
    `https://api.kvkbase.nl/v1/lookup/${kvkNumber}/branches`,
    { headers: { Authorization: `Bearer ${API_KEY}` } }
  );
  if (!response.ok) throw new Error(`KVKBase returned ${response.status}`);
  return response.json();
}

const data = await getBranches("12345678");
for (const b of data.branches) {
  const city = b.address?.city ?? "unknown";
  console.log(`${b.branchNumber}  ${b.name}  (${city}, ${b.isMain ? "main" : "secondary"})`);
}

Une réponse ressemble à peu près à ceci :

{
  "kvkNumber": "12345678",
  "companyName": "Bakkerij De Korenaar B.V.",
  "totalBranches": 2,
  "branches": [
    {
      "branchNumber": "000012345678",
      "name": "Bakkerij De Korenaar",
      "isMain": true,
      "address": {
        "street": "Dorpsstraat",
        "houseNumber": "12",
        "postalCode": "3732 HB",
        "city": "De Bilt",
        "country": "Nederland"
      },
      "activities": [
        { "sbiCode": "10711", "description": "Brood- en banketbakkerijen", "isMain": true }
      ]
    },
    {
      "branchNumber": "000087654321",
      "name": "De Korenaar Utrecht",
      "isMain": false,
      "address": {
        "street": "Oudegracht",
        "houseNumber": "140",
        "postalCode": "3511 AZ",
        "city": "Utrecht",
        "country": "Nederland"
      },
      "activities": [
        { "sbiCode": "47241", "description": "Winkels in brood en banketbakkerswerk", "isMain": true }
      ]
    }
  ]
}

Deux points d’attention. Le champ address peut valoir null lorsqu’aucune adresse n’est enregistrée pour un établissement : vérifiez-le avant de lire son contenu. Et comparez totalBranches avec la longueur du tableau branches : pour les grandes chaînes, le total peut dépasser le nombre d’établissements renvoyés avec tous leurs détails, et il vaut mieux le savoir avant de considérer votre liste comme complète. Notez que les descriptions SBI sont renvoyées en néerlandais, telles que le registre les stocke.

Laisser les clients choisir une adresse de livraison

Un usage courant est une liste déroulante d’adresses de livraison. Récupérez les établissements une fois à la création du compte, stockez-les et laissez le client choisir à chaque commande. Placez l’établissement principal en premier, car c’est généralement aussi l’adresse de facturation.

async function deliveryOptions(kvkNumber) {
  const { branches } = await getBranches(kvkNumber);
  return branches
    .filter((b) => b.address)
    .map((b) => {
      const a = b.address;
      const number = a.houseNumber + (a.houseNumberAddition ?? "");
      return {
        establishmentNumber: b.branchNumber,
        label: `${b.name}, ${a.street} ${number}, ${a.city}`,
        isMain: b.isMain,
      };
    })
    .sort((x, y) => Number(y.isMain) - Number(x.isMain));
}

Stockez le numéro d’établissement sur chaque commande, pas seulement l’adresse en texte libre. Si un établissement déménage plus tard, vous pouvez le récupérer à nouveau et mettre à jour l’adresse, au lieu de deviner quelle adresse en texte libre correspondait à quel lieu.

Les établissements dans votre CRM : une entreprise, plusieurs lieux

Dans un CRM, vous voulez généralement un compte par numéro KVK, avec les établissements comme lieux rattachés. Cela évite les comptes en double et regroupe chiffre d’affaires, points de contact et contrats au bon niveau. Utilisez le numéro KVK comme clé du compte et le numéro d’établissement comme clé de chaque lieu.

Cela fonctionne aussi dans l’autre sens. Si votre CRM est rempli de comptes isolés, récupérez les établissements de chaque compte et repérez ceux qui partagent un numéro KVK. Vous ferez ainsi apparaître des doublons qu’une comparaison de noms ne détecterait jamais, car l’établissement exerce sous un autre nom. Gardez en tête la forme juridique : un groupe composé de plusieurs BV a plusieurs numéros KVK, même si votre équipe commerciale le considère comme un seul client. Notre article sur les formes juridiques néerlandaises dans les données KVK y revient en détail.

Recherche classique ou point de terminaison des établissements ?

Si vous n’avez besoin que de l’adresse de l’établissement principal, une recherche classique est moins chère. Avec ?enrich=true, vous obtenez l’adresse complète, les noms commerciaux, la forme juridique et les codes SBI pour 2 jetons. Le point de terminaison des établissements est à utiliser quand vous voulez vraiment tous les lieux. Une approche pratique consiste à lancer d’abord la recherche classique et à n’appeler le point de terminaison des établissements que pour les clients professionnels susceptibles d’avoir plusieurs sites, ou dès qu’un client demande une livraison à une autre adresse.

Tous les paramètres et coûts en jetons figurent dans la référence de l’API.

Pour commencer

Les données d’établissements font la différence entre « nous connaissons cette entreprise » et « nous savons où cette entreprise exerce son activité ». Un point de terminaison supplémentaire vous donne tous les lieux, avec leur propre adresse et leurs activités, rattachés proprement au numéro KVK que vous utilisez déjà.

Créez un compte KVKBase gratuit et essayez le point de terminaison des établissements avec le numéro KVK d’une entreprise que vous connaissez.