Recherche d'entreprise néerlandaise dans Zapier sans code

La configuration honnête : une étape webhook générique

Il n’y a pas d’application KVKBase dans l’annuaire Zapier. Ce qui existe, et fonctionne bien, c’est Webhooks by Zapier, l’étape intégrée pour appeler n’importe quelle API REST. Le même schéma s’applique à Make (module HTTP), n8n (nœud HTTP Request) et Power Automate (action HTTP).

Un Zap qui fonctionne ressemble à ceci :

L’étape 2 est presque toujours sautée, alors que c’est la moins chère du Zap. Sans elle, une cellule vide ou à moitié remplie vous coûte une tâche et une recherche, et renvoie une erreur.

Configuration de l’étape 3 :

Action:  Webhooks by Zapier > GET
URL:     https://api.kvkbase.nl/v1/lookup/68750110?enrich=true
Headers: Authorization | Bearer YOUR_API_KEY

Remplacez le numéro KvK par la référence du champ de votre déclencheur. Gardez la clé dans l’en-tête plutôt que dans la chaîne de requête : les chaînes de requête finissent dans les journaux, chez Zapier comme chez nous.

Comment Zapier vous transmet la réponse

Zapier aplatit le JSON avant que vous puissiez le mapper. Les objets imbriqués sont joints par un double tiret bas : address.city devient address__city et vat.valid devient vat__valid. Les tableaux comme activities et websites sont écrasés : si vous avez besoin d’un seul code SBI, utilisez une étape Formatter ou Code pour choisir le bon élément au lieu de supposer que le premier est l’activité principale.

Voici le piège dans lequel tout le monde tombe une fois. Zapier construit le menu de mapping à partir de votre réponse de test. Testez sans enrich=true et employees__total, websites et statutoryName n’apparaissent jamais dans ce menu : vous ne pourrez donc jamais les mapper. Testez avec une entreprise individuelle et tout le bloc vat manque, car le numéro de TVA n’est déduit que pour une BV et une NV.

Testez donc toujours avec exactement l’URL et les paramètres de requête que vous utiliserez en production, et avec une entreprise qui possède tous les champs dont vous avez besoin. Si vous modifiez la requête plus tard, retestez l’étape pour que les nouveaux champs apparaissent.

Quand vous n’avez qu’un nom d’entreprise

Les déclencheurs fournissent souvent un nom et pas de numéro. Dans ce cas, vous enchaînez deux étapes webhook : d’abord GET /v1/search?... avec le nom, qui renvoie des candidats avec leur numéro KvK, puis GET /v1/lookup/{kvkNumber} avec le numéro du premier résultat.

Ne faites cela que là où vous pouvez vous permettre de vous tromper. Un Zap prend toujours le premier résultat, et pour un nom comme « Van der Berg Holding », il y en a dix. Pour tout ce qui touche à une facture ou à un contrat, placez une personne dans la boucle : envoyez les candidats sur Slack ou dans une étape d’approbation et enrichissez ensuite. Notez que cette voie coûte deux recherches par enregistrement au lieu d’une.

Ce qui casse réellement en production

Un 404 arrête le Zap. Quand une entreprise n’existe plus, nous renvoyons NOT_FOUND avec un 404. Webhooks by Zapier traite tout code hors 2xx comme un échec et interrompt cette exécution. Sur une liste de cinq cents lignes, cela fait cinq cents erreurs dans votre historique de tâches. Utilisez GET /v1/verify/{kvkNumber} quand vous voulez seulement savoir si un numéro existe, ou interceptez l’erreur avec un chemin d’erreur pour que le reste continue.

Un déclencheur en masse atteint la limite de débit. Une feuille de calcul de deux mille lignes qui arrive d’un coup lance deux mille appels. L’offre gratuite en autorise dix par minute, Starter soixante. Zapier signale RATE_LIMIT_EXCEEDED et rejoue automatiquement, ce qui atteint de nouveau la limite. Ajoutez une étape Delay, ou faites le chargement initial avec un script et laissez le Zap ne gérer que les nouvelles lignes.

Des champs vides sans message d’erreur. Mappez vat__number alors que la réponse n’avait pas ce bloc et Zapier écrit simplement une valeur vide. Pas d’erreur, juste une colonne vide. Si cela compte pour vous, filtrez sur vat__valid is true avant d’appliquer une autoliquidation.

Le quota n’est pas la limite de débit. La limite par minute revient si vous patientez. Votre quota mensuel, non. Un Zap pris par erreur dans une boucle peut consommer en une matinée un quota gratuit de cinquante recherches. Consultez GET /v1/me/quota quand un Zap se met à échouer sans raison évidente.

Pour un travail répétable sur des centaines ou des milliers d’entreprises, un petit script utilisant POST /v1/lookup/batch bat toujours une exécution de Zap par ligne. Zapier est à son meilleur pour le cas unitaire : une nouvelle réponse de formulaire, une nouvelle affaire, un nouveau client.