DataPort.pl
Analiza · REST vs SOAP

API GUS SOAP vs REST (BIR 1.1)

Porównanie oficjalnego API GUS SOAP z REST API DataPort — ta sama baza REGON, inna integracja.

Szukasz alternatywy dla API GUS SOAP lub prostszego sposobu na pobieranie danych firm po NIP? Oficjalna usługa BIR 1.1 GUS (dokumentacja na api.stat.gov.pl) wymaga klienta SOAP, obsługi XML i sesji. API GUS REST w DataPort zwraca te same dane rejestrowe w JSON — jednym zapytaniem HTTP.

Poniżej znajdziesz obiektywne porównanie pod kątem integracji w PHP, JavaScript, ERP i CRM. Jeśli dopiero wybierasz dostęp do rejestru, zobacz też landing API GUS, dokumentację REST oraz przewodnik jak użyć API.

DataPort.pl — API GUS REST / JSON

Nakładka na rejestr GUS: JSON, klucz API, cache i aktualizacja w tle. Idealne do aplikacji, sklepów, CRM i fakturowania.

  • GET / JSON — bez sesji SOAP
  • Odpowiedź z cache często <100 ms
  • Playground i dokumentacja po polsku

GUS BIR 1.1 — SOAP / XML

Oficjalne API stat.gov.pl: WSDL, envelope SOAP, MTOM, Zaloguj → DaneSzukaj → Wyloguj. Pełna kontrola u źródła.

  • Własny klucz BIR od GUS (formularz)
  • Typowo 2–5 s na zapytanie na żywo
  • Dokumentacja PDF + WSDL

Tabela porównawcza: API GUS SOAP i REST

Te same dane rejestrowe — inna warstwa techniczna dostępu.

Porównanie API DataPort REST z oficjalnym API GUS BIR 1.1 SOAP
Kryterium DataPort API GUS SOAP BIR
Protokół HTTPS REST HTTPS SOAP 1.2
Format odpowiedzi JSON XML (MTOM)
Autentykacja Nagłówek X-API-Key Zaloguj → sid → Wyloguj
Typowe zapytanie (NIP) 1 request GET 3+ requestów SOAP
Czas odpowiedzi <100 ms (cache) ~2–5 s (GUS na żywo)
Klucz dostępu Po rejestracji w panelu Wniosek na api.stat.gov.pl
Obsługa błędów / przerw GUS Cache + retry po stronie serwisu Po stronie integratora
Batch (wiele NIP) POST /companies/batch Pętla SOAP + limity
Dokumentacja dla devów Reference + playground PDF, WSDL, przykłady SOAP
Źródło danych Rejestr REGON — GUS BIR 1.1 / 1.2

Integracja GUS BIR: REST vs SOAP w praktyce

DataPort — jedno zapytanie 
GET https://dataport.pl/api/v1/company/5213456789
X-API-Key: twoj_klucz
Accept: application/json

→ 200 OK, pole "company" w JSON
GUS SOAP — uproszczony przebieg 
1. Zaloguj(klucz BIR) → sid
2. DaneSzukaj + sid → XML
3. GetValue / raport pełny
4. Wyloguj(sid)

+ envelope SOAP, MTOM, parser XML

Słowniczek (API GUS)

BIR 1.1 / 1.2
Baza Internetowa REGON — oficjalny rejestr podmiotów GUS, dostępny przez API SOAP.
SOAP
Protokół z envelope XML używany w usłudze UslugaBIRzewnPubl GUS.
MTOM
Mechanizm przesyłania załączników w odpowiedziach SOAP GUS — wymaga parsowania po stronie klienta.
sid
Identyfikator sesji po wywołaniu Zaloguj — obowiązkowy w kolejnych requestach SOAP.

Wybierz DataPort, gdy…

  • Budujesz sklep, SaaS, CRM lub moduł fakturowy i chcesz szybko sprawdzać NIP.
  • Zespół zna REST/JSON, a nie chce utrzymywać klienta SOAP.
  • Potrzebujesz przewidywalnego czasu odpowiedzi przy powtarzalnych zapytaniach.
  • Chcesz batch NIP-ów bez samodzielnej obsługi limitów GUS.

Wybierz GUS SOAP, gdy…

  • Masz już wdrożony klient SOAP i infrastrukturę pod BIR.
  • Potrzebujesz bezpośrednio wszystkich raportów BIR bez pośrednika.
  • Integracja jest wyłącznie wewnętrzna i opłaca się utrzymanie sesji GUS.
  • Masz bardzo wysoki wolumen i własny cache na poziomie aplikacji.

Podsumowanie

GUS SOAP to oficjalna, pełna ścieżka do rejestru — najlepsza, gdy masz doświadczenie z BIR i chcesz pełnej kontroli u źródła. DataPort API to ta sama baza firm w formacie przyjaznym dla nowoczesnych aplikacji: mniej kodu integracyjnego, szybsze odpowiedzi z cache i gotowe narzędzia dla developerów. W większości projektów komercyjnych REST okazuje się prostszy w utrzymaniu niż własna warstwa SOAP.

Powiązane

Sprawdź NIP online Weryfikacja kontrahentów Walidacja NIP w API API Reference

Najczęstsze pytania

Czym różni się API DataPort.pl od oficjalnego API GUS SOAP?

Oficjalne API GUS BIR 1.1 działa przez SOAP i zwraca XML. Wymaga logowania (Zaloguj), sesji (sid) i wylogowania (Wyloguj). DataPort.pl to REST API z odpowiedzią JSON — jeden nagłówek X-API-Key i proste zapytanie GET po NIP, bez obsługi sesji SOAP po stronie klienta.

Czy dane z DataPort.pl są takie same jak z GUS?

Tak. DataPort pobiera dane z tego samego rejestru BIR 1.1 / BIR 1.2, co oficjalne API GUS. Różnica dotyczy sposobu dostępu (REST zamiast SOAP) i warstwy cache, która przyspiesza powtarzalne zapytania.

Kiedy warto korzystać bezpośrednio z API GUS SOAP?

Bezpośrednie SOAP ma sens przy bardzo dużej skali zapytań, gdy potrzebujesz pełnej kontroli nad sesją GUS, raportów zbiorczych REGON lub integracji wyłącznie wewnątrz infrastruktury bez pośrednika. Dla typowych aplikacji webowych, ERP i CRM szybsze wdrożenie daje REST API.

Ile trwa integracja z DataPort vs GUS SOAP?

Integracja z DataPort.pl to zwykle jeden endpoint HTTP i klucz API — często kilka godzin. Integracja z GUS SOAP wymaga klienta SOAP, obsługi MTOM, sesji, parsowania XML i limitów GUS — zwykle dni lub tygodnie pracy developera.

Czy DataPort zastępuje klucz GUS BIR?

Tak — nie musisz składać wniosku o klucz BIR ani implementować Zaloguj/Wyloguj. DataPort korzysta z GUS po stronie serwera i udostępnia własny klucz REST API w panelu.

Czy mogę migrować z integracji SOAP GUS na DataPort?

Tak. Zamień wywołania SOAP na GET /api/v1/company/{nip} i mapuj pola JSON (nazwa, REGON, adres, status działalności) na swój model danych. Szczegóły pól: API Reference.

Przetestuj REST API zamiast SOAP GUS

Playground pozwala wysłać pierwsze zapytanie bez pisania kodu — od razu po rejestracji.

Otwórz playground Dokumentacja Załóż konto