Daten

DATEN

balance_sheet_accounts · profit_and_loss_account · annual_financial_statements

Referenz der Abschluss-Features von fetch-organization: Bilanzen und Gewinn- und Verlustrechnungen als Kontenbäume, jedes Geschäftsjahr mit seiner Quelle, dazu vollständige Jahresabschlüsse als Text. Mit Max enthalten die Jahre von Energieversorgern auch ihre Tätigkeitsabschlüsse. Beträge sind in Euro.

balance_sheet_accounts (3 Credits)

Schlüssel	Typ	Beschreibung
[]	array<object>	Ein Eintrag pro Geschäftsjahr, das neueste zuerst. Ein leeres Array, wenn keine Bilanz bekannt ist.
[].year	number	Kalenderjahr, in dem das Geschäftsjahr endet: Ein Geschäftsjahr von Juli 2024 bis Juni 2025 ist 2025. Den genauen Zeitraum nennt _provenance.
[].balance_sheet_accounts	array<object>	Kontenbaum. Oberste Ebene: Aktivseite und Passivseite. Erkenne sie an name.de, nicht an der Position, denn eine Seite kann fehlen.
[].balance_sheet_accounts[].name	object	Positionsname. de: Standardname einer bekannten Position, sonst die Bezeichnung wie gedruckt. en: nur bei bekannten Positionen vorhanden, nie null. in_report: Wortlaut im Abschluss (Text oder null). Erkenne Positionen an de.
[].balance_sheet_accounts[].value	number \| null	Betrag in Euro. Verluste im Eigenkapital (Jahresfehlbetrag, Verlustvortrag, Bilanzverlust) sind negativ. null, wenn Marktdaten für eine Zeile keinen Wert haben.
[].balance_sheet_accounts[].children	array<object>	Unterpositionen mit derselben Struktur, gegliedert wie im Abschluss; wie tief eine Position liegt, kann je Abschluss verschieden sein. davon-Zeilen sind im Betrag der übergeordneten Position schon enthalten.
[]._provenance	object	Quelle der Bilanz dieses Jahres, in jedem Plan. Die Felder stehen unten.
[].activity_statements Max	array<object>	Nur mit Max: die Tätigkeitsbilanzen von Energieversorgern, siehe unten. Der Schlüssel fehlt, wenn das Jahr keine hat.

profit_and_loss_account (3 Credits)

Schlüssel	Typ	Beschreibung
[]	array<object>	Ein Eintrag pro Geschäftsjahr, das neueste zuerst. Ein leeres Array, wenn keine GuV bekannt ist – häufig bei kleinen Unternehmen, die nur eine Bilanz veröffentlichen.
[].year	number	Kalenderjahr, in dem das Geschäftsjahr endet: Ein Geschäftsjahr von Juli 2024 bis Juni 2025 ist 2025. Den genauen Zeitraum nennt _provenance.
[].profit_and_loss_accounts	array<object>	GuV-Positionen in Reihenfolge und Gliederung des Abschlusses. Die oberste Ebene enthält auch gedruckte Zwischensummen und Ergebnisse wie Betriebsergebnis oder Jahresüberschuss: Summiere sie nicht, sondern nimm die Ergebniszeilen.
[].profit_and_loss_accounts[].name	object	Wie bei der Bilanz: de, en und in_report. in_report enthält auch Gliederungsziffern wie "a) Löhne und Gehälter".
[].profit_and_loss_accounts[].value	number \| null	Betrag in Euro. Aufwände tragen das Vorzeichen aus dem Abschluss, mal positiv, mal negativ: Vergleiche deshalb die Beträge ohne Vorzeichen. null, wenn Marktdaten für eine Zeile keinen Wert haben.
[].profit_and_loss_accounts[].children	array<object>	Unterpositionen mit derselben Struktur, gegliedert wie gedruckt. davon-Zeilen sind im Betrag der übergeordneten Position schon enthalten.
[]._provenance	object	Quelle der GuV dieses Jahres, in jedem Plan. Die Felder stehen unten.
[].activity_statements Max	array<object>	Nur mit Max: die Tätigkeits-GuVs von Energieversorgern, siehe unten. Der Schlüssel fehlt, wenn das Jahr keine hat.

_provenance: woher die Zahlen stammen

In jedem Plan trägt jedes Jahr von balance_sheet_accounts, profit_and_loss_account und financial_kpi ein _provenance, ebenso jeder Eintrag von activity_statements. Bilanz, GuV und Kennzahlen desselben Jahres können aus verschiedenen Quellen stammen; lies jeweils ihr eigenes _provenance.

Schlüssel	Typ	Beschreibung
_provenance.statement_type	string \| null	Art des Abschlusses: Jahresabschluss (Abschluss des Unternehmens), Bilanz (allein veröffentlichte Bilanz), Konzernabschluss (Abschluss eines Konzerns), Tätigkeitsabschluss (nur in activity_statements) oder null bei Marktdaten börsennotierter Unternehmen.
_provenance.period_start	string \| null	Erster Tag des Geschäftsjahres (YYYY-MM-DD); null, wenn er unbekannt ist, etwa bei Marktdaten.
_provenance.period_end	string \| null	Letzter Tag des Geschäftsjahres, der Bilanzstichtag (YYYY-MM-DD); null, wenn er unbekannt ist.
_provenance.exempt_subsidiary	boolean	true, wenn das Unternehmen mit diesem Abschluss als befreites Tochterunternehmen den Konzernabschluss seiner Muttergesellschaft veröffentlicht: Die Zahlen sind dann die des Konzerns, nicht die des Unternehmens. false, wenn der Abschluss nicht als solcher erkannt ist.
_provenance.parent_organization	object \| null	{entity_id, name} der Muttergesellschaft, wenn exempt_subsidiary true ist, sonst null. entity_id ist null, wenn sich die Mutter nicht eindeutig zuordnen lässt.

Beispiel: BioNTech Manufacturing GmbH veröffentlicht für 2023 den Konzernabschluss der BioNTech SE.

"_provenance": {
  "statement_type": "Konzernabschluss",
  "period_start": "2023-01-01",
  "period_end": "2023-12-31",
  "exempt_subsidiary": true,
  "parent_organization": {
    "entity_id": "ff3d08559be5e2be873c7d0935062d2f",
    "name": "BioNTech SE"
  }
}

activity_statements: Tätigkeitsabschlüsse (§ 6b EnWG)

Max

Energieversorger veröffentlichen mit ihrem Jahresabschluss für jede regulierte Tätigkeit, etwa die Stromverteilung, eine eigene Bilanz und GuV. Mit Max enthalten die Jahre von balance_sheet_accounts und profit_and_loss_account diese Tätigkeitsabschlüsse als activity_statements, ohne zusätzliche Credits; hat ein Jahr keine, fehlt der Schlüssel. Jeder Eintrag enthält einen Kontenbaum wie das Jahr selbst (balance_sheet_accounts bzw. profit_and_loss_accounts), ein eigenes _provenance mit statement_type Tätigkeitsabschluss und activity.name: {de: string, en?: string, in_report: string | null}.

Die Zahlen der Tätigkeiten ergeben zusammen nicht zwangsläufig die Unternehmenszahlen. Bilanzen und GuVs sind getrennte Listen und können unterschiedliche Tätigkeiten enthalten.

Mögliche Tätigkeiten (activity.name). Der Wert Andere Tätigkeiten kann in einem Jahr mehrfach vorkommen; unterscheide die Einträge an in_report.

name.de	name.en
Elektrizitätsverteilung	Electricity distribution
Gasverteilung	Gas distribution
Messstellenbetrieb	Metering point operation
Gasspeicherung	Gas storage
Gasfernleitung	Gas transmission
Elektrizitätsübertragung	Electricity transmission
LNG-Anlagenbetrieb	LNG facility operation
Andere Tätigkeiten	Other activities

annual_financial_statements (5 Credits)

Schlüssel	Typ	Beschreibung
[]	array<object>	Ein Eintrag pro offengelegtem Abschluss.
[].year	number	Geschäftsjahr des Abschlusses.
[].document_type	string	Abschlussart. Beobachtete Werte: Jahresabschluss, Konzernabschluss.
[].document_title	string	Titel des Dokuments, z. B. "Jahresabschluss zum 31. Dezember 2023".
[].document_date	string	Veröffentlichungs- bzw. Dokumentdatum.
[].language	string	Sprache des Dokuments.
[].document_md	string	Vollständiger Abschluss als Markdown-Text (für LLM-Verarbeitung geeignet).

annual_financial_statements__html (5 Credits)

Schlüssel	Typ	Beschreibung
[]	array<object>	Gleiche Einträge wie annual_financial_statements, jedoch mit document_html statt document_md.
[].document_html	string	Vollständiger Abschluss als eigenständig darstellbares HTML.