n8n
Dati aziendali nei workflow, senza codice.
Con il nodo n8n porti i dati aziendali nei tuoi workflow senza codice. Il nodo è verificato da n8n e chiama la stessa API del tuo software.
Installare il nodo
I nodi verificati li installi direttamente dall’editor. Può farlo solo l’owner o un admin dell’istanza n8n; dopo, tutti i membri possono usare il nodo.
- Apri un workflow e clicca su “+” per aprire il pannello dei nodi.
- Cerca “handelsregister.ai” e scegli il nodo con il badge di verifica.
- Clicca su “Install”.
- Crea una credential “Handelsregister.ai API” e inserisci la tua chiave API. In alternativa usa un bearer token.
In un’istanza self-hosted puoi installare il nodo anche in Settings › Community Nodes con il nome del pacchetto @handelsregister/n8n-nodes-handelsregister-ai.
Operazioni
Il nodo offre gli endpoint dell’API come operazioni. I crediti sono gli stessi dell’API.
| Operazione | Cosa fa | Crediti |
|---|---|---|
| Fetch Organization | Profilo aziendale con feature selezionabili, Modalità AI e Tempo reale. | 5 + feature |
| Search Organizations | Cercare aziende per nome e filtri. “Return All” sfoglia tutti i risultati, “Maximum Results” limita il numero. | 1 per pagina |
| Fetch Person | Profilo persona, da Plus. | 15 |
| Fetch Document | Un documento dal registro. Il file si trova poi nella proprietà binaria “data”. | 15 |
| List Signals | Signals per tema, azienda e periodo, pagina per pagina. | 20 per pagina |
| Get Signal | Un singolo segnale. | 20 |
| Get Signal Catalog | I temi Signals. | gratis |
Per le richieste di lettura il nodo ripete errori di rete, 408, 429 ed errori del server fino a tre volte. Con “Continue On Fail” il workflow continua e il risultato contiene lo stato, il codice di errore e meta.
Workflow di esempio
Questo workflow crea una lista di tutte le GmbH attive in un’area di codice postale, ciascuna con la sua direzione.
- Inizia con un trigger, ad esempio “Manual Trigger” per provare o “Schedule Trigger” per una pianificazione fissa.
- Aggiungi il nodo handelsregister.ai con l’operazione “Search Organizations”. Nei filtri imposta il codice postale, la forma giuridica GmbH e lo stato attivo.
- Imposta “Output” su un item per azienda. Attiva “Return All” e limita il numero con “Maximum Results”. Così sai in anticipo quanti profili aziendali seguiranno.
- Aggiungi un secondo nodo handelsregister.ai con “Fetch Organization”. Inserisci l’espressione
{{ $json.entity_id }}inqe seleziona la feature Related Persons, la direzione. - Scrivi il risultato nella tua destinazione, ad esempio un foglio di calcolo o il tuo CRM.