Ověření dodavatele v Česku přes API

Než zaplatíte zálohu nebo podepíšete rámcovou smlouvu, ověřte podle IČO, že dodavatel existuje, není v likvidaci ani v insolvenci a že se jeho údaje nemění pod rukama.

Problém

Nákupní a finanční týmy si dodavatele zpravidla ověří jednou, při založení v systému, a pak na něj zapomenou. Firma se přitom může dostat do likvidace nebo insolvence, změnit název či sídlo a objednávky půjdou dál na starý záznam. U dodavatelů z více zemí k tomu přibývá odlišný formát rejstříků. Prometiam vrací české firmy ve stejném objektu jako firmy z ostatních 28 zemí, takže jedna kontrola platí pro celý seznam dodavatelů.

Jak to funguje

  • GET /companies/search?country=CZ&company_number=... najde dodavatele podle IČO (nebo přes name=).
  • GET /companies/{id} vrátí stav, právní formu a sídlo.
  • POST /monitor zapne sledování dodavatele; webhook přijde při změně stavu, zániku nebo změně v rejstříku.
  • GET /sanctions/screen?name=... (beta) prověří jméno dodavatele proti sankčním seznamům.
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=CZ&company_number=45274649' \
  -H 'Authorization: Bearer rk_live_...'

Odpověď obsahuje status (standardizovaný) a local_status (stav tak, jak ho uvádí rejstřík). Likvidace, insolvence, konkurs a reorganizace jsou součástí stavu, takže pravidlo ve schvalovacím toku zvládnete jedním porovnáním.

Co dostanete

PoleCo znamená
company_nameObchodní firma zapsaná v rejstříku
company_numberIČO, osmimístné identifikační číslo osoby
statusStandardizovaný stav (i likvidace, insolvence, konkurs a reorganizace)
local_statusStav tak, jak ho uvádí rejstřík
legal_form / local_legal_formPrávní forma, standardizovaná a v českém znění rejstříku
founding_dateDatum vzniku
adresaSídlo: ulice, obec, PSČ a kraj
share_capitalZákladní kapitál, jak je zapsán v rejstříku
activity_codeKód hlavní činnosti CZ-NACE 2025 z Registru ekonomických subjektů (ČSÚ)
registry_detailsRejstříkový soud a spisová značka (například B 1581, Městský soud v Praze)

Co uložit do spisu dodavatele

K záznamu dodavatele si uložte odpověď z GET /companies/{id} s datem a časem dotazu: obchodní název, IČO, status a local_status, právní formu a sídlo. Při každé další kontrole porovnejte nový záznam s uloženým. Pokud se změnil název nebo sídlo, zkontrolujte, zda smlouva, objednávka a faktury nesou aktuální údaje; pokud se změnil stav, pozastavte platby a rozhodnutí nechte na odpovědné osobě. Rozdíl mezi údaji na faktuře a v rejstříku není sám o sobě důkazem pochybení, často jde o zpožděný zápis změny, proto jej vždy ověřte u dodavatele.

Po onboardingu: sledování portfolia

Seznam klíčových dodavatelů si zaregistrujete přes POST /monitor s {"company_id": ..., "country": "CZ"}. Upozornění se týkají změny stavu, zániku, shody se sankčním seznamem (beta) a změn v rejstříku: názvu, právní formy, sídla a základního kapitálu. Datum události je den, kdy se změna poprvé objevila v datech rejstříku, a žádné události nejsou starší než první načtení v říjnu 2026. Data o Česku se obnovují každý pracovní den.

Co pro Česko nedostanete

  • Jen záznamy o firmách: bez statutárních orgánů, společníků a skutečných majitelů a bez signálu o plnění povinností vůči rejstříku.
  • Jen obchodní právnické osoby; OSVČ, jiné fyzické osoby a neziskové subjekty (spolky, nadace) se nevracejí.
  • Žádné DIČ: plátce DPH českého dodavatele přes API neověříte, vat= se pro Česko odmítá. Registr nespolehlivých plátců vede Finanční správa a Prometiam jej neposkytuje.
  • Žádná insolvenční oznámení; likvidaci a insolvenci uvidíte jen ve stavu a v událostech rejstříku.
  • Žádné účetní závěrky českých firem.

Obsahuje data z veřejných rejstříků České republiky (Ministerstvo spravedlnosti, otevřená data ISVR) a Českého statistického úřadu (RES, CC BY 4.0). Upraveno společností Prometiam. Contains data from the public registers of the Czech Republic (Ministry of Justice, ISVR open data) and the Czech Statistical Office (RES, CC BY 4.0). Adapted by Prometiam. Ověřování sankcí je v beta verzi.

Jaký tarif se hodí

Pro pravidelnou kontrolu desítek dodavatelů stačí Starter (9,99 EUR měsíčně, 1 000 kreditů). Chcete-li webhooky a plné ověřování sankcí (beta), zvolte Professional (29,99 EUR měsíčně, 10 000 kreditů). Při roční platbě získáte dva měsíce zdarma.

Související stránky

Začněte 14denní zkušební období · Dokumentace API

Zkušební období trvá 14 dní a zahrnuje 500 kreditů. Vyžaduje se platební karta, během zkušebního období se nic neúčtuje; poté pokračuje tarif Starter (9,99 EUR měsíčně), pokud jej nezrušíte.

Frequently asked questions

Jak zjistím, že je dodavatel v likvidaci nebo insolvenci?
V polích status a local_status a v událostech rejstříku. Likvidace, insolvence, konkurs i reorganizace jsou ve stavu zahrnuty; samostatná insolvenční oznámení pro Česko nejsou součástí API.
Ověřím přes API i plátce DPH?
Ne, pro Česko API DIČ neposkytuje a vat= odmítá. Registr nespolehlivých plátců vede Finanční správa a Prometiam jej neposkytuje.
Vrátí se i OSVČ?
Ne. Vracejí se jen obchodní právnické osoby; OSVČ a jiné fyzické osoby nikdy.
Jak dostanu upozornění na změnu u dodavatele?
Zaregistrujte jej přes POST /monitor se zemí CZ; změny přijdou webhookem. Webhooky patří do tarifu Professional.
Je zkušební období bez karty?
Ne. 14 dní, 500 kreditů, platební karta se vyžaduje a během zkoušky se nic neúčtuje; poté pokračuje Starter (9,99 EUR měsíčně), pokud jej nezrušíte.