n8n
Bedrijfsgegevens in workflows, zonder code.
Met de n8n-node haal je bedrijfsgegevens zonder code in je workflows. De node is door n8n geverifieerd en roept dezelfde API aan als je eigen software.
De node installeren
Geverifieerde nodes installeer je direct vanuit de editor. Alleen de eigenaar of een beheerder van de n8n-instantie kan dat; daarna kunnen alle leden de node gebruiken.
- Open een workflow en klik op „+” om het nodepaneel te openen.
- Zoek naar „handelsregister.ai” en kies de node met het verificatiebadge.
- Klik op „Install”.
- Maak een credential „Handelsregister.ai API” aan en voer je API-sleutel in. Je kunt ook een bearer-token gebruiken.
In een zelfgehoste instantie kun je de node ook installeren onder Settings › Community Nodes met de pakketnaam @handelsregister/n8n-nodes-handelsregister-ai.
Operaties
De node biedt de API-endpoints aan als operaties. De credits zijn dezelfde als in de API.
| Operatie | Wat ze doet | Credits |
|---|---|---|
| Fetch Organization | Bedrijfsprofiel met selecteerbare features, AI-modus en Realtime. | 5 + features |
| Search Organizations | Bedrijven zoeken op naam en filters. „Return All” bladert door alle resultaten, „Maximum Results” begrenst het aantal. | 1 per pagina |
| Fetch Person | Persoonsprofiel, vanaf Plus. | 15 |
| Fetch Document | Een document uit het register. Het bestand staat daarna in de binaire eigenschap „data”. | 15 |
| List Signals | Signals op onderwerp, bedrijf en periode, pagina voor pagina. | 20 per pagina |
| Get Signal | Eén signaal. | 20 |
| Get Signal Catalog | De Signals-onderwerpen. | gratis |
Bij leesaanvragen probeert de node netwerkfouten, 408, 429 en serverfouten tot drie keer opnieuw. Met „Continue On Fail” loopt de workflow door en bevat het resultaat de status, de foutcode en meta.
Voorbeeldworkflow
Deze workflow bouwt een lijst van alle actieve GmbH’s in een postcodegebied, elk met zijn bestuur.
- Begin met een trigger, bijvoorbeeld „Manual Trigger” om uit te proberen of „Schedule Trigger” voor een vast schema.
- Voeg de handelsregister.ai-node toe met de operatie „Search Organizations”. Stel in de filters de postcode, de rechtsvorm GmbH en de status actief in.
- Zet „Output” op één item per bedrijf. Zet „Return All” aan en begrens het aantal met „Maximum Results”. Zo weet je vooraf hoeveel bedrijfsprofielen er volgen.
- Voeg een tweede handelsregister.ai-node toe met „Fetch Organization”. Voer in
qde expressie{{ $json.entity_id }}in en kies de feature Related Persons, het bestuur. - Schrijf het resultaat naar je bestemming, bijvoorbeeld een spreadsheet of je CRM.