KRS API z oceną firmy, danymi finansowymi i webhookiem zmian
Jedno zapytanie po numerze NIP, KRS albo REGON zwraca dane z KRS, liczby ze sprawozdań, status VAT, sygnały z KRZ i score 0-100 ze składowymi. Webhook informuje Twój system o każdej zmianie w portfelu.
Co zwraca API
| Zasób | Zawartość |
|---|---|
| Firma | nazwa, forma prawna, adres, PKD, numery NIP, KRS i REGON |
| Rejestr | zarząd, prokurenci, wspólnicy, kapitał, zmiany w KRS |
| Finanse | pozycje bilansu, RZiS i przepływów za kolejne lata, wskaźniki |
| Ocena | score 0-100, cztery składowe, mediana branży, poziom ryzyka |
| Sygnały | postępowania w KRZ, obwieszczenia MSiG, status VAT, zaległości |
| Rekomendacja | termin, limit kupiecki, przedpłata według Twoich reguł |
| Portfel | lista monitorowanych NIP-ów, dodawanie i usuwanie |
Zapytanie i odpowiedź
API działa w standardzie REST i zwraca JSON. Autoryzacja kluczem API w nagłówku, klucze tworzysz i unieważniasz w ustawieniach organizacji.
GET /api/v1/companies/{nip}/score
Authorization: Bearer <klucz API>{
"nip": "<NIP>",
"score": 67,
"risk": "medium",
"components": {
"liquidity": 71,
"debt": 58,
"profitability": 69,
"revenue_growth": 72
},
"signals": [],
"recommendation": {
"term_days": 30,
"credit_limit": null
}
}Webhook zmian w portfelu
Webhook wysyła zdarzenie, gdy score kontrahenta się zmienia, pojawia się nowy sygnał w rejestrze albo kontrahent przechodzi do innego poziomu ryzyka. Każde zdarzenie jest podpisane, więc Twój system sprawdzi, że pochodzi ze Score.
- score.changed
- risk.changed
- signal.created
- statement.published
Limity API w planach
| Plan | Zapytania miesięcznie | Webhooki |
|---|---|---|
| Business | 20 000 | tak |
| Portfel | 200 000 | tak |
| Enterprise | według umowy | tak |
Do czego używa się API
- Wstępna ocena wniosku w leasingu, faktoringu i finansowaniu MSP
- Blokada zamówienia w ERP, gdy kontrahent przekracza limit albo wchodzi w wysokie ryzyko
- Pole score w karcie klienta w CRM, na przykład w HubSpot albo Pipedrive
- Synchronizacja portfela z Comarch ERP Optima, enova365, Symfonia i Subiekt przez plik CSV
KRS API rządowe a API Score
Rządowe API KRS zwraca odpis z rejestru. API Score łączy go ze sprawozdaniami z RDF, białą listą VAT i KRZ, liczy wskaźniki i ocenę i pilnuje zmian za Ciebie. Źródła opisujemy na stronie źródła danych o firmach.