Často kladené otázky

Kredity jsou měna, kterou platíš za používání našeho API. Každý požadavek stojí podle endpointu a zvolených možností určitý počet kreditů.

Kredity získáš třemi způsoby:

• Registrační bonus: Noví uživatelé dostanou při registraci 150 kreditů zdarma
• Měsíční kredity z předplatného: Každý tarif obsahuje měsíční objem kreditů
• Dobití kreditů: Dokup si další kredity podle potřeby

Cena závisí na endpointu a zvolených datech. Přesné údaje najdeš zde:

• V naší API dokumentaci najdeš všechny endpointy s jejich cenami
• Kalkulačkou kreditů na naší úvodní stránce si odhadneš náklady

Záleží na tom, zda máš předplatné:

• S předplatným: Kredity z dobití a registrační bonus nevyprší, dokud trvá tvoje předplatné
• Bez předplatného: Kredity platí 30 dní od připsání
• Kredity z předplatného: Platí do konce příslušného zúčtovacího období

Když tvůj zůstatek už nestačí:

• API požadavky odpovídají chybou „Insufficient credits“ (HTTP 402)
• Dokup kredity nebo počkej na další měsíční kredity z předplatného
• Tvůj účet i přístup k API zůstávají zachovány, stačí jen dokoupit kredity

Svou spotřebu vidíš na dashboardu; zobrazí se tam upozornění, když ti dochází zůstatek.

Všechny tarify zahrnují:

• Kredity bez vypršení platnosti: Tvoje zakoupené kredity nevyprší, dokud trvá tvoje předplatné
• Měsíční objem kreditů: Každý měsíc nové kredity
• Přístup k API: Všechny endpointy; některé datové body a filtry jsou k dispozici od Pro nebo Max

Navíc podle tarifu:

• Plus: Ideální pro menší projekty a testování
• Pro: 5% bonus na všechny nákupy kreditů, prioritní podpora
• Max: 15% bonus na nákupy kreditů, největší měsíční objem, prioritní podpora

• Na začátku každého zúčtovacího období dostaneš kredity svého tarifu, při roční platbě každý měsíc
• Měsíční kredity se spotřebovávají před zakoupenými kredity
• Nevyužité měsíční kredity na konci období vyprší
• Měsíční kredity dostáváš, dokud trvá tvoje předplatné, po zrušení do konce zaplaceného období

Ano, své předplatné máš plně pod kontrolou:

• Přechod na vyšší tarif: Na vyšší tarif můžeš přejít kdykoli: změna platí okamžitě, začíná nové zúčtovací období a nová cena se účtuje hned
• Přechod na nižší tarif: Na nižší tarif můžeš přejít kdykoli: změna platí okamžitě, začíná nové zúčtovací období a nová cena se účtuje hned
• Zrušení: Zruš kdykoli bez minimální doby trvání; tvůj tarif poběží do konce zaplaceného období
• Obnovení: Zrušené předplatné obnovíš před jeho koncem v části „Spravovat“ na dashboardu

Důležité: Při změně si zbývající kredity z předplatného převezmeš do nového tarifu. Z roční na měsíční platbu přejdeš až po skončení ročního předplatného.

Předplatné zrušíš a platební údaje spravuješ na dashboardu, tarif změníš v sekci cen na úvodní stránce.

Když zrušíš své předplatné:

• Měsíční kredity: Zůstávají použitelné do konce zaplaceného období
• Kredity z dobití: Do konce zaplaceného období nevyprší; poté opět platí jejich původní datum vypršení
• Přístup k API: Zůstává zachován, dokud máš kredity; profily osob však vyžadují aktivní předplatné

Kredity si koupíš na dashboardu nebo v sekci cen na úvodní stránce pod „Top-up Credits“. Na dashboardu:

1. Otevři svůj dashboard
2. Sjeď k části „Koupit kredity“
3. Zvol množství posuvníkem nebo jednou z rychlých hodnot
4. Zkontroluj bonusy a celkový počet kreditů
5. Dokonči zabezpečenou platbu přes Stripe

Kredity jsou k dispozici ihned po nákupu.

Ano, s předplatným. Bez předplatného platí kredity z dobití 30 dní od nákupu. Dokud máš předplatné (Plus, Pro nebo Max), nevyprší, a to ani dříve zakoupené, pokud jsou při zahájení předplatného ještě platné. Když předplatné skončí, opět platí jejich původní datum vypršení.

Čím více najednou koupíš, tím více bonusových kreditů dostaneš:

Bonusy se uplatní automaticky a přičtou se k bonusu tvého tarifu.

Ano, dobití zahrnuje nejméně 2 000 kreditů. To zajišťuje:

• Nižší transakční náklady na kredit
• Lepší cenu pro tebe
• Menší náročnost zpracování plateb

Na jeden nákup můžeš zvolit až 500 000 kreditů.

Bonus za objem a bonus tarifu se sčítají:

Oba bonusy se vztahují k základním kreditům.

Naše ceny jsou jednoduché:

• Kredity: 0,01 € za kredit (před bonusy)
• Předplatné: Pevná měsíční nebo roční cena se zahrnutými kredity
• Žádné skryté poplatky: Platíš, co vidíš

Všechny ceny jsou v eurech, bez zákonné DPH.

Ne, všechny ceny jsou uvedeny bez DPH. Výše DPH závisí na tvé zemi a DIČ; vypočítá se a zobrazí v pokladně.

Přijímáme tyto platební metody:

• Kreditní karta (Visa, Mastercard, American Express)
• Debetní karta
• PayPal
• Platba na fakturu bankovním převodem se smlouvou Enterprise ([email protected])

Všechny online platby probíhají bezpečně a v souladu s PCI přes Stripe.

Ano, ke každé platbě se automaticky vystaví faktura:

• K dispozici ihned po platbě
• S předplatným kdykoli k dispozici na dashboardu v části „Zobrazit faktury“
• Se všemi potřebnými daňovými údaji
• E-mailem po každé platbě

Naše faktury splňují daňové předpisy EU a obsahují všechny údaje pro tvoje účetnictví.

Tarify a dobití kreditů platíš v pokladně přes Stripe, kreditní nebo debetní kartou či přes PayPal, a dostaneš za ně fakturu. Platbu na fakturu bankovním převodem nabízíme se smlouvou Enterprise; napiš nám na [email protected].

Kredity bez vypršení platnosti jsou výhodou každého předplatného:

• Platí pro zakoupené kredity a registrační bonus
• Kredity musí být při zahájení předplatného ještě platné
• Nevyprší, dokud trvá tvoje předplatné
• Když předplatné skončí, opět platí lhůta 30 dní od nákupu

Kredity se spotřebovávají v tomto pořadí:

1. Kredity z předplatného (pokud máš předplatné)
2. Zakoupené kredity a registrační bonus (nejstarší jako první)

Tím zajistíme:

• Měsíční kredity se využijí dříve, než vyprší
• Zakoupené kredity vydrží déle
• Své kredity využiješ optimálně

Strhávání probíhá automaticky:

• Kredity se strhávají po odpovědi, a to jen za dodaná data
• Každé stržení se zaznamená s podrobnostmi
• Tvůj zůstatek se aktualizuje okamžitě
• Neúspěšné požadavky kredity nestojí, kromě AI režimu u profilů firem: ten se účtuje i při chybě

Zámky v databázi zajišťují, že je každé stržení správné i při vysoké zátěži.

AI režim je volba pro profily firem (/api/v1/fetch-organization):

• Lepší matching: často najde firmy, které přesné hledání podle názvu přehlédne
• Webová data: kontaktní údaje, klíčová slova, produkty a služby a úplná klasifikace WZ
• Stojí 20 kreditů navíc, i když požadavek selže
• Volitelně u /api/v1/fetch-organization; u /api/v1/fetch-person vždy aktivní (zahrnuto v základní ceně 15 kreditů)

Naše servery jsou v Německu a EU.

Ano, handelsregister.ai je v souladu s GDPR. Data pocházejí z veřejných rejstříků, naše servery jsou v Německu a v EU.

Smlouvu o zpracování osobních údajů uzavřeme na požádání. Napiš nám na [email protected].

Všechny podrobnosti najdeš v našich zásadách ochrany osobních údajů.

Aktuální stav API vidíš kdykoli na naší stavové stránce na handelsregister.ai/status.

Smluvně zaručenou dostupnost (SLA) nabízíme se smlouvou Enterprise.

Pro německý obchodní rejstřík neexistuje žádné oficiální API. handelsregister.ai je nezávislé API společnosti Fusionbase GmbH, které dodává úřední data o firmách z obchodního rejstříku, Bundesanzeiger a insolvenčních oznámení strukturovaně jako JSON – na přání v reálném čase, pro software a AI agenty.

Data pocházejí z úředních rejstříků a veřejných zdrojů, především:

• Obchodní rejstřík (Handelsregister): Rejstříková data jako právní forma, sídlo a vedení, k tomu oznámení, seznamy společníků a dokumenty
• Unternehmensregister & Bundesanzeiger: Zveřejněné roční účetní závěrky s rozvahou a výkazem zisku a ztráty
• Insolvenční soudy: Insolvenční oznámení
• Tisk a web: Zprávy, firemní weby a další veřejně dostupné webové stránky

API obsahuje více než 5 milionů firem a organizací.

Všechny firmy a organizace zapsané v německém obchodním rejstříku (Handelsregister) nebo v některém z dalších rejstříků oficiálního rejstříkového portálu:

• Obchodní rejstřík, oddíl B (HRB): kapitálové společnosti jako GmbH, UG (haftungsbeschränkt), AG, SE a KGaA
• Obchodní rejstřík, oddíl A (HRA): zapsaní podnikatelé (e.K.) a osobní společnosti jako OHG, KG a GmbH & Co. KG
• Rejstřík družstev (GnR): zapsaná družstva (eG)
• Rejstřík partnerských společností (PR): partnerské společnosti osob ve svobodných povoláních (PartG, PartG mbB)
• Spolkový rejstřík (VR): zapsané spolky (e.V.)
• Rejstřík společností občanského práva (GsR): zapsané společnosti občanského práva (eGbR)

S AI režimem najdeš prostřednictvím veřejně dostupných webových stránek i firmy bez zápisu v rejstříku, například živnostníky a osoby ve svobodných povoláních.

Podle firmy jsou k dispozici tyto kategorie dat:

Ne každá firma má všechny kategorie dat; dostupnost závisí na velikosti, právní formě a povinnostech zveřejňování.

Finanční data (rozvahy, výkazy zisku a ztráty, KPI) jsou k dispozici pro firmy, které musí zveřejňovat své roční účetní závěrky. Jde především o:

• Všechny GmbH, UG, AG a KGaA
• Některé osobní společnosti bez fyzické osoby jako neomezeně ručícího společníka (např. GmbH & Co. KG)

Míra podrobnosti se liší: větší firmy obvykle zveřejňují obsáhlejší finanční výkazy, menší často jen zkrácené rozvahy. Živnostníci a osobní společnosti s fyzickou osobou jako neomezeně ručícím společníkem zpravidla finanční data nemají.

Mnoho koncernů zveřejňuje dvě závěrky: roční účetní závěrku samotné společnosti a konsolidovanou účetní závěrku. V API, v Playgroundu a v obohacování firem lze zvolit, jaký typ závěrky a kolik účetních období se dodá; na profilech firem se jedním kliknutím přepíná mezi individuálními a konsolidovanými čísly, pokud jsou pro stejný rok k dispozici obě.

Data o společnících jsou k dispozici především pro:

• GmbH a UG: Seznamy společníků se podávají k obchodnímu rejstříku a obsahují jména, vklady a výše podílů
• AG: Jednotliví akcionáři se zpravidla nezapisují; známí mohou být jen velcí akcionáři z veřejných oznámení

Dostupnost závisí na tom, zda byly k rejstříku podány aktuální seznamy společníků.

Data zpracováváme kombinací automatizovaných systémů a extrakce s podporou AI:

• Oficiální rejstříkové dokumenty a oznámení se automaticky vytěžují
• AI informace strukturuje, doplňuje a analyzuje
• Data z několika zdrojů se slučují a udržují aktuální

To závisí na zdroji:

• Obchodní rejstřík: Základní údaje, osoby a rejstříková oznámení průběžně aktualizujeme podle rejstříku. S režimem v reálném čase načte API profil firmy při dotazu živě z obchodního rejstříku.
• Účetní závěrky: Nově zveřejněné závěrky přebíráme každý den. Firmy mají na zveřejnění až dvanáct měsíců, nejnovější závěrka se proto často týká předloňského roku.
• Insolvenční oznámení: Soudy je obvykle zveřejňují v den rozhodnutí nebo krátce poté.
• Dokumenty: Výpisy z rejstříku, seznamy společníků a společenské smlouvy načítá API vždy živě z obchodního rejstříku.

Ano. S režimem v reálném čase (parametr realtime_mode) načte API profil firmy při dotazu živě z obchodního rejstříku, včetně aktuálních jednatelů. Stojí to 10 kreditů navíc, jen pokud živé načtení uspěje, a trvá to o několik sekund déle. Bez režimu v reálném čase pochází profil z naší databáze.

Bývalé jednatele a jiné historické údaje načtení v reálném čase neobsahuje.

Dokumenty jako výpisy z obchodního rejstříku, seznamy společníků a stanovy načítá API vždy živě z obchodního rejstříku. Pokud byl stejný dokument načten během posledních 24 hodin, dodáme ho z mezipaměti.

Ano, s podnikovou smlouvou Enterprise: dostaneš export celé databáze a užívací práva upravíme v individuální licenci. Napiš nám na [email protected], co máš v plánu; odpovíme do jednoho pracovního dne.

Pro jednotlivé seznamy slouží export ve „Vyhledávání a export“: až 5 000 firem na jeden export.