NIP, biała lista i KRS w jednym wierszu: wzbogacanie danych firm w n8n

NIP, biała lista i KRS w jednym wierszu: wzbogacanie danych firm w n8n#

Lista leadów, kontrahentów albo dostawców często zaczyna się od samego NIP-u. Reszta, czyli nazwa, REGON, forma prawna, kto zasiada w zarządzie, czym firma się zajmuje i na jakie rachunki przyjmuje płatności, leży w dwóch publicznych rejestrach. Oba mają darmowe API.

Ten workflow n8n łączy je w jeden wiersz arkusza. Nie wymaga klucza do żadnego z rejestrów.

Numer KRS bierzemy z białej listy#

API KRS przyjmuje numer KRS, nie NIP. Zamiast prosić użytkownika o drugi identyfikator, workflow najpierw pyta białą listę VAT, która w odpowiedzi zwraca pole krs, i dopiero wtedy idzie do KRS po aktualny odpis:

wl-api.mf.gov.pl/api/search/nip/{NIP}?date={dziś}
api-krs.ms.gov.pl/api/krs/OdpisAktualny/{KRS z odpowiedzi}?rejestr=P&format=json

Firma bez wpisu w KRS (na przykład jednoosobowa działalność) dostaje dane z białej listy, a pola z KRS zostają puste.

Odpis z KRS nie ma jednego kształtu#

Struktura odpisu zależy od formy prawnej. Zarząd spółki z o.o. i wspólnicy spółki jawnej siedzą pod innymi kluczami, a imiona bywają tablicą obiektów albo zwykłym tekstem. Zamiast mapować każdą ścieżkę osobno, kod szuka kluczy w głąb drzewa:

const dane   = odpis ? findDeep(odpis, 'danePodmiotu') : null;
const header = odpis ? findDeep(odpis, 'naglowekA') : null;
const pkd    = odpis ? findDeep(odpis, 'przedmiotDzialalnosci') : null;

Osoby są zbierane z działu 2 odpisu jako „imię nazwisko (funkcja)”, bez duplikatów, maksymalnie 12.

Dwa szczegóły, przez które Google Sheets odrzuca zapis#

Drugi szczegół: aktualizacja z automatycznym mapowaniem nie lubi mieszanych typów. Wartość logiczna w jednej kolumnie i tekst w drugiej potrafią dać błąd. Wszystko idzie więc jako tekst, a puste wartości jako puste komórki, a nie słowo „null”.

Co ląduje w arkuszu#

Ograniczenia#

Jednoosobowe działalności nie mają wpisu w KRS. Ich dane rejestrowe są w CEIDG, której API wymaga tokenu, więc ten workflow go nie używa.

Zapytanie idzie tylko do rejestru przedsiębiorców (rejestr=P). Stowarzyszenia i fundacje są w rejestrze S i zostaną bez danych z KRS.

Każda firma to dwa zapytania. Limit API Ministerstwa wynosi 100 zapytań dziennie, więc dłuższe listy trzeba dzielić na kilka dni. NIP z błędną sumą kontrolną i tak trafia do zapytania (kończy się błędem i jest pomijany), więc warto go odfiltrować wcześniej.

Wyszukiwanie kluczy w głąb to heurystyka. Przy nietypowej formie prawnej któreś pole może zostać puste, mimo że informacja jest w odpisie.

Kiedy to nie ma sensu#

Przy kilku firmach szybciej sprawdzić je w wyszukiwarkach rejestrów. Workflow przydaje się przy listach liczonych w setkach, na przykład przy przygotowaniu bazy do sprzedaży albo przeglądzie dostawców. Przed samą płatnością lepiej sprawdza się osobny workflow, który weryfikuje kontrahentów na białej liście. Gdy dane z rejestrów mają trafiać prosto do CRM albo systemu zakupowego, to już zadanie dla automatyzacji procesów.