Finanzen

• Beträge stehen in Euro, als volle Beträge ohne Tausender-Kürzung. Ein Umsatz von 538,2 Mio. € kommt als 538151607.13.
• Vorzeichen: Aufwendungen tragen das Vorzeichen, das der Abschluss druckt. Manche Abschlüsse zeigen sie positiv, andere negativ. Vergleiche Aufwendungen deshalb ohne Vorzeichen. Verluste und Fehlbeträge sind negativ.
• Quoten und Margen sind Dezimalzahlen: 0.75 bedeutet 75 %. Faktoren wie debt_to_equity und interest_coverage sind Vielfache.
• Geschäftsjahr: year ist das Kalenderjahr, in dem das Geschäftsjahr endet. Ein Geschäftsjahr vom 01.10.2024 bis 30.09.2025 heißt also 2025. Die genauen Daten stehen in _provenance.period_start und period_end.
• Reihenfolge: Jedes Feature liefert eine Liste mit einem Eintrag pro Geschäftsjahr, das neueste zuerst. Zwischen zwei Jahren kann ein Jahr fehlen, wenn dafür kein Abschluss vorliegt.
• null heißt: Der Abschluss nennt den Wert nicht, oder er lässt sich aus ihm nicht ableiten. Eine kleine Firma veröffentlicht zum Beispiel keine GuV, also bleibt revenue leer.

Hat eine Firma keine passenden Abschlüsse, kommt das Feature als leere Liste []. Dafür berechnen wir keine Credits.

Ein Einzelabschluss (Jahresabschluss) zeigt die Firma selbst, ein Konzernabschluss (Konzernabschluss) die ganze Gruppe. Ohne weitere Angabe wählt jedes Feature selbst. Eine Antwort kann deshalb Einzel- und Konzernzahlen enthalten, auch für dasselbe Jahr in verschiedenen Features.

Jeder Eintrag nennt in _provenance, aus welchem Abschluss seine Zahlen stammen. Vergleiche Jahre nur innerhalb desselben statement_type. Sonst vergleichst du eine Firma mit ihrem Konzern.

Mit financial_statement_type=annual bekommst du nur Einzelabschlüsse, mit consolidated nur Konzernabschlüsse. financial_years begrenzt die Antwort auf die neuesten Geschäftsjahre, von 1 bis 30. Beide Parameter gelten für alle fünf Features und ändern den Preis nicht. Mehr dazu in Finanzkennzahlen auswerten.

Jeder Eintrag von Finanz-KPIs, Bilanz und GuV enthält _provenance, in jedem Credit-Abo und auch ohne Abo. Die Felder sind in allen drei Features gleich. Bei den Finanz-KPIs ist _provenance immer der letzte Schlüssel der Zeile.

Was eine Firma veröffentlicht, legt das Gesetz fest, abhängig von Rechtsform und Größenklasse. Danach richtet sich, welche Felder Werte haben.

Ihre Abschlüsse veröffentlichen GmbH und UG, AG, SE und KGaA, die GmbH & Co. KG und die eG. Eine KG oder OHG mit einer natürlichen Person als persönlich haftendem Gesellschafter veröffentlicht nur, wenn sie sehr groß ist. Dasselbe gilt für Einzelkaufleute. Partnerschaftsgesellschaften veröffentlichen keine Abschlüsse. Eine Konzerntochter kann unter bestimmten Voraussetzungen auf die Offenlegung ihres eigenen Abschlusses verzichten. Dafür muss sie in den Konzernabschluss ihrer Mutter einbezogen sein (§ 264 Abs. 3 HGB).

Kleinstgesellschaften dürfen ihre Bilanz auch nur hinterlegen. Dann ist sie nicht frei abrufbar. Mehr zu Größenklassen und Fristen in Datenverfügbarkeit.

Firmen haben für die Offenlegung zwölf Monate nach dem Ende des Geschäftsjahres Zeit, und viele nutzen die Frist voll aus. Der neueste Eintrag betrifft deshalb oft das vorletzte Geschäftsjahr oder ein älteres.

Die Spalte Verfügbarkeit in den Tabellen unten fasst das je Rechtsform zusammen. Dort heißt „teils“: Der Wert kommt, wenn die Größenklasse der Firma ihn veröffentlicht.

Diese Kennzahlen bekommst du mit jedem Konto, mit oder ohne Credit-Abo, im Feature financial_kpi (Finanz-KPIs).

Zum Beispiel ein Geschäftsjahr aus unserer Beispielanfrage für die Hetzner Online GmbH, Ansbach HRB 6089, mit den Basiskennzahlen und seiner Herkunft:

Mit den Credit-Abos Pro und Max enthält jede Zeile der Finanz-KPIs über 90 weitere Kennzahlen. Sie kommen in derselben Zeile und zum selben Preis.

Quoten, Margen und Summen wie ebitda oder net_debt_broad berechnen wir aus den Posten des Abschlusses. Fehlt ein nötiger Posten, ist die Kennzahl null.

Firmen stellen ihre Abschlüsse nach unterschiedlichen Regeln auf. Die meisten bilanzieren nach dem Handelsgesetzbuch (HGB). Konzerne am Kapitalmarkt stellen ihren Konzernabschluss nach den internationalen Standards IFRS auf.

Auch nach HGB sehen Abschlüsse verschieden aus. Die Bilanz folgt dem Schema aus § 266 HGB, kleine Firmen veröffentlichen sie verkürzt. Die GuV folgt dem Gesamtkostenverfahren oder dem Umsatzkostenverfahren (§ 275 HGB). Jedes Verfahren behält seine eigenen Posten.

Damit du Posten über die Jahre und zwischen Firmen vergleichen kannst, geben wir jeder erkannten Zeile einen einheitlichen Namen. Er steht in name.de und name.en, egal nach welchem Standard und unter welcher Bezeichnung der Abschluss die Zeile druckt. Aus „5. Personalaufwand“ wird so überall Personalaufwand und Personnel expenses.

name.in_report behält die Bezeichnung genau so, wie sie im Abschluss steht, mit Gliederungsnummer. Nutze es für die Anzeige und für den Abgleich mit dem Original. Beträge, Reihenfolge und Gliederung übernehmen wir aus dem Abschluss.

Ordnen wir eine Zeile keinem einheitlichen Posten zu, fehlt name.en, und name.de wiederholt die gedruckte Bezeichnung. An name.en erkennst du also, ob eine Zeile einheitlich benannt ist.

Für Kennzahlen, die für jede Firma gleich berechnet sind, nutzt du die Finanz-KPIs. Nach welchem Regelwerk ein Abschluss aufgestellt ist, nennt audit.accounting_framework in den Jahresabschlüssen, wenn der Abschluss einen Bestätigungsvermerk enthält.

Das Feature balance_sheet_accounts liefert die Bilanz jedes Geschäftsjahres mit allen Posten. Die Posten bilden einen Baum, so wie der Abschluss sie gliedert. Ihre Namen vereinheitlichen wir, mehr dazu unter Rechnungslegung.

Die Wurzeln sind Aktivseite und Passivseite. Erkenne sie und jeden bekannten Posten an name.de, nicht an der Position. Wie tief ein Posten liegt, kann sich zwischen zwei Abschlüssen unterscheiden. Durchsuche deshalb den ganzen Baum.

Die Kinder eines Postens müssen nicht seine Summe ergeben. „Davon“-Zeilen sind ein Teil des Elternwerts, kein Zusatz.

Mit dem Credit-Abo Max bekommst du bei Energieversorgern zusätzlich die Tätigkeitsabschlüsse, ohne Aufpreis. Das sind die getrennten Bilanzen, die ein Energieversorger für jede regulierte Tätigkeit nach § 6b EnWG veröffentlicht. Sie stehen in activity_statements, jeweils mit activity.name, dem Baum und _provenance. Die Tätigkeiten decken meist nur einen Teil der Firma ab. Addiere sie deshalb nicht und vergleiche sie nicht mit den Summen der Firma.

Im Beispiel der Hetzner Online GmbH der Anfang der Bilanz 2023, gekürzt auf den ersten Zweig der Aktivseite:

Das Feature profit_and_loss_account liefert die Gewinn- und Verlustrechnung jedes Geschäftsjahres. Die Knoten sind wie in der Bilanz aufgebaut, die Liste heißt hier profit_and_loss_accounts.

Die oberste Ebene enthält Posten und gedruckte Zwischenergebnisse nebeneinander, etwa Rohergebnis oder Jahresüberschuss. Summiere sie deshalb nicht, sondern nutze die gedruckten Ergebnisse.

Eine GuV veröffentlichen mittelgroße und große Firmen. Mittelgroße dürfen sie mit dem Rohergebnis beginnen, dann fehlt der Umsatz als eigene Zeile.

Auch hier liefert das Credit-Abo Max bei Energieversorgern die Tätigkeitsabschlüsse in activity_statements, mit der GuV jeder Tätigkeit unter profit_and_loss_accounts. Bilanz und GuV einer Tätigkeit ordnest du über activity.name.de einander zu.

Die Features annual_financial_statements und annual_financial_statements__html liefern die veröffentlichten Abschlüsse im vollen Wortlaut. Dazu gehören Bilanz, GuV, Anhang und Lagebericht, soweit die Firma sie veröffentlicht.

Die Markdown-Variante ist vor allem für KI-Agenten gedacht. Sie ist deutlich kompakter als HTML und spart Tokens. Die Originale haben oft keine saubere Struktur. Gängige Markdown-Renderer zeigen den Text deshalb ohne weitere Bearbeitung nicht sauber an. Für die Anzeige mit Tabellen nutzt du die HTML-Variante. Beide Varianten haben dieselben Felder, nur der Text steht in document_md oder in document_html.

Ohne financial_years kommen die fünf neuesten Abschlüsse. Mit financial_years=3 kommen alle Abschlüsse der drei neuesten Geschäftsjahre. Ein Abschluss kann sehr lang sein. Vor allem die HTML-Variante wird bei vielen Jahren groß.

Enthält ein Abschluss einen Bestätigungsvermerk, beschreibt audit die Prüfung: wer geprüft hat, nach welchem Regelwerk und wann der Vermerk unterschrieben wurde. Ohne Vermerk ist audit null.

Der zur Zeit unserer Beispielanfrage neueste Abschluss der Hetzner Online GmbH, der Text gekürzt: