Vérifier si une entreprise néerlandaise est toujours active

Le vocabulaire néerlandais, car les mots ne sont pas interchangeables

Cinq termes néerlandais sont aplatis en « fermée » en français, alors qu’ils signifient des choses différentes pour votre modèle de risque.

Celui qui piège les équipes étrangères est le bloc du milieu. Une entreprise néerlandaise en faillite est toujours dans le registre et peut encore renvoyer isActive: true, car l’inscription n’est pas clôturée tant que la masse n’est pas réglée. Si votre contrôle est if (isActive) proceed, vous accorderez volontiers du crédit à une entreprise sous administration.

Vérifiez toujours les deux champs :

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

isActive est un booléen. insolvency contient l’état d’insolvabilité enregistré et est absent ou vide s’il n’y en a pas. Aucun des deux champs n’exige enrich=true, ce qui en fait le contrôle utile le moins cher que vous puissiez lancer.

Un tableau de décision qui résiste à la réalité

La troisième ligne est la plus intéressante. Une inscription qui devient inactive n’est pas automatiquement une mauvaise nouvelle. Des entrepreneurs individuels se transforment en BV et l’ancienne inscription se clôt. Des groupes fusionnent leurs filiales dans la société mère. Une entreprise déplace son inscription. Dans tous ces cas, la contrepartie existe toujours, souvent sous un nouveau numéro KvK que vous n’avez pas encore.

Désactiver automatiquement des comptes sur isActive: false produit des clients furieux qui n’ont rien fait de mal. Dirigez le cas vers une personne, ou au minimum affichez-le comme un avertissement plutôt que comme une sanction.

Pourquoi le cache de 24 heures compte ici en particulier

Les données d’entreprise de cette API sont mises en cache 24 heures pour les entreprises actives. Sur la plupart des pages, c’est une note de bas de page. Sur celle-ci, c’est tout le risque.

La chaîne de délais est plus longue que le cache seul :

1. L’événement a lieu, par exemple un tribunal déclare une faillite.
2. La publication est traitée et le registre est mis à jour. Ce n’est pas instantané.
3. Notre cache peut servir une copie prise avant cette mise à jour, pendant 24 heures au plus.

L’énoncé honnête est donc : une réponse true signifie « aucune clôture ni insolvabilité n’était enregistrée à un moment donné au cours du dernier jour ». C’est une excellente entrée pour l’intégration d’un client, pour un balayage mensuel de portefeuille, pour décider de continuer ou non à envoyer une lettre d’information. C’est une entrée faible pour libérer des marchandises dont la valeur dépasse ce que vous pouvez vous permettre de perdre, et il faut le dire en interne plutôt que de laisser une coche verte laisser entendre plus que ce qu’elle signifie.

En pratique : enregistrez l’horodatage du contrôle à côté du résultat. Quand quelque chose tourne mal, la question sera « qu’est-ce que nous savions et quand », et un booléen sans horodatage ne peut pas y répondre.

Surveiller plutôt que vérifier

Un contrôle ponctuel à l’inscription vieillit immédiatement. Si la relation avec la contrepartie est durable, interrogez régulièrement. Les recherches par lots rendent cela abordable :

curl -X POST "https://api.kvkbase.nl/v1/lookup/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kvkNumbers":["68750110","12345678"]}'

Lancez-le chaque semaine sur votre base clients, comparez isActive et insolvency avec les valeurs stockées, et ne déclenchez une alerte qu’en cas de changement. Des milliers d’enregistrements se réduisent ainsi à une poignée d’éléments qu’une personne lit réellement. Les détails de planification, de quota et d’alerte sont traités dans la surveillance du statut des entreprises KvK.

Une dernière habitude qui s’amortit toute seule : quand vous stockez le résultat, stockez le triplet de statut complet plutôt qu’un seul booléen dérivé. Conserver isActive, la valeur d’insolvency et l’heure du contrôle vous permet de répondre plus tard sans réinterroger, et de distinguer une entreprise bloquée parce qu’elle était en faillite d’une entreprise bloquée parce que son inscription s’est clôturée. Une seule colonne is_ok jette cette information, et vous la regretterez la première fois qu’un client contestera une décision.

Si vous préférez ne pas construire cela vous-même, la surveillance d’entreprises contrôle chaque jour une liste d’entreprises et signale une radiation, un sursis de paiement ou une faillite par e-mail ou webhook.