Surveiller le statut des entreprises néerlandaises via l'API KVK
KVKBase Team

Surveiller le statut des entreprises néerlandaises via l'API KVK

Détectez automatiquement la faillite, la radiation ou le changement d'adresse d'un client ou fournisseur avec l'API KVKBase et réduisez le risque financier.

kvkapimonitoringgestion des risquesfailliteconformité

Un client qui a payé à temps la semaine dernière peut être en faillite la semaine prochaine. Un fournisseur installé à la même adresse depuis des années a peut-être discrètement été radié. Pour les entreprises B2B, ce ne sont pas des scénarios théoriques : ce sont de vrais risques qui peuvent causer de lourds dégâts financiers.

Avec l’API KVKBase, vous pouvez détecter ces changements automatiquement, sans consulter manuellement chaque jour le registre du commerce néerlandais. Cet article explique comment surveiller le statut des entreprises, quels signaux comptent et comment le mettre en place concrètement.

Quels changements de statut sont pertinents ?

Le registre du commerce de la KVK ne contient pas seulement des données statiques sur les entreprises. Il comprend aussi des informations de statut à jour. Les changements qui ont le plus d’impact sur votre activité sont :

  • Déclaration de faillite : l’entreprise a été déclarée en faillite par un tribunal
  • Suspension des paiements : l’entreprise a demandé un moratoire temporaire sur ses dettes
  • Radiation : l’entreprise a été formellement dissoute et retirée du registre
  • Changement d’adresse : l’adresse du siège a changé, ce qui est important pour le courrier et la facturation
  • Changement de nom : l’entreprise exerce désormais sous un autre nom
  • Changement de forme juridique : par exemple de l’entreprise individuelle à la société privée (BV)
  • Changement de dirigeants : d’autres personnes disposent désormais du pouvoir de signature

Tous ces changements ne sont pas aussi urgents. Un changement d’adresse est d’ordre administratif ; une déclaration de faillite exige une action immédiate de la gestion du crédit ou du recouvrement.

Pourquoi les contrôles manuels ne passent pas à l’échelle

Dans beaucoup d’entreprises, on a tendance à contrôler les débiteurs ou les fournisseurs au coup par coup, seulement une fois que quelque chose a déjà mal tourné. Une facture impayée qui n’est jamais réglée, une relance de paiement renvoyée à une ancienne adresse.

À ce stade, le mal est déjà fait. Une surveillance proactive est bien plus efficace : vous savez avant d’envoyer une facture, avant d’effectuer une grosse livraison, avant de signer un contrat.

Consulter manuellement le registre du commerce pour une liste de centaines de clients n’est pas réaliste. Une surveillance automatisée via l’API, si.

Interroger le statut d’une entreprise via l’API KVKBase

L’API KVKBase renvoie un champ active et des informations de statut supplémentaires pour chaque entreprise. Voici une implémentation simple en Python :

import os
import requests

API_KEY = os.environ["KVKBASE_API_KEY"]
BASE_URL = "https://api.kvkbase.nl/api/v1"

def check_company_status(kvk_number: str) -> dict:
    response = requests.get(
        f"{BASE_URL}/kvk/{kvk_number}",
        headers={"x-api-key": API_KEY}
    )
    response.raise_for_status()
    data = response.json()

    return {
        "kvk_number": kvk_number,
        "name": data.get("naam"),
        "active": data.get("actief", True),
        "legal_form": data.get("rechtsvorm"),
        "address": data.get("adres", {}),
    }

# Vérifier une entreprise donnée
status = check_company_status("12345678")
if not status["active"]:
    print(f"WARNING: {status['name']} is no longer active!")

Surveillance en masse : analyser toute votre liste de clients

En pratique, vous ne voulez pas vérifier les entreprises une par une. Vous voulez passer en revue toute votre liste de clients. L’approche la plus efficace est un traitement par lots périodique associé à un mécanisme d’alerte.

import time
import smtplib
from email.message import EmailMessage
from typing import List

def monitor_portfolio(kvk_numbers: List[str]) -> List[dict]:
    """Vérifie une liste de numéros KVK et renvoie les éventuelles alertes."""
    alerts = []

    for kvk in kvk_numbers:
        try:
            status = check_company_status(kvk)
            if not status["active"]:
                alerts.append({
                    "kvk_number": kvk,
                    "company": status["name"],
                    "reason": "Company no longer active in KVK register"
                })
            time.sleep(0.2)  # Respecter les limites de débit
        except Exception as e:
            print(f"Error fetching {kvk}: {e}")

    return alerts

def send_alert_email(alerts: List[dict], recipient: str):
    if not alerts:
        return

    msg = EmailMessage()
    msg["Subject"] = f"KVK Monitor: {len(alerts)} company/companies require attention"
    msg["From"] = "[email protected]"
    msg["To"] = recipient

    body = "The following companies are no longer active:\n\n"
    for alert in alerts:
        body += f"- {alert['company']} (KVK: {alert['kvk_number']})\n"
        body += f"  Reason: {alert['reason']}\n\n"

    msg.set_content(body)

    with smtplib.SMTP("localhost") as smtp:
        smtp.send_message(msg)

Détecter les changements d’adresse

Les changements d’adresse demandent une approche différente. Il vous faut un point de référence : l’adresse enregistrée dans votre propre système. Vous comparez ensuite la réponse de l’API avec votre propre base de données.

def detect_address_changes(kvk_number: str, stored_address: dict) -> dict | None:
    """Compare l'adresse KVK actuelle avec l'adresse stockée."""
    current = check_company_status(kvk_number)
    api_address = current.get("address", {})

    fields_to_check = ["straat", "huisnummer", "postcode", "plaats"]
    changes = {}

    for field in fields_to_check:
        stored_val = stored_address.get(field, "").lower().strip()
        api_val = str(api_address.get(field, "")).lower().strip()
        if stored_val != api_val and api_val:
            changes[field] = {
                "old": stored_address.get(field),
                "new": api_address.get(field)
            }

    if changes:
        return {
            "kvk_number": kvk_number,
            "company": current["name"],
            "changes": changes
        }
    return None

Fréquence et stratégie

La fréquence de surveillance dépend de votre profil de risque :

SegmentFréquence recommandéeRaison
Gros débiteurs (>10k d’encours)QuotidienneRisque financier élevé
Clients réguliersHebdomadaireÉquilibre entre risque et consommation d’API
Clients occasionnelsMensuelleFaible volume, faible risque
FournisseursMensuelleRisque de continuité d’activité

Pour la plupart des entreprises, un traitement par lots hebdomadaire de nuit, par segment, offre un bon équilibre. Associez-le à votre configuration de webhooks si vous voulez des mises à jour en temps réel en complément des contrôles périodiques.

Intégration avec votre CRM ou ERP

La surveillance devient vraiment puissante lorsqu’elle est connectée à vos systèmes existants. Imaginez :

  • Un client est déclaré en faillite, ce qui déclenche automatiquement une tâche pour le responsable crédit dans votre CRM
  • Un fournisseur est radié, ce qui fait apparaître un avertissement dans votre module d’achats à la prochaine commande
  • Un débiteur change d’adresse, ce qui met automatiquement à jour toutes les factures en cours avec les nouvelles coordonnées

Ces intégrations sont réalisables avec l’API KVKBase comme source de données et une couche intermédiaire légère qui traduit les événements en actions dans votre ERP ou votre CRM.

Démarrer la surveillance

Vous voulez mettre en place la surveillance du statut des entreprises pour votre propre portefeuille ? Commencez par ces étapes :

  1. Exportez vos numéros KVK depuis votre CRM ou votre logiciel de comptabilité
  2. Obtenez une clé d’API via le tableau de bord KVKBase
  3. Mettez en place un premier contrôle par lots avec un script Python ou une tâche cron
  4. Définissez vos seuils d’alerte : qu’est-ce qui déclenche une notification, et qui la reçoit ?
  5. Connectez-vous à votre workflow : un message Slack suffit-il, ou faut-il créer immédiatement une tâche ?

La surveillance n’est pas un projet ponctuel mais un processus continu. Les entreprises changent en permanence, et la plupart des changements ne deviennent un problème que lorsqu’on les remarque trop tard. Avec une surveillance KVK automatisée, vous disposez à tout moment d’une image fidèle de votre portefeuille clients, sans que personne ait à vérifier à la main chaque jour.

À lire aussi : Les entreprises nouvellement immatriculées comme prospects B2B, pour l’autre face de la médaille : repérer de nouvelles opportunités grâce au registre du commerce.