Établissements et siège principal des entreprises néerlandaises

Une inscription, plusieurs lieux

Le registre néerlandais sépare l’entreprise des lieux où elle exerce. Vestiging signifie établissement. La hoofdvestiging est l’établissement principal, et tout autre site est une nevenvestiging. Tous appartiennent à une seule inscription et donc à un seul numéro KvK.

La différence entre huit et douze chiffres est le moyen le plus rapide de savoir quel numéro vous avez entre les mains quand un client colle quelque chose dans un ticket de support. S’il compte douze chiffres, c’est un site, et vous ne pouvez pas rechercher une entreprise avec.

Deux structures qui se ressemblent sans être identiques :

• Une entreprise de quatre boutiques. Un numéro KvK, quatre vestigingsnummers, une seule contrepartie juridique. Votre contrat et votre facture vont à l’entreprise.
• Un groupe de quatre sociétés opérationnelles sous une holding. Quatre numéros KvK, quatre contreparties juridiques, et le lien de groupe n’est pas un champ que renvoie l’API. Si vous avez besoin du groupe, il vous faut une source extérieure au registre.

Récupérer les données

Le compteur vient avec l’enrichissement, la liste vient de son propre endpoint.

curl "https://api.kvkbase.nl/v1/lookup/68750110?enrich=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://api.kvkbase.nl/v1/lookup/68750110/branches" \
  -H "Authorization: Bearer YOUR_API_KEY"

Le schéma utile consiste à lire d’abord totalBranches et à n’appeler l’endpoint des établissements que s’il est supérieur à un. La plupart des inscriptions néerlandaises n’ont qu’un site : vous évitez donc le second appel pour la grande majorité des entreprises et votre quota dure sensiblement plus longtemps. Si vous enrichissez une base clients en masse, cela seul peut diviser par deux votre volume d’appels.

N’intégrez pas à votre code l’hypothèse inverse : totalBranches peut être absent (sans enrich=true) ou égal à zéro (une entité immatriculée sans lieu d’activité, ce qui arrive avec les holdings). Gérez les deux sans lever d’exception.

Où cela compte dans un produit

• Paiement et livraison. Préremplissez l’adresse de l’établissement principal, puis proposez la liste des établissements si le compteur dépasse un. Se tromper ici envoie une palette à un siège statutaire qui est le salon d’un comptable.
• Attribution de territoires. Une chaîne nationale relève légitimement de plusieurs régions commerciales. Attribuer sur le seul code postal du siège concentre tous les grands comptes à Amsterdam et Rotterdam.
• Opérations au niveau du site. Le service sur le terrain, les installations et les inspections ont lieu dans une vestiging, pas dans une entreprise.
• Déduplication. Si vous importez des fiches clients de plusieurs sources, la même entreprise arrive sous forme de plusieurs lignes avec des adresses différentes. Un rapprochement sur l’adresse la scindera. Un rapprochement sur le numéro KvK la fusionnera correctement.

Si votre produit ne touche jamais un lieu physique, ignorez tout cela. Stocker des données d’établissements que vous ne lisez pas, c’est une table à maintenir à jour pour rien.

Le piège : l’adresse du siège n’est pas toujours celle où arrive le courrier

Deux choses distinctes sont confondues ici. L’address d’une recherche est l’adresse de visite de l’établissement principal. postalAddress, un champ réservé à enrich=true, est l’endroit où l’entreprise reçoit son courrier, et pour une part non négligeable des inscriptions, les deux diffèrent. Les petites entreprises s’enregistrent à l’adresse de leur comptable ou d’un prestataire de domiciliation et reçoivent leur courrier ailleurs.

Si vous imprimez des factures ou envoyez du papier où que ce soit, utilisez postalAddress quand elle est présente et repliez-vous sur address sinon. Si vous cherchez à juger si une entreprise est réelle, sachez qu’une adresse de domiciliation partagée est courante et légale : une adresse qui porte des centaines d’inscriptions est un signal faible, pas une preuve de quoi que ce soit.

Un dernier détail à coder une fois pour toutes : les adresses néerlandaises séparent le numéro de rue de son complément. address contient houseNumber et houseNumberAddition séparément, donc 12 et A sont deux champs et non 12A. Les formulaires conçus autour d’une seule ligne de rue en texte libre perdent le complément à l’aller-retour, et une livraison à Keizersgracht 12 au lieu de Keizersgracht 12A est une autre porte. Modélisez les deux champs séparément dès le départ.

Si vous stockez déjà des adresses pour d’autres pays, résistez à l’envie de faire entrer la forme néerlandaise dans une colonne existante à ligne unique pour l’analyser ensuite. Analyser correctement Keizersgracht 12A hs exige de connaître les conventions néerlandaises pour les compléments et les mentions d’étage, et le registre a déjà fait ce travail pour vous. Gardez les champs qu’il fournit et concaténez uniquement pour l’affichage.