Talous – Dokumentaatio | handelsregister.ai

Ominaisuus
Ominaisuus	Mitä se palauttaa	Krediitit
financial_kpi	Taloudelliset tunnusluvut: yksi tunnuslukurivi tilikautta kohden	1
balance_sheet_accounts	Tase: kaikki erät tilikausittain puurakenteena	3
profit_and_loss_account	Tuloslaskelma (saks. GuV): kaikki erät tilikausittain puurakenteena	3
annual_financial_statements	Tilinpäätökset (Markdown): tilinpäätösten koko teksti tiiviinä AI-agenteille	5
annual_financial_statements__html	Tilinpäätökset (HTML): koko teksti taulukkoineen HTML:nä näytettäväksi	5

Käytännöt

Summat ovat euroina, täysinä summina ilman pyöristystä tuhansiin. 538,2 miljoonan euron liikevaihto tulee muodossa 538151607.13.
Etumerkit: kuluilla on se etumerkki, jonka tilinpäätös tulostaa. Osa tilinpäätöksistä näyttää ne positiivisina, osa negatiivisina. Vertaa siis kuluja ilman etumerkkiä. Tappiot ja alijäämät ovat negatiivisia.
Suhdeluvut ja marginaalit ovat desimaalilukuja: 0.75 tarkoittaa 75 %. Kertoimet kuten debt_to_equity ja interest_coverage ovat monikertoja.
Tilikausi: year on kalenterivuosi, jona tilikausi päättyy. Tilikausi 2024-10-01–2025-09-30 on siis 2025. Tarkat päivämäärät ovat kentissä _provenance.period_start ja period_end.
Järjestys: jokainen ominaisuus palauttaa listan, jossa on yksi merkintä tilikautta kohden, uusin ensin. Kahden vuoden välistä voi puuttua vuosi, jos siltä ei ole tilinpäätöstä.
null tarkoittaa: tilinpäätös ei anna arvoa, tai sitä ei voida johtaa siitä. Pieni yritys esimerkiksi ei julkaise tuloslaskelmaa, joten revenue jää tyhjäksi.

Jos yrityksellä ei ole sopivia tilinpäätöksiä, ominaisuus tulee tyhjänä listana []. Siitä emme veloita krediittejä.

Yksittäis- ja konsernitilinpäätökset

Yksittäistilinpäätös (Jahresabschluss) näyttää yrityksen itsensä, konsernitilinpäätös (Konzernabschluss) koko konsernin. Ilman lisämäärityksiä kukin ominaisuus valitsee itse. Vastaus voi siksi sisältää sekä yksittäis- että konsernilukuja, jopa samalta vuodelta eri ominaisuuksissa.

Jokainen merkintä kertoo kentässä _provenance, mistä tilinpäätöksestä sen luvut ovat. Vertaa vuosia vain saman statement_type-arvon sisällä. Muuten vertaat yritystä sen konserniin.

Asetuksella financial_statement_type=annual saat vain yksittäistilinpäätökset, arvolla consolidated vain konsernitilinpäätökset. financial_years rajaa vastauksen uusimpiin tilikausiin, 1–30. Molemmat parametrit koskevat kaikkia viittä ominaisuutta eivätkä muuta hintaa. Lisää kohdassa Taloudellisten tunnuslukujen analysointi.

Merkinnän alkuperä

Jokainen taloudellisten tunnuslukujen, taseen ja tuloslaskelman merkintä sisältää kentän _provenance jokaisessa paketissa ja myös ilman pakettia. Kentät ovat samat kaikissa kolmessa ominaisuudessa. Taloudellisissa tunnusluvuissa _provenance on aina rivin viimeinen avain.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
financial_kpi[]._provenanceobject	Mistä tilinpäätöksestä rivin luvut ovat. Mukana jokaisella rivillä, jokaisessa paketissa ja myös ilman pakettia, aina viimeisenä avaimena.`financial_kpi`	–	yleensä: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[]._provenance.statement_typestring\|null	Tilinpäätöksen laji rekisterin nimeämänä.Arvot: `Jahresabschluss` yrityksen yksittäistilinpäätös, `Bilanz` erikseen julkaistu tase, `Konzernabschluss` konsernin luvut, `null` pörssiyhtiön markkinatiedot	`"Jahresabschluss"`	kuten yllä
financial_kpi[]._provenance.period_startstring\|null	Tilikauden ensimmäinen päivä tilinpäätöksen mukaan.Tyhjä, kun tilinpäätös ei ilmoita alkua, sekä markkinatiedoilla	`"2023-01-01"`	kuten yllä
financial_kpi[]._provenance.period_endstring\|null	Tilikauden viimeinen päivä, tilinpäätöspäivä. Tilikausi voi olla lyhyempi tai pidempi kuin kaksitoista kuukautta, esimerkiksi perustamisen tai tilikauden muutoksen jälkeen.	`"2023-12-31"`	kuten yllä
financial_kpi[]._provenance.exempt_subsidiaryboolean	true, jos yritys julkaisi oman tilinpäätöksensä sijaan emoyhtiönsä konsernitilinpäätöksen. Kaikki vuoden luvut koskevat silloin `parent_organization`-yhtiön konsernia.	`false`	kuten yllä
financial_kpi[]._provenance.parent_organizationobject\|null	Yritys, jonka konsernitilinpäätös julkaistiin, kentillä entity_id ja name. entity_id on null, jos nimi ei yksilöi yritystä yksiselitteisesti.Tyhjä, kun exempt_subsidiary on false	`null`	harvoin

Koko ja yhtiömuoto

Se, mitä yritys julkaisee, on säädetty laissa yhtiömuodon ja kokoluokan mukaan. Tämä ratkaisee, missä kentissä on arvoja.

GmbH ja UG, AG, SE ja KGaA, GmbH & Co. KG sekä eG julkaisevat tilinpäätöksensä. KG tai OHG, jonka henkilökohtaisesti vastuunalainen yhtiömies on luonnollinen henkilö, julkaisee vain, jos se on hyvin suuri. Sama pätee elinkeinonharjoittajiin. Partnerschaftsgesellschaftit (PartG) eivät julkaise tilinpäätöksiä. Konsernin tytäryhtiö voi tietyin edellytyksin jättää oman tilinpäätöksensä julkaisematta. Silloin sen on sisällyttävä emoyhtiön konsernitilinpäätökseen (HGB 264 § 3 mom.).

Kokoluokka
Kokoluokka	Mitä julkaistaan	Mitä saat
Mikro	Lyhennetty tase	Tase ja siitä saatavat luvut, esimerkiksi taseen loppusumma
Pieni	Tase ja liitetiedot, ei tuloslaskelmaa	Tase ja siitä saatavat luvut, osin henkilöstömäärä; liikevaihtoa yleensä ei
Keskisuuri	Tase, tuloslaskelma, liitetiedot ja toimintakertomus; tuloslaskelma voi alkaa bruttotuloksesta	Tase ja tuloslaskelma; liikevaihto, jos tuloslaskelma näyttää sen erikseen
Suuri	Täydellinen tilinpäätös toimintakertomuksineen	Tase, tuloslaskelma ja tunnusluvut täydessä laajuudessa

Mikroyritykset voivat myös vain tallettaa taseensa. Se ei silloin ole vapaasti saatavilla. Lisää kokoluokista ja määräajoista kohdassa Tietojen saatavuus.

Yrityksillä on julkaisemiseen kaksitoista kuukautta tilikauden päättymisestä, ja monet käyttävät koko ajan. Uusin merkintä koskee siksi usein toissa vuotta tai vanhempaa.

Alla olevien taulukoiden Saatavuus-sarake tiivistää tämän yhtiömuodoittain. ”osittain” tarkoittaa: arvo tulee, jos yrityksen kokoluokka julkaisee sen.

Perustunnusluvut

Nämä tunnusluvut saat jokaisella tilillä, paketin kanssa tai ilman, ominaisuudessa financial_kpi (Taloudelliset tunnusluvut).

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
financial_kpiarray	Taloudelliset tunnusluvut: yksi rivi tilikautta kohden, uusin ensin.Tyhjä, kun yritys ei ole julkaissut arvioitavissa olevia tilinpäätöksiä`financial_kpi`	–	yleensä: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[].yearinteger	Kalenterivuosi, jona tilikausi päättyy.	`2023`	kuten yllä
financial_kpi[].revenuenumber\|null	Liikevaihto euroina.Tyhjä, kun tilinpäätöksessä ei ole tuloslaskelmaa tai liikevaihtoa	`538151607.13`	osittain: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[].net_incomenumber\|null	Tilikauden voitto tai tappio euroina; tappio on negatiivinen.	`164916783.06`	kuten yllä
financial_kpi[].active_totalnumber\|null	Taseen loppusumma euroina.	`397093655.67`	yleensä: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[].employeesnumber\|null	Henkilöstömäärä sellaisena kuin tilinpäätös sen ilmoittaa.Tyhjä, kun tilinpäätöksessä ei ole liitetietoja henkilöstömäärineen, esimerkiksi mikroyrityksillä	`340`	osittain: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[].material_expensesnumber\|null	Materiaalikulut euroina, tilinpäätöksen etumerkillä.	`116509640.56`	kuten yllä
financial_kpi[].personnel_expensesnumber\|null	Henkilöstökulut euroina, tilinpäätöksen etumerkillä.	`37557386.2`	kuten yllä

Esimerkiksi yksi tilikausi esimerkkihaustamme yritykselle Hetzner Online GmbH, Ansbach HRB 6089, perustunnuslukuineen ja alkuperineen:

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

Esimerkkivastaus: ote financial_kpi-kentästä yritykselle Hetzner Online GmbH, tilikausi 2023

Laajennetut tunnusluvut

Pro- ja Max-paketeissa jokainen taloudellisten tunnuslukujen rivi sisältää yli 90 lisätunnuslukua. Ne tulevat samalla rivillä ja samaan hintaan.

Laskemme suhdeluvut, marginaalit ja summat kuten ebitda tai net_debt_broad tilinpäätöksen eristä. Jos tarvittava erä puuttuu, tunnusluku on null.

Koko ja henkilöä kohden lasketut arvot

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
financial_kpi[].company_size_by_employeesstring\|null	Kokoluokka henkilöstömäärän mukaan.Arvot: `micro` mikro, `small` pieni, `medium` keskisuuri, `large` suuri`financial_kpi` · Pro ja ylemmät	`"large"`	osittain: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[].company_size_by_assetsstring\|null	Kokoluokka taseen loppusumman mukaan.Arvot: `micro` mikro, `small` pieni, `medium` keskisuuri, `large` suuri	`"large"`	yleensä: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[].company_size_by_revenuestring\|null	Kokoluokka liikevaihdon mukaan.Arvot: `micro` mikro, `small` pieni, `medium` keskisuuri, `large` suuri	`"large"`	osittain: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[].revenue_per_employeenumber\|null	Liikevaihto henkilöä kohden euroina.	`1582798.844`	kuten yllä
financial_kpi[].net_income_per_employeenumber\|null	Tilikauden tulos henkilöä kohden euroina.	`485049.362`	kuten yllä

Tase: summat ja erät

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
financial_kpi[].assets_totalnumber\|null	Vastaavaa yhteensä taseen mukaan, euroina.`financial_kpi` · Pro ja ylemmät	`397093655.67`	yleensä: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[].equity_totalnumber\|null	Oma pääoma euroina.	`297695266.84`	kuten yllä
financial_kpi[].liabilities_totalnumber\|null	Velat yhteensä euroina.	`28921831.79`	kuten yllä
financial_kpi[].provisions_totalnumber\|null	Varaukset yhteensä euroina.	`55716527.94`	osittain: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[].current_assets_totalnumber\|null	Vaihtuvat vastaavat euroina.	`75902450.81`	kuten yllä
financial_kpi[].fixed_assets_totalnumber\|null	Pysyvät vastaavat euroina.	`316193205.41`	kuten yllä
financial_kpi[].inventory_totalnumber\|null	Vaihto-omaisuus euroina.	`2605622.88`	kuten yllä
financial_kpi[].receivables_totalnumber\|null	Saamiset ja muut varat euroina.	`34451734.53`	kuten yllä
financial_kpi[].trade_receivablesnumber\|null	Myyntisaamiset euroina.	`25390709.7`	kuten yllä
financial_kpi[].intragroup_receivablesnumber\|null	Saamiset sidosyrityksiltä euroina.	`548819.99`	kuten yllä
financial_kpi[].securities_current_totalnumber\|null	Vaihtuviin vastaaviin kuuluvat arvopaperit euroina.	`null`	kuten yllä
financial_kpi[].cash_and_equivalentsnumber\|null	Käteisvarat, pankkisaamiset ja shekit euroina.	`38845093.4`	kuten yllä
financial_kpi[].ppe_totalnumber\|null	Aineelliset hyödykkeet euroina.	`269497218.27`	kuten yllä
financial_kpi[].land_and_buildingsnumber\|null	Maa-alueet ja rakennukset, myös vieraalla maalla olevat rakennukset, euroina.	`46944085.59`	kuten yllä
financial_kpi[].intangible_assetsnumber\|null	Aineettomat hyödykkeet euroina.	`18788946.41`	kuten yllä
financial_kpi[].goodwillnumber\|null	Liikearvo euroina.	`null`	kuten yllä
financial_kpi[].long_term_financial_assetsnumber\|null	Sijoitukset (pitkäaikaiset) euroina.	`27907040.73`	kuten yllä
financial_kpi[].prepaid_expensesnumber\|null	Siirtosaamiset euroina.	`4997999.45`	kuten yllä
financial_kpi[].capital_reservesnumber\|null	Pääomarahastot euroina.	`536224.77`	kuten yllä
financial_kpi[].revenue_reservesnumber\|null	Voittovarat (rahastot) euroina.	`20005000`	kuten yllä
financial_kpi[].profit_loss_carried_forwardnumber\|null	Edellisten tilikausien voitto tai tappio euroina; kertynyt tappio on negatiivinen.	`332187259.01`	kuten yllä
financial_kpi[].pension_provisionsnumber\|null	Eläkevaraukset ja vastaavat velvoitteet euroina.	`null`	kuten yllä
financial_kpi[].other_provisionsnumber\|null	Muut varaukset euroina.	`22278401.94`	kuten yllä
financial_kpi[].trade_payablesnumber\|null	Ostovelat euroina.	`14625866.4`	kuten yllä
financial_kpi[].intragroup_payablesnumber\|null	Velat konserniyhtiöille euroina.	`2667666.2`	kuten yllä
financial_kpi[].liabilities_to_affiliated_companiesnumber\|null	Velat sidosyrityksille euroina.	`2667666.2`	kuten yllä
financial_kpi[].other_liabilitiesnumber\|null	Muut velat euroina.	`11628299.19`	kuten yllä
financial_kpi[].deferred_incomenumber\|null	Siirtovelat euroina.	`14760029.1`	kuten yllä
financial_kpi[].bank_debtnumber\|null	Velat pankeille euroina.	`null`	kuten yllä
financial_kpi[].bondsnumber\|null	Joukkovelkakirjalainat euroina.	`null`	kuten yllä

Rakenne ja taseen tunnusluvut

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
financial_kpi[].equity_rationumber\|null	Omavaraisuusaste: oma pääoma jaettuna taseen loppusummalla.`financial_kpi` · Pro ja ylemmät	`0.75`	yleensä: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[].debt_to_equitynumber\|null	Velkaantumisaste: velat jaettuna omalla pääomalla, kertoimena.	`0.097`	osittain: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[].debt_to_assetsnumber\|null	Velat jaettuna taseen loppusummalla.	`0.073`	kuten yllä
financial_kpi[].cash_to_assetsnumber\|null	Rahavarat jaettuna taseen loppusummalla.	`0.098`	kuten yllä
financial_kpi[].cash_to_liabilitiesnumber\|null	Rahavarat jaettuna veloilla.	`1.343`	kuten yllä
financial_kpi[].receivables_to_assetsnumber\|null	Saamiset jaettuna taseen loppusummalla.	`0.087`	kuten yllä
financial_kpi[].inventory_to_assetsnumber\|null	Vaihto-omaisuus jaettuna taseen loppusummalla.	`0.007`	kuten yllä
financial_kpi[].ppe_to_assetsnumber\|null	Aineelliset hyödykkeet jaettuna taseen loppusummalla.	`0.679`	kuten yllä
financial_kpi[].intangible_to_assetsnumber\|null	Aineettomat hyödykkeet jaettuna taseen loppusummalla.	`0.047`	kuten yllä
financial_kpi[].goodwill_to_assetsnumber\|null	Liikearvo jaettuna taseen loppusummalla.	`null`	kuten yllä
financial_kpi[].intangible_to_equitynumber\|null	Aineettomat hyödykkeet jaettuna omalla pääomalla.	`0.063`	kuten yllä
financial_kpi[].tangible_equitynumber\|null	Oma pääoma ilman aineettomia hyödykkeitä ja liikearvoa, euroina.	`278906320.43`	kuten yllä
financial_kpi[].tangible_equity_rationumber\|null	Aineellinen oma pääoma jaettuna taseen loppusummalla.	`0.702`	kuten yllä

Käyttöpääoma ja velat

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
financial_kpi[].operating_working_capitalnumber\|null	Vaihto-omaisuus plus myyntisaamiset miinus ostovelat, euroina.`financial_kpi` · Pro ja ylemmät	`13370466.18`	osittain: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[].net_working_capital_strictnumber\|null	Vaihtuvat vastaavat miinus lyhytaikaiset velat suppeasti määriteltynä, euroina.	`61276584.41`	kuten yllä
financial_kpi[].net_working_capital_approxnumber\|null	Nettokäyttöpääoman likiarvo, kun tilinpäätös ei ilmoita kaikkia maturiteetteja, euroina.	`46980619.02`	kuten yllä
financial_kpi[].interest_bearing_debt_strictnumber\|null	Korolliset velat suppeasti määriteltynä: lähinnä pankkivelat ja joukkovelkakirjalainat, euroina.	`null`	kuten yllä
financial_kpi[].interest_bearing_debt_broadnumber\|null	Korolliset velat laajasti määriteltynä, euroina.	`14295965.39`	kuten yllä
financial_kpi[].net_debt_narrownumber\|null	Nettovelka: korolliset velat (suppea) miinus rahavarat, euroina. Negatiivinen tarkoittaa nettokassaa.	`null`	kuten yllä
financial_kpi[].net_debt_broadnumber\|null	Nettovelka: korolliset velat (laaja) miinus rahavarat, euroina. Negatiivinen tarkoittaa nettokassaa.	`-24549128.01`	kuten yllä

Tuloslaskelman erät ja tulokset

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
financial_kpi[].material_expenses_goodsnumber\|null	Aineiden, tarvikkeiden ja tavaroiden kulut sekä ostettujen tavaroiden kulut euroina.`financial_kpi` · Pro ja ylemmät	`1157010.5`	osittain: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[].material_expenses_servicesnumber\|null	Ostettujen palvelujen kulut euroina.	`115352630.06`	kuten yllä
financial_kpi[].wages_salariesnumber\|null	Palkat ja palkkiot euroina.	`33140885.29`	kuten yllä
financial_kpi[].social_expensesnumber\|null	Sosiaaliturvamaksut euroina.	`4416500.91`	kuten yllä
financial_kpi[].pension_costsnumber\|null	Eläke- ja avustuskulut euroina.	`null`	kuten yllä
financial_kpi[].depreciation_amortizationnumber\|null	Aineettomien ja aineellisten hyödykkeiden poistot euroina.	`129958760.25`	kuten yllä
financial_kpi[].depreciation_amortization_operatingnumber\|null	Liiketoiminnan poistot ilman sijoitusten arvonalentumisia, euroina.	`129958760.25`	kuten yllä
financial_kpi[].write_downs_financial_assets_and_securitiesnumber\|null	Sijoitusten ja vaihtuviin vastaaviin kuuluvien arvopapereiden arvonalentumiset euroina.	`null`	kuten yllä
financial_kpi[].other_operating_incomenumber\|null	Liiketoiminnan muut tuotot euroina.	`1229615.57`	kuten yllä
financial_kpi[].other_operating_expensesnumber\|null	Liiketoiminnan muut kulut euroina.	`29380170.42`	kuten yllä
financial_kpi[].selling_expensesnumber\|null	Myynnin kulut euroina, kun tuloslaskelma on laadittu myynnin kustannusmenetelmällä.	`null`	kuten yllä
financial_kpi[].admin_expensesnumber\|null	Yleiset hallintokulut euroina, kun tuloslaskelma on laadittu myynnin kustannusmenetelmällä.	`null`	kuten yllä
financial_kpi[].gross_profitnumber\|null	Bruttokate: liikevaihto miinus materiaalikulut tai myynnin kustannukset, euroina.	`null`	kuten yllä
financial_kpi[].ebitnumber\|null	Tulos ennen korkoja ja veroja (EBIT) euroina.	`null`	kuten yllä
financial_kpi[].ebtnumber\|null	Varsinaisen toiminnan tulos ennen veroja (EBT) euroina.	`null`	kuten yllä
financial_kpi[].ebitdanumber\|null	Tulos ennen korkoja, veroja ja poistoja (EBITDA) euroina.	`null`	kuten yllä
financial_kpi[].income_taxesnumber\|null	Tulo- ja tuottoverot euroina.	`67650181.5`	kuten yllä
financial_kpi[].other_taxesnumber\|null	Muut verot euroina.	`94694.61`	kuten yllä
financial_kpi[].income_after_taxesnumber\|null	Tulos verojen jälkeen euroina.	`165011477.67`	kuten yllä
financial_kpi[].interest_incomenumber\|null	Korko- ja vastaavat tuotot euroina.	`5025778.39`	kuten yllä
financial_kpi[].interest_expensenumber\|null	Korko- ja vastaavat kulut euroina, tilinpäätöksen etumerkillä.	`42.37`	kuten yllä
financial_kpi[].finance_incomenumber\|null	Rahoitustoiminnan tuotot yhteensä euroina.	`5025778.39`	kuten yllä
financial_kpi[].finance_income_from_affiliatesnumber\|null	Tuotot osuuksista sidosyrityksissä euroina.	`null`	kuten yllä

Marginaalit ja tuloslaskelman tunnusluvut

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
financial_kpi[].gross_marginnumber\|null	Bruttokateprosentti: bruttokate jaettuna liikevaihdolla.`financial_kpi` · Pro ja ylemmät	`null`	osittain: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[].ebitda_marginnumber\|null	EBITDA-marginaali: EBITDA jaettuna liikevaihdolla.	`null`	kuten yllä
financial_kpi[].ebit_marginnumber\|null	EBIT-marginaali: EBIT jaettuna liikevaihdolla.	`null`	kuten yllä
financial_kpi[].net_marginnumber\|null	Nettomarginaali: tilikauden tulos jaettuna liikevaihdolla.	`0.306`	kuten yllä
financial_kpi[].material_intensitynumber\|null	Materiaalikuluaste: materiaalikulut jaettuna liikevaihdolla.	`0.216`	kuten yllä
financial_kpi[].personnel_intensitynumber\|null	Henkilöstökuluaste: henkilöstökulut jaettuna liikevaihdolla.	`0.07`	kuten yllä
financial_kpi[].sganumber\|null	Myynnin ja hallinnon kulut yhteensä (SG&A) euroina.	`null`	kuten yllä
financial_kpi[].sga_rationumber\|null	Myynnin ja hallinnon kulut jaettuna liikevaihdolla.	`null`	kuten yllä
financial_kpi[].opex_corenumber\|null	Tilikauden keskeiset liiketoiminnan kulut euroina.	`66937556.62`	kuten yllä
financial_kpi[].opex_rationumber\|null	Keskeiset liiketoiminnan kulut jaettuna liikevaihdolla.	`0.124`	kuten yllä
financial_kpi[].interest_coveragenumber\|null	Korkokate: EBIT jaettuna korkokuluilla, kertoimena.	`null`	kuten yllä
financial_kpi[].effective_tax_ratenumber\|null	Efektiivinen veroaste: tuloverot jaettuna tuloksella ennen veroja.	`null`	kuten yllä
financial_kpi[].capitalized_own_work_rationumber\|null	Valmistus omaan käyttöön jaettuna liikevaihdolla.	`0.003`	kuten yllä
financial_kpi[].inventory_change_rationumber\|null	Varastojen muutos jaettuna liikevaihdolla.	`null`	kuten yllä
financial_kpi[].finance_to_ebt_rationumber\|null	Rahoitustulos jaettuna tuloksella ennen veroja.	`null`	kuten yllä

Rivin lähde

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
financial_kpi[].source_statement_datestring\|null	Sen tilinpäätöksen tilinpäätöspäivä, josta rivi on peräisin. Sama kuin _provenance.period_end.`financial_kpi` · Pro ja ylemmät	`"2023-12-31"`	yleensä: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
financial_kpi[].source_statement_typestring\|null	Sen tilinpäätöksen laji, josta rivi on peräisin. Sama kuin _provenance.statement_type.	`"Jahresabschluss"`	kuten yllä

Tilinpäätösnormistot

Yritykset laativat tilinpäätöksensä eri sääntöjen mukaan. Useimmat noudattavat Saksan kauppalakia (HGB). Pääomamarkkinoilla toimivat konsernit laativat konsernitilinpäätöksensä kansainvälisten IFRS-standardien mukaan.

HGB:n mukaisetkin tilinpäätökset näyttävät erilaisilta. Tase noudattaa HGB:n 266 §:n kaavaa; pienet yritykset julkaisevat sen lyhennettynä. Tuloslaskelma noudattaa kokonaiskustannusmenetelmää tai myynnin kustannusmenetelmää (HGB 275 §). Kummallakin menetelmällä on omat eränsä.

Jotta voit verrata eriä vuosien ja yritysten välillä, annamme jokaiselle tunnistetulle riville yhtenäisen nimen. Se on kentissä name.de ja name.en riippumatta siitä, mitä normistoa ja mitä nimikettä tilinpäätös rivillä käyttää. ”5. Personalaufwand” on siten kaikkialla Personalaufwand ja Personnel expenses.

name.in_report säilyttää nimikkeen täsmälleen sellaisena kuin se on tilinpäätöksessä, jäsennysnumeroineen. Käytä sitä näyttämiseen ja alkuperäiseen vertaamiseen. Summat, järjestyksen ja rakenteen otamme tilinpäätöksestä.

Jos emme yhdistä riviä yhtenäiseen erään, name.en puuttuu ja name.de toistaa tulostetun nimikkeen. name.en kertoo siis, onko rivillä yhtenäinen nimi.

Kaikille yrityksille samalla tavalla laskettuihin tunnuslukuihin käytä Taloudellisia tunnuslukuja. Minkä normiston mukaan tilinpäätös on laadittu, kertoo audit.accounting_framework tilinpäätöksissä, jos tilinpäätös sisältää tilintarkastajan lausunnon.

Tase

Ominaisuus balance_sheet_accounts palauttaa kunkin tilikauden taseen kaikkine erineen. Erät muodostavat puun, joka on jäsennetty kuten tilinpäätöksessä. Yhtenäistämme niiden nimet; lisää kohdassa Tilinpäätösnormistot.

Juuret ovat Aktivseite (vastaavaa) ja Passivseite (vastattavaa). Tunnista ne ja jokainen tunnettu erä kentästä name.de, ei sijainnista. Se, kuinka syvällä erä on, voi vaihdella tilinpäätösten välillä. Hae siis koko puusta.

Erän lasten ei tarvitse olla yhteensä sen summa. ”Davon”-rivit (”josta”) ovat osa ylemmän tason arvoa, eivät lisäys.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
balance_sheet_accountsarray	Taseet: yksi merkintä tilikautta kohden, uusin ensin.Tyhjä, kun yritys ei ole julkaissut tasetta`balance_sheet_accounts`	–	yleensä: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
balance_sheet_accounts[].yearinteger	Kalenterivuosi, jona tilikausi päättyy.	`2023`	kuten yllä
balance_sheet_accounts[].balance_sheet_accountsarray	Erien puu juurina Aktivseite ja Passivseite. Jokaisella solmulla on name, value ja children.	–	kuten yllä
balance_sheet_accounts[].balance_sheet_accounts[].name.destring	Erän yhtenäinen saksankielinen nimi, sama vuosien, yritysten ja tilinpäätösnormistojen välillä. Tunnista erä sen avulla. Jos riviä ei ole yhdistetty yhtenäiseen erään, tämä on tulostettu nimike.	`"Aktivseite"`	kuten yllä
balance_sheet_accounts[].balance_sheet_accounts[].name.enstring	Erän yhtenäinen englanninkielinen nimi. Jos avain puuttuu, riviä ei ole yhdistetty yhtenäiseen erään.	`"Assets"`	kuten yllä
balance_sheet_accounts[].balance_sheet_accounts[].name.in_reportstring\|null	Nimike täsmälleen sellaisena kuin tilinpäätös sen tulostaa, jäsennysnumeroineen. Tarkoitettu näyttämiseen ja alkuperäiseen vertaamiseen.	`"Aktiva"`	kuten yllä
balance_sheet_accounts[].balance_sheet_accounts[].valuenumber\|null	Erän summa euroina. Jos tilinpäätös ei tulosta summaa, tämä on lasten summa.	`397093655.67`	kuten yllä
balance_sheet_accounts[].balance_sheet_accounts[].childrenarray	Alaerät tulostetussa järjestyksessä, samalla rakenteella. Voi olla tyhjä.	–	osittain: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
balance_sheet_accounts[]._provenanceobject	Mistä tilinpäätöksestä tase on peräisin, samoilla kentillä kuin taloudellisissa tunnusluvuissa.	–	yleensä: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
balance_sheet_accounts[].activity_statementsarray	Energiayhtiön toimintokohtaiset tilinpäätökset (EnWG 6b §). Jokaisella toiminnolla on activity.name kentillä de, en ja in_report, taseen puu ja _provenance, jonka statement_type on Tätigkeitsabschluss. Vain jos tilinpäätös sisältää toimintokohtaisia tilinpäätöksiä.`balance_sheet_accounts` · Max ja ylemmät	–	harvoin

Max-paketissa saat lisäksi energiayhtiöiden toimintokohtaiset tilinpäätökset ilman lisämaksua. Ne ovat erillisiä taseita, jotka energiayhtiö julkaisee kustakin säännellystä toiminnosta EnWG:n 6b §:n mukaan. Ne ovat kentässä activity_statements, kukin kentillä activity.name, puu ja _provenance. Toiminnot kattavat yleensä vain osan yrityksestä. Älä siis laske niitä yhteen äläkä vertaa niitä yrityksen kokonaislukuihin.

Esimerkissä Hetzner Online GmbH:n vuoden 2023 taseen alku, lyhennettynä vastaavaa-puolen ensimmäiseen haaraan:

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}

Esimerkkivastaus: ote balance_sheet_accounts-kentästä yritykselle Hetzner Online GmbH

Tuloslaskelma

Ominaisuus profit_and_loss_account palauttaa kunkin tilikauden tuloslaskelman. Solmut on jäsennetty kuten taseessa; lista on tässä nimeltään profit_and_loss_accounts.

Ylin taso sisältää eriä ja tulostettuja välisummia rinnakkain, esimerkiksi bruttotulos tai tilikauden tulos. Älä siis laske niitä yhteen; käytä tulostettuja tuloksia.

Keskisuuret ja suuret yritykset julkaisevat tuloslaskelman. Keskisuuret voivat aloittaa sen bruttotuloksesta; silloin liikevaihto puuttuu erillisenä rivinä.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
profit_and_loss_accountarray	Tuloslaskelmat: yksi merkintä tilikautta kohden, uusin ensin. Jokainen merkintä sisältää eränsä kentässä `profit_and_loss_accounts`.Tyhjä, kun yritys ei ole julkaissut tuloslaskelmaa, esimerkiksi pienenä yrityksenä`profit_and_loss_account`	–	osittain: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
profit_and_loss_account[].yearinteger	Kalenterivuosi, jona tilikausi päättyy.	`2023`	kuten yllä
profit_and_loss_account[].profit_and_loss_accountsarray	Tuloslaskelman rivit tulostetussa järjestyksessä puurakenteena kuten taseessa. Ylimmällä tasolla erät ja välisummat ovat rinnakkain.	–	kuten yllä
profit_and_loss_account[].profit_and_loss_accounts[].name.destring	Erän yhtenäinen saksankielinen nimi, sama vuosien, yritysten ja tilinpäätösnormistojen välillä. Jos riviä ei ole yhdistetty yhtenäiseen erään, tämä on tulostettu nimike.	`"Umsatzerlöse"`	kuten yllä
profit_and_loss_account[].profit_and_loss_accounts[].name.enstring	Erän yhtenäinen englanninkielinen nimi. Jos avain puuttuu, riviä ei ole yhdistetty yhtenäiseen erään.	`"Revenue"`	kuten yllä
profit_and_loss_account[].profit_and_loss_accounts[].name.in_reportstring\|null	Nimike täsmälleen sellaisena kuin tilinpäätös sen tulostaa. Tarkoitettu näyttämiseen ja alkuperäiseen vertaamiseen.	`"1. Umsatzerlöse"`	kuten yllä
profit_and_loss_account[].profit_and_loss_accounts[].valuenumber\|null	Summa euroina. Kuluilla on tilinpäätöksen etumerkki.	`538151607.13`	kuten yllä
profit_and_loss_account[].profit_and_loss_accounts[].childrenarray	Alarivit samalla rakenteella. Voi olla tyhjä.	–	kuten yllä
profit_and_loss_account[]._provenanceobject	Mistä tilinpäätöksestä tuloslaskelma on peräisin, samoilla kentillä kuin taloudellisissa tunnusluvuissa.	–	kuten yllä
profit_and_loss_account[].activity_statementsarray	Energiayhtiön tuloslaskelma toiminnoittain (EnWG 6b §): activity.name, rivit kentässä profit_and_loss_accounts ja _provenance. Vain jos tilinpäätös sisältää toimintokohtaisia tilinpäätöksiä.`profit_and_loss_account` · Max ja ylemmät	–	harvoin

Myös tässä Max-paketti palauttaa energiayhtiöiden toimintokohtaiset tilinpäätökset kentässä activity_statements, kunkin toiminnon tuloslaskelma kentässä profit_and_loss_accounts. Toiminnon taseen ja tuloslaskelman yhdistät kentän activity.name.de avulla.

Tilinpäätökset

Ominaisuudet annual_financial_statements ja annual_financial_statements__html palauttavat julkaistut tilinpäätökset kokotekstinä. Mukana ovat tase, tuloslaskelma, liitetiedot ja toimintakertomus siltä osin kuin yritys ne julkaisee.

Markdown-versio on tarkoitettu ensisijaisesti AI-agenteille. Se on paljon tiiviimpi kuin HTML ja säästää tokeneita. Alkuperäisillä asiakirjoilla ei usein ole siistiä rakennetta. Tavalliset Markdown-renderöijät eivät siksi näytä tekstiä siististi ilman jatkokäsittelyä. Taulukoiden näyttämiseen käytä HTML-versiota. Molemmilla versioilla on samat kentät; vain teksti on joko kentässä document_md tai document_html.

Ilman financial_years-parametria saat viisi uusinta tilinpäätöstä. Arvolla financial_years=3 saat kaikki kolmen uusimman tilikauden tilinpäätökset. Tilinpäätös voi olla hyvin pitkä. Etenkin HTML-versio kasvaa suureksi monella vuodella.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
annual_financial_statementsarray	Julkaistut tilinpäätökset kokotekstinä Markdownina, uusin ensin.Tyhjä, kun yritys ei ole julkaissut tilinpäätöksiä`annual_financial_statements`	–	yleensä: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
annual_financial_statements[].document_typestring	Tilinpäätöksen laji.Arvot: `Jahresabschluss` yksittäistilinpäätös, `Konzernabschluss` konsernin tilinpäätös	`"Jahresabschluss"`	kuten yllä
annual_financial_statements[].document_titlestring	Julkaisun otsikko tilikausineen.	`"Jahresabschluss zum Geschäftsjahr vom 01.01.2023 bis zum…"`	kuten yllä
annual_financial_statements[].document_datestring	Julkaisupäivä.	`"2025-06-25"`	kuten yllä
annual_financial_statements[].yearinteger	Kalenterivuosi, jona tilikausi päättyy.	`2023`	kuten yllä
annual_financial_statements[].languagestring	Tilinpäätöksen kieli saksankielisenä nimenä, esimerkiksi Deutsch tai Englisch. Se on teksti, ei koodi.	`"Deutsch"`	kuten yllä
annual_financial_statements[].document_mdstring	Koko teksti Markdownina: tase, tuloslaskelma, liitetiedot ja toimintakertomus siltä osin kuin julkaistu. Tiivis AI-agenteille; näyttämiseen käytä document_html-kenttää.	`"Firma\nInformation\nBezeichnung \nHetzner Online GmbH, G…"`	kuten yllä
annual_financial_statements__htmlarray	Samat tilinpäätökset HTML:nä taulukkoineen näyttämistä varten. Jokaisella merkinnällä on samat kentät; teksti on kentässä document_html kentän document_md sijaan.Tyhjä, kun yritys ei ole julkaissut tilinpäätöksiä`annual_financial_statements__html`	–	kuten yllä

Tilintarkastus

Jos tilinpäätös sisältää tilintarkastajan lausunnon, audit kuvaa tarkastuksen: kuka tarkasti, minkä normiston mukaan ja milloin lausunto allekirjoitettiin. Ilman lausuntoa audit on null.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
annual_financial_statements[].auditobject\|null	Tilinpäätöksen tilintarkastus, jos se sisältää tilintarkastajan lausunnon. Sisältyy ominaisuuden hintaan.Tyhjä, kun tilinpäätös ei sisällä tilintarkastajan lausuntoa`annual_financial_statements`	–	osittain: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG harvoin: KG, OHG, e.K. ei koskaan: PartG
annual_financial_statements[].audit.kindstring	Raportin laji.Arvot: `AUDIT_REPORT` tilintarkastajan lausunto (Bestätigungsvermerk)	`"AUDIT_REPORT"`	kuten yllä
annual_financial_statements[].audit.subjectstring	Mikä tilinpäätös tarkastettiin.Arvot: `OWN` yrityksen oma tilinpäätös, `OWN_GROUP` yrityksen oma konsernitilinpäätös	`"OWN"`	kuten yllä
annual_financial_statements[].audit.auditedboolean	true, jos tilinpäätös tarkastettiin.	`true`	kuten yllä
annual_financial_statements[].audit.accounting_frameworkstring\|null	Tarkastetun tilinpäätöksen normisto.Arvot: `HGB` Saksan kauppalaki (Handelsgesetzbuch), `IFRS_EU` EU:ssa hyväksytyt IFRS-standardit, `PUBLG` Saksan julkistamislaki (Publizitätsgesetz)	`"HGB"`	kuten yllä
annual_financial_statements[].audit.auditor.namestring	Tilintarkastusyhteisön nimi.	`"WP Koehler GmbH Wirtschaftsprüfungsgesellschaft"`	kuten yllä
annual_financial_statements[].audit.auditor.typestring	Tilintarkastajan laji.Arvot: `FIRM` tilintarkastusyhteisö (Wirtschaftsprüfungsgesellschaft), `COOP_ASSOCIATION` osuuskuntien tilintarkastusliitto	`"FIRM"`	kuten yllä
annual_financial_statements[].audit.auditor.entity_idstring\|null	Tilintarkastusyhteisön entity_id, käytettävissä q-parametrina fetch-organization-pyynnössä.Tyhjä, kun nimi ei yksilöi yritystä yksiselitteisesti	`null`	kuten yllä
annual_financial_statements[].audit.auditor.networkobject\|null	Tilintarkastusverkosto kentillä key ja name, esimerkiksi PwC.Tyhjä, kun yhteisö ei kuulu tunnettuun verkostoon	–	kuten yllä
annual_financial_statements[].audit.auditor.signatoriesarray	Allekirjoittaneet tilintarkastajat kentillä name, academic_title ja qualification, esimerkiksi WP eli Wirtschaftsprüfer (saksalainen KHT-tilintarkastaja).	–	kuten yllä
annual_financial_statements[].audit.signedobject\|null	Tilintarkastajan lausunnon paikka (place) ja päivämäärä (date).	–	kuten yllä

Hetzner Online GmbH:n uusin tilinpäätös esimerkkihakumme hetkellä, teksti lyhennettynä:

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}

Esimerkkivastaus: ote annual_financial_statements-kentästä yritykselle Hetzner Online GmbH

Seuraavaksi

Analysoi taloudellisia tunnuslukuja Hae tunnusluvut useammalta vuodelta, valitse yksittäis- tai konsernitilinpäätökset. fetch-organization Päätepisteen kaikki parametrit ja ominaisuudet. Datan saatavuus Mitä kunkin yhtiömuodon ja kokoluokan on julkaistava. search-organizations Löydä yrityksiä liikevaihdon, henkilöstön tai taseen loppusumman mukaan.