Monitorujemy VAT / KRS / KRZ — wyłącznie oficjalne rejestry

Ryzyko kontrahenta,
wychwycone wcześnie.

RiskWatch monitoruje oficjalne polskie rejestry — VAT, KRS i KRZ — dla każdej firmy, od której zależysz. Zmiany stają się punktowanymi zdarzeniami, podpisanymi i dostarczanymi do Twoich systemów.

Darmowy plan obejmuje 25 firm na Białej liście VAT bez podpinania karty.

Strumień zdarzeńSymulacja
CRITICALVAT_REMOVEDNorbud Instalacje Sp. z o.o.
INFOKRS_BOARD_CHANGEDHelvet Trans Mazowsze S.A.
CRITICALKRZ_RESTRUCTURING_FOUNDStalmet Wschod Sp. j.
INFOVAT_RESTOREDAparthotel Bursztyn Sp. z o.o.
VAT_REMOVEDVAT_NOT_REGISTEREDVAT_RESTOREDVAT_STATUS_CHANGEDKRS_DELETEDKRS_LIQUIDATIONKRS_BOARD_CHANGEDKRS_ADDRESS_CHANGEDKRZ_BANKRUPTCY_FOUNDKRZ_RESTRUCTURING_FOUNDKRZ_BUSINESS_BAN_FOUNDKRZ_ENFORCEMENT_FOUNDKRZ_NEW_PROCEEDINGKRZ_PROCEEDING_CLOSED
01Jak to działa

Od rejestru do webhooka.

01 / 05

Obserwuj

Dodaj NIP-y, od których zależysz. Wybierz źródła i częstotliwość dla każdego kontrahenta — resztą zajmie się harmonogram.

Norbud Instalacje Sp. z o.o.VAT KRS / codziennie
Helvet Trans Mazowsze S.A.VAT KRS KRZ / codziennie
Stalmet Wschod Sp. j.VAT / co tydzień
02 / 05

Pobierz

Wyłącznie oficjalne rejestry. Dane VAT i KRS płyną wprost z systemów państwowych, a KRZ sprawdzamy w osobnym, kontrolowanym środowisku.

MF VAT whitelistwykazpodatnikowvat.mf.gov.pl
KRS OpenAPIapi-krs.ms.gov.pl
KRZ registerkrz.ms.gov.pl
03 / 05

Porównaj

Każdy odczyt porównujemy z poprzednim. Szum odpada — zdarzeniem staje się tylko zmiana, która ma znaczenie.

vat_statusCzynnytoWykreslony
snapshot hashc41f09 changed
eventVAT_REMOVED
04 / 05

Oceń

Zdarzenia mają udokumentowane wagi — od wniosków upadłościowych po zmiany w zarządzie. Wynik trafia do pasma od LOW do CRITICAL.

05 / 05

Dostarcz

Zdarzenia trafiają prosto do Twoich systemów jako podpisane webhooki. Twój zespół wie, że przyszły od nas — i może działać automatycznie.

POST https://yourapp.example/hooks/riskwatch
X-RiskWatch-Event: risk_event.critical
X-RiskWatch-Signature: t=1767...,v1=9c41...
200 OK
02Źródła

Trzy rejestry. Jeden strumień.

wykazpodatnikowvat.mf.gov.pl

Biała lista VAT

Status rejestracji prosto z Ministerstwa Finansów: czynny, zwolniony, wykreślony, przywrócony. Rejestr, który decyduje, czy fakturę można bezpiecznie opłacić.

INFOCZYNNYWYKRESLONYZWOLNIONY
api-krs.ms.gov.pl

KRS — rejestr sądowy

Likwidacje, wykreślenia, zmiany zarządu i adresu z OpenAPI Krajowego Rejestru Sądowego.

LIKWIDACJAZMIANA ZARZĄDUZMIANA ADRESU
krz.ms.gov.pl

KRZ — rejestr zadłużonych

Postępowania upadłościowe i restrukturyzacyjne. Gdy rejestr nie daje pewnej odpowiedzi, nigdy nie zgłaszamy „czysto”.

UPADŁOŚĆRESTRUKTURYZACJABRAK WPISÓW
03Ocena ryzyka

Wynik, który obronisz.

Każde zdarzenie ma udokumentowaną wagę. Wynik to suma nierozwiązanych przesłanek, w pasmach czytelnych na pierwszy rzut oka.

VAT_STATUS_CHANGED+15
VAT_REMOVED+50
KRS_LIQUIDATION+60
KRZ_RESTRUCTURING_FOUND+80
CRITICAL
Zasada 01

Brak danych to nie brak ryzyka.

Niepewny odczyt nie zastępuje ostatniego zweryfikowanego stanu. Kontrola kończy się błędem i nie tworzy nowej czystej bazy odniesienia.

Zasada 02

Sekrety zostają sekretami.

Klucze API przechowujemy jako hashe. Sekrety webhooków są szyfrowane i odszyfrowywane przez serwer wyłącznie wtedy, gdy musi podpisać dostarczenie.

Zasada 03

Tylko oficjalne źródła.

Dane bierzemy wprost z rejestrów państwowych, nie z kopii ani agregatorów. Zdarzenie zapisuje kod rejestru i typ sygnału; krytyczne ustalenia zawsze weryfikuj w oficjalnym rejestrze.

Zasada 04

Firmy, nie osoby.

Publiczne wejścia monitoringu przyjmują NIP podmiotu gospodarczego. RiskWatch nie oferuje monitoringu konsumenckiego ani wyszukiwania osób.

04Dla developerów

Integracja w jedno popołudnie.

  • Klucze API Bearer z zakresami read, write i webhook oraz darmowym sandboxem rw_test_ na danych testowych.
  • Jednorazowe sprawdzenia przed przelewem (/v1/checks/vat, /v1/checks/bank-account, /v1/checks/vies, /v1/checks/sanctions: MSWiA, UE FSF, OFAC SDN) oraz ciągły monitoring listy obserwowanych.
  • Zdalny serwer MCP po Streamable HTTP (https://api.riskwatch.pl/mcp) z OAuth 2.1 + PKCE (S256) i 9 narzędziami dla Claude, ChatGPT i Gemini.
  • Klucze idempotencji przy każdym żądaniu zapisu.
  • Webhooki podpisane HMAC z oknem anty-replay.
  • Typowany SDK TypeScript i pełna specyfikacja OpenAPI 3.1.
POST /v1/watchlist (Free: VAT)
curl -X POST https://api.riskwatch.pl/v1/watchlist \
  -H "Authorization: Bearer rw_live_yourkey" \
  -H "Idempotency-Key: add-batch-014" \
  -H "Content-Type: application/json" \
  -d '{"nips":["<YOUR_VALID_NIP>"],"sources":["VAT"]}'
Weryfikacja podpisu webhooka
import { createHmac, timingSafeEqual } from "node:crypto";

// During secret rotation the header carries several v1= signatures
// (t=...,v1=<current>,v1=<previous>); accept a match on any of them.
const parts = signatureHeader.split(",").map((part) => part.trim());
const t = (parts.find((part) => part.startsWith("t=")) ?? "").slice(2);
const age = Math.abs(Date.now() / 1000 - Number(t));
if (!t || !Number.isFinite(age) || age > 300) throw new Error("stale");

const digest = Buffer.from(
  createHmac("sha256", webhookSecret).update(`${t}.${rawBody}`).digest("hex"),
  "hex"
);
const ok = parts
  .filter((part) => part.startsWith("v1="))
  .some((part) => {
    const actual = Buffer.from(part.slice(3), "hex");
    return actual.length === digest.length && timingSafeEqual(actual, digest);
  });

Weź swoich kontrahentów
pod obserwację.

Rozpocznij monitoring