Tout construire soi-même ou utiliser une API

Tout construire soi-même est une option sérieuse

Ce n’est pas un homme de paille à abattre. Les données du registre néerlandais sont publiques, la KvK publie un jeu de données ouvert gratuit avec les données de base des entreprises, et il existe une API documentée. Pour un enrichissement ponctuel d’un fichier, une migration, une analyse ou un outil interne, construire soi-même est souvent simplement le bon choix. Vous n’avez besoin de personne pour vous vendre un abonnement pour cela.

Le tableau change dès que cela devient quelque chose qui continue de tourner.

Le scraping face à l’API

Brièvement, et sans sermon. Les données sont publiques, mais le site de la KvK a des conditions d’utilisation et l’extraction automatisée sort généralement de leur cadre. Il y a une API et un jeu de données ouvert juste à côté qui servent le même but. Et si vous pesez quand même cette option : un scraper est aussi le plus faible des trois sur le plan technique, car toute modification de l’interface casse votre analyseur et vous ne le découvrez que quand vos données se taisent.

Utiliser le jeu de données ouvert n’est pas du scraping et ne pose pas ce problème.

Où partent réellement les heures

Quatre endroits, par ordre de fréquence à laquelle ils surprennent.

VIES. Le numéro de TVA ne figure pas dans le registre du commerce. Vous le déduisez sous la forme NL + numéro KvK + B01, et cela ne vaut que pour les BV et NV. Il faut ensuite le vérifier auprès de VIES, qui fonctionne en SOAP. VIES est souvent lent et les États membres tombent en panne indépendamment les uns des autres. Il vous faut donc des nouvelles tentatives, un délai d’expiration qui ne bloque pas votre paiement, et un cache avec sa propre durée de validité.

Le piège qui casse le plus souvent en production : « invalide » et « VIES était injoignable » ne sont pas la même chose. Ramenez les deux à un seul false et vous bloquerez des clients légitimes pendant une panne sans savoir pourquoi. Conservez la raison séparément, même si votre interface n’en fait qu’une seule chose. Le contexte se trouve dans le guide de validation du numéro de TVA avec VIES.

Adresses. La rue, le numéro et le complément n’arrivent pas proprement dans un seul champ. Des compléments comme A, bis, 2-hoog et zwart doivent rester séparés du numéro de rue, sinon votre adresse ne correspondra plus à rien ensuite. Nous renvoyons houseNumber et houseNumberAddition comme champs distincts précisément pour cette raison.

Formes juridiques. Les notations du registre ne sont pas ce que vous voulez montrer dans votre interface ni ce que vous voulez dans votre logique de facturation. Vous construisez une table de correspondance, et cette table n’est jamais terminée.

Rafraîchissement. Une copie du jeu de données ouvert est un instantané par définition. Les immatriculations, déménagements et changements de nom continuent. Il vous faut un calendrier d’import, un moyen de savoir quel âge a votre copie, et une décision sur ce qu’il faut faire d’un numéro KvK que vous n’avez pas encore. C’est de la maintenance, pas de la construction.

Pour les règles de validation du numéro KvK lui-même, vous n’avez rien à inventer, elles figurent dans l’article sur la validation du numéro KvK et la somme de contrôle.

Qui devrait tout construire soi-même

Construisez-le vous-même si c’est ponctuel, si cela reste interne, si votre volume est assez faible pour qu’une panne ne gêne personne, ou si vous avez déjà une équipe qui maintient des intégrations de ce genre. Ce n’est pas une réponse de second choix, c’est la solution la moins chère pour cette situation.

Si vous finissez chez nous, c’est parce que cela se trouve dans un parcours client et doit continuer de fonctionner sans que personne n’y jette un œil chaque semaine : un appel pour l’entreprise plus la TVA, ou le widget intégrable si vous préférez n’écrire aucun backend. Et si vous le construisez vous-même, portez au moins jusqu’au bout la distinction entre invalide et injoignable. C’est l’erreur qui coûte le plus cher.