Jak monitorować kontrahentów w KRZ, MSiG i KRS?

Jednorazowa weryfikacja kontrahenta mówi tylko o dniu, w którym ją wykonano. Wniosek o upadłość, zmiana zarządu albo wpis do MSiG pojawiają się później – i zwykle nikt ich nie zauważa na czas. Monitoring rozwiązuje to inaczej: raz wskazujesz podmioty, a system sam informuje o zdarzeniach.

Ten poradnik pokazuje, jak zbudować listę monitorowanych podmiotów w panelu i jak odbierać zdarzenia przez API.

Co jest monitorowane

Do jednego monitora podpięte są wszystkie źródła, w których podmiot może się pojawić:

Monitorować możesz spółkę (KRS), podmiot po NIP – również jednoosobową działalność spoza KRS – oraz osobę fizyczną po numerze PESEL.

Krok 1: Dodaj podmioty do monitoringu

W panelu przejdź do sekcji Monitorowanie i wklej listę identyfikatorów. Możesz dodać własną etykietę (np. nazwę klienta z Twojego CRM) i tagi – tagi ułatwiają późniejsze filtrowanie i eksport.

Ten sam efekt osiągniesz przez API. Endpoint POST /v1/monitors/bulkprzyjmuje do 1000 pozycji w jednym żądaniu:

curl -s -X POST "https://api.krdata.pl/v1/monitors/bulk" \
  -H "x-api-key: TWOJ_KLUCZ" \
  -H "content-type: application/json" \
  -d '{
    "items": [
      { "identifier_type": "nip", "identifier_value": "5252248481", "label": "Klient 1042" },
      { "identifier_type": "krs", "identifier_value": "0000000001" }
    ]
  }'

Odpowiedź mówi, co faktycznie powstało:

{ "inserted": 1, "duplicates": 1, "invalid": [] }

Duplikaty (podmioty już obserwowane) są pomijane, a błędne pozycje wracają w polu invalid razem z powodem. Cała operacja jest odrzucana, jeśli liczba monitorów przekroczyłaby limit abonamentu.

identifier_type musi zgadzać się z formatem wartości. Numer KRS wklejony w pole NIP zostanie odrzucony, zamiast po cichu utworzyć bezużyteczny monitor.

Jeżeli chcesz najpierw sprawdzić listę i dopasować nazwy podmiotów bez tworzenia monitorów, użyj POST /v1/monitors/resolve. Ten endpoint nie liczy się do żadnej puli.

Krok 2: Odbieraj powiadomienia

Nowe dopasowania trafiają do historii zdarzeń w panelu oraz na e-mail przypisany do konta – jako zbiorcze podsumowanie wysyłane co godzinę w ciągu dnia, więc jedno obwieszczenie nie generuje serii osobnych wiadomości. Powiadomienie zawiera nazwę podmiotu, źródło i odnośnik do rekordu, więc z wiadomości przechodzisz wprost do treści obwieszczenia.

Krok 3: Pobierz zdarzenia do swojego systemu

Endpoint GET /v1/monitor-events zwraca paginowaną historię dopasowań dla wszystkich Twoich monitorów:

curl -s "https://api.krdata.pl/v1/monitor-events?source=krz&limit=100" \
  -H "x-api-key: TWOJ_KLUCZ"

{
  "items": [
    {
      "id": 90412,
      "monitor_id": "…",
      "source": "krz",
      "announcement_id": "1f0a…",
      "title": "Obwieszczenie o ogłoszeniu upadłości",
      "entity_name": "…",
      "krs": "0000000001",
      "created_at": "2026-05-29T06:14:02Z"
    }
  ],
  "limit": 100,
  "offset": 0,
  "has_more": false
}

Parametry: monitor_id (zdarzenia jednego podmiotu), source(krz, msig, krs_changes, bzp, knf, uokik), limitdo 200 oraz offset.

Zapisuj u siebie największe id z pobranej strony – przy kolejnym odpytaniu wystarczy pobrać zdarzenia nowsze niż zapamiętane, zamiast przeglądać całą historię.

Jak ułożyć proces

1. Zasil listę z systemu źródłowego. Wyeksportuj NIP-y kontrahentów z ERP lub CRM i wyślij je jednym wywołaniem POST /v1/monitors/bulk.
2. Nadaj etykiety i tagi. Etykieta niech odpowiada identyfikatorowi po Twojej stronie – ułatwia to późniejsze łączenie zdarzeń z kontrahentem.
3. Odpytuj feed raz dziennie. Zdarzenia rejestrowe pojawiają się w cyklu dobowym; częstsze odpytywanie nic nie wnosi.
4. Utrzymuj listę. Usuwaj podmioty, z którymi zakończyłeś współpracę – limit monitorów zależy od abonamentu.

Najczęstsze problemy

• Brak zdarzeń mimo wpisu w rejestrze – sprawdź, czy monitor został utworzony na właściwym identyfikatorze. Podmiot bez KRS monitoruj po NIP.
• Zdarzenie o firmie o podobnej nazwie – dopasowanie odbywa się po identyfikatorach, nie po nazwie. Jeśli widzisz obcy podmiot, zwykle chodzi o wspólną sygnaturę sprawy w tym samym postępowaniu.
• Odrzucone dodanie całej listy – suma istniejących i nowych monitorów przekracza limit planu. Usuń nieaktywne pozycje albo zmień abonament.

Zanim ustawisz monitoring, warto sprawdzić stan bieżący – opisujemy to w poradniku Jak sprawdzić, czy firma jest w KRZ.