Finance – Dokumentace | handelsregister.ai

Funkce
Funkce	Co vrací	Kredity
financial_kpi	Finanční KPI: jeden řádek ukazatelů za každé účetní období	1
balance_sheet_accounts	Rozvaha: všechny položky za každé účetní období jako strom	3
profit_and_loss_account	Výkaz zisku a ztráty (německy GuV): všechny položky za každé účetní období jako strom	3
annual_financial_statements	Roční účetní závěrky (Markdown): plný text závěrek, kompaktně pro AI agenty	5
annual_financial_statements__html	Roční účetní závěrky (HTML): plný text s tabulkami jako HTML, k zobrazení	5

Konvence

Částky jsou v eurech, jako plné částky bez zaokrouhlení na tisíce. Tržby 538,2 mil. € přijdou jako 538151607.13.
Znaménka: náklady nesou znaménko, které tiskne závěrka. Některé závěrky je uvádějí kladně, jiné záporně. Náklady proto porovnávej bez znaménka. Ztráty a schodky jsou záporné.
Poměrové ukazatele a marže jsou desetinná čísla: 0.75 znamená 75 %. Faktory jako debt_to_equity a interest_coverage jsou násobky.
Účetní období: year je kalendářní rok, ve kterém účetní období končí. Účetní období od 2024-10-01 do 2025-09-30 je tedy 2025. Přesná data jsou v _provenance.period_start a period_end.
Pořadí: každá funkce vrací seznam s jedním záznamem na účetní období, nejnovější první. Mezi dvěma roky může rok chybět, pokud pro něj neexistuje závěrka.
null znamená: závěrka hodnotu neuvádí, nebo ji z ní nelze odvodit. Malá firma například nezveřejňuje výkaz zisku a ztráty, proto revenue zůstává prázdné.

Pokud firma nemá odpovídající závěrky, přijde funkce jako prázdný seznam []. Za to neúčtujeme žádné kredity.

Individuální a konsolidované závěrky

Individuální závěrka (Jahresabschluss) ukazuje firmu samotnou, konsolidovaná závěrka (Konzernabschluss) celý koncern. Bez dalšího zadání volí každá funkce sama. Odpověď proto může obsahovat individuální i koncernová čísla, dokonce pro stejný rok v různých funkcích.

Každý záznam uvádí v _provenance, ze které závěrky jeho čísla pocházejí. Roky porovnávej jen v rámci stejného statement_type. Jinak porovnáváš firmu s jejím koncernem.

S financial_statement_type=annual dostaneš jen individuální závěrky, s consolidated jen konsolidované. financial_years omezí odpověď na nejnovější účetní období, od 1 do 30. Oba parametry platí pro všech pět funkcí a nemění cenu. Více v části Analyzovat finanční ukazatele.

Původ záznamu

Každý záznam finančních KPI, rozvahy a výkazu zisku a ztráty obsahuje _provenance, v každém tarifu i bez tarifu. Pole jsou ve všech třech funkcích stejná. Ve finančních KPI je _provenance vždy posledním klíčem řádku.

Pole
Pole	Význam	Příklad	Dostupnost
financial_kpi[]._provenanceobject	Ze které závěrky čísla řádku pocházejí. V každém řádku, v každém tarifu i bez tarifu, vždy jako poslední klíč.`financial_kpi`	–	většinou: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[]._provenance.statement_typestring\|null	Druh závěrky, jak ho pojmenovává rejstřík.Hodnoty: `Jahresabschluss` individuální závěrka firmy, `Bilanz` samostatně zveřejněná rozvaha, `Konzernabschluss` čísla koncernu, `null` tržní data kótované firmy	`"Jahresabschluss"`	jako výše
financial_kpi[]._provenance.period_startstring\|null	První den účetního období, jak je vytištěn v závěrce.Prázdné, když závěrka neuvádí začátek, a u tržních dat	`"2023-01-01"`	jako výše
financial_kpi[]._provenance.period_endstring\|null	Poslední den účetního období, rozvahový den. Účetní období může být kratší nebo delší než dvanáct měsíců, například po založení nebo změně účetního období.	`"2023-12-31"`	jako výše
financial_kpi[]._provenance.exempt_subsidiaryboolean	true, pokud firma místo vlastní závěrky zveřejnila konsolidovanou závěrku mateřské společnosti. Všechna čísla za rok pak platí pro koncern `parent_organization`.	`false`	jako výše
financial_kpi[]._provenance.parent_organizationobject\|null	Firma, jejíž konsolidovaná závěrka byla zveřejněna, s entity_id a name. entity_id je null, pokud název jednoznačně neidentifikuje firmu.Prázdné, když exempt_subsidiary je false	`null`	zřídka

Velikost a právní forma

Co firma zveřejňuje, stanoví zákon podle právní formy a velikostní třídy. To rozhoduje, která pole mají hodnoty.

GmbH a UG, AG, SE a KGaA, GmbH & Co. KG a eG zveřejňují své závěrky. KG nebo OHG s fyzickou osobou jako osobně ručícím společníkem zveřejňuje jen tehdy, když je velmi velká. Totéž platí pro jednotlivce zapsané jako kupce. Partnerské společnosti (PartG) závěrky nezveřejňují. Dceřiná společnost v koncernu může za určitých podmínek zveřejnění vlastní závěrky vynechat. Musí být k tomu zahrnuta v konsolidované závěrce své mateřské společnosti (§ 264 odst. 3 HGB).

Velikostní třída
Velikostní třída	Co se zveřejňuje	Co dostaneš
Mikro	Zkrácená rozvaha	Rozvaha a čísla z ní, například bilanční suma
Malá	Rozvaha a příloha, žádný výkaz zisku a ztráty	Rozvaha a čísla z ní, částečně počet zaměstnanců; tržby většinou ne
Střední	Rozvaha, výkaz zisku a ztráty, příloha a výroční zpráva; výkaz zisku a ztráty smí začínat hrubým výsledkem	Rozvaha a výkaz zisku a ztráty; tržby, pokud je výkaz uvádí samostatně
Velká	Úplná účetní závěrka s výroční zprávou	Rozvaha, výkaz zisku a ztráty a ukazatele v plné hloubce

Mikrofirmy smějí rozvahu také jen uložit. Pak není volně dostupná. Více o velikostních třídách a lhůtách v části Dostupnost dat.

Firmy mají na zveřejnění dvanáct měsíců po konci účetního období a mnohé lhůtu plně využívají. Nejnovější záznam se proto často týká předloňského nebo staršího roku.

Sloupec Dostupnost v tabulkách níže to shrnuje podle právní formy. „částečně“ znamená: hodnota přijde, pokud ji velikostní třída firmy zveřejňuje.

Základní ukazatele

Tyto ukazatele dostaneš s každým účtem, s tarifem i bez něj, ve funkci financial_kpi (Finanční KPI).

Pole
Pole	Význam	Příklad	Dostupnost
financial_kpiarray	Finanční KPI: jeden řádek za každé účetní období, nejnovější první.Prázdné, když firma nezveřejnila žádné vyhodnotitelné závěrky`financial_kpi`	–	většinou: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[].yearinteger	Kalendářní rok, ve kterém účetní období končí.	`2023`	jako výše
financial_kpi[].revenuenumber\|null	Tržby v eurech.Prázdné, když závěrka neobsahuje výkaz zisku a ztráty ani tržby	`538151607.13`	částečně: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[].net_incomenumber\|null	Hospodářský výsledek za rok (zisk nebo ztráta) v eurech; ztráta je záporná.	`164916783.06`	jako výše
financial_kpi[].active_totalnumber\|null	Bilanční suma v eurech.	`397093655.67`	většinou: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[].employeesnumber\|null	Počet zaměstnanců, jak ho závěrka uvádí.Prázdné, když závěrka nemá přílohu s počtem zaměstnanců, například u mikrofirem	`340`	částečně: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[].material_expensesnumber\|null	Materiálové náklady v eurech, se znaménkem ze závěrky.	`116509640.56`	jako výše
financial_kpi[].personnel_expensesnumber\|null	Osobní náklady v eurech, se znaménkem ze závěrky.	`37557386.2`	jako výše

Například jedno účetní období z našeho ukázkového požadavku na Hetzner Online GmbH, Ansbach HRB 6089, se základními ukazateli a jejich původem:

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: TVUJ_API_KLIC" \
  --data-urlencode 'q=Hetzner Online GmbH' \
  --data-urlencode 'feature=financial_kpi' \
  --data-urlencode 'financial_years=1'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "TVUJ_API_KLIC"},
    params={
        "q": "Hetzner Online GmbH",
        "feature": ["financial_kpi"],
        "financial_years": "1",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "Hetzner Online GmbH");
url.searchParams.append("feature", "financial_kpi");
url.searchParams.append("financial_years", "1");

const response = await fetch(url, {
  headers: { "x-api-key": "TVUJ_API_KLIC" },
});
const data = await response.json();

1{2  "financial_kpi": [3    {4      "year": 2023,5      "employees": 340,6      "active_total": 397093655.67,7      "revenue": 538151607.13,8      "material_expenses": 116509640.56,9      "personnel_expenses": 37557386.2,10      "net_income": 164916783.06,11      "_provenance": {12        "statement_type": "Jahresabschluss",13        "period_start": "2023-01-01",14        "period_end": "2023-12-31",15        "exempt_subsidiary": false,16        "parent_organization": null17      }18    }19  ]20}

Ukázková odpověď: výňatek z financial_kpi pro Hetzner Online GmbH, účetní období 2023

Rozšířené ukazatele

S tarify Pro a Max obsahuje každý řádek finančních KPI přes 90 dalších ukazatelů. Přicházejí ve stejném řádku a za stejnou cenu.

Poměrové ukazatele, marže a součty jako ebitda nebo net_debt_broad počítáme z položek závěrky. Pokud potřebná položka chybí, je ukazatel null.

Velikost a hodnoty na zaměstnance

Pole
Pole	Význam	Příklad	Dostupnost
financial_kpi[].company_size_by_employeesstring\|null	Velikostní třída podle počtu zaměstnanců.Hodnoty: `micro` mikro, `small` malá, `medium` střední, `large` velká`financial_kpi` · od Pro	`"large"`	částečně: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[].company_size_by_assetsstring\|null	Velikostní třída podle bilanční sumy.Hodnoty: `micro` mikro, `small` malá, `medium` střední, `large` velká	`"large"`	většinou: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[].company_size_by_revenuestring\|null	Velikostní třída podle tržeb.Hodnoty: `micro` mikro, `small` malá, `medium` střední, `large` velká	`"large"`	částečně: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[].revenue_per_employeenumber\|null	Tržby na zaměstnance v eurech.	`1582798.844`	jako výše
financial_kpi[].net_income_per_employeenumber\|null	Hospodářský výsledek na zaměstnance v eurech.	`485049.362`	jako výše

Rozvaha: součty a položky

Pole
Pole	Význam	Příklad	Dostupnost
financial_kpi[].assets_totalnumber\|null	Součet aktiv podle rozvahy, v eurech.`financial_kpi` · od Pro	`397093655.67`	většinou: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[].equity_totalnumber\|null	Vlastní kapitál v eurech.	`297695266.84`	jako výše
financial_kpi[].liabilities_totalnumber\|null	Závazky celkem v eurech.	`28921831.79`	jako výše
financial_kpi[].provisions_totalnumber\|null	Rezervy celkem v eurech.	`55716527.94`	částečně: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[].current_assets_totalnumber\|null	Oběžná aktiva v eurech.	`75902450.81`	jako výše
financial_kpi[].fixed_assets_totalnumber\|null	Stálá aktiva v eurech.	`316193205.41`	jako výše
financial_kpi[].inventory_totalnumber\|null	Zásoby v eurech.	`2605622.88`	jako výše
financial_kpi[].receivables_totalnumber\|null	Pohledávky a ostatní aktiva v eurech.	`34451734.53`	jako výše
financial_kpi[].trade_receivablesnumber\|null	Pohledávky z obchodních vztahů v eurech.	`25390709.7`	jako výše
financial_kpi[].intragroup_receivablesnumber\|null	Pohledávky za propojenými podniky v eurech.	`548819.99`	jako výše
financial_kpi[].securities_current_totalnumber\|null	Cenné papíry v oběžných aktivech v eurech.	`null`	jako výše
financial_kpi[].cash_and_equivalentsnumber\|null	Pokladní hotovost, zůstatky na bankovních účtech a šeky v eurech.	`38845093.4`	jako výše
financial_kpi[].ppe_totalnumber\|null	Dlouhodobý hmotný majetek v eurech.	`269497218.27`	jako výše
financial_kpi[].land_and_buildingsnumber\|null	Pozemky a stavby, včetně staveb na cizích pozemcích, v eurech.	`46944085.59`	jako výše
financial_kpi[].intangible_assetsnumber\|null	Dlouhodobý nehmotný majetek v eurech.	`18788946.41`	jako výše
financial_kpi[].goodwillnumber\|null	Goodwill v eurech.	`null`	jako výše
financial_kpi[].long_term_financial_assetsnumber\|null	Dlouhodobý finanční majetek v eurech.	`27907040.73`	jako výše
financial_kpi[].prepaid_expensesnumber\|null	Náklady příštích období v eurech.	`4997999.45`	jako výše
financial_kpi[].capital_reservesnumber\|null	Kapitálové fondy v eurech.	`536224.77`	jako výše
financial_kpi[].revenue_reservesnumber\|null	Fondy ze zisku v eurech.	`20005000`	jako výše
financial_kpi[].profit_loss_carried_forwardnumber\|null	Výsledek hospodaření minulých let v eurech; neuhrazená ztráta je záporná.	`332187259.01`	jako výše
financial_kpi[].pension_provisionsnumber\|null	Rezervy na penze a podobné závazky v eurech.	`null`	jako výše
financial_kpi[].other_provisionsnumber\|null	Ostatní rezervy v eurech.	`22278401.94`	jako výše
financial_kpi[].trade_payablesnumber\|null	Závazky z obchodních vztahů v eurech.	`14625866.4`	jako výše
financial_kpi[].intragroup_payablesnumber\|null	Závazky vůči podnikům ve skupině v eurech.	`2667666.2`	jako výše
financial_kpi[].liabilities_to_affiliated_companiesnumber\|null	Závazky vůči propojeným podnikům v eurech.	`2667666.2`	jako výše
financial_kpi[].other_liabilitiesnumber\|null	Ostatní závazky v eurech.	`11628299.19`	jako výše
financial_kpi[].deferred_incomenumber\|null	Výnosy příštích období v eurech.	`14760029.1`	jako výše
financial_kpi[].bank_debtnumber\|null	Závazky vůči bankám v eurech.	`null`	jako výše
financial_kpi[].bondsnumber\|null	Dluhopisy v eurech.	`null`	jako výše

Struktura a rozvahové poměry

Pole
Pole	Význam	Příklad	Dostupnost
financial_kpi[].equity_rationumber\|null	Podíl vlastního kapitálu: vlastní kapitál děleno bilanční sumou.`financial_kpi` · od Pro	`0.75`	většinou: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[].debt_to_equitynumber\|null	Míra zadlužení: závazky děleno vlastním kapitálem, jako faktor.	`0.097`	částečně: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[].debt_to_assetsnumber\|null	Závazky děleno bilanční sumou.	`0.073`	jako výše
financial_kpi[].cash_to_assetsnumber\|null	Peníze a peněžní ekvivalenty děleno bilanční sumou.	`0.098`	jako výše
financial_kpi[].cash_to_liabilitiesnumber\|null	Peníze a peněžní ekvivalenty děleno závazky.	`1.343`	jako výše
financial_kpi[].receivables_to_assetsnumber\|null	Pohledávky děleno bilanční sumou.	`0.087`	jako výše
financial_kpi[].inventory_to_assetsnumber\|null	Zásoby děleno bilanční sumou.	`0.007`	jako výše
financial_kpi[].ppe_to_assetsnumber\|null	Dlouhodobý hmotný majetek děleno bilanční sumou.	`0.679`	jako výše
financial_kpi[].intangible_to_assetsnumber\|null	Dlouhodobý nehmotný majetek děleno bilanční sumou.	`0.047`	jako výše
financial_kpi[].goodwill_to_assetsnumber\|null	Goodwill děleno bilanční sumou.	`null`	jako výše
financial_kpi[].intangible_to_equitynumber\|null	Dlouhodobý nehmotný majetek děleno vlastním kapitálem.	`0.063`	jako výše
financial_kpi[].tangible_equitynumber\|null	Vlastní kapitál bez nehmotného majetku a goodwillu, v eurech.	`278906320.43`	jako výše
financial_kpi[].tangible_equity_rationumber\|null	Hmotný vlastní kapitál děleno bilanční sumou.	`0.702`	jako výše

Pracovní kapitál a zadlužení

Pole
Pole	Význam	Příklad	Dostupnost
financial_kpi[].operating_working_capitalnumber\|null	Zásoby plus pohledávky z obchodních vztahů, minus závazky z obchodních vztahů, v eurech.`financial_kpi` · od Pro	`13370466.18`	částečně: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[].net_working_capital_strictnumber\|null	Oběžná aktiva minus krátkodobé závazky, v užším vymezení, v eurech.	`61276584.41`	jako výše
financial_kpi[].net_working_capital_approxnumber\|null	Přiblížení čistého pracovního kapitálu, když závěrka neuvádí všechny splatnosti, v eurech.	`46980619.02`	jako výše
financial_kpi[].interest_bearing_debt_strictnumber\|null	Úročené dluhy v užším vymezení: hlavně bankovní úvěry a dluhopisy, v eurech.	`null`	jako výše
financial_kpi[].interest_bearing_debt_broadnumber\|null	Úročené dluhy v širším vymezení, v eurech.	`14295965.39`	jako výše
financial_kpi[].net_debt_narrownumber\|null	Čistý dluh: úročené dluhy (užší) minus peníze a peněžní ekvivalenty, v eurech. Záporná hodnota znamená čistou hotovost.	`null`	jako výše
financial_kpi[].net_debt_broadnumber\|null	Čistý dluh: úročené dluhy (širší) minus peníze a peněžní ekvivalenty, v eurech. Záporná hodnota znamená čistou hotovost.	`-24549128.01`	jako výše

Položky a výsledky výkazu zisku a ztráty

Pole
Pole	Význam	Příklad	Dostupnost
financial_kpi[].material_expenses_goodsnumber\|null	Náklady na suroviny, materiál a nakoupené zboží, v eurech.`financial_kpi` · od Pro	`1157010.5`	částečně: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[].material_expenses_servicesnumber\|null	Náklady na nakoupené služby v eurech.	`115352630.06`	jako výše
financial_kpi[].wages_salariesnumber\|null	Mzdy a platy v eurech.	`33140885.29`	jako výše
financial_kpi[].social_expensesnumber\|null	Sociální odvody v eurech.	`4416500.91`	jako výše
financial_kpi[].pension_costsnumber\|null	Náklady na penzijní zabezpečení a podporu v eurech.	`null`	jako výše
financial_kpi[].depreciation_amortizationnumber\|null	Odpisy dlouhodobého nehmotného a hmotného majetku, v eurech.	`129958760.25`	jako výše
financial_kpi[].depreciation_amortization_operatingnumber\|null	Provozní odpisy, bez odpisů finančního majetku, v eurech.	`129958760.25`	jako výše
financial_kpi[].write_downs_financial_assets_and_securitiesnumber\|null	Odpisy finančního majetku a cenných papírů v oběžných aktivech, v eurech.	`null`	jako výše
financial_kpi[].other_operating_incomenumber\|null	Ostatní provozní výnosy v eurech.	`1229615.57`	jako výše
financial_kpi[].other_operating_expensesnumber\|null	Ostatní provozní náklady v eurech.	`29380170.42`	jako výše
financial_kpi[].selling_expensesnumber\|null	Odbytové náklady v eurech, u výkazu v účelovém členění.	`null`	jako výše
financial_kpi[].admin_expensesnumber\|null	Všeobecné správní náklady v eurech, u výkazu v účelovém členění.	`null`	jako výše
financial_kpi[].gross_profitnumber\|null	Hrubý zisk: tržby minus materiálové náklady nebo náklady na prodané výkony, v eurech.	`null`	jako výše
financial_kpi[].ebitnumber\|null	Výsledek před úroky a daněmi (EBIT) v eurech.	`null`	jako výše
financial_kpi[].ebtnumber\|null	Výsledek z běžné činnosti před zdaněním (EBT) v eurech.	`null`	jako výše
financial_kpi[].ebitdanumber\|null	Výsledek před úroky, daněmi a odpisy (EBITDA) v eurech.	`null`	jako výše
financial_kpi[].income_taxesnumber\|null	Daně z příjmů v eurech.	`67650181.5`	jako výše
financial_kpi[].other_taxesnumber\|null	Ostatní daně v eurech.	`94694.61`	jako výše
financial_kpi[].income_after_taxesnumber\|null	Výsledek po zdanění v eurech.	`165011477.67`	jako výše
financial_kpi[].interest_incomenumber\|null	Úroky a podobné výnosy v eurech.	`5025778.39`	jako výše
financial_kpi[].interest_expensenumber\|null	Úroky a podobné náklady v eurech, se znaménkem ze závěrky.	`42.37`	jako výše
financial_kpi[].finance_incomenumber\|null	Celkové výnosy z finanční činnosti, v eurech.	`5025778.39`	jako výše
financial_kpi[].finance_income_from_affiliatesnumber\|null	Výnosy z podílů v propojených podnicích, v eurech.	`null`	jako výše

Marže a poměry výkazu zisku a ztráty

Pole
Pole	Význam	Příklad	Dostupnost
financial_kpi[].gross_marginnumber\|null	Hrubá marže: hrubý zisk děleno tržbami.`financial_kpi` · od Pro	`null`	částečně: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[].ebitda_marginnumber\|null	Marže EBITDA: EBITDA děleno tržbami.	`null`	jako výše
financial_kpi[].ebit_marginnumber\|null	Marže EBIT: EBIT děleno tržbami.	`null`	jako výše
financial_kpi[].net_marginnumber\|null	Čistá marže: hospodářský výsledek děleno tržbami.	`0.306`	jako výše
financial_kpi[].material_intensitynumber\|null	Materiálová náročnost: materiálové náklady děleno tržbami.	`0.216`	jako výše
financial_kpi[].personnel_intensitynumber\|null	Osobní náročnost: osobní náklady děleno tržbami.	`0.07`	jako výše
financial_kpi[].sganumber\|null	Odbytové a správní náklady dohromady (SG&A), v eurech.	`null`	jako výše
financial_kpi[].sga_rationumber\|null	Odbytové a správní náklady děleno tržbami.	`null`	jako výše
financial_kpi[].opex_corenumber\|null	Hlavní provozní náklady účetního období v eurech.	`66937556.62`	jako výše
financial_kpi[].opex_rationumber\|null	Hlavní provozní náklady děleno tržbami.	`0.124`	jako výše
financial_kpi[].interest_coveragenumber\|null	Úrokové krytí: EBIT děleno nákladovými úroky, jako faktor.	`null`	jako výše
financial_kpi[].effective_tax_ratenumber\|null	Efektivní daňová sazba: daně z příjmů děleno výsledkem před zdaněním.	`null`	jako výše
financial_kpi[].capitalized_own_work_rationumber\|null	Aktivované vlastní výkony děleno tržbami.	`0.003`	jako výše
financial_kpi[].inventory_change_rationumber\|null	Změna stavu zásob děleno tržbami.	`null`	jako výše
financial_kpi[].finance_to_ebt_rationumber\|null	Finanční výsledek děleno výsledkem před zdaněním.	`null`	jako výše

Zdroj řádku

Pole
Pole	Význam	Příklad	Dostupnost
financial_kpi[].source_statement_datestring\|null	Rozvahový den závěrky, ze které řádek pochází. Stejné jako _provenance.period_end.`financial_kpi` · od Pro	`"2023-12-31"`	většinou: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
financial_kpi[].source_statement_typestring\|null	Druh závěrky, ze které řádek pochází. Stejné jako _provenance.statement_type.	`"Jahresabschluss"`	jako výše

Účetní standardy

Firmy sestavují závěrky podle různých pravidel. Většina se řídí německým obchodním zákoníkem (HGB). Koncerny na kapitálovém trhu sestavují konsolidovanou závěrku podle mezinárodních standardů IFRS.

I podle HGB vypadají závěrky různě. Rozvaha se řídí schématem § 266 HGB; malé firmy ji zveřejňují ve zkrácené podobě. Výkaz zisku a ztráty se řídí druhovým nebo účelovým členěním (§ 275 HGB). Každé členění má vlastní položky.

Abys mohl položky porovnávat napříč roky a mezi firmami, dáváme každému rozpoznanému řádku jednotný název. Je v name.de a name.en, bez ohledu na to, podle jakého standardu a s jakým popiskem závěrka řádek tiskne. Z „5. Personalaufwand“ se tak všude stane Personalaufwand a Personnel expenses.

name.in_report zachovává popisek přesně tak, jak je v závěrce, s číslem v osnově. Používej ho k zobrazení a ke kontrole s originálem. Částky, pořadí a strukturu přebíráme ze závěrky.

Pokud řádek nepřiřadíme k jednotné položce, name.en chybí a name.de opakuje vytištěný popisek. Podle name.en tedy poznáš, zda má řádek jednotný název.

Pro ukazatele počítané u každé firmy stejně použij finanční KPI. Podle jakého rámce byla závěrka sestavena, uvádí audit.accounting_framework v účetních závěrkách, pokud závěrka obsahuje výrok auditora.

Rozvaha

Funkce balance_sheet_accounts vrací rozvahu každého účetního období se všemi položkami. Položky tvoří strom, strukturovaný jako v závěrce. Jejich názvy normalizujeme; více v části Účetní standardy.

Kořeny jsou Aktivseite (aktiva) a Passivseite (pasiva). Poznáš je i každou známou položku podle name.de, ne podle pozice. Jak hluboko položka leží, se může mezi dvěma závěrkami lišit. Prohledávej proto celý strom.

Potomci položky nemusí dát v součtu její celkovou hodnotu. Řádky „davon“ („z toho“) jsou součástí nadřazené hodnoty, ne přírůstkem.

Pole
Pole	Význam	Příklad	Dostupnost
balance_sheet_accountsarray	Rozvahy: jeden záznam za každé účetní období, nejnovější první.Prázdné, když firma nezveřejnila žádnou rozvahu`balance_sheet_accounts`	–	většinou: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
balance_sheet_accounts[].yearinteger	Kalendářní rok, ve kterém účetní období končí.	`2023`	jako výše
balance_sheet_accounts[].balance_sheet_accountsarray	Strom položek s kořeny Aktivseite a Passivseite. Každý uzel má name, value a children.	–	jako výše
balance_sheet_accounts[].balance_sheet_accounts[].name.destring	Jednotný německý název položky, stejný napříč roky, firmami a účetními standardy. Podle něj položku poznáš. Pokud řádek není přiřazen k jednotné položce, jde o vytištěný popisek.	`"Aktivseite"`	jako výše
balance_sheet_accounts[].balance_sheet_accounts[].name.enstring	Jednotný anglický název položky. Pokud klíč chybí, řádek není přiřazen k jednotné položce.	`"Assets"`	jako výše
balance_sheet_accounts[].balance_sheet_accounts[].name.in_reportstring\|null	Popisek přesně tak, jak ho závěrka tiskne, s číslem v osnově. Určeno k zobrazení a ke kontrole s originálem.	`"Aktiva"`	jako výše
balance_sheet_accounts[].balance_sheet_accounts[].valuenumber\|null	Částka položky v eurech. Pokud závěrka netiskne částku, jde o součet potomků.	`397093655.67`	jako výše
balance_sheet_accounts[].balance_sheet_accounts[].childrenarray	Podpoložky ve vytištěném pořadí, se stejnou strukturou. Mohou být prázdné.	–	částečně: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
balance_sheet_accounts[]._provenanceobject	Ze které závěrky rozvaha pochází, se stejnými poli jako ve finančních KPI.	–	většinou: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
balance_sheet_accounts[].activity_statementsarray	Výkazy činnosti energetického podniku (§ 6b EnWG). Každá činnost má activity.name s de, en a in_report, strom rozvahy a _provenance se statement_type Tätigkeitsabschluss. Jen pokud závěrka obsahuje výkazy činnosti.`balance_sheet_accounts` · od Max	–	zřídka

S tarifem Max dostaneš navíc výkazy činnosti energetických podniků, bez příplatku. Jsou to samostatné rozvahy, které energetický podnik zveřejňuje pro každou regulovanou činnost podle § 6b EnWG. Jsou v activity_statements, každá s activity.name, stromem a _provenance. Činnosti obvykle pokrývají jen část firmy. Nesčítej je proto a neporovnávej je se součty firmy.

V příkladu Hetzner Online GmbH začátek rozvahy za rok 2023, zkrácený na první větev aktiv:

1{2  "balance_sheet_accounts": [3    {4      "year": 2023,5      "balance_sheet_accounts": [6        {7          "name": {8            "de": "Aktivseite",9            "en": "Assets",10            "in_report": "Aktiva"11          },12          "value": 397093655.67,13          "children": [14            {15              "name": {16                "de": "Anlagevermögen",17                "en": "Fixed Assets",18                "in_report": "A. Anlagevermögen"19              },20              "value": 316193205.41,21              "children": [22                {23                  "name": {24                    "de": "Immaterielle Vermögensgegenstände",25                    "en": "Intangible Assets",26                    "in_report": "I. Immaterielle Vermögensgegenstände"27                  },28                  "value": 18788946.41,29                  "children": [30                    {31                      "name": {32                        "de": "Entgeltlich erworbene Konzessionen",33                        "en": "Purchased Concessions",34                        "in_report": "1. entgeltlich erworbene Konzessionen, gewerbliche Schutzrechte und ähnliche Rechte und Werte sowie Lizenzen an solchen Rechten und Werten"35                      },36                      "value": 13879378,37                      "children": []38                    },39                    {40                      "name": {41                        "de": "Geleistete Anzahlungen",42                        "en": "Advance Payments",43                        "in_report": "2. geleistete Anzahlungen"44                      },45                      "value": 4909568.41,46                      "children": []47                    }48                  ]49                }50              ]51            }52          ]53        }54      ],55      "_provenance": {56        "statement_type": "Jahresabschluss",57        "period_start": "2023-01-01",58        "period_end": "2023-12-31",59        "exempt_subsidiary": false,60        "parent_organization": null61      }62    }63  ]64}

Ukázková odpověď: výňatek z balance_sheet_accounts pro Hetzner Online GmbH

Výkaz zisku a ztráty

Funkce profit_and_loss_account vrací výkaz zisku a ztráty každého účetního období. Uzly jsou strukturované jako v rozvaze; seznam se zde jmenuje profit_and_loss_accounts.

Nejvyšší úroveň obsahuje položky a vytištěné mezisoučty vedle sebe, například hrubý výsledek nebo hospodářský výsledek. Nesčítej je proto; používej vytištěné výsledky.

Výkaz zisku a ztráty zveřejňují střední a velké firmy. Střední firmy ho smějí začít hrubým výsledkem; tržby pak jako samostatný řádek chybí.

Pole
Pole	Význam	Příklad	Dostupnost
profit_and_loss_accountarray	Výkazy zisku a ztráty: jeden záznam za každé účetní období, nejnovější první. Každý záznam obsahuje své položky pod `profit_and_loss_accounts`.Prázdné, když firma nezveřejnila žádný výkaz zisku a ztráty, například jako malá firma`profit_and_loss_account`	–	částečně: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
profit_and_loss_account[].yearinteger	Kalendářní rok, ve kterém účetní období končí.	`2023`	jako výše
profit_and_loss_account[].profit_and_loss_accountsarray	Řádky výkazu zisku a ztráty ve vytištěném pořadí, jako strom jako v rozvaze. Nahoře stojí položky a mezisoučty vedle sebe.	–	jako výše
profit_and_loss_account[].profit_and_loss_accounts[].name.destring	Jednotný německý název položky, stejný napříč roky, firmami a účetními standardy. Pokud řádek není přiřazen k jednotné položce, jde o vytištěný popisek.	`"Umsatzerlöse"`	jako výše
profit_and_loss_account[].profit_and_loss_accounts[].name.enstring	Jednotný anglický název položky. Pokud klíč chybí, řádek není přiřazen k jednotné položce.	`"Revenue"`	jako výše
profit_and_loss_account[].profit_and_loss_accounts[].name.in_reportstring\|null	Popisek přesně tak, jak ho závěrka tiskne. Určeno k zobrazení a ke kontrole s originálem.	`"1. Umsatzerlöse"`	jako výše
profit_and_loss_account[].profit_and_loss_accounts[].valuenumber\|null	Částka v eurech. Náklady nesou znaménko ze závěrky.	`538151607.13`	jako výše
profit_and_loss_account[].profit_and_loss_accounts[].childrenarray	Podřádky se stejnou strukturou. Mohou být prázdné.	–	jako výše
profit_and_loss_account[]._provenanceobject	Ze které závěrky výkaz zisku a ztráty pochází, se stejnými poli jako ve finančních KPI.	–	jako výše
profit_and_loss_account[].activity_statementsarray	Výkaz zisku a ztráty pro každou činnost energetického podniku (§ 6b EnWG): activity.name, řádky v profit_and_loss_accounts a _provenance. Jen pokud závěrka obsahuje výkazy činnosti.`profit_and_loss_account` · od Max	–	zřídka

I zde vrací tarif Max výkazy činnosti energetických podniků v activity_statements, s výkazem zisku a ztráty každé činnosti pod profit_and_loss_accounts. Rozvahu a výkaz zisku a ztráty jedné činnosti spáruješ přes activity.name.de.

Roční účetní závěrky

Funkce annual_financial_statements a annual_financial_statements__html vracejí zveřejněné závěrky v plném znění. Patří k tomu rozvaha, výkaz zisku a ztráty, příloha a výroční zpráva, pokud je firma zveřejňuje.

Varianta Markdown je určena hlavně pro AI agenty. Je mnohem kompaktnější než HTML a šetří tokeny. Originály často nemají čistou strukturu. Běžné renderery Markdownu proto text bez dalšího zpracování čistě nezobrazí. K zobrazení s tabulkami použij variantu HTML. Obě varianty mají stejná pole; jen text je v document_md nebo v document_html.

Bez financial_years dostaneš pět nejnovějších závěrek. S financial_years=3 dostaneš všechny závěrky tří nejnovějších účetních období. Závěrka může být velmi dlouhá. Zejména varianta HTML je při mnoha letech velká.

Pole
Pole	Význam	Příklad	Dostupnost
annual_financial_statementsarray	Zveřejněné závěrky v plném znění jako Markdown, nejnovější první.Prázdné, když firma nezveřejnila žádné závěrky`annual_financial_statements`	–	většinou: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
annual_financial_statements[].document_typestring	Druh závěrky.Hodnoty: `Jahresabschluss` individuální závěrka, `Konzernabschluss` závěrka koncernu	`"Jahresabschluss"`	jako výše
annual_financial_statements[].document_titlestring	Název zveřejnění, s účetním obdobím.	`"Jahresabschluss zum Geschäftsjahr vom 01.01.2023 bis zum…"`	jako výše
annual_financial_statements[].document_datestring	Datum zveřejnění.	`"2025-06-25"`	jako výše
annual_financial_statements[].yearinteger	Kalendářní rok, ve kterém účetní období končí.	`2023`	jako výše
annual_financial_statements[].languagestring	Jazyk závěrky jako jeho německý název, například Deutsch nebo Englisch. Je to text, ne kód.	`"Deutsch"`	jako výše
annual_financial_statements[].document_mdstring	Plný text jako Markdown, s rozvahou, výkazem zisku a ztráty, přílohou a výroční zprávou, pokud byly zveřejněny. Kompaktní pro AI agenty; k zobrazení použij document_html.	`"Firma\nInformation\nBezeichnung \nHetzner Online GmbH, G…"`	jako výše
annual_financial_statements__htmlarray	Tytéž závěrky jako HTML s tabulkami, k zobrazení. Každý záznam má stejná pole; text je v document_html místo document_md.Prázdné, když firma nezveřejnila žádné závěrky`annual_financial_statements__html`	–	jako výše

Audit

Pokud závěrka obsahuje výrok auditora, audit popisuje audit: kdo auditoval, podle jakého rámce a kdy byl výrok podepsán. Bez výroku je audit null.

Pole
Pole	Význam	Příklad	Dostupnost
annual_financial_statements[].auditobject\|null	Audit závěrky, pokud obsahuje výrok auditora. Zahrnuto v ceně funkce.Prázdné, když závěrka neobsahuje výrok auditora`annual_financial_statements`	–	částečně: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG zřídka: KG, OHG, e.K. nikdy: PartG
annual_financial_statements[].audit.kindstring	Druh zprávy.Hodnoty: `AUDIT_REPORT` výrok auditora (Bestätigungsvermerk)	`"AUDIT_REPORT"`	jako výše
annual_financial_statements[].audit.subjectstring	Která závěrka byla auditována.Hodnoty: `OWN` vlastní závěrka firmy, `OWN_GROUP` vlastní konsolidovaná závěrka firmy	`"OWN"`	jako výše
annual_financial_statements[].audit.auditedboolean	true, pokud byla závěrka auditována.	`true`	jako výše
annual_financial_statements[].audit.accounting_frameworkstring\|null	Rámec auditované závěrky.Hodnoty: `HGB` německý obchodní zákoník (Handelsgesetzbuch), `IFRS_EU` IFRS ve znění přijatém v EU, `PUBLG` německý zákon o zveřejňování (Publizitätsgesetz)	`"HGB"`	jako výše
annual_financial_statements[].audit.auditor.namestring	Název auditorské firmy.	`"WP Koehler GmbH Wirtschaftsprüfungsgesellschaft"`	jako výše
annual_financial_statements[].audit.auditor.typestring	Druh auditora.Hodnoty: `FIRM` auditorská společnost (Wirtschaftsprüfungsgesellschaft), `COOP_ASSOCIATION` revizní svaz družstev	`"FIRM"`	jako výše
annual_financial_statements[].audit.auditor.entity_idstring\|null	entity_id auditorské firmy, použitelné jako q ve fetch-organization.Prázdné, když název jednoznačně neidentifikuje firmu	`null`	jako výše
annual_financial_statements[].audit.auditor.networkobject\|null	Auditorská síť s key a name, například PwC.Prázdné, když firma nepatří do žádné známé sítě	–	jako výše
annual_financial_statements[].audit.auditor.signatoriesarray	Podepisující auditoři s name, academic_title a qualification, například WP pro Wirtschaftsprüfer (německý statutární auditor).	–	jako výše
annual_financial_statements[].audit.signedobject\|null	Místo (place) a datum (date) výroku auditora.	–	jako výše

Nejnovější závěrka Hetzner Online GmbH v době našeho ukázkového požadavku, text zkrácen:

1{2  "annual_financial_statements": [3    {4      "document_type": "Jahresabschluss",5      "document_date": "2025-06-25",6      "document_title": "Jahresabschluss zum Geschäftsjahr vom 01.01.2023 bis zum 31.12.2023",7      "language": "Deutsch",8      "year": 2023,9      "audit": {10        "kind": "AUDIT_REPORT",11        "subject": "OWN",12        "audited": true,13        "accounting_framework": "HGB",14        "auditor": {15          "name": "WP Koehler GmbH Wirtschaftsprüfungsgesellschaft",16          "type": "FIRM",17          "entity_id": null,18          "network": null,19          "signatories": [20            {21              "name": "Reiner Musterwald",22              "academic_title": null,23              "qualification": "WP"24            }25          ]26        },27        "signed": {28          "place": "Seeheim-Jugehein",29          "date": "2024-06-10"30        }31      },32      "document_md": "Firma
Information
Bezeichnung 
Hetzner Online GmbH, Gunzenhausen
Rechnungslegung / Finanzberichte
Unternehmensregister
Jahresabschluss zum Geschäftsjahr vom 01.01.2023 bis zum 31.12.2023
 
Datum: 25.06.2025
Sprache:
Deutsch
| |
| --- |
| He…"33    }34  ]35}

Ukázková odpověď: výňatek z annual_financial_statements pro Hetzner Online GmbH

Dále

Analyzovat finanční ukazatele Načíst ukazatele za více let, zvolit individuální nebo konsolidované závěrky. fetch-organization Všechny parametry a funkce endpointu. Dostupnost dat Co musí která právní forma a velikostní třída zveřejňovat. search-organizations Najít firmy podle tržeb, zaměstnanců nebo bilanční sumy.