Wpisujesz NIP klienta i program sam wypełnia nazwę firmy, adres i REGON – bez ręcznego szukania. To integracja z bazą GUS (Głównego Urzędu Statystycznego). Jak działa ta funkcja, czy jest bezpłatna i kiedy dane mogą być nieaktualne?
Co to jest API GUS/REGON i skąd programy pobierają dane?
GUS (Główny Urząd Statystyczny) prowadzi rejestr REGON – centralną bazę podmiotów gospodarczych w Polsce. Baza zawiera dane wszystkich firm, spółek, stowarzyszeń i innych jednostek zarejestrowanych w Polsce. GUS udostępnia bezpłatne API (REGON API, zwane też BIR – Baza Internetowa Regon), z którego mogą korzystać producenci oprogramowania po uprzedniej rejestracji. Program do faktur, który zintegrował się z tym API, może w czasie rzeczywistym pobierać dane bezpośrednio z oficjalnego rejestru – bez pośredników i bez opłat dla użytkownika końcowego.
Jak działa pobieranie danych z GUS?
GUS udostępnia bezpłatne API (REGON API), z którego mogą korzystać programy do faktur. Gdy wpisujesz NIP kontrahenta, program wysyła zapytanie do serwera GUS i w ciągu kilku sekund odbiera dane: pełną nazwę firmy, adres siedziby, REGON, formę prawną i status działalności.
Dane są pobierane bezpośrednio z oficjalnej bazy rejestrów publicznych – REGON – prowadzonej przez GUS. To najbardziej aktualne źródło danych o polskich przedsiębiorcach.
Co możesz pobrać z GUS po NIP?
- Pełna nazwa firmy (dokładna, z rejestru)
- Adres siedziby (ulica, numer, miejscowość, kod pocztowy)
- REGON (9- lub 14-cyfrowy)
- Forma prawna (JDG, sp. z o.o., S.A., fundacja itd.)
- Status działalności (aktywna / zawieszona / wykreślona)
- Kody PKD (główna i dodatkowe działalności)
- Data wpisu i wykreślenia z rejestru
Jak działa uzupełnianie danych kontrahenta w programie Faktura VAT – krok po kroku
Procedura w programie Faktura VAT STANDARD jest intuicyjna:
- Otwórz kartotekę kontrahentów lub przejdź bezpośrednio do wystawiania nowej faktury.
- Wpisz NIP kontrahenta w polu NIP. Program automatycznie rozpoznaje format (10 cyfr) i aktywuje przycisk pobierania danych.
- Kliknij przycisk „Pobierz z GUS" (lub naciśnij Enter po wpisaniu NIP – zależy od wersji programu). Program łączy się z API GUS.
- W ciągu 2–5 sekund pola: nazwa firmy, adres, miasto, kod pocztowy i REGON wypełniają się automatycznie danymi z rejestru.
- Zweryfikuj dane wzrokowo – upewnij się, że nazwa i adres są aktualne. Jeśli firma zmieniła adres niedawno, GUS może jeszcze nie mieć nowego adresu.
- Zapisz kontrahenta. Przy kolejnych fakturach dane są pobierane z lokalnej kartoteki – nie trzeba ponownie odpytywać GUS.
Czego GUS nie zawiera – ważne ograniczenia
Choć REGON API jest bardzo pomocne, ma istotne ograniczenia, o których warto wiedzieć:
- Numery rachunków bankowych – GUS ich nie przechowuje. Numer konta bankowego musisz wpisać ręcznie lub pobrać go z białej listy podatników VAT (Ministerstwo Finansów).
- Status VAT – REGON nie informuje, czy firma jest aktywnym podatnikiem VAT, czy jest zwolniona lub wykreślona. Do weryfikacji statusu VAT służy osobna Biała Lista podatników VAT.
- Dane kontaktowe – telefon, e-mail, strona WWW nie są dostępne w REGON.
- Adres do korespondencji – GUS podaje adres siedziby, który może różnić się od adresu do faktur.
- Osoby kontaktowe i reprezentacja – dane zarządu są dostępne w KRS, nie w REGON.
Jak połączyć weryfikację GUS z Białą Listą VAT?
Kompleksowa weryfikacja kontrahenta powinna obejmować dwa kroki:
- GUS/REGON – potwierdzenie że firma istnieje, aktualna nazwa i adres, forma prawna
- Biała Lista MF – sprawdzenie czy firma jest aktywnym vatowcem i czy numer rachunku bankowego jest zarejestrowany w Wykazie Podatników VAT
Program Faktura VAT STANDARD obsługuje obie weryfikacje. Dzięki temu możesz w jednym miejscu zarówno pobrać dane firmy, jak i sprawdzić jej status VAT – co jest szczególnie ważne przy płatnościach powyżej 15 000 zł (split payment i sankcje za przelew na niezarejestrowane konto). Dowiedz się więcej w artykule biała lista podatników VAT – jak sprawdzić kontrahenta.
API GUS a CEIDG – różnice
Często myli się dwa różne rejestry:
- REGON (GUS) – rejestr wszystkich podmiotów: JDG, spółki, NGO, urzędy. Pobierasz pełną nazwę, REGON, formę prawną, PKD.
- CEIDG – rejestr wyłącznie osób fizycznych prowadzących działalność gospodarczą (JDG). Zawiera też datę zawieszenia/wznowienia działalności i niekiedy adres e-mail/www podany przez przedsiębiorcę.
W praktyce programy do faktur korzystają głównie z REGON API, które obejmuje szerszy zakres podmiotów. Dla JDG dane z CEIDG i REGON są zgodne – obie bazy powinny zawierać te same podstawowe dane, choć aktualizacja może przebiegać z różną szybkością.
Kiedy dane z GUS mogą być nieaktualne?
Baza REGON jest aktualizowana na podstawie danych z KRS, CEIDG i urzędów skarbowych. Aktualizacja może następować z opóźnieniem kilku dni do kilku tygodni od rzeczywistej zmiany (np. zmiany adresu, nazwy, zawieszenia działalności). Zawsze warto zweryfikować dane z dokumentem firmowym klienta, szczególnie przy nowych kontrahentach.
Co zrobić gdy NIP nie zwraca danych?
Brak danych po wpisaniu NIP może wynikać z kilku przyczyn:
- Nowa firma – właśnie założona, dane jeszcze nie dotarły do REGON (może minąć kilka dni)
- Nieprawidłowy NIP – sprawdź czy wpisałeś 10 cyfr bez myślników i spacji
- Firma zagraniczna – REGON zawiera tylko polskie podmioty; dla zagranicznych firm wpisz dane ręcznie
- Wykreślona firma – jeśli firma zakończyła działalność, GUS może nie zwracać jej danych lub oznaczyć ją jako nieaktywną
- Przerwa techniczna API GUS – rzadko, ale API GUS bywa chwilowo niedostępne
W każdym przypadku program umożliwia wpisanie danych kontrahenta ręcznie.
Weryfikacja NIP w bazie VAT – white list
Oprócz pobierania danych z GUS, program do faktur może też weryfikować NIP kontrahenta w Wykazie Podatników VAT (białej liście) Ministerstwa Finansów – sprawdzając czy firma jest aktywnym vatowcem i czy numer rachunku bankowego jest zarejestrowany. To ważna funkcja dla firm dbających o bezpieczeństwo transakcji. Program Faktura VAT STANDARD obsługuje weryfikację w białej liście VAT.
Najczęściej zadawane pytania
Czy pobieranie z GUS jest bezpłatne?
Tak – API REGON GUS jest bezpłatne dla programów rejestrowanych przez producenta. Koszt tej funkcji jest wliczony w cenę programu do faktur. Nie ma limitów liczby zapytań do GUS w standardowym użytkowaniu.
Co jeśli GUS nie ma danych dla podanego NIP?
Może się zdarzyć gdy NIP jest nowy (firma właśnie założona, dane jeszcze nie dotarły do REGON) lub gdy NIP jest nieprawidłowy. W takim przypadku uzupełnij dane ręcznie. Program umożliwia też zapis nowego kontrahenta bez danych z GUS.
Czy dane pobrane z GUS są wystarczające do faktury?
Dla celów faktury VAT wystarczą: nazwa, adres i NIP kontrahenta. REGON nie jest wymagany na fakturze. Jednak dla własnej ewidencji i weryfikacji warto go mieć. Numer rachunku bankowego i status VAT musisz sprawdzić osobno w Białej Liście MF.
Jak często GUS aktualizuje dane?
GUS aktualizuje bazę REGON na bieżąco, ale zmiany rejestrowane przez przedsiębiorców w CEIDG i KRS mogą trafić do REGON z opóźnieniem kilku dni roboczych. W praktyce dla bieżących kontrahentów dane rzadko są nieaktualne – problem pojawia się głównie przy bardzo świeżo założonych firmach lub przy niedawnych zmianach danych.
Poradniki z cyklu: Weryfikacja kontrahenta
Szukasz programu do fakturowania?
Faktura VAT 2026 – prosty program dla firm. KSeF 2.0, JPK_V7M, wielowalutowość.
Pobierz bezpłatnie na 31 dni