Preverenie dodávateľa na Slovensku cez API

Skôr než zaplatíte zálohu alebo podpíšete rámcovú zmluvu, overte podľa IČO, že dodávateľ existuje, nie je v konkurze ani v reštrukturalizácii a že sa jeho údaje nemenia pod rukami.

Problém

Nákupné a finančné tímy si dodávateľa zvyknú overiť raz, pri založení v systéme, a potom naň zabudnú. Pritom firma sa môže dostať do konkurzu alebo reštrukturalizácie, zmeniť názov či sídlo a objednávky pôjdu ďalej na starý záznam. Pri dodávateľoch z viacerých krajín k tomu pribúda rôzny formát registrov. Prometiam vracia slovenské firmy v rovnakom objekte ako firmy zo zvyšných 26 krajín, takže jedna kontrola platí pre celý zoznam dodávateľov.

Ako to funguje

  • GET /companies/search?country=SK&company_number=... nájde dodávateľa podľa IČO (alebo cez name=).
  • GET /companies/{id} vráti stav, právnu formu a sídlo.
  • POST /monitor zapne sledovanie dodávateľa; webhook príde pri zmene stavu, zániku alebo zmene v registri.
  • GET /sanctions/screen?name=... (beta) preverí meno dodávateľa proti sankčným zoznamom.
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=SK&company_number=35763469' \
  -H 'Authorization: Bearer rk_live_...'

Odpoveď obsahuje status (štandardizovaný) a local_status (stav tak, ako ho uvádza register). Konkurz a reštrukturalizácia sú súčasťou stavu, takže pravidlo v schvaľovacom toku zvládnete jedným porovnaním.

Čo dostanete

PoleČo znamená
company_nameObchodné meno zapísané v registri
company_numberIČO, osemmiestne identifikačné číslo organizácie
statusŠtandardizovaný stav (aj konkurz a reštrukturalizácia)
local_statusStav tak, ako ho uvádza register
legal_form / local_legal_formPrávna forma, štandardizovaná a v slovenskom znení registra
founding_dateDátum vzniku
adresaSídlo: ulica, obec, PSČ
activity_codeKód hlavnej činnosti SK NACE, ak ho register uvádza

Čo uložiť do spisu dodávateľa

K záznamu dodávateľa si uložte odpoveď z GET /companies/{id} s dátumom a časom dotazu: obchodné meno, IČO, status a local_status, právnu formu a sídlo. Pri každej ďalšej kontrole porovnajte nový záznam s uloženým. Ak sa zmenilo obchodné meno alebo sídlo, skontrolujte, či zmluva, objednávka a faktúry nesú aktuálne údaje; ak sa zmenil stav, pozastavte platby a rozhodnutie nechajte na zodpovednej osobe. Rozdiel medzi údajmi na faktúre a v registri nie je sám o sebe dôkazom pochybenia, často ide o oneskorený zápis zmeny, preto ho vždy overte u dodávateľa.

Po onboardingu: sledovanie portfólia

Zoznam kľúčových dodávateľov si zaregistrujete cez POST /monitor s {"company_id": ..., "country": "SK"}. Upozornenia sa týkajú zmeny stavu, zániku, zhody so sankčným zoznamom (beta) a zmien v registri: názvu, právnej formy a sídla. Dátum udalosti je deň, keď sa zmena prvýkrát objavila v údajoch registra, a najstaršie udalosti sú od 30. septembra 2026. Údaje o Slovensku sa obnovujú každý pracovný deň.

Čo pre Slovensko nedostanete

  • Len záznamy o firmách: bez štatutárov, spoločníkov a skutočných vlastníkov a bez signálu o plnení povinností voči registru.
  • Len obchodné právnické osoby; živnostníci, iné fyzické osoby a nekomerčné subjekty (združenia, nadácie) sa nevracajú.
  • Žiadne číslo DPH: na overenie platiteľa DPH slovenského dodávateľa API nepoužijete, vat= sa pre Slovensko odmieta.
  • Žiadne oznamy o insolvencii; konkurz a reštrukturalizáciu uvidíte len v stave a v udalostiach registra.
  • Žiadne účtovné závierky slovenských firiem.

Contains data from the Register of Legal Entities (RPO), Ministry of Interior and Statistical Office of the Slovak Republic, CC BY 4.0. Overovanie sankcií je v beta verzii.

Aký plán sa hodí

Pre pravidelnú kontrolu desiatok dodávateľov stačí Starter (9,99 EUR mesačne, 1 000 kreditov). Ak chcete webhooky a plné overovanie sankcií (beta), zvoľte Professional (29,99 EUR mesačne, 10 000 kreditov). Pri ročnej platbe získate dva mesiace zadarmo.

Súvisiace stránky

Začnite 14-dňové skúšobné obdobie · Dokumentácia API

Skúšobné obdobie trvá 14 dní a zahŕňa 500 kreditov. Vyžaduje sa platobná karta, počas skúšobného obdobia sa nič neúčtuje; potom pokračuje plán Starter (9,99 EUR mesačne), ak ho nezrušíte.

Frequently asked questions

Ako zistím, či je dodávateľ v konkurze?
V poli status a local_status a v udalostiach registra. Konkurz aj reštrukturalizácia sú v stave zahrnuté; samostatné insolvenčné oznamy pre Slovensko nie sú súčasťou API.
Overím cez API aj platiteľa DPH?
Nie, pre Slovensko API číslo DPH neposkytuje a vat= odmieta. Pre dodávateľov z iných krajín EÚ existuje GET /vat/{number} s kontrolou voči VIES.
Vrátia sa aj živnostníci?
Nie. Vracajú sa len obchodné právnické osoby; živnostníci a iné fyzické osoby nikdy.
Ako dostanem upozornenie na zmenu dodávateľa?
Zaregistrujte ho cez POST /monitor s krajinou SK; zmeny prídu webhookom. Webhooky patria do plánu Professional.
Je skúšobné obdobie bez karty?
Nie. 14 dní, 500 kreditov, platobná karta sa vyžaduje a počas skúšky sa nič neúčtuje; potom pokračuje Starter (9,99 EUR mesačne), ak ho nezrušíte.