n8n
Dane firm w workflow, bez kodu.
Z node’em n8n pobierasz dane firm do swoich workflow bez kodu. Node jest zweryfikowany przez n8n i wywołuje to samo API co twoje własne oprogramowanie.
Instalacja node
Zweryfikowane nodes instalujesz prosto z edytora. Może to zrobić tylko właściciel lub administrator instancji n8n; potem wszyscy członkowie mogą używać node.
- Otwórz workflow i kliknij „+”, aby otworzyć panel nodes.
- Wyszukaj „handelsregister.ai” i wybierz node z odznaką weryfikacji.
- Kliknij „Install”.
- Utwórz credential „Handelsregister.ai API” i wpisz swój klucz API. Alternatywnie użyj bearer tokenu.
W instancji self-hosted możesz też zainstalować node w Settings › Community Nodes z nazwą pakietu @handelsregister/n8n-nodes-handelsregister-ai.
Operacje
Node udostępnia endpointy API jako operacje. Kredyty są takie same jak w API.
| Operacja | Co robi | Kredyty |
|---|---|---|
| Fetch Organization | Profil firmy z wybieranymi features, trybem AI i trybem czasu rzeczywistego. | 5 + features |
| Search Organizations | Wyszukiwanie firm po nazwie i filtrach. „Return All” przechodzi przez wszystkie wyniki, „Maximum Results” ogranicza ich liczbę. | 1 za stronę |
| Fetch Person | Profil osoby, od Plus. | 15 |
| Fetch Document | Dokument z rejestru. Plik trafia potem do binarnej właściwości „data”. | 15 |
| List Signals | Signals według tematu, firmy i okresu, strona po stronie. | 20 za stronę |
| Get Signal | Pojedynczy sygnał. | 20 |
| Get Signal Catalog | Tematy Signals. | bezpłatnie |
Przy zapytaniach odczytu node ponawia błędy sieci, 408, 429 i błędy serwera do trzech razy. Z „Continue On Fail” workflow działa dalej, a wynik zawiera status, kod błędu i meta.
Przykładowy workflow
Ten workflow buduje listę wszystkich aktywnych GmbH w obszarze kodu pocztowego, każdą z jej zarządem.
- Zacznij od triggera, np. „Manual Trigger” do testów albo „Schedule Trigger” dla stałego harmonogramu.
- Dodaj node handelsregister.ai z operacją „Search Organizations”. W filtrach ustaw kod pocztowy, formę prawną GmbH i status aktywny.
- Ustaw „Output” na jeden element na firmę. Włącz „Return All” i ogranicz liczbę przez „Maximum Results”. Tak z góry wiesz, ile profili firm nastąpi.
- Dodaj drugi node handelsregister.ai z „Fetch Organization”. Wpisz w
qwyrażenie{{ $json.entity_id }}i wybierz feature Related Persons, czyli zarząd. - Zapisz wynik w miejscu docelowym, np. w arkuszu kalkulacyjnym lub w CRM.