B2B Credit Score API — A-F grade
Composite credit rating 0-100 + A-F grade pre 1 653 345 SK + CZ firiem. Derivované z finančných výkazov + tax compliance + konkurzov + sankcií. Per-faktor breakdown, <100 ms API, free tier 600 req/min bez auth kľúča.
Credit check jedným IČO
Zadaj IČO → dostaneš score + grade + top 3 factors (pozitívne aj negatívne).
Rozdelenie podľa grade
A+ · Top-tier
193 155 firiem (11.7 %). Range 90-100. Excellent financial health, clean compliance.
A · Strong
259 311 firiem (15.7 %). Range 80-89. Strong performer, minor watch items.
B · Baseline
609 231 firiem (36.8 %). Range 70-79. Stable, priemerný operator.
C · Caution
114 814 firiem (6.9 %). Range 55-69. 1-2 negatívne signály.
D-F · High risk
476 834 firiem (28.8 %). Range <55. Distress alebo viaceré hard-stops.
Čo ide do skóre — top factors
Turnover + profit
RUZ tržby za posledný rok + čistý zisk. Bonus za tržby > €1M a pozitívny profit. Bez výkazov = neutrál.
ROA + Debt/Equity
Return on Assets (>5 % = silný operator) + D/E ratio (<1 = zdravá kapitálová štruktúra). Šablóna 699.
Tax reliability
FS spoľahlivosť: "vysoko spoľahlivý" +5, "spoľahlivý" +3, "menej spoľahlivý" 0.
Public contracts
CRZ verejné zmluvy — firma pravidelne obchoduje so štátom. Bonus za contract v posledných 12 mes. RPVS UBO +2.
Vek firmy
>10y v biznise = +4 (established). 5-10y = +2. <2y = 0 (neutrál). Korelácia so survival rate.
Tax debt
FS daňový dlh — scale podľa sumy. <€1k = −5, €1-10k = −10, >€10k = −20. Hard signál o cashflow issues.
Insurance debts
SocPoist + VšZP dlhy. Nepriamy cashflow signál (firmy nestíhajú odvody). Kumulatívna scale.
Likvidácia / reštrukturalizácia
RPO/OV flag in_liquidation alebo in_restructuring. Firma v procese — vysoké riziko default.
Konkurz · HARD-STOP
OV in_bankruptcy — score sa nastaví na max 10 (grade F). Aktuálne 39 002 firiem v konkurze.
Sankcia / debarment · HARD-STOP
OpenSanctions hit alebo World Bank / EU debarment. Score ≤ 5, grade F, PROHIBITED compliance tier.
Response shape
GET /api/v1/companies/31322832/credit-score
{
"data": {
"ico": "31322832",
"name": "SLOVNAFT, a.s.",
"score": 91,
"grade": "A+",
"baseline": 70,
"factors": [
{ "name": "turnover", "delta": +12, "note": "€4.2B" },
{ "name": "profit", "delta": +8, "note": "€180M net" },
{ "name": "tax_reliability", "delta": +5, "note": "vysoko spoľahlivý" },
{ "name": "age", "delta": +4, "note": "31 rokov" }
],
"warnings": [],
"hardStop": null,
"computedAt": "2026-04-23T07:10:00Z"
},
"meta": { "duration_ms": 42, "cached": false }
}
Typické nasadenia
B2B sales pre-qual
Predtým ako investujete hodiny do proposalu: auto-check credit pri lead qualification. C/D/E leads dostanú shorter trial, A/A+ priority treatment.
Accounts Receivable
Pre-invoice risk scoring: D-F clients = cash-on-delivery alebo pre-paid. A/A+ = 60d NET. Zníži DSO + bad debt write-offs.
Procurement / Supplier
Pre-qual suppliers pri RFP / framework contract. Minimálne B (70+) pre contract >€50k. Bulk score celého vendor base mesačne.
Fintech underwriting
SMB lending / factoring pre-approval. Score + factor breakdown → decision engine input. Sanctions/bankruptcy hard-stop auto-reject.
Často kladené otázky
Z čoho počítate credit score?
Z dát, ktoré už zbierame denne/týždenne: RUZ finančné výkazy (tržby, profit, ROA, ROE, debt/equity), FS tax compliance (tax reliability trieda + tax debts), OV (konkurz/reštrukturalizácia/likvidácia flags), SocPoist + VšZP dlhy, CRZ public contract history (pozitívny signál dôvery verejného sektora), vek firmy, RPVS UBO registrácia. Hard-stop na OpenSanctions hit (sankcie/debarment → score ≤10). Baseline 70, každý faktor ± delta, clamp 0-100. Full factor breakdown per firma v API response.
Ako interpretujem A-F grade?
A+ (≥90): Top-tier, excellent financial health, clean compliance. ~193,155 firiem. A (80-89): Strong performer, minor watch items. ~259,311. B (70-79): Stable, priemer (baseline). ~609,231. C (55-69): Caution — 1-2 negatívne signály (tax debt / deklinujúci profit). ~114,814. D (40-54): Elevated risk — viacero issues. E (20-39): High risk — likvidácia/restrukturalizácia / vysoké dlhy. F (<20): Distress — bankrot / sankcia / viaceré hard-stops. D-F spolu ~476,834.
Je to regulovaný credit rating (ESMA / SEC NRSRO)?
Nie. Nie sme registrovaný credit rating agency podľa EU Regulation 1060/2009 (CRA Regulation) ani ESMA-supervised. Je to analytical credit score určený pre internú B2B risk assessment — pre-trade counterparty check, AR underwriting, procurement pre-qual. Nepoužívajte pre regulatorne vyžadované účely (solvency II kapitál, Basel III IRB ratings, verejné bond ratings). Pre tie potrebujete Moody's / S&P / Fitch / Scope. Náš score replikuje podobnú logiku za zlomok ceny pre B2B sales/treasury/AR teams.
Ako často sa skóre aktualizuje?
Týždenne. Weekly timer entyrix-credit-scores.timer (Mon 07:10 UTC) recompute-ne skóre pre firmy so stale dátami (--only-stale). Full refresh po mesačnom ARES / RUZ update. Per-company credit_score_updated_at timestamp dostanete v API. Pre real-time rescoring po nejakom trigger eventu (napríklad OV bankruptcy publish) support bude v DS-45 Monitoring (webhook on credit_grade change).
Dostanem factor-level vysvetlenie, prečo firma má dané score?
Áno. GET /api/v1/companies/:ico/credit-score vracia factors[] array — každý faktor má {name, delta, note}. Napríklad [{name: 'turnover', delta: +8, note: '€2.4M'}, {name: 'tax_reliability', delta: +5, note: 'vysoko spoľahlivý'}, {name: 'tax_debt', delta: -12, note: '€48k'}]. Plus baseline (70), hardStop (null alebo reason), warnings[], computedAt. Pre audit trail + explainability — user-facing UI môže zobraziť "ako vznikol score".
Môžem bulk-skórovať celú vendor base (100-1000 firiem)?
Áno. POST /api/v1/companies/bulk berie 100 IČO / request (batch 10ms/each = ~1s na 100 firiem). Full response obsahuje credit_score + credit_grade. Pre väčšie batch (10k+) použite GET /api/v1/companies/advanced-search.csv?credit_grade=D,E,F CSV export (38 stĺpcov vrátane finančných). Alebo /companies/advanced-search?min_credit_score=80&max_credit_score=100 pre high-tier supplier shortlist.
Ako porovnať score s inými ratingovými modelmi?
Náš 0-100 má rough equivalenciu: 90-100 (A+) ≈ S&P A / Moody's A2 / Scope A — investment grade top quartile. 70-89 (B/A) ≈ BBB- do A- — investment grade lower. 55-69 (C) ≈ BB / Ba2 — speculative. 40-54 (D) ≈ B/B1 — high yield. <40 (E/F) ≈ CCC/C alebo default. Toto je orientačný mapping, pre SMB segment. Our score je viac compliance-heavy (sanctions hard-stop, tax debt penalty) než klasický rating agency model, ktorý váži hlavne default probability.
Pripojené ďalej
Credit score je jedným signálom plného compliance profile. Plus sankcie, NIS2, transparency feeds.