Extrait KvK (uittreksel) ou données d'API

Deux produits différents issus du même registre

Le mot néerlandais uittreksel signifie extrait. Un uittreksel KvK est un PDF que la Chambre de commerce délivre sur demande, montrant ce que le registre indique d’une inscription à cet instant : le numéro KvK, la dénomination sociale, la forme juridique, l’adresse du siège, la date d’immatriculation, les codes d’activité et les établissements. Il existe une version pour l’entité et une version par établissement.

Une API vous donne les mêmes faits, mais l’objet que vous récupérez est une donnée, pas une preuve. Cette distinction est toute la décision.

Quand vous avez réellement besoin du document

Demandez un uittreksel quand un tiers doit être convaincu, pas quand votre code a besoin d’une valeur :

• Ouvrir un compte bancaire pour une entité néerlandaise, aux Pays-Bas ou à l’étranger.
• Actes notariés, cessions de parts, et tout ce que touche un notaire de droit civil.
• Procédures judiciaires et exécution, où vous devez montrer que la contrepartie existe et qui peut signer.
• Appels d’offres et marchés publics, où les documents de consultation précisent une ancienneté maximale de l’extrait.
• Autorités étrangères qui ont besoin d’un document à légaliser ou à apostiller. Il n’y a aucun moyen d’apostiller une réponse JSON.

Pour un public international, ce dernier cas revient plus souvent qu’on ne le pense. Si vous enregistrez la présence d’une filiale néerlandaise dans un autre pays, le registre de ce pays veut du papier émanant du registre néerlandais, et aucun accès par API n’y supplée.

Quand l’API est le bon outil

Tout ce qui se passe dans votre logiciel : valider un numéro KvK au paiement, préremplir un nom et une adresse d’entreprise, segmenter par code SBI, surveiller si des clients existants sont toujours actifs, enrichir un CRM. Tout cela est du travail sur des données, et un PDF est une très mauvaise entrée pour cela.

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

La réponse enrichie est l’analogue le plus proche de ce que montre un extrait sur papier : statutoryName, tradingNames, legalForm, address, postalAddress, registrationDate, activities, totalBranches et isActive. Ce qu’elle ne contient volontairement pas, ce sont les dirigeants et les pouvoirs de signature, ce qui est l’une des principales raisons pour lesquelles l’extrait existe encore.

L’erreur à éviter : traiter un PDF fourni par le client comme à jour

Le cas de figure que nous voyons dans les parcours d’intégration est un champ de formulaire qui dit « téléversez votre extrait KvK ». Un client en téléverse un. Quelqu’un le parcourt du regard, l’affaire avance, et le PDF reste dans un dossier comme document de référence.

Deux choses ne vont pas. Le PDF est un instantané du moment de sa délivrance, qui peut remonter à un an avant le téléversement, et rien dans votre système ne remarquera jamais que l’entreprise a été dissoute entre-temps. Et un PDF n’est pas interrogeable : quand vous devrez plus tard répondre à « lesquels de nos clients sont des fondations », vous ne le pourrez pas.

La bonne approche combine les deux, avec des rôles différents. Prenez l’extrait si votre processus de conformité exige un document, mais extrayez-en le numéro KvK et utilisez ce numéro comme clé. Puis interrogez le registre via l’API à intervalles réguliers pour que le statut reste frais, et gardez le PDF uniquement comme la pièce justificative qu’il est. Pour le volet interrogation, voir la surveillance du statut des entreprises KvK.

Un détail pratique si vous analysez des extraits : la dénomination sociale du document inclut le suffixe de forme juridique, et la ponctuation néerlandaise de « B.V. » est incohérente dans la pratique. Normalisez avant de la comparer à quoi que ce soit.

Si vous avez besoin des deux et voulez garder un processus simple, commandez l’extrait une seule fois à l’intégration pour le dossier de conformité, et laissez l’API gérer tout ce qui change ensuite. Cette répartition garde un document là où un document est exigé, garde votre base interrogeable, et fait que personne n’a à rouvrir un PDF pour répondre à une question que votre propre système sait déjà traiter.