L'API officielle de la KvK ou KVKBase

Nous nous appuyons sur la même source

Il n’existe pas de second registre du commerce néerlandais. La KvK est la source de référence, nous interrogeons nous-mêmes cette API, et chaque champ que nous renvoyons vient de là ou de VIES. La question n’est donc pas de savoir à qui appartiennent les meilleures données, mais qui fait le travail d’assemblage.

Une version technique plus détaillée de la même comparaison se trouve dans l’article sur l’API officielle de la KvK face à KVKBase.

Ce que l’API de la KvK fait mieux

Trois choses, sans détour.

C’est l’autorité. Dans un litige, un audit ou une discussion avec un régulateur, « récupéré auprès de l’API de la KvK » est une réponse plus solide que « récupéré auprès d’un intermédiaire qui interroge la KvK ». Si c’est votre situation, cela pèse plus lourd que la commodité.

Il y a des endpoints que nous ne revendons pas. Notre catalogue est une sélection. Si vous avez besoin de quelque chose qui n’y figure pas, l’accès direct est la seule voie.

Pas d’intermédiaire. Une grande équipe interne qui veut son propre contrat, son propre SLA et une ligne directe en cas de panne ne devrait placer personne entre elle et la source. C’est un choix d’architecture légitime, pas un manque de confiance.

Ce que coûte réellement l’accès direct

Pas les 0,02 EUR. La facture arrive sous forme de code.

Une image complète d’une entreprise représente plusieurs appels chez la KvK : la recherche pour passer d’un nom à un numéro KvK, le profil de base, le profil des établissements pour l’adresse et les données d’établissement, et les noms pour la dénomination sociale et les noms commerciaux. Ce sont des réponses distinctes que vous fusionnez vous-même, avec votre propre gestion d’erreurs par appel et votre propre décision sur ce qui se passe quand le troisième appel échoue après la réussite des deux premiers.

Puis il y a la TVA. 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, ce qui ne vaut que pour les BV et NV, puis vous le vérifiez auprès de VIES. VIES fonctionne en SOAP, il est souvent lent, et il tombe en panne indépendamment par État membre. Cela implique des nouvelles tentatives, un cache, et une réponse explicite à la question de ce que vous affichez quand VIES ne dit rien plutôt que « invalide ». Ce dernier point est le piège sur lequel la plupart des intégrations échouent : valid: false et « VIES était injoignable » ne doivent jamais se ressembler dans votre interface.

Chez nous, c’est un seul appel. GET /v1/lookup/{kvkNumber} renvoie le profil plus vat avec number, valid et validatedAt, et ?enrich=true ajoute l’adresse postale, les effectifs, les sites web, la dénomination sociale, les noms commerciaux et le nombre d’établissements.

Faire le calcul de volume

Sur l’endpoint de profil payant, mille requêtes reviennent à environ 26,40 EUR par mois chez la KvK, contre 19 EUR chez nous pour mille recherches. Cinq mille reviennent à environ 106,40 EUR contre nos 49 EUR. Cela ne s’inverse que si vous pouvez traiter assez de demandes depuis l’endpoint de recherche gratuit pour limiter les requêtes de profil, ou si vous mettez en cache de façon si agressive que votre nombre de requêtes reste très en dessous de votre nombre d’utilisateurs.

Faites le calcul avec votre propre taux de réussite du cache avant de trancher sur le prix. Avec un cache bien rempli de votre côté, l’accès direct est souvent moins cher qu’il n’y paraît d’abord.

Qui devrait passer en direct

Intégrez-vous directement à la KvK si vous avez une équipe interne qui en assumera la charge, si vous voulez votre propre contrat avec la source, ou si vous avez besoin d’endpoints hors de notre catalogue. Passez aussi en direct pour tout contrôle où un jour de retard est inacceptable, par exemple un contrôle d’insolvabilité juste avant l’expédition, où notre cache de 24 heures est le mauvais outil.

Si vous finissez chez nous, c’est parce que vous voulez l’entreprise et la TVA dans une seule réponse et préférez ne pas maintenir vous-même la fusion et le travail VIES.