Zadat IČO na webu a podívat se na skóre zabere pár vteřin. Když ale firma měsíčně vystavuje stovky dokladů, schvaluje desítky nových odběratelů nebo registruje B2B zákazníky na e-shopu, ruční prověřování nestíhá. Ve spěchu se na něj zapomene a finanční oddělení pak řeší problém až po splatnosti. Scorify API přináší data o finančním zdraví firem přímo do vašich aplikací.
| Co | Jak |
|---|---|
| Rozhraní | REST, odpověď v JSON |
| Dotaz | GET /api/firma/{ičo} s hlavičkou X-Api-Key |
| Report v PDF | GET /api/firma/{ičo}/pdf |
| Limit | 300 dotazů za minutu na klíč |
| Tarif | Enterprise, klíč si vygenerujete v účtu |
Proč napojit prověrku přímo do systému
Přepínání mezi firemním systémem a prohlížečem zdržuje a otevírá prostor pro chyby. Po napojení:
- Platební podmínky podle dat: systém sám rozhodne, jestli nový zákazník dostane fakturu na 30 dní, nebo zaplatí zálohu.
- Doplnění údajů o zákazníkovi: z IČO se doplní název, sídlo, skóre a stav v rejstřících.
- Pojistka proti rizikovým smlouvám: obchodník neuzavře zakázku s firmou v insolvenci, aniž by to někdo viděl.
Ukázka odpovědi
API vrací strukturovaná data, se kterými umí pracovat každý vývojář. Dotaz:
- adresa:
GET https://scorify.cz/api/firma/12345678 - hlavička:
X-Api-Key: fs_váš_klíč
Hlavní pole odpovědi:
| Pole v odpovědi | Co obsahuje |
|---|---|
ico, nazev, adresa | identifikace firmy |
score.value, score.rating, score.label | skóre 0–100, stupeň AA až E a slovní riziko |
score.parametry | za co se strhávaly body (finanční a nefinanční) |
rizika | insolvenční rejstřík, nespolehlivý plátce DPH a další rizika |
finance | zadluženost, likvidita, vlastní kapitál |
Úplný popis polí a příklad volání jsou v dokumentaci API.
3 typické způsoby nasazení
1. ERP a fakturace
Při zakládání zakázky nebo faktury systém na pozadí ověří IČO odběratele. Když má firma záznam v insolvenčním rejstříku nebo skóre pod vámi zvolenou hranicí, systém nedovolí platbu na fakturu a nabídne zálohu.
2. CRM a obchodní příležitosti
Jakmile obchodník založí nový kontakt, karta se doplní o skóre a rizika. Vedoucí obchodu vidí bonitu zájemce dřív, než tým stráví hodiny přípravou nabídky.
3. B2B e-shop a portál
Zákazník v košíku zvolí platbu na fakturu se splatností. E-shop přes API zkontroluje IČO. Když splní vaše podmínky, objednávka projde; u rizikové firmy košík nabídne platbu předem.
Napojení si naprogramuje váš IT tým nebo integrátor podle dokumentace. Pro jednorázové prověření celého seznamu IČO bez programování slouží v tarifu Enterprise hromadné ověření přímo na webu.
Jak získat přístup
API klíč je součástí tarifu Enterprise (1 999 Kč měsíčně nebo 20 000 Kč ročně). Po aktivaci ho vygenerujete v sekci Můj účet → Členství. Podrobnosti v ceníku a dokumentaci API.
Zdroje
- Dokumentace Scorify API — adresy, hlavičky, pole odpovědi a příklady volání
- Ceník Scorify — tarif Enterprise s API klíčem
Časté otázky
Kolik dotazů API zvládne?
Limit je 300 dotazů za minutu na jeden klíč. Bez klíče je veřejné rozhraní omezené na 40 dotazů za minutu.
Ve kterém tarifu je API?
V tarifu Enterprise. Ten zahrnuje i neomezené prověřování, hlídání neomezeného počtu firem a hromadné ověření seznamu IČO.
Umí API vrátit report i jako PDF?
Ano, GET /api/firma/{ičo}/pdf vrátí stejný PDF report, jaký si stáhnete v profilu firmy.
Máte hotové konektory pro Pohodu, Helios nebo ABRA?
Hotové doplňky do konkrétních systémů zatím nenabízíme. API je obecné REST rozhraní a napojení podle dokumentace zvládne každý vývojář nebo dodavatel vašeho systému.