Časté dotazy

Z úředních rejstříků a zveřejnění: z Handelsregister (obchodní rejstřík), z Unternehmensregister (rejstřík podniků) s účetními závěrkami a z insolvenčních oznámení. Zprávy a obsah webů pocházejí z webu. Více v části Dostupnost dat.

Mnoho údajů čteme automaticky ze zveřejněných dokumentů a oznámení. Používáme k tomu nejnovější technologie a hodně investujeme do kvality; jednotlivé chyby přesto nelze vyloučit.

Profil firmy pochází z naší databáze. V režimu v reálném čase se API navíc živě dotazuje Handelsregister a vrací aktuálně zapsané osoby. Dokumenty API načítá z rejstříku, když si je vyžádáš.

Pokud byl stejný dokument načten krátce předtím, může být starý až 24 hodin.

Firmy musí zveřejnit účetní závěrku nejpozději dvanáct měsíců po rozvahovém dni a mnohé tuto lhůtu plně využívají. Nejnovější závěrka se proto často týká předloňského roku.

Obvykle proto, že ji firma nemusí zveřejňovat. Co je veřejné, závisí na právní formě a velikosti: malá GmbH například nezveřejňuje výkaz zisku a ztráty, takže pro ni tržby většinou nejsou. Prázdné hodnoty se v odpovědi objevují jako null nebo [].

U názvu, který sdílí více firem, může API vrátit jednu z nich, ne nutně tu, kterou myslíš, nebo odpovědět 404. Pokud potřebuješ přesnost, ptej se rejstříkovým soudem a rejstříkovým číslem, například „Ansbach HRB 6089“, nebo pomocí entity_id. Samotné rejstříkové číslo nestačí, protože stejné číslo existuje u mnoha soudů.

Ne. Funkce se účtuje jen tehdy, když vrátí data. AI režim se naopak účtuje, i když žádnou firmu nenajde. Jen když API požadavek ukončí s 408, neúčtuje se. Režim v reálném čase stojí kredity za každé úspěšné živé načtení, i když neukáže nic nového.

Nic. Požadavek, který skončí chybou, se neúčtuje; jedinou výjimkou je příplatek za AI režim. Při stavu 402 uvádí meta.request_credit_cost, kolik by požadavek stál nejvýše. Více v části Chyby.

Ne. Profily firem, Vyhledávání a export, dokumenty a Signals můžeš používat s každým účtem; platíš jen kredity. Předplatné kreditů odemyká další data:

• Plus: profil osoby.
• Pro: rozšířené Finanční KPI, funkce Síť firmy, vyhledávací filtry pro vlastnictví, vedení a insolvenci a téma Signals Insolvence.
• Max: vše z Pro, plus funkce Podrobní společníci, výkazy činnosti energetických podniků a téma Signals Přeměny a M&A.

Vše o cenách a tarifech najdeš v části Účtování.

Nový účet dostane 150 startovních kreditů. Bez předplatného kreditů platí startovní kredity a dobití kreditů 30 dní. Dokud je předplatné kreditů aktivní, nepropadají.

Pro režim v reálném čase, profily osob a dokumenty alespoň 120 sekund, protože tyto požadavky trvají déle. Pokud v režimu v reálném čase selže jen živé načtení, dostaneš uložená data bez příplatku za režim v reálném čase. Pokud požadavek trvá příliš dlouho, skončí s 408, u dokumentů s 504. Nic se pak neúčtuje. Zkus to později znovu.

Pro profily firem 60 požadavků za minutu a účet, pro dokumenty 5. Nad tento limit API odpoví stavem 429 a uvede čekací dobu v Retry-After. Všechny limity najdeš v části Limity.

Ano, u profilů firem, profilů osob, vyhledávání a dokumentů. Pošli vlastní hodnotu v headeru Idempotency-Key. Pokud požadavek zopakuješ se stejným klíčem a stejnými parametry do 24 hodin, nic nestojí.

Ano. V Účet › API klíče vytvoříš další klíče, například jeden pro každou aplikaci. Pokud klíč smažeš, je okamžitě neplatný. Všechny klíče sdílejí zůstatek tvého účtu.