Date financiare – Documentație

Funcție
Funcție	Ce returnează	Credite
financial_kpi	Indicatori financiari: un rând de KPI‑uri pe exercițiu financiar	1
balance_sheet_accounts	Bilanț: toate pozițiile pe exercițiu financiar, ca arbore	3
profit_and_loss_account	Cont de profit și pierdere (în germană GuV): toate pozițiile pe exercițiu financiar, ca arbore	3
annual_financial_statements	Situații financiare anuale (Markdown): textul integral al situațiilor, compact pentru agenți AI	5
annual_financial_statements__html	Situații financiare anuale (HTML): textul integral cu tabele ca HTML, pentru afișare	5

Convenții

Sumele sunt în euro, ca sume întregi, fără rotunjire la mii. O cifră de afaceri de 538,2 milioane € vine ca 538151607.13.
Semnele: cheltuielile poartă semnul pe care îl tipărește situația. Unele situații le arată pozitive, altele negative. Compară deci cheltuielile fără semn. Pierderile și deficitele sunt negative.
Rapoartele și marjele sunt numere zecimale: 0.75 înseamnă 75 %. Factorii precum debt_to_equity și interest_coverage sunt multipli.
Exercițiul financiar: year este anul calendaristic în care se încheie exercițiul financiar. Un exercițiu financiar de la 2024-10-01 la 2025-09-30 este deci 2025. Datele exacte se află în _provenance.period_start și period_end.
Ordinea: fiecare funcție returnează o listă cu câte o intrare pe exercițiu financiar, cea mai nouă prima. Între doi ani poate lipsi un an dacă nu există o situație pentru el.
null înseamnă: situația nu indică valoarea sau aceasta nu poate fi dedusă din ea. O companie mică, de exemplu, nu publică un cont de profit și pierdere, așa că revenue rămâne gol.

Dacă o companie nu are situații potrivite, funcția vine ca listă goală []. Pentru asta nu taxăm credite.

Situații individuale și consolidate

O situație individuală (Jahresabschluss) arată compania însăși, o situație consolidată (Konzernabschluss) întregul grup. Fără alte date de intrare, fiecare funcție alege singură. Un răspuns poate conține deci cifre individuale și de grup, chiar și pentru același an în funcții diferite.

Fiecare intrare indică în _provenance din ce situație provin cifrele ei. Compară anii doar în cadrul aceluiași statement_type. Altfel compari o companie cu grupul ei.

Cu financial_statement_type=annual primești doar situații individuale, cu consolidated doar situații consolidate. financial_years limitează răspunsul la cele mai noi exerciții financiare, de la 1 la 30. Ambii parametri se aplică tuturor celor cinci funcții și nu schimbă prețul. Mai multe la Analizează KPI‑urile financiare.

Originea unei intrări

Fiecare intrare din indicatorii financiari, bilanț și contul de profit și pierdere conține _provenance, în orice plan și chiar fără plan. Câmpurile sunt aceleași în toate cele trei funcții. În indicatorii financiari, _provenance este întotdeauna ultima cheie a rândului.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
financial_kpi[]._provenanceobject	Din ce situație provin cifrele rândului. Prezent în fiecare rând, în orice plan și chiar fără plan, întotdeauna ca ultima cheie.`financial_kpi`	–	de obicei: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[]._provenance.statement_typestring\|null	Tipul situației, așa cum îl numește registrul.Valori: `Jahresabschluss` situația individuală a companiei, `Bilanz` un bilanț publicat separat, `Konzernabschluss` cifrele grupului, `null` date de piață ale unei companii listate	`"Jahresabschluss"`	ca mai sus
financial_kpi[]._provenance.period_startstring\|null	Prima zi a exercițiului financiar, așa cum e tipărită în situație.Gol când situația nu indică începutul, precum și la datele de piață	`"2023-01-01"`	ca mai sus
financial_kpi[]._provenance.period_endstring\|null	Ultima zi a exercițiului financiar, data bilanțului. Un exercițiu financiar poate fi mai scurt sau mai lung de douăsprezece luni, de exemplu după o înființare sau o schimbare a exercițiului financiar.	`"2023-12-31"`	ca mai sus
financial_kpi[]._provenance.exempt_subsidiaryboolean	true dacă compania a publicat situația consolidată a societății-mamă în locul propriei situații. Toate cifrele anului se aplică atunci grupului lui `parent_organization`.	`false`	ca mai sus
financial_kpi[]._provenance.parent_organizationobject\|null	Compania a cărei situație consolidată a fost publicată, cu entity_id și name. entity_id este null dacă numele nu identifică unic o companie.Gol când exempt_subsidiary este false	`null`	rar

Mărime și formă juridică

Ce publică o companie stabilește legea, în funcție de forma juridică și clasa de mărime. Asta decide ce câmpuri au valori.

GmbH și UG, AG, SE și KGaA, GmbH & Co. KG și eG își publică situațiile. Un KG sau OHG cu o persoană fizică drept asociat cu răspundere personală publică doar dacă este foarte mare. La fel pentru comercianții individuali. Societățile de profesii liberale (PartG) nu publică situații. O filială dintr-un grup poate, în anumite condiții, să nu-și publice propria situație. Pentru asta trebuie să fie inclusă în situația consolidată a societății-mamă (§ 264 alin. 3 HGB).

Clasă de mărime
Clasă de mărime	Ce se publică	Ce primești
Micro	Un bilanț prescurtat	Bilanțul și cifrele din el, de exemplu totalul activelor
Mică	Bilanț și anexă, fără cont de profit și pierdere	Bilanțul și cifrele din el, parțial numărul de angajați; de obicei nu și cifra de afaceri
Mijlocie	Bilanț, cont de profit și pierdere, anexă și raport de gestiune; contul de profit și pierdere poate începe cu rezultatul brut	Bilanț și cont de profit și pierdere; cifra de afaceri dacă contul de profit și pierdere o arată separat
Mare	Situația anuală completă cu raport de gestiune	Bilanț, cont de profit și pierdere și KPI‑uri în toată profunzimea

Microîntreprinderile pot și doar să își depună bilanțul. Acesta nu este atunci liber accesibil. Mai multe despre clasele de mărime și termene la Disponibilitatea datelor.

Companiile au douăsprezece luni după încheierea exercițiului financiar ca să publice, iar multe folosesc tot termenul. Cea mai nouă intrare acoperă de aceea adesea anul de dinainte de anul trecut sau unul mai vechi.

Coloana Disponibilitate din tabelele de mai jos rezumă asta pe formă juridică. „parțial” înseamnă: valoarea vine dacă clasa de mărime a companiei o publică.

KPI‑uri de bază

Aceste KPI‑uri le primești cu orice cont, cu sau fără plan, în funcția financial_kpi (Indicatori financiari).

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
financial_kpiarray	Indicatorii financiari: un rând pe exercițiu financiar, cel mai nou primul.Gol când compania nu a publicat situații care pot fi evaluate`financial_kpi`	–	de obicei: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[].yearinteger	Anul calendaristic în care se încheie exercițiul financiar.	`2023`	ca mai sus
financial_kpi[].revenuenumber\|null	Cifra de afaceri în euro.Gol când situația nu conține cont de profit și pierdere sau cifră de afaceri	`538151607.13`	parțial: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[].net_incomenumber\|null	Profitul sau pierderea netă a anului în euro; o pierdere este negativă.	`164916783.06`	ca mai sus
financial_kpi[].active_totalnumber\|null	Totalul activelor în euro.	`397093655.67`	de obicei: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[].employeesnumber\|null	Numărul de angajați, așa cum îl indică situația.Gol când situația nu are anexă cu numărul de angajați, de exemplu la microîntreprinderi	`340`	parțial: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[].material_expensesnumber\|null	Cheltuieli cu materialele în euro, cu semnul din situație.	`116509640.56`	ca mai sus
financial_kpi[].personnel_expensesnumber\|null	Cheltuieli cu personalul în euro, cu semnul din situație.	`37557386.2`	ca mai sus

De exemplu, un exercițiu financiar din cererea noastră exemplu pentru Hetzner Online GmbH, Ansbach HRB 6089, cu KPI‑urile de bază și originea lui:

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: CHEIA_TA_API" \
  --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": "CHEIA_TA_API"},
    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": "CHEIA_TA_API" },
});
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}

Răspuns exemplu: fragment din financial_kpi pentru Hetzner Online GmbH, exercițiul financiar 2023

KPI‑uri extinse

Cu planurile Pro și Max, fiecare rând al indicatorilor financiari conține peste 90 de KPI‑uri în plus. Vin în același rând și la același preț.

Rapoartele, marjele și totalurile precum ebitda sau net_debt_broad le calculăm din pozițiile situației. Dacă lipsește o poziție necesară, KPI‑ul este null.

Mărime și valori per angajat

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
financial_kpi[].company_size_by_employeesstring\|null	Clasa de mărime după numărul de angajați.Valori: `micro` micro, `small` mică, `medium` mijlocie, `large` mare`financial_kpi` · de la Pro	`"large"`	parțial: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[].company_size_by_assetsstring\|null	Clasa de mărime după totalul activelor.Valori: `micro` micro, `small` mică, `medium` mijlocie, `large` mare	`"large"`	de obicei: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[].company_size_by_revenuestring\|null	Clasa de mărime după cifra de afaceri.Valori: `micro` micro, `small` mică, `medium` mijlocie, `large` mare	`"large"`	parțial: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[].revenue_per_employeenumber\|null	Cifra de afaceri per angajat în euro.	`1582798.844`	ca mai sus
financial_kpi[].net_income_per_employeenumber\|null	Profitul net per angajat în euro.	`485049.362`	ca mai sus

Bilanț: totaluri și poziții

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
financial_kpi[].assets_totalnumber\|null	Suma activelor conform bilanțului, în euro.`financial_kpi` · de la Pro	`397093655.67`	de obicei: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[].equity_totalnumber\|null	Capitalurile proprii în euro.	`297695266.84`	ca mai sus
financial_kpi[].liabilities_totalnumber\|null	Totalul datoriilor în euro.	`28921831.79`	ca mai sus
financial_kpi[].provisions_totalnumber\|null	Totalul provizioanelor în euro.	`55716527.94`	parțial: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[].current_assets_totalnumber\|null	Activele circulante în euro.	`75902450.81`	ca mai sus
financial_kpi[].fixed_assets_totalnumber\|null	Activele imobilizate în euro.	`316193205.41`	ca mai sus
financial_kpi[].inventory_totalnumber\|null	Stocurile în euro.	`2605622.88`	ca mai sus
financial_kpi[].receivables_totalnumber\|null	Creanțele și alte active în euro.	`34451734.53`	ca mai sus
financial_kpi[].trade_receivablesnumber\|null	Creanțele comerciale în euro.	`25390709.7`	ca mai sus
financial_kpi[].intragroup_receivablesnumber\|null	Creanțele față de companiile afiliate în euro.	`548819.99`	ca mai sus
financial_kpi[].securities_current_totalnumber\|null	Titlurile de valoare deținute ca active circulante în euro.	`null`	ca mai sus
financial_kpi[].cash_and_equivalentsnumber\|null	Numerarul în casă, soldurile bancare și cecurile în euro.	`38845093.4`	ca mai sus
financial_kpi[].ppe_totalnumber\|null	Imobilizările corporale în euro.	`269497218.27`	ca mai sus
financial_kpi[].land_and_buildingsnumber\|null	Terenuri și clădiri, inclusiv clădirile pe terenuri ale terților, în euro.	`46944085.59`	ca mai sus
financial_kpi[].intangible_assetsnumber\|null	Imobilizările necorporale în euro.	`18788946.41`	ca mai sus
financial_kpi[].goodwillnumber\|null	Fondul comercial (goodwill) în euro.	`null`	ca mai sus
financial_kpi[].long_term_financial_assetsnumber\|null	Imobilizările financiare (pe termen lung) în euro.	`27907040.73`	ca mai sus
financial_kpi[].prepaid_expensesnumber\|null	Cheltuielile înregistrate în avans în euro.	`4997999.45`	ca mai sus
financial_kpi[].capital_reservesnumber\|null	Rezervele de capital în euro.	`536224.77`	ca mai sus
financial_kpi[].revenue_reservesnumber\|null	Rezervele din profit în euro.	`20005000`	ca mai sus
financial_kpi[].profit_loss_carried_forwardnumber\|null	Profitul sau pierderea reportată în euro; o pierdere reportată este negativă.	`332187259.01`	ca mai sus
financial_kpi[].pension_provisionsnumber\|null	Provizioanele pentru pensii și obligații similare în euro.	`null`	ca mai sus
financial_kpi[].other_provisionsnumber\|null	Alte provizioane în euro.	`22278401.94`	ca mai sus
financial_kpi[].trade_payablesnumber\|null	Datoriile comerciale în euro.	`14625866.4`	ca mai sus
financial_kpi[].intragroup_payablesnumber\|null	Datoriile față de companiile din grup în euro.	`2667666.2`	ca mai sus
financial_kpi[].liabilities_to_affiliated_companiesnumber\|null	Datoriile față de companiile afiliate în euro.	`2667666.2`	ca mai sus
financial_kpi[].other_liabilitiesnumber\|null	Alte datorii în euro.	`11628299.19`	ca mai sus
financial_kpi[].deferred_incomenumber\|null	Veniturile înregistrate în avans în euro.	`14760029.1`	ca mai sus
financial_kpi[].bank_debtnumber\|null	Datoriile față de bănci în euro.	`null`	ca mai sus
financial_kpi[].bondsnumber\|null	Obligațiunile în euro.	`null`	ca mai sus

Structură și rapoarte de bilanț

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
financial_kpi[].equity_rationumber\|null	Rata capitalurilor proprii: capitalurile proprii împărțite la totalul activelor.`financial_kpi` · de la Pro	`0.75`	de obicei: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[].debt_to_equitynumber\|null	Gradul de îndatorare: datoriile împărțite la capitalurile proprii, ca factor.	`0.097`	parțial: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[].debt_to_assetsnumber\|null	Datoriile împărțite la totalul activelor.	`0.073`	ca mai sus
financial_kpi[].cash_to_assetsnumber\|null	Numerarul și echivalentele de numerar împărțite la totalul activelor.	`0.098`	ca mai sus
financial_kpi[].cash_to_liabilitiesnumber\|null	Numerarul și echivalentele de numerar împărțite la datorii.	`1.343`	ca mai sus
financial_kpi[].receivables_to_assetsnumber\|null	Creanțele împărțite la totalul activelor.	`0.087`	ca mai sus
financial_kpi[].inventory_to_assetsnumber\|null	Stocurile împărțite la totalul activelor.	`0.007`	ca mai sus
financial_kpi[].ppe_to_assetsnumber\|null	Imobilizările corporale împărțite la totalul activelor.	`0.679`	ca mai sus
financial_kpi[].intangible_to_assetsnumber\|null	Imobilizările necorporale împărțite la totalul activelor.	`0.047`	ca mai sus
financial_kpi[].goodwill_to_assetsnumber\|null	Fondul comercial împărțit la totalul activelor.	`null`	ca mai sus
financial_kpi[].intangible_to_equitynumber\|null	Imobilizările necorporale împărțite la capitalurile proprii.	`0.063`	ca mai sus
financial_kpi[].tangible_equitynumber\|null	Capitalurile proprii fără imobilizări necorporale și fond comercial, în euro.	`278906320.43`	ca mai sus
financial_kpi[].tangible_equity_rationumber\|null	Capitalurile proprii tangibile împărțite la totalul activelor.	`0.702`	ca mai sus

Capital de lucru și datorii

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
financial_kpi[].operating_working_capitalnumber\|null	Stocurile plus creanțele comerciale, minus datoriile comerciale, în euro.`financial_kpi` · de la Pro	`13370466.18`	parțial: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[].net_working_capital_strictnumber\|null	Activele circulante minus datoriile pe termen scurt, în sens restrâns, în euro.	`61276584.41`	ca mai sus
financial_kpi[].net_working_capital_approxnumber\|null	Aproximarea capitalului de lucru net când situația nu indică toate scadențele, în euro.	`46980619.02`	ca mai sus
financial_kpi[].interest_bearing_debt_strictnumber\|null	Datoriile purtătoare de dobândă, în sens restrâns: în principal datorii bancare și obligațiuni, în euro.	`null`	ca mai sus
financial_kpi[].interest_bearing_debt_broadnumber\|null	Datoriile purtătoare de dobândă, în sens larg, în euro.	`14295965.39`	ca mai sus
financial_kpi[].net_debt_narrownumber\|null	Datoria netă: datoriile purtătoare de dobândă (restrâns) minus numerarul și echivalentele de numerar, în euro. Negativ înseamnă numerar net.	`null`	ca mai sus
financial_kpi[].net_debt_broadnumber\|null	Datoria netă: datoriile purtătoare de dobândă (larg) minus numerarul și echivalentele de numerar, în euro. Negativ înseamnă numerar net.	`-24549128.01`	ca mai sus

Poziții și rezultate din contul de profit și pierdere

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
financial_kpi[].material_expenses_goodsnumber\|null	Cheltuieli cu materiile prime, materialele consumabile și mărfurile achiziționate, în euro.`financial_kpi` · de la Pro	`1157010.5`	parțial: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[].material_expenses_servicesnumber\|null	Cheltuieli cu serviciile achiziționate în euro.	`115352630.06`	ca mai sus
financial_kpi[].wages_salariesnumber\|null	Salariile în euro.	`33140885.29`	ca mai sus
financial_kpi[].social_expensesnumber\|null	Contribuțiile sociale în euro.	`4416500.91`	ca mai sus
financial_kpi[].pension_costsnumber\|null	Cheltuieli cu pensiile și ajutoarele în euro.	`null`	ca mai sus
financial_kpi[].depreciation_amortizationnumber\|null	Amortizarea imobilizărilor necorporale și corporale, în euro.	`129958760.25`	ca mai sus
financial_kpi[].depreciation_amortization_operatingnumber\|null	Amortizarea operațională, fără deprecierile imobilizărilor financiare, în euro.	`129958760.25`	ca mai sus
financial_kpi[].write_downs_financial_assets_and_securitiesnumber\|null	Deprecierile imobilizărilor financiare și ale titlurilor de valoare deținute ca active circulante, în euro.	`null`	ca mai sus
financial_kpi[].other_operating_incomenumber\|null	Alte venituri din exploatare în euro.	`1229615.57`	ca mai sus
financial_kpi[].other_operating_expensesnumber\|null	Alte cheltuieli de exploatare în euro.	`29380170.42`	ca mai sus
financial_kpi[].selling_expensesnumber\|null	Cheltuieli de vânzare în euro, la un cont de profit și pierdere după metoda costului vânzărilor.	`null`	ca mai sus
financial_kpi[].admin_expensesnumber\|null	Cheltuieli generale de administrație în euro, la un cont de profit și pierdere după metoda costului vânzărilor.	`null`	ca mai sus
financial_kpi[].gross_profitnumber\|null	Profitul brut: cifra de afaceri minus cheltuielile cu materialele sau costul vânzărilor, în euro.	`null`	ca mai sus
financial_kpi[].ebitnumber\|null	Rezultatul înainte de dobânzi și impozite (EBIT) în euro.	`null`	ca mai sus
financial_kpi[].ebtnumber\|null	Rezultatul din activitatea curentă înainte de impozite (EBT) în euro.	`null`	ca mai sus
financial_kpi[].ebitdanumber\|null	Rezultatul înainte de dobânzi, impozite, depreciere și amortizare (EBITDA) în euro.	`null`	ca mai sus
financial_kpi[].income_taxesnumber\|null	Impozitele pe venit și profit în euro.	`67650181.5`	ca mai sus
financial_kpi[].other_taxesnumber\|null	Alte impozite în euro.	`94694.61`	ca mai sus
financial_kpi[].income_after_taxesnumber\|null	Rezultatul după impozite în euro.	`165011477.67`	ca mai sus
financial_kpi[].interest_incomenumber\|null	Venituri din dobânzi și venituri similare în euro.	`5025778.39`	ca mai sus
financial_kpi[].interest_expensenumber\|null	Cheltuieli cu dobânzile și cheltuieli similare în euro, cu semnul din situație.	`42.37`	ca mai sus
financial_kpi[].finance_incomenumber\|null	Totalul veniturilor din activitatea financiară, în euro.	`5025778.39`	ca mai sus
financial_kpi[].finance_income_from_affiliatesnumber\|null	Venituri din participațiile la companii afiliate, în euro.	`null`	ca mai sus

Marje și rapoarte din contul de profit și pierdere

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
financial_kpi[].gross_marginnumber\|null	Marja brută: profitul brut împărțit la cifra de afaceri.`financial_kpi` · de la Pro	`null`	parțial: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[].ebitda_marginnumber\|null	Marja EBITDA: EBITDA împărțit la cifra de afaceri.	`null`	ca mai sus
financial_kpi[].ebit_marginnumber\|null	Marja EBIT: EBIT împărțit la cifra de afaceri.	`null`	ca mai sus
financial_kpi[].net_marginnumber\|null	Marja netă: profitul net împărțit la cifra de afaceri.	`0.306`	ca mai sus
financial_kpi[].material_intensitynumber\|null	Ponderea materialelor: cheltuielile cu materialele împărțite la cifra de afaceri.	`0.216`	ca mai sus
financial_kpi[].personnel_intensitynumber\|null	Ponderea personalului: cheltuielile cu personalul împărțite la cifra de afaceri.	`0.07`	ca mai sus
financial_kpi[].sganumber\|null	Cheltuielile de vânzare și administrative împreună (SG&A), în euro.	`null`	ca mai sus
financial_kpi[].sga_rationumber\|null	Cheltuielile de vânzare și administrative împărțite la cifra de afaceri.	`null`	ca mai sus
financial_kpi[].opex_corenumber\|null	Cheltuielile operaționale de bază ale exercițiului financiar în euro.	`66937556.62`	ca mai sus
financial_kpi[].opex_rationumber\|null	Cheltuielile operaționale de bază împărțite la cifra de afaceri.	`0.124`	ca mai sus
financial_kpi[].interest_coveragenumber\|null	Gradul de acoperire a dobânzilor: EBIT împărțit la cheltuielile cu dobânzile, ca factor.	`null`	ca mai sus
financial_kpi[].effective_tax_ratenumber\|null	Cota efectivă de impozitare: impozitele pe venit împărțite la rezultatul înainte de impozite.	`null`	ca mai sus
financial_kpi[].capitalized_own_work_rationumber\|null	Producția proprie capitalizată împărțită la cifra de afaceri.	`0.003`	ca mai sus
financial_kpi[].inventory_change_rationumber\|null	Variația stocurilor împărțită la cifra de afaceri.	`null`	ca mai sus
financial_kpi[].finance_to_ebt_rationumber\|null	Rezultatul financiar împărțit la rezultatul înainte de impozite.	`null`	ca mai sus

Sursa rândului

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
financial_kpi[].source_statement_datestring\|null	Data bilanțului situației din care provine rândul. Aceeași ca _provenance.period_end.`financial_kpi` · de la Pro	`"2023-12-31"`	de obicei: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
financial_kpi[].source_statement_typestring\|null	Tipul situației din care provine rândul. Același ca _provenance.statement_type.	`"Jahresabschluss"`	ca mai sus

Standarde contabile

Companiile își întocmesc situațiile după reguli diferite. Majoritatea urmează Codul comercial german (HGB). Grupurile listate își întocmesc situația consolidată după standardele internaționale IFRS.

Chiar și sub HGB, situațiile arată diferit. Bilanțul urmează schema din § 266 HGB; companiile mici îl publică prescurtat. Contul de profit și pierdere urmează metoda costului total sau metoda costului vânzărilor (§ 275 HGB). Fiecare metodă are propriile poziții.

Ca să poți compara pozițiile între ani și între companii, dăm fiecărui rând recunoscut o denumire unitară. Aceasta se află în name.de și name.en, indiferent de standard și de eticheta pe care o tipărește situația pentru rând. „5. Personalaufwand” devine astfel peste tot Personalaufwand și Personnel expenses.

name.in_report păstrează eticheta exact cum apare în situație, cu numărul din structură. Folosește-o pentru afișare și pentru verificarea cu originalul. Sumele, ordinea și structura le preluăm din situație.

Dacă nu atribuim un rând unei poziții unitare, name.en lipsește, iar name.de repetă eticheta tipărită. Așadar name.en îți spune dacă un rând are o denumire unitară.

Pentru KPI‑uri calculate la fel pentru fiecare companie, folosește indicatorii financiari. După ce cadru a fost întocmită o situație se indică în audit.accounting_framework din situațiile anuale, dacă situația conține o opinie de audit.

Bilanț

Funcția balance_sheet_accounts returnează bilanțul fiecărui exercițiu financiar cu toate pozițiile. Pozițiile formează un arbore, structurat ca în situație. Le normalizăm denumirile; mai multe la Standarde contabile.

Rădăcinile sunt Aktivseite (activ) și Passivseite (capitaluri proprii și datorii). Recunoaște-le, ca și orice poziție cunoscută, după name.de, nu după poziție în arbore. Cât de adânc se află o poziție poate diferi între două situații. Caută deci în tot arborele.

Copiii unei poziții nu trebuie să dea împreună totalul ei. Rândurile „Davon” („din care”) fac parte din valoarea părinte, nu se adaugă.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
balance_sheet_accountsarray	Bilanțurile: câte o intrare pe exercițiu financiar, cea mai nouă prima.Gol când compania nu a publicat niciun bilanț`balance_sheet_accounts`	–	de obicei: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
balance_sheet_accounts[].yearinteger	Anul calendaristic în care se încheie exercițiul financiar.	`2023`	ca mai sus
balance_sheet_accounts[].balance_sheet_accountsarray	Arborele pozițiilor cu rădăcinile Aktivseite și Passivseite. Fiecare nod are name, value și children.	–	ca mai sus
balance_sheet_accounts[].balance_sheet_accounts[].name.destring	Denumirea germană unitară a poziției, aceeași între ani, companii și standarde contabile. Folosește-o ca să recunoști o poziție. Dacă rândul nu este atribuit unei poziții unitare, aceasta este eticheta tipărită.	`"Aktivseite"`	ca mai sus
balance_sheet_accounts[].balance_sheet_accounts[].name.enstring	Denumirea engleză unitară a poziției. Dacă cheia lipsește, rândul nu este atribuit unei poziții unitare.	`"Assets"`	ca mai sus
balance_sheet_accounts[].balance_sheet_accounts[].name.in_reportstring\|null	Eticheta exact cum o tipărește situația, cu numărul din structură. Destinată afișării și verificării cu originalul.	`"Aktiva"`	ca mai sus
balance_sheet_accounts[].balance_sheet_accounts[].valuenumber\|null	Suma poziției în euro. Dacă situația nu tipărește o sumă, aceasta este suma copiilor.	`397093655.67`	ca mai sus
balance_sheet_accounts[].balance_sheet_accounts[].childrenarray	Subpozițiile în ordinea tipărită, cu aceeași structură. Poate fi gol.	–	parțial: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
balance_sheet_accounts[]._provenanceobject	Din ce situație provine bilanțul, cu aceleași câmpuri ca în indicatorii financiari.	–	de obicei: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
balance_sheet_accounts[].activity_statementsarray	Situațiile de activitate ale unui furnizor de energie (§ 6b EnWG). Fiecare activitate are activity.name cu de, en și in_report, arborele bilanțului și _provenance cu statement_type Tätigkeitsabschluss. Doar dacă situația conține situații de activitate.`balance_sheet_accounts` · de la Max	–	rar

Cu planul Max primești și situațiile de activitate ale furnizorilor de energie, fără cost suplimentar. Acestea sunt bilanțurile separate pe care un furnizor de energie le publică pentru fiecare activitate reglementată conform § 6b EnWG. Se află în activity_statements, fiecare cu activity.name, arborele și _provenance. Activitățile acoperă de obicei doar o parte a companiei. Deci nu le aduna și nu le compara cu totalurile companiei.

În exemplul Hetzner Online GmbH, începutul bilanțului pe 2023, scurtat la prima ramură a activului:

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}

Răspuns exemplu: fragment din balance_sheet_accounts pentru Hetzner Online GmbH

Cont de profit și pierdere

Funcția profit_and_loss_account returnează contul de profit și pierdere al fiecărui exercițiu financiar. Nodurile sunt structurate ca în bilanț; lista se numește aici profit_and_loss_accounts.

Nivelul superior conține poziții și subtotaluri tipărite unele lângă altele, de exemplu rezultatul brut sau profitul net. Deci nu le aduna; folosește rezultatele tipărite.

Companiile mijlocii și mari publică un cont de profit și pierdere. Companiile mijlocii îl pot începe cu rezultatul brut; atunci cifra de afaceri lipsește ca rând separat.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
profit_and_loss_accountarray	Conturile de profit și pierdere: câte o intrare pe exercițiu financiar, cea mai nouă prima. Fiecare intrare își conține pozițiile la `profit_and_loss_accounts`.Gol când compania nu a publicat niciun cont de profit și pierdere, de exemplu ca companie mică`profit_and_loss_account`	–	parțial: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
profit_and_loss_account[].yearinteger	Anul calendaristic în care se încheie exercițiul financiar.	`2023`	ca mai sus
profit_and_loss_account[].profit_and_loss_accountsarray	Rândurile contului de profit și pierdere în ordinea tipărită, ca arbore ca în bilanț. La nivelul superior, pozițiile și subtotalurile stau unele lângă altele.	–	ca mai sus
profit_and_loss_account[].profit_and_loss_accounts[].name.destring	Denumirea germană unitară a poziției, aceeași între ani, companii și standarde contabile. Dacă rândul nu este atribuit unei poziții unitare, aceasta este eticheta tipărită.	`"Umsatzerlöse"`	ca mai sus
profit_and_loss_account[].profit_and_loss_accounts[].name.enstring	Denumirea engleză unitară a poziției. Dacă cheia lipsește, rândul nu este atribuit unei poziții unitare.	`"Revenue"`	ca mai sus
profit_and_loss_account[].profit_and_loss_accounts[].name.in_reportstring\|null	Eticheta exact cum o tipărește situația. Destinată afișării și verificării cu originalul.	`"1. Umsatzerlöse"`	ca mai sus
profit_and_loss_account[].profit_and_loss_accounts[].valuenumber\|null	Suma în euro. Cheltuielile poartă semnul din situație.	`538151607.13`	ca mai sus
profit_and_loss_account[].profit_and_loss_accounts[].childrenarray	Subrândurile cu aceeași structură. Poate fi gol.	–	ca mai sus
profit_and_loss_account[]._provenanceobject	Din ce situație provine contul de profit și pierdere, cu aceleași câmpuri ca în indicatorii financiari.	–	ca mai sus
profit_and_loss_account[].activity_statementsarray	Contul de profit și pierdere pe activitate al unui furnizor de energie (§ 6b EnWG): activity.name, rândurile în profit_and_loss_accounts și _provenance. Doar dacă situația conține situații de activitate.`profit_and_loss_account` · de la Max	–	rar

Și aici, planul Max returnează situațiile de activitate ale furnizorilor de energie în activity_statements, cu contul de profit și pierdere al fiecărei activități la profit_and_loss_accounts. Bilanțul și contul de profit și pierdere ale unei activități le potrivești prin activity.name.de.

Situații financiare anuale

Funcțiile annual_financial_statements și annual_financial_statements__html returnează situațiile publicate ca text integral. Asta include bilanțul, contul de profit și pierdere, anexa și raportul de gestiune, în măsura în care compania le publică.

Varianta Markdown este gândită în principal pentru agenți AI. Este mult mai compactă decât HTML și economisește tokeni. Originalele adesea nu au o structură curată. Rendererele Markdown obișnuite nu afișează de aceea textul curat fără prelucrare suplimentară. Pentru afișare cu tabele folosește varianta HTML. Ambele variante au aceleași câmpuri; doar textul se află în document_md sau în document_html.

Fără financial_years primești cele mai noi cinci situații. Cu financial_years=3 primești toate situațiile celor mai noi trei exerciții financiare. O situație poate fi foarte lungă. Mai ales varianta HTML devine mare cu mulți ani.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
annual_financial_statementsarray	Situațiile publicate ca text integral în Markdown, cele mai noi primele.Gol când compania nu a publicat situații`annual_financial_statements`	–	de obicei: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
annual_financial_statements[].document_typestring	Tipul situației.Valori: `Jahresabschluss` situație individuală, `Konzernabschluss` situația grupului	`"Jahresabschluss"`	ca mai sus
annual_financial_statements[].document_titlestring	Titlul publicației, cu exercițiul financiar.	`"Jahresabschluss zum Geschäftsjahr vom 01.01.2023 bis zum…"`	ca mai sus
annual_financial_statements[].document_datestring	Data publicării.	`"2025-06-25"`	ca mai sus
annual_financial_statements[].yearinteger	Anul calendaristic în care se încheie exercițiul financiar.	`2023`	ca mai sus
annual_financial_statements[].languagestring	Limba situației ca denumire germană, de exemplu Deutsch sau Englisch. Este un text, nu un cod.	`"Deutsch"`	ca mai sus
annual_financial_statements[].document_mdstring	Textul integral ca Markdown, cu bilanț, cont de profit și pierdere, anexă și raport de gestiune, în măsura în care sunt publicate. Compact pentru agenți AI; pentru afișare folosește document_html.	`"Firma\nInformation\nBezeichnung \nHetzner Online GmbH, G…"`	ca mai sus
annual_financial_statements__htmlarray	Aceleași situații ca HTML cu tabele, pentru afișare. Fiecare intrare are aceleași câmpuri; textul se află în document_html în loc de document_md.Gol când compania nu a publicat situații`annual_financial_statements__html`	–	ca mai sus

Audit

Dacă o situație conține o opinie de audit, audit descrie auditul: cine a auditat, după ce cadru și când a fost semnată opinia. Fără opinie, audit este null.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
annual_financial_statements[].auditobject\|null	Auditul situației, dacă aceasta conține o opinie de audit. Inclus în prețul funcției.Gol când situația nu conține o opinie de audit`annual_financial_statements`	–	parțial: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG rar: KG, OHG, e.K. niciodată: PartG
annual_financial_statements[].audit.kindstring	Tipul raportului.Valori: `AUDIT_REPORT` opinie de audit (Bestätigungsvermerk)	`"AUDIT_REPORT"`	ca mai sus
annual_financial_statements[].audit.subjectstring	Ce situație a fost auditată.Valori: `OWN` propria situație a companiei, `OWN_GROUP` propria situație consolidată a companiei	`"OWN"`	ca mai sus
annual_financial_statements[].audit.auditedboolean	true dacă situația a fost auditată.	`true`	ca mai sus
annual_financial_statements[].audit.accounting_frameworkstring\|null	Cadrul situației auditate.Valori: `HGB` Codul comercial german (Handelsgesetzbuch), `IFRS_EU` IFRS așa cum au fost adoptate în UE, `PUBLG` Legea germană privind publicitatea (Publizitätsgesetz)	`"HGB"`	ca mai sus
annual_financial_statements[].audit.auditor.namestring	Numele firmei de audit.	`"WP Koehler GmbH Wirtschaftsprüfungsgesellschaft"`	ca mai sus
annual_financial_statements[].audit.auditor.typestring	Tipul auditorului.Valori: `FIRM` firmă de audit (Wirtschaftsprüfungsgesellschaft), `COOP_ASSOCIATION` asociație de audit a cooperativelor	`"FIRM"`	ca mai sus
annual_financial_statements[].audit.auditor.entity_idstring\|null	entity_id-ul firmei de audit, utilizabil ca q în fetch-organization.Gol când numele nu identifică unic o companie	`null`	ca mai sus
annual_financial_statements[].audit.auditor.networkobject\|null	Rețeaua de audit cu key și name, de exemplu PwC.Gol când firma nu aparține unei rețele cunoscute	–	ca mai sus
annual_financial_statements[].audit.auditor.signatoriesarray	Auditorii semnatari cu name, academic_title și qualification, de exemplu WP pentru Wirtschaftsprüfer (auditor public german).	–	ca mai sus
annual_financial_statements[].audit.signedobject\|null	Locul (place) și data (date) opiniei de audit.	–	ca mai sus

Cea mai nouă situație a Hetzner Online GmbH la momentul cererii noastre exemplu, text scurtat:

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}

Răspuns exemplu: fragment din annual_financial_statements pentru Hetzner Online GmbH

Mai departe

Analizează KPI‑urile financiare Preia KPI‑uri pe mai mulți ani, alege situații individuale sau consolidate. fetch-organization Toți parametrii și toate funcțiile endpointului. Disponibilitatea datelor Ce trebuie să publice fiecare formă juridică și clasă de mărime. search-organizations Găsește companii după cifra de afaceri, angajați sau totalul activelor.