Darmowe API do KRS i innych rejestrów — co naprawdę jest dostępne

Co dostajesz za darmo — konkretnie

• KRS (Ministerstwo Sprawiedliwości) — odpis aktualny i pełny w JSON. Bez klucza, bez rejestracji.
• REGON / GUS BIR — tożsamość, adres, PKD, forma prawna. Bezpłatne, ale wymaga klucza i działa po SOAP z sesją.
• Wykaz podatników VAT (Ministerstwo Finansów) — status podatnika i rachunki. Bezpłatne, ostro limitowane.
• CRBR — beneficjenci rzeczywiści, oficjalna bramka SOAP.
• CEIDG — działalności gospodarcze; wymaga klucza.
• BZP (UZP) — ogłoszenia o zamówieniach publicznych.
• SUDOP (UOKiK) — pomoc publiczna i de minimis.

To nie jest mało. Dane naprawdę są jawne i naprawdę są za darmo. Pytanie brzmi, ile kosztuje ich używanie.

Gdzie znika oszczędność

Sześć różnych protokołów. Część REST z JSON-em, część SOAP z XML-em i sesją, jeden wymaga rozpakowania dobowego pliku. Każdy ma inny format daty, inne nazewnictwo pól i inne pojęcie „braku wyniku”.

Limity, które ujawniają się w produkcji. Wykaz VAT dopuszcza około 100 zapytań wyszukiwania na dobę z jednego IP — po przekroczeniu blokuje adres do północy. Integracja przetestowana na dziesięciu fakturach przestaje działać pierwszego dnia realnego użycia.

Brak mostów między rejestrami. Masz NIP, a KRS chce numeru KRS. Trzeba zbudować przejście przez REGON — czyli jedno pytanie biznesowe to dwa albo trzy zapytania do różnych systemów.

Brak SLA i wsparcia. Gdy rejestr nie odpowiada, nie ma komu tego zgłosić. Twoja integracja musi sama umieć powiedzieć „nie wiem”, zamiast udawać, że wpisu nie ma — o czym pisaliśmy w tekście o not_found kontra unavailable.

Rejestry są darmowe. Darmowa nie jest praca, którą trzeba wykonać, żeby dało się z nich korzystać codziennie i bez niespodzianek.

Kiedy własna integracja ma sens

Ma sens, gdy potrzebujesz jednego rejestru, ruch jest niewielki i nikt nie ucierpi, jeśli przez dobę nie zadziała. Odpytywanie samego KRS raz na jakiś czas to kilkadziesiąt linii kodu i tyle.

Przestaje mieć sens, gdy potrzebujesz kilku źródeł naraz, masz stały wolumen i ktoś podejmuje decyzje na podstawie wyniku. Wtedy koszt przenosi się z pisania na utrzymanie: zmiany w formatach, limity, obsługa niedostępności, cache, retencja, audyt.

Co robi warstwa pośrednia

Ujednolica kopertę odpowiedzi dla wszystkich źródeł, buduje mosty między identyfikatorami, trzyma budżety zapytań po swojej stronie i rozróżnia „nie ma wpisu” od „nie wiem”. Nie zastępuje rejestrów — odpowiada za ich pobranie, normalizację i oznaczenie czasem ważności.

Zakres źródeł i zasady rozliczeń: dokumentacja Rejestry API.

Materiał ma charakter informacyjny. Wymienione rejestry prowadzą organy administracji publicznej — Ministerstwo Sprawiedliwości, Ministerstwo Finansów, GUS, UZP i UOKiK. Limity i zasady dostępu ustalają te organy i mogą się zmieniać.