Wiele NIPów · panel · API · CSV

Sprawdzanie batchowe NIP

Do 20 numerów naraz — w panelu użytkownika lub przez REST API. Zbiorcze podsumowanie, tabela wyników z GUS i eksport do CSV.

Podgląd interfejsu

Jak wygląda batch w panelu

Tylko wizualizacja — bez wysyłania danych

Sprawdzanie batchowe wymaga konta — dostępne w panelu użytkownika lub przez REST API z kluczem.

Eksport do CSV w panelu użytkownika

Po zalogowaniu wejdź w Panel → Wyszukaj wiele — tam batch liczy się w limicie konta i możesz pobrać trzy warianty pliku CSV (separator ;, UTF-8 pod Excel):

  • Pełna lista — w kolejności wklejenia
  • Znalezione — NIP, REGON, nazwa, adres
  • Bez wyniku — błędne NIP-y i brak w GUS
Załóż konto — batch + CSV

1. Wklej listę NIPów

W panelu użytkownika lub w body JSON API — do 20 numerów.

2. Walidacja i lookup

Sprawdzamy format, duplikaty i pobieramy dane z rejestru GUS BIR 1.1.

3. Zbiorczy wynik

Podsumowanie liczb, tabela firm i lista wpisów bez wyniku.

4. Pobierz CSV

W panelu użytkownika — pełna lista, znalezione lub bez wyniku. Gotowe do Excela.

Dla kogo to jest?

  • ERP i fakturowanie — weryfikacja partii kontrahentów przed wystawieniem faktur
  • Księgowość — masowe sprawdzenie statusu działalności na liście NIPów
  • Compliance — onboarding wielu dostawców w jednym kroku integracji
  • E-commerce B2B — synchronizacja bazy firm z rejestrem GUS

Przykład zapytania

POST /api/v1/companies/batch
X-API-Key: twój_klucz

{
  "nips": [
    "5261040828",
    "1234567890",
    "9876543210"
  ],
  "format": "simple"
}

Wydajność

  • ~70ms Cache hit — 20 NIPów już w bazie, odpowiedź niemal natychmiastowa.
  • ~12s Cold start — wiele NIPów wymaga pobrania z GUS; czas rośnie liniowo.
  • W odpowiedzi pole meta.processing_time_ms pokazuje czas serwera.

Limity i rozliczanie

  • • Maksymalnie 20 NIPów w jednym batchu w panelu lub przez API.
  • • W panelu i API: 1 unikalny NIP = 1 jednostka dziennego limitu konta.
  • CSV w panelu — po zalogowaniu, bez dodatkowego klucza API; trzy warianty pliku do pobrania.
  • • Duplikaty w liście są pomijane — nie liczymy ich dwa razy.
  • • Niepoprawne NIPy nie zużywają limitu — w podsumowaniu widać je jako „niepoprawnych”.
Porównaj plany API

Batch vs pojedyncze zapytanie

Batch API 20× GET /company/{nip}
Liczba requestów HTTP 1 20
Zbiorcza odpowiedź Tak Nie — składanie po stronie klienta
Prefetch z bazy Jedno zapytanie SQL Osobno per NIP
Eksport CSV Tak (panel) Nie — ręczne składanie
Koszt limitu API 20 NIPów = 20 jednostek 20 NIPów = 20 jednostek

Zacznij od darmowego konta — klucz API w panelu w kilka minut.

Załóż konto
Pojedyncze sprawdzenie NIP · Monitoring firm · Pełna dokumentacja API