n8n
Data o firmách ve workflow, bez kódu.
S nodem pro n8n dostaneš data o firmách do svých workflow bez kódu. Node je ověřený od n8n a volá stejné API jako tvůj vlastní software.
Instalace nodu
Ověřené nody instaluješ přímo z editoru. Může to udělat jen vlastník nebo administrátor instance n8n; potom mohou node používat všichni členové.
- Otevři workflow a kliknutím na „+“ otevři panel nodů.
- Vyhledej „handelsregister.ai“ a vyber node s odznakem ověření.
- Klikni na „Install“.
- Vytvoř credential „Handelsregister.ai API“ a zadej svůj API klíč. Případně použij bearer token.
V instanci provozované ve vlastní režii můžeš node nainstalovat i v Settings › Community Nodes s názvem balíčku @handelsregister/n8n-nodes-handelsregister-ai.
Operace
Node nabízí endpointy API jako operace. Kredity jsou stejné jako v API.
| Operace | Co dělá | Kredity |
|---|---|---|
| Fetch Organization | Profil firmy s volitelnými funkcemi, AI režimem a režimem v reálném čase. | 5 + funkce |
| Search Organizations | Hledat firmy podle názvu a filtrů. „Return All“ projde všechny výsledky, „Maximum Results“ omezí jejich počet. | 1 za stránku |
| Fetch Person | Profil osoby, od tarifu Plus. | 15 |
| Fetch Document | Dokument z rejstříku. Soubor je pak v binární vlastnosti „data“. | 15 |
| List Signals | Signals podle tématu, firmy a období, stránku po stránce. | 20 za stránku |
| Get Signal | Jeden signál. | 20 |
| Get Signal Catalog | Témata Signals. | zdarma |
U čtecích požadavků node opakuje chyby sítě, 408, 429 a chyby serveru až třikrát. S „Continue On Fail“ workflow běží dál a výsledek obsahuje stav, chybový kód a meta.
Ukázkový workflow
Tento workflow sestaví seznam všech aktivních GmbH v oblasti jednoho PSČ, každou s jejím vedením.
- Začni triggerem, například „Manual Trigger“ na vyzkoušení nebo „Schedule Trigger“ pro pevný harmonogram.
- Přidej node handelsregister.ai s operací „Search Organizations“. Ve filtrech nastav PSČ, právní formu GmbH a stav aktivní.
- Nastav „Output“ na jednu položku na firmu. Zapni „Return All“ a omez počet pomocí „Maximum Results“. Předem tak víš, kolik profilů firem bude následovat.
- Přidej druhý node handelsregister.ai s „Fetch Organization“. Do
qzadej výraz{{ $json.entity_id }}a vyber funkci Related Persons, tedy vedení. - Zapiš výsledek do svého cíle, například do tabulky nebo do CRM.