n8n
Des données d’entreprise dans tes workflows, sans code.
Avec le node n8n, tu intègres des données d’entreprise dans tes workflows sans code. Le node est vérifié par n8n et appelle la même API que ton propre logiciel.
Installer le node
Tu installes les nodes vérifiés directement depuis l’éditeur. Seul le propriétaire ou un administrateur de l’instance n8n peut le faire ; ensuite, tous les membres peuvent utiliser le node.
- Ouvre un workflow et clique sur « + » pour ouvrir le panneau des nodes.
- Recherche « handelsregister.ai » et choisis le node portant le badge vérifié.
- Clique sur « Install ».
- Crée un credential « Handelsregister.ai API » et saisis ta clé API. Tu peux aussi utiliser un bearer token.
Dans une instance auto-hébergée, tu peux aussi installer le node sous Settings › Community Nodes avec le nom de paquet @handelsregister/n8n-nodes-handelsregister-ai.
Opérations
Le node propose les endpoints de l’API sous forme d’opérations. Les crédits sont les mêmes que dans l’API.
| Opération | Ce qu’elle fait | Crédits |
|---|---|---|
| Fetch Organization | Profil d’entreprise avec fonctionnalités au choix, mode IA et mode temps réel. | 5 + fonctionnalités |
| Search Organizations | Rechercher des entreprises par nom et filtres. « Return All » parcourt tous les résultats, « Maximum Results » en limite le nombre. | 1 par page |
| Fetch Person | Profil de personne, à partir de Plus. | 15 |
| Fetch Document | Un document du registre. Le fichier se trouve ensuite dans la propriété binaire « data ». | 15 |
| List Signals | Signals par thème, entreprise et période, page par page. | 20 par page |
| Get Signal | Un signal unique. | 20 |
| Get Signal Catalog | Les thèmes Signals. | gratuit |
Pour les requêtes de lecture, le node retente jusqu’à trois fois les erreurs réseau, 408, 429 et les erreurs serveur. Avec « Continue On Fail », le workflow continue, et le résultat contient le statut, le code d’erreur et meta.
Exemple de workflow
Ce workflow construit une liste de toutes les GmbH actives d’une zone de code postal, chacune avec sa direction.
- Commence par un trigger, par exemple « Manual Trigger » pour essayer ou « Schedule Trigger » pour un rythme fixe.
- Ajoute le node handelsregister.ai avec l’opération « Search Organizations ». Dans les filtres, définis le code postal, la forme juridique GmbH et le statut actif.
- Règle « Output » sur un élément par entreprise. Active « Return All » et limite le nombre avec « Maximum Results ». Tu sais ainsi à l’avance combien de profils d’entreprise suivront.
- Ajoute un second node handelsregister.ai avec « Fetch Organization ». Saisis l’expression
{{ $json.entity_id }}dansqet sélectionne la fonctionnalité Related Persons, la direction. - Écris le résultat vers ta destination, par exemple un tableur ou ton CRM.