Today Automate logo

🔎 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.

Wykresy pod lupą, symbol sprawdzania danych firmy w rejestrach

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.

Notes z ołówkiem, symbol umowy wypełnianej danymi z rejestru

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.

Niebieskie koła zębate, symbol połączenia systemu z rejestrami

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ź.

    1. NIP
    2. CEIDG
    3. GUS REGON
    4. KRS
    5. pola umowy
    Moduł 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.

    1. karta leada
    2. CEIDG
    3. dane rejestrowe
    Moduł Leady →

Jak pracujemy

  1. Konsultacja

    Ustalamy, gdzie ma działać wyszukiwanie po NIP: w CRM, formularzu, umowie czy fakturze, i które pola mają się uzupełniać.

  2. 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.

  3. Integracja

    Kolejność rejestrów, mapowanie pól, zapis NIP-u, limity czasu i komunikaty błędów. GUS sprawdzamy najpierw na jego środowisku testowym.

  4. 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.

  • Logo PythonLogo Django

    Python i Django

    Kolejność rejestrów, kontrola błędów i zapis w Today CRM albo w Twoim systemie.

  • Logo n8nLogo Make

    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

  1. Odpisujemy w ciągu 1 dnia roboczego.
  2. Umawiamy 30-minutową rozmowę.
  3. Przygotowujemy propozycję i wycenę.

pole wymagane

Administratorem Twoich danych jest Today Group spółka z ograniczoną odpowiedzialnością (KRS 0001253446, NIP 9542911671). Użyjemy ich tylko po to, żeby odpowiedzieć na Twoje zapytanie. Podstawą jest nasz uzasadniony interes, czyli odpowiedź na Twoje zapytanie (art. 6 ust. 1 lit. f RODO). Masz prawo dostępu do danych, ich poprawienia, usunięcia i sprzeciwu. Szczegóły są w polityce prywatności.

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.

  1. 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.
  2. CEIDG. Zapytanie do API Hurtowni Danych CEIDG. Dla jednoosobowej działalności wracają nazwa firmy, imię i nazwisko przedsiębiorcy, adres i REGON.
  3. 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.
  4. KRS. Dla spółki z numerem KRS odpis aktualny: funkcje w zarządzie i sposób reprezentacji.
  5. Zapis. Dane trafiają do pól CRM albo umowy, z informacją, z którego rejestru pochodzą.
Brak NIP-u w CEIDG to nie awaria. API CEIDG odpowiada „nie znaleziono” na NIP każdej spółki, bo spółek nie ma w tej ewidencji. Integracja traktuje to jako sygnał, żeby pytać dalej w GUS. Za awarię uznaje dopiero brak odpowiedzi, błąd serwera albo brak tokenu.

Taki moduł budujemy w Today CRM albo w Twoim systemie, w ramach oprogramowania dedykowanego.

CEIDG, GUS REGON czy KRS: który rejestr do czego?

Rejestry firm dostępne przez API
RejestrKogo obejmujeDostęp do APICo z niego bierzemy
CEIDGjednoosobowe działalności gospodarczetoken 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 REGONbezpłatny klucz użytkownika od GUS, usługa SOAPnazwa, adres, REGON, numer KRS z raportu pełnego
KRSspółki i inne podmioty wpisane do KRSotwarte API, bez kluczafunkcje 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.

Wyszukanie w GUS nie zwraca numeru KRS. Numer jest dopiero w raporcie pełnym podmiotu, więc integracja wykonuje drugie zapytanie. Gdy ono się nie uda, nazwa i adres i tak trafiają do formularza, a numer KRS można dopisać ręcznie.

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.