🔎 Dane kontrahenta z rejestrów po NIP
Integracja z GUS REGON, KRS i CEIDG: dane firmy po NIP
Wpisujesz NIP, a nazwa firmy, adres, REGON, numer KRS i sposób reprezentacji uzupełniają się same w CRM, formularzu albo umowie. Łączymy Twój system z CEIDG, GUS REGON i KRS przez ich API i pilnujemy, żeby awaria rejestru dawała jasny komunikat, a nie puste albo zmyślone pole.
Integracja z GUS REGON, KRS i CEIDG w skrócie
Integracja z GUS REGON, KRS i CEIDG to połączenie Twojego systemu z publicznymi rejestrami firm przez API, dzięki któremu po wpisaniu NIP-u dane firmy uzupełniają się same. W Today CRM kolejność jest stała: najpierw CEIDG dla jednoosobowych działalności, potem GUS REGON dla spółek i innych podmiotów, a dla spółki z numerem KRS jeszcze odpis z KRS z zasadami reprezentacji.
Najpierw suma kontrolna.
NIP z literówką odpada przed pierwszym zapytaniem do rejestru, z komunikatem o błędnych cyfrach.
Właściwy rejestr.
Jednoosobowa działalność z CEIDG, spółka z GUS REGON i KRS. Użytkownik nie musi wiedzieć, gdzie szukać.
Nic nie jest zgadywane.
Gdy rejestr nie odpowie, widzisz, który i dlaczego. Pole nie wypełnia się wartością zastępczą.
Nazwisko wpisuje człowiek.
KRS podaje funkcję w zarządzie i sposób reprezentacji, ale nazwiska w publicznym odpisie są zamaskowane.
Dane kontrahenta bez przepisywania z wyszukiwarki
Dziś: Nazwa i adres przepisywane ręcznie z wyszukiwarki rejestru
Po wdrożeniu: NIP wpisany raz, reszta pól uzupełnia się sama
Dziś: Literówka w NIP wychodzi dopiero na fakturze albo w umowie
Po wdrożeniu: Suma kontrolna sprawdzona przed zapytaniem do rejestru
Dziś: Ręczne szukanie, czy firma jest w CEIDG, czy w KRS
Po wdrożeniu: System sam idzie po kolei: CEIDG, GUS REGON, KRS
Dziś: Sposób reprezentacji spółki sprawdzany w odpisie z KRS
Po wdrożeniu: Funkcja w zarządzie i zasady reprezentacji widoczne przy umowie
Dziś: Ta sama firma kilka razy w bazie, bo NIP zapisano różnie
Po wdrożeniu: NIP zapisany jako same cyfry, jedna firma na jeden numer
Dane firmy pochodzą z rejestru, nie z pamięci osoby, która je wpisuje.
Co łączymy z rejestrami GUS, KRS i CEIDG
Zakres ustalamy na konsultacji. Najczęściej obejmuje te elementy.
Dane firmy po NIP w CRM.
Nazwa, adres, miejscowość i REGON, a dla jednoosobowej działalności także imię i nazwisko przedsiębiorcy, status i kod PKD z CEIDG.
Umowy z danymi kontrahenta.
Pola umowy: nazwa, adres, NIP, KRS, REGON i zdanie o reprezentacji. Osoba podpisująca za spółkę zostaje do wpisania.
Karta leada z danymi rejestrowymi.
Dane z CEIDG pobierane jednym przyciskiem na karcie leada, po NIP-ie albo po nazwie firmy.
Formularze i własne aplikacje.
Pole NIP w Twoim formularzu albo panelu, które uzupełnia resztę danych z rejestru.
Jedna firma na jeden NIP.
NIP zapisany jako same cyfry, więc różne zapisy tego samego numeru trafiają w tę samą firmę.
Czytelne błędy.
Komunikat z nazwą rejestru, który nie odpowiedział, i limit czasu na każde zapytanie.
Dane po NIP w Today CRM
Z tej integracji korzystamy na co dzień w naszym Today CRM.
Umowy: dane kontrahenta z rejestrów
W module umów wpisujesz NIP i klikasz „Pobierz”. Nazwa, adres, NIP, KRS i REGON trafiają do pól umowy, a funkcja w zarządzie i sposób reprezentacji pojawiają się jako podpowiedź.
- NIP
- CEIDG
- GUS REGON
- KRS
- pola umowy
Leady: dane rejestrowe z CEIDG
Na karcie leada przycisk „Wzbogać dane” pobiera z CEIDG nazwę, status działalności, PKD, właściciela i adres. Szuka po NIP-ie, a gdy go nie ma, po nazwie firmy.
- karta leada
- CEIDG
- dane rejestrowe
Jak pracujemy
Konsultacja
Ustalamy, gdzie ma działać wyszukiwanie po NIP: w CRM, formularzu, umowie czy fakturze, i które pola mają się uzupełniać.
Dostępy do rejestrów
Klucz do GUS REGON i token do API CEIDG są wydawane na Twoją firmę. KRS ma otwarte API bez klucza.
Integracja
Kolejność rejestrów, mapowanie pól, zapis NIP-u, limity czasu i komunikaty błędów. GUS sprawdzamy najpierw na jego środowisku testowym.
Test i uruchomienie
Próba na prawdziwych NIP-ach działalności i spółek, potem start i opieka po wdrożeniu.
Czego nie robimy
- Nie podstawiamy danych zastępczych, gdy rejestr nie odpowiada. Zamiast tego jest komunikat, z którego rejestru brakuje odpowiedzi.
- Nie zgadujemy nazwisk członków zarządu, które KRS maskuje w publicznym odpisie.
- Nie przyjmujemy numeru, który tylko wygląda na KRS. Do zapytania o odpis idzie wyłącznie dziesięciocyfrowy numer z raportu GUS.
- Nie omijamy limitów zapytań rejestrów. Wyszukiwanie po NIP ma własny limit na godzinę.
Narzędzia
API CEIDG (Hurtownia Danych v3)
Jednoosobowe działalności po NIP-ie albo nazwie, token z dane.biznes.gov.pl.
GUS REGON BIR1.1
Usługa SOAP z kluczem od GUS: wyszukanie podmiotu po NIP-ie i raport pełny z numerem KRS.
API KRS
Odpis aktualny w JSON bez klucza: funkcje w zarządzie i sposób reprezentacji.
Python i Django
Kolejność rejestrów, kontrola błędów i zapis w Today CRM albo w Twoim systemie.
n8n lub Make
Prostsze przepływy bez własnego serwera, np. formularz uzupełniany po NIP-ie. Zobacz n8n i Make.
Opisz, gdzie chcesz pobierać dane po NIP
Napisz, czym zajmuje się Twoja firma i co chcesz usprawnić.
Wrócimy z konkretną propozycją, a nie z ogólną prezentacją.
Co dzieje się dalej
- Odpisujemy w ciągu 1 dnia roboczego.
- Umawiamy 30-minutową rozmowę.
- Przygotowujemy propozycję i wycenę.
Najczęstsze pytania
Jak pobrać dane firmy po NIP przez API?
Z trzech publicznych rejestrów: CEIDG dla jednoosobowych działalności, GUS REGON dla spółek i innych podmiotów oraz KRS dla spółek wpisanych do rejestru sądowego. W Today CRM najpierw pytamy CEIDG, a gdy NIP tam nie występuje, GUS REGON. Gdy spółka ma numer KRS, dobieramy jeszcze odpis z KRS z zasadami reprezentacji.
Czy API GUS REGON jest darmowe?
Tak, usługa BIR jest bezpłatna, ale do środowiska produkcyjnego potrzebny jest klucz użytkownika, o który firma prosi GUS mailowo. Do testów GUS udostępnia osobne środowisko z kluczem podanym w dokumentacji. Stan na listopad 2026: dostępne są wersje 1.1 i 1.2 usługi, a nasza integracja korzysta z 1.1.
Czy API KRS wymaga klucza?
Nie. Odpis aktualny z KRS można pobrać w formacie JSON bez rejestracji i bez klucza, podając numer KRS. Numeru nie trzeba znać z góry: w naszej integracji bierzemy go z raportu pełnego GUS REGON, wyszukanego po NIP-ie.
Dlaczego KRS nie podaje nazwisk członków zarządu?
Publiczne API KRS zwraca dane osób fizycznych zamaskowane: pierwsza litera i gwiazdki. Jawne zostają funkcja w organie, np. prezes zarządu, i sposób reprezentacji spółki. Dlatego przy umowie system podpowiada funkcję i zasady reprezentacji, a nazwisko osoby podpisującej wpisuje człowiek. Stan na listopad 2026.
Czym różni się CEIDG od KRS i REGON?
To trzy różne rejestry. CEIDG to ewidencja jednoosobowych działalności gospodarczych i wspólników spółek cywilnych. KRS to rejestr sądowy spółek handlowych i innych podmiotów prawnych. REGON to rejestr statystyczny GUS, w którym są zarówno spółki, jak i osoby prowadzące działalność.
Co się dzieje, gdy rejestr nie odpowiada?
Wyszukiwanie kończy się komunikatem z nazwą rejestru, który nie odpowiedział, a pola zostają puste. Integracja nie podstawia danych zastępczych ani częściowych jako kompletnych, bo błędna nazwa kontrahenta w umowie jest gorsza niż jej brak. Każde zapytanie ma limit czasu, więc wolny rejestr nie blokuje aplikacji.
Jak działa pobieranie danych firmy po NIP z GUS, KRS i CEIDG?
Użytkownik wpisuje NIP, a integracja przechodzi przez rejestry w stałej kolejności. Każdy krok ma jedno zadanie i jasny wynik: dane, brak podmiotu albo błąd konkretnego rejestru.
- Sprawdzenie NIP-u. Suma kontrolna liczona przed zapytaniem. NIP z literówką kończy się komunikatem o błędnych cyfrach, a nie błędem rejestru.
- CEIDG. Zapytanie do API Hurtowni Danych CEIDG. Dla jednoosobowej działalności wracają nazwa firmy, imię i nazwisko przedsiębiorcy, adres i REGON.
- GUS REGON. Gdy CEIDG nie zna NIP-u, logowanie do usługi BIR1.1, wyszukanie podmiotu i raport pełny, z którego pochodzi numer KRS.
- KRS. Dla spółki z numerem KRS odpis aktualny: funkcje w zarządzie i sposób reprezentacji.
- Zapis. Dane trafiają do pól CRM albo umowy, z informacją, z którego rejestru pochodzą.
Taki moduł budujemy w Today CRM albo w Twoim systemie, w ramach oprogramowania dedykowanego.
CEIDG, GUS REGON czy KRS: który rejestr do czego?
| Rejestr | Kogo obejmuje | Dostęp do API | Co z niego bierzemy |
|---|---|---|---|
| CEIDG | jednoosobowe działalności gospodarcze | token do API Hurtowni Danych CEIDG (dane.biznes.gov.pl) | nazwa, przedsiębiorca, adres, REGON, PKD, status |
| GUS REGON (BIR1.1) | spółki, działalności i inne podmioty z numerem REGON | bezpłatny klucz użytkownika od GUS, usługa SOAP | nazwa, adres, REGON, numer KRS z raportu pełnego |
| KRS | spółki i inne podmioty wpisane do KRS | otwarte API, bez klucza | funkcje w zarządzie, sposób reprezentacji |
Stan na listopad 2026. GUS podaje na swojej stronie limity zapytań zależne od pory dnia i udostępnia też nowszą wersję usługi, BIR1.2. Przed wdrożeniem sprawdzamy aktualne warunki dla Twojego klucza.
Dane z rejestrów w CRM i w umowie
W module Umowy Today CRM wpisujesz NIP kontrahenta i klikasz „Pobierz”. Dla spółki pola umowy dostają nazwę, adres, NIP, KRS i REGON, a obok pojawia się funkcja w zarządzie i sposób reprezentacji z KRS, żeby było wiadomo, czy wystarczy jeden podpis. Dla jednoosobowej działalności w umowie pojawia się imię i nazwisko przedsiębiorcy z CEIDG, bo prowadzi on działalność osobiście.
- Kontrahent spoza bazy: NIP i adres e-mail zakładają firmę w CRM, a NIP zapisuje się po sprawdzeniu w rejestrach.
- Zła firma z listy: NIP różny od tego w kartotece zatrzymuje zapis, zanim dokument wyjdzie do klienta.
- Nazwa z rejestru: nazwa kontrahenta przychodzi z rejestru, nie z klawiatury.
Dane z CEIDG a RODO
Dane z CEIDG dotyczą osób prowadzących działalność, więc są danymi osobowymi, mimo że pochodzą z publicznego rejestru. Klucze do rejestrów trzymamy po stronie serwera, nigdy w przeglądarce, a do CRM zapisujemy tylko pola potrzebne w procesie. Zakres danych i podstawę przetwarzania ustalamy z Tobą przed startem, szczególnie gdy dane mają służyć do kampanii.

