GUS REGON API + Biala Lista VAT – CRM enrichment dla B2B (workflow n8n)

Polski handlowiec B2B traci 15 minut na kazdy nowy lead sprawdzajac recznie NIP w Bialej Liscie VAT, pobierajac dane z GUS REGON, weryfikujac KRS i wstukujac to do CRM. 50 leadow = 12,5h pracy miesiecznie. Workflow n8n z GUS REGON API + Biala Lista robi to w 8 sekund. Ten przewodnik pokazuje pelen setup.

Co to jest GUS REGON API i co daje

GUS REGON to oficjalna baza danych Glownego Urzedu Statystycznego z informacjami o wszystkich zarejestrowanych w Polsce firmach. API gratis, wymaga rejestracji i klucza. Z NIP/REGON/KRS pobierasz:

• Pelna nazwa firmy + adres siedziby + adres korespondencyjny
• PKD glowny + dodatkowe (kody dzialalnosci)
• Forma prawna (sp. z o.o., j.d.g., S.A.)
• Data rejestracji + data zawieszenia/wykreslenia (jesli byla)
• NIP, REGON, KRS – cross-validacja
• Liczba pracownikow (przedzial, np. 10-49)

Plus z Bialej Listy VAT (osobne API MF): status czynny/nieczynny, konta bankowe zgloszone do MF, data rejestracji jako podatnik VAT.

Use case: enrichment leadow w CRM

Klient SYSTEMBOX (B2B SaaS, ~80 leadow/mies): lead zostawia tylko email + NIP w formularzu. Workflow n8n auto-zbiera wszystkie pozostale dane i pushuje do HubSpot. Handlowiec widzi pelen profil firmy bez recznego klikania.

Setup workflow n8n

Krok 1: Klucz GUS REGON API

Wejdz na api.stat.gov.pl, zarejestruj sie, wypelnij formularz (email, dane firmy). Klucz dostaniesz mailem w 1-3 dni. Bezplatny, limit 5 000 wywolan/dzien.

Krok 2: HTTP Request – GUS REGON

Endpoint: https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc (SOAP). Pro tip: uzyj wrappera REST jak regon-go.pl lub biz-data.pl, latwiejsze niz SOAP. Lub Twoj wlasny serwer Python z biblioteka RegonAPI.

Workflow: POST https://api.stat.gov.pl/regon/v1/search body {"nip": "{{ $json.nip }}"} headers X-Api-Key: TWOJ_KLUCZ. Response zawiera REGON + nazwa + adres + PKD.

Krok 3: HTTP Request – Biala Lista VAT

Endpoint: GET https://wl-api.mf.gov.pl/api/search/nip/{{nip}} (gratis, bez klucza). Response: status czynny/nieczynny + lista kont bankowych zgloszonych do MF.

Krok 4: Merge response w n8n

Function node laczy oba response w jeden JSON z polami: nip, regon, nazwa, adres, pkd_main, status_vat, konta_bankowe, data_enrichment.

Krok 5: Push do CRM

HubSpot Contact Update przez API: PATCH /contacts/v1/contact/email/{{email}} z payloadem JSON. Pipedrive: PUT /v1/persons/{{id}}. Salesforce: POST /services/data/v60.0/sobjects/Contact/Email/.

Praktyczne edge cases

1. NIP UE (intra-community)

NIP z prefixem (PL1234567890) wymaga osobnego endpoint: VIES VAT validation przez Komisje Europejska. https://ec.europa.eu/taxation_customs/vies/. n8n moze to obsluzyc HTTP Request z parseowaniem XML.

2. Firma nie istnieje / zawieszona

GUS moze zwrocic 404 lub status zawieszony. Workflow musi to obsluzyc: IF node sprawdza status, jesli zawieszony, push do HubSpot z tagiem „Firma zawieszona” + email do handlowca do weryfikacji manualnej.

3. Limit API GUS

5 000 wywolan/dzien to duzo, ale gdy enrichu istniejaca baze 50k kontaktow = 10 dni. Rozwiazanie: queue + batch processing. n8n Schedule node co godzine przetwarza 200 rekordow. Plus cache: jesli juz raz pobrane = pomin.

Co dalej z enriched data: 5 use cases

• Lead scoring: firmy z PKD 70.22 (consulting) + 10-49 prac = +20 pkt scoring (twoja ICP)
• Personalizacja email: dane PKD/wielkosc, rozne email sequences
• Compliance KYC: status VAT czynny? Konto zgloszone do MF? Jesli nie = flag
• Auto-faktura: pelne dane do Subiekt API = faktura w 5 sek
• Sales triggers: nowy adres = mozliwy expansion, handlowiec sprawdz

Koszt vs ROI

• GUS REGON API: gratis (limit 5k/dzien)
• Biala Lista VAT: gratis
• n8n self-hosted: ~20 zl/mies VPS
• Setup time: 2-3h sam lub VIP setup 2 997 zl
• Oszczednosc handlowca: 15 min/lead x 80 leadow/mies = 20h x 100 zl/h = 2 000 zl/mies

FAQ

Czy moge uzywac GUS API komercyjnie?

Tak, GUS BIR1 jest publicznym API. Mozesz uzywac do wszystkich celow biznesowych. Bez ograniczen komercyjnych.

Co z RODO?

Dane firmowe (NIP, REGON, nazwa, adres) sa publiczne i nie sa objete RODO. Dane osobowe (CEO, kontakty) wymagaja oddzielnej zgody.

Czy sa API z dodatkowymi danymi (kontakty, decision makers)?

Tak. Apollo, Clay, ZoomInfo dodaja emaile + LinkedIn decision makers. Ale sa platne ($50-500/mies) i dane moga byc stare. GUS + LinkedIn manualnie czesto wystarczy.