{ "lookup" :

Données d'entreprises néerlandaises depuis l'étranger

Réponse courte

Les données du registre du commerce néerlandais sont publiques et consultables de n'importe où. Vous n'avez besoin ni d'une entité néerlandaise, ni d'un compte bancaire néerlandais, ni d'eHerkenning pour les interroger : une clé d'API suffit. Ce qu'il faut réussir, c'est le modèle de données, car les adresses, noms et identifiants néerlandais ne s'inscrivent pas proprement dans des formulaires conçus pour d'autres pays, et pour la facturation transfrontalière le champ qui compte est le numéro de TVA validé par VIES, pas le numéro KvK.

Obtenir une clé API Lire la documentation
cURL 
# Fonctionne depuis n'importe quel pays
curl ".../v1/lookup/68750110?enrich=true" \
  -H "Authorization: Bearer KEY"

{
  "statutoryName": "Acme B.V.",
  "address": {
    "postalCode": "1016 GB",
    "country": "NL"
  }
}

Ce dont vous n’avez pas besoin

Les équipes hors des Pays-Bas supposent couramment que lire des données d’entreprises néerlandaises exige une présence locale. Ce n’est pas le cas. La liste pratique des choses dont vous pouvez cesser de vous soucier :

  • eHerkenning. Un dispositif d’identité professionnelle néerlandais pour se connecter aux services de l’État. Il existe pour qu’une entreprise puisse déposer ses propres modifications. Lire des données publiques n’a rien à voir avec lui.
  • DigiD. La connexion des citoyens. Même chose, et elle n’est de toute façon pas accessible aux non-résidents.
  • Un compte bancaire ou une entité néerlandaise. Non requis pour obtenir une clé d’API ni pour la payer.
  • Une licence de données. Les données de base du registre du commerce sont publiques. Des conditions d’attribution et de réutilisation s’appliquent à la redistribution en masse, pas au fait de rechercher une entreprise dans votre propre produit.

L’aspect opérationnel du démarrage depuis l’étranger, y compris les clés, la facturation et une première requête, est traité dans comment rechercher des données d’entreprises néerlandaises depuis l’extérieur des Pays-Bas. Cette page porte sur la forme des données une fois que vous les avez.

Le modèle de données, et où il se heurte à votre schéma

ChampCe que les schémas étrangers ratent
kvkNumberhuit chiffres, les zéros initiaux sont réels. Une colonne d’entiers les détruit.
statutoryNameabsent pour les entrepreneurs individuels et les sociétés de personnes. Repliez-vous sur name.
tradingNamesun tableau, pas une chaîne. Une entreprise peut exercer sous plusieurs noms.
address.houseNumber et houseNumberAdditiondeux champs, pas un. 12 et A sont distincts.
address.postalCodequatre chiffres, un espace, deux lettres : 1016 GB. Non numérique, et l’espace est conventionnel.
legalFormun code, pas du texte libre. Basez votre logique dessus.
vatprésent seulement pour les formes BV et NV, et seulement après un contrôle VIES.
totalBranchesréservé à enrich=true. Absent n’est pas la même chose que zéro.

Le code postal est celui qui casse en silence. Une expression régulière écrite pour des codes à cinq chiffres allemands ou français rejette toute adresse néerlandaise, et un normaliseur qui retire les caractères non alphanumériques transforme 1016 GB en 1016GB, ce qui reste valide mais ne correspondra pas à une valeur stockée qui conservait l’espace. Choisissez une forme canonique et normalisez à l’écriture.

Le complément de numéro de rue est celui qui casse cher, car un colis part à la mauvaise porte et personne ne le découvre avant la plainte d’un client.

Facturation transfrontalière : le champ qui compte vraiment

Si vous vendez aux Pays-Bas depuis un autre État membre de l’UE, la question commerciale est de savoir si vous facturez votre propre TVA ou appliquez l’autoliquidation. Cela dépend de la détention par le client d’un numéro d’identification TVA valide, confirmé auprès de VIES. Cela ne dépend aucunement du numéro KvK.

curl "https://api.kvkbase.nl/v1/validate/vat/NL068750110B01" \
  -H "Authorization: Bearer YOUR_API_KEY"

Deux choses à prévoir dès le départ. Validez au moment de la facture, pas seulement à l’inscription, car ce sur quoi vous vous appuyez est le statut à la date de la facture. Et stockez le résultat avec son horodatage, car cette preuve conservée est ce que vous présentez quand la situation est contestée plus tard.

Si le client vous donne un numéro KvK plutôt qu’un numéro de TVA, la recherche tentera d’en déduire un pour une BV ou une NV et de le vérifier, mais la déduction est une heuristique qui échoue sur les unités fiscales. Traitez un résultat absent ou invalide comme « demandez au client », jamais comme « non assujetti à la TVA ».

Une note sur les noms et le rapprochement

Les dénominations sociales néerlandaises portent un suffixe de forme juridique, et la ponctuation de B.V. est incohérente d’une source à l’autre. Les signes diacritiques apparaissent dans le registre et disparaissent dans la saisie des utilisateurs. Les noms commençant par van, de et den sont triés et saisis dans plusieurs ordres. Toute comparaison exacte de chaînes entre un nom du registre néerlandais et ce que détient un système étranger échouera plus souvent qu’elle ne réussira.

Rapprochez sur kvkNumber partout où vous le pouvez. Quand vous ne le pouvez pas, normalisez de façon agressive, acceptez une courte liste plutôt qu’une réponse unique, et montrez la ville et la forme juridique à côté de chaque candidat pour qu’une personne choisisse le bon. C’est moins cher que le travail de réconciliation qui suit un mauvais rapprochement automatique.

Enfin, prévoyez les appels que vous ne ferez pas. L’offre gratuite est de cinquante recherches par mois, ce qui suffit pour construire et tester sur de vraies inscriptions mais pas pour enrichir une base clients. Mettez en cache ce que vous récupérez, rafraîchissez selon un calendrier plutôt qu’à chaque chargement de page, et utilisez l’appel peu coûteux /v1/verify/{kvkNumber} pour valider la saisie afin que les recherches complètes ne soient consommées que là où vous consommez réellement le profil.

Questions fréquentes

Ai-je besoin d'eHerkenning pour lire le registre ?
Non. eHerkenning est une identification professionnelle néerlandaise servant aux démarches auprès des services de l'État, comme la modification de sa propre inscription. Lire les données publiques d'entreprise n'en requiert aucune. Une clé d'API en HTTPS est toute l'exigence.
Ai-je besoin d'une entreprise ou d'un compte bancaire néerlandais ?
Non. La facturation se fait en euros et fonctionne depuis n'importe quel pays. Il n'y a aucune condition de résidence ou d'établissement pour lire un registre public, et les données elles-mêmes sont des informations publiques et non un jeu de données sous licence avec des restrictions territoriales.
Un numéro KvK suffit-il pour facturer sans TVA ?
Non. Pour une livraison intracommunautaire en autoliquidation, il vous faut un numéro de TVA que VIES confirme comme valide, avec vos propres justificatifs. Un numéro KvK prouve l'inscription au registre du commerce et ne dit rien du statut TVA.
Puis-je stocker des données d'entreprises néerlandaises au regard du RGPD ?
Les données d'entreprise portant sur des personnes morales ne sont généralement pas des données personnelles, mais les fiches d'entrepreneurs individuels identifient de fait une personne, et leur adresse est souvent une adresse personnelle. Traitez les inscriptions à une seule personne avec le même soin que des données personnelles. Un article plus détaillé figure sur le blog.

Pour aller plus loin

Mis à jour:

Un seul appel vous donne toute l'entreprise

Les données KvK, le numéro de TVA déduit et un contrôle VIES en direct, en une seule requête. L'offre gratuite comprend 50 recherches par mois, sans carte bancaire.

Créer une clé API gratuite Voir les tarifs
50
recherches gratuites par mois
1
requête au lieu de trois
0
carte bancaire, contrat ou appel commercial