Consulter les données d'entreprises néerlandaises à l'étranger

Si vous développez une application qui travaille avec des entreprises néerlandaises, vous devrez tôt ou tard vérifier et récupérer leurs données d’immatriculation. Les Pays-Bas tiennent un registre centralisé des entreprises via la KVK (Kamer van Koophandel, la chambre de commerce), et chaque société immatriculée possède un numéro KVK unique à 8 chiffres.

Accéder à ces données depuis l’étranger était autrefois pénible. Ce guide présente vos options et vous montre comment intégrer la recherche d’entreprises néerlandaises dans votre application, où que vous soyez.

Qu’est-ce que la KVK et pourquoi est-ce important ?

La KVK est l’équivalent néerlandais de Companies House au Royaume-Uni ou du registre du commerce en France. Toute entreprise active aux Pays-Bas, qu’il s’agisse d’un indépendant seul ou d’une multinationale, doit s’immatriculer auprès de la KVK.

Le registre contient les informations clés de chaque société :

• Dénomination et noms commerciaux : le nom officiel enregistré et les éventuels noms commerciaux sous lesquels la société exerce
• Numéro KVK : un identifiant unique à 8 chiffres
• RSIN : un numéro d’identification à 9 chiffres utilisé pour les relations avec l’administration et le fisc
• Adresse enregistrée : l’adresse officielle déclarée
• Forme juridique : BV (société à responsabilité limitée), NV (société anonyme), eenmanszaak (entreprise individuelle), VOF (société en nom collectif), et d’autres
• Codes SBI : codes de classification d’activité qui décrivent les activités de la société
• Statut actif : indique si la société est actuellement active ou a été dissoute

Ces données servent dans les processus de facturation, de conformité, d’onboarding et de due diligence dans toute l’Europe.

Le défi pour les développeurs internationaux

Si vous êtes établi hors des Pays-Bas, vous rencontrerez plusieurs obstacles pour accéder aux données KVK :

1. L’API KVK officielle exige un certificat néerlandais PKIoverheid pour l’authentification. Pour une entité étrangère, en obtenir un est irréaliste pour la plupart des équipes.
2. Le site web de la KVK est principalement en néerlandais. Le parcourir et analyser ses résultats par programme n’est pas fiable.
3. VIES (VAT Information Exchange System) peut valider les numéros de TVA néerlandais, mais ne renvoie pas le profil complet de l’entreprise dont vous avez généralement besoin.

Ces obstacles expliquent précisément l’existence d’API tierces comme KVKBase. Elles offrent une interface REST claire vers les mêmes données sous-jacentes, authentifiée par une simple clé d’API.

Rechercher une entreprise par numéro KVK

La recherche la plus directe se fait par numéro KVK. Si un client néerlandais vous communique son numéro KVK lors de l’onboarding, vous pouvez récupérer son profil complet en une seule requête :

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

La réponse comprend la dénomination, les noms commerciaux, l’adresse, la forme juridique, les codes SBI et le statut actif de la société. Voici un exemple de réponse typique :

{
  "kvkNumber": "12345678",
  "tradeName": "Voorbeeld BV",
  "legalForm": "Besloten Vennootschap",
  "address": {
    "street": "Herengracht",
    "houseNumber": "500",
    "postalCode": "1017CB",
    "city": "Amsterdam"
  },
  "sbiCodes": [
    { "code": "6201", "description": "Ontwikkelen en produceren van software" }
  ],
  "isActive": true
}

Rechercher par nom d’entreprise

Quand vous n’avez pas le numéro KVK, vous pouvez chercher par nom. C’est utile pour les champs à saisie semi-automatique où l’utilisateur commence à taper un nom d’entreprise :

const response = await fetch(
  'https://api.kvkbase.nl/api/v1/search?q=bol.com&limit=5',
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);

const results = await response.json();

Le point de terminaison de recherche renvoie une liste d’entreprises correspondantes avec leurs numéros KVK : l’utilisateur choisit la bonne, et vous pouvez ensuite lancer une recherche complète.

Valider les numéros de TVA néerlandais

Les numéros de TVA néerlandais (BTW-nummers) suivent le format NL + 9 chiffres + B + 2 chiffres (par exemple NL123456789B01). Pour vérifier qu’un numéro de TVA est valide et actuellement actif, vous pouvez utiliser le système VIES ou l’API KVKBase :

import requests

api_key = "YOUR_API_KEY"
vat_number = "NL123456789B01"

response = requests.get(
    f"https://api.kvkbase.nl/api/v1/vat/{vat_number}",
    headers={"Authorization": f"Bearer {api_key}"}
)

data = response.json()
print(f"Valid: {data['valid']}")
print(f"Company: {data['tradeName']}")

C’est particulièrement utile pour les processus de facturation, où la réglementation européenne vous impose de vérifier le statut TVA de vos clients professionnels.

API KVKBase ou accès direct à l’API KVK

Voici une comparaison pratique :

	API KVKBase	API KVK officielle
Authentification	Clé d’API	Certificat PKIoverheid
Accès depuis l’étranger	Oui, HTTPS standard	Nécessite un certificat néerlandais
Format de réponse	JSON clair	Variable selon le point de terminaison
Recherche par nom	Oui	Limitée
Limites de débit	Généreuses, selon l’offre	Strictes
Validation de la TVA	Incluse	Système distinct
Tarification	Offres à l’usage	Gratuite mais configuration complexe

Pour la plupart des équipes internationales, l’API KVKBase est la voie la plus rapide vers la production. Vous vous inscrivez, obtenez une clé d’API et envoyez vos premières requêtes en quelques minutes.

Conseils d’intégration

Quelques points à garder en tête lors de l’intégration de données d’entreprises néerlandaises :

• Mettez en cache sans retenue. Les données d’immatriculation changent peu. Une durée de vie de 24 heures pour les résultats en cache vous économisera des appels d’API et améliorera les temps de réponse.
• Gérez les entreprises inactives. Le champ isActive indique si une société exerce toujours. Selon votre cas d’usage, vous voudrez peut-être signaler ou rejeter les entreprises inactives.
• Normalisez les adresses. Les codes postaux néerlandais suivent un format strict 1234AB (quatre chiffres, deux lettres, sans espace). Certains systèmes insèrent un espace. Normalisez avant de stocker.
• Stockez le numéro KVK sous forme de chaîne. Les zéros initiaux sont significatifs. Le numéro KVK 01234567 n’est pas le même que 1234567.

Pour commencer

Créez un compte KVKBase gratuit sur kvkbase.nl pour obtenir votre clé d’API. L’offre gratuite vous donne assez de requêtes pour construire et tester votre intégration. Quand vous êtes prêt pour la production, passez à une offre adaptée à votre volume.

La documentation de l’API couvre chaque point de terminaison, paramètre et champ de réponse en détail.