n8n
Yritystiedot työnkuluissa ilman koodia.
n8n-noden avulla tuot yritystietoja työnkulkuihisi ilman koodia. n8n on varmentanut noden, ja se kutsuu samaa API:a kuin oma ohjelmistosi.
Asenna node
Varmennetut nodet asennat suoraan editorista. Vain n8n-instanssin omistaja tai ylläpitäjä voi tehdä tämän; sen jälkeen kaikki jäsenet voivat käyttää nodea.
- Avaa työnkulku ja avaa nodepaneeli napsauttamalla ”+”.
- Hae ”handelsregister.ai” ja valitse node, jossa on varmennusmerkki.
- Napsauta ”Install”.
- Luo ”Handelsregister.ai API” -tunnistetieto (credential) ja syötä API-avaimesi. Vaihtoehtoisesti käytä bearer-tokenia.
Itse ylläpidetyssä instanssissa voit asentaa noden myös kohdassa Settings › Community Nodes paketin nimellä @handelsregister/n8n-nodes-handelsregister-ai.
Operaatiot
Node tarjoaa API:n päätepisteet operaatioina. Krediitit ovat samat kuin API:ssa.
| Operaatio | Mitä se tekee | Krediitit |
|---|---|---|
| Fetch Organization | Yritysprofiili valittavine ominaisuuksineen, AI-tilalla ja Reaaliajalla. | 5 + ominaisuudet |
| Search Organizations | Hae yrityksiä nimellä ja suodattimilla. ”Return All” käy läpi kaikki tulossivut, ”Maximum Results” rajaa määrän. | 1 sivulta |
| Fetch Person | Henkilöprofiili, Plussasta alkaen. | 15 |
| Fetch Document | Asiakirja rekisteristä. Tiedosto on sen jälkeen binääriominaisuudessa ”data”. | 15 |
| List Signals | Signals aiheen, yrityksen ja ajanjakson mukaan, sivu kerrallaan. | 20 sivulta |
| Get Signal | Yksittäinen signaali. | 20 |
| Get Signal Catalog | Signals-aiheet. | maksuton |
Lukupyynnöissä node yrittää verkkovirheitä, tiloja 408 ja 429 sekä palvelinvirheitä uudelleen enintään kolme kertaa. Asetuksella ”Continue On Fail” työnkulku jatkuu, ja tulos sisältää tilan, virhekoodin ja kentän meta.
Esimerkkityönkulku
Tämä työnkulku kokoaa listan kaikista postinumeroalueen aktiivisista GmbH-yhtiöistä, kunkin johtoineen.
- Aloita triggerillä, esimerkiksi ”Manual Trigger” kokeilua varten tai ”Schedule Trigger” kiinteää aikataulua varten.
- Lisää handelsregister.ai-node operaatiolla ”Search Organizations”. Aseta suodattimiin postinumero, yhtiömuoto GmbH ja tila aktiivinen.
- Aseta ”Output” yhdeksi itemiksi yritystä kohden. Ota ”Return All” käyttöön ja rajaa määrä asetuksella ”Maximum Results”. Näin tiedät etukäteen, kuinka monta yritysprofiilia seuraa.
- Lisää toinen handelsregister.ai-node operaatiolla ”Fetch Organization”. Syötä parametriin
qlauseke{{ $json.entity_id }}ja valitse ominaisuus Related Persons eli johto. - Kirjoita tulos kohteeseesi, esimerkiksi taulukkoon tai CRM:ään.