n8n
Cégadatok workflow-kban, kód nélkül.
Az n8n node-dal kód nélkül húzod be a cégadatokat a workflow-idba. A node-ot az n8n ellenőrizte, és ugyanazt az API-t hívja, mint a saját szoftvered.
A node telepítése
Az ellenőrzött node-okat közvetlenül a szerkesztőből telepíted. Ezt csak az n8n-példány tulajdonosa vagy egy admin teheti meg; ezután minden tag használhatja a node-ot.
- Nyiss meg egy workflow-t, és kattints a „+” jelre a nodes panel megnyitásához.
- Keress rá a „handelsregister.ai” kifejezésre, és válaszd az ellenőrzött jelvényes node-ot.
- Kattints az „Install” gombra.
- Hozz létre egy „Handelsregister.ai API” credentialt, és add meg az API-kulcsodat. Alternatívaként használj bearer tokent.
Saját üzemeltetésű példányban a node-ot a Settings › Community Nodes alatt is telepítheted a @handelsregister/n8n-nodes-handelsregister-ai csomagnévvel.
Műveletek
A node az API végpontjait műveletekként kínálja. A kreditek ugyanazok, mint az API-ban.
| Művelet | Mit csinál | Kredit |
|---|---|---|
| Fetch Organization | Cégprofil választható funkciókkal, AI móddal és valós idejű móddal. | 5 + funkciók |
| Search Organizations | Cégek keresése név és szűrők alapján. A „Return All” az összes találaton végiglapoz, a „Maximum Results” korlátozza a számukat. | oldalanként 1 |
| Fetch Person | Személyprofil, Plus csomagtól. | 15 |
| Fetch Document | Egy dokumentum a nyilvántartásból. A fájl ezután a „data” bináris tulajdonságban van. | 15 |
| List Signals | Signals téma, cég és időszak szerint, oldalanként. | oldalanként 20 |
| Get Signal | Egyetlen jelzés. | 20 |
| Get Signal Catalog | A Signals-témák. | ingyenes |
Olvasási kéréseknél a node a hálózati hibákat, a 408-at, a 429-et és a szerverhibákat legfeljebb háromszor próbálja újra. A „Continue On Fail” beállítással a workflow tovább fut, és az eredmény tartalmazza a státuszt, a hibakódot és a meta mezőt.
Példa workflow
Ez a workflow egy irányítószám-körzet összes aktív GmbH-jának listáját állítja össze, mindegyiket a vezetésével.
- Kezdj egy triggerrel, például „Manual Trigger” a kipróbáláshoz vagy „Schedule Trigger” rögzített ütemezéshez.
- Add hozzá a handelsregister.ai node-ot a „Search Organizations” művelettel. A szűrőkben állítsd be az irányítószámot, a GmbH jogi formát és az aktív státuszt.
- Állítsd az „Output” beállítást cégenként egy itemre. Kapcsold be a „Return All” opciót, és korlátozd a számot a „Maximum Results” beállítással. Így előre tudod, hány cégprofil következik.
- Adj hozzá egy második handelsregister.ai node-ot „Fetch Organization” művelettel. Írd be a
{{ $json.entity_id }}kifejezést aqmezőbe, és válaszd ki a Related Persons funkciót, a vezetést. - Írd az eredményt a célhelyedre, például egy táblázatba vagy a CRM-edbe.