Datenfelder

1 search_companies → Karte

Kompakter Auszug. Codes sind hier bereits als Labels ausgegeben (z. B. GmbH, Oberösterreich).

2 get_company_details → Profil

Das Unternehmen liegt unter result. Hier stehen die Roh-Codes (z. B. legal_form: "GES" = GmbH, bundesland: "O" = Oberösterreich). Die vollständigen Code-Tabellen stehen weiter unten unter Code-Tabellen.

identity · Stammdaten

location · Sitz

company · Eckdaten

size · Größeneinordnung

financials · Finanzdaten

Zuerst die Kopf-Felder, danach die Positionen – jede als Zeitreihe (Jahr → Wert).

Bilanz-Positionen in financials.bilanz

GuV-Positionen in financials.guv · nur bei has_guv (~3 % der Firmen)

Zur Offenlegung der Gewinn- und Verlustrechnung (GuV) sind gemäß § 277 UGB ausschließlich mittelgroße und große Kapitalgesellschaften verpflichtet. Maßgeblich ist, ob an zwei aufeinanderfolgenden Abschlussstichtagen mindestens zwei der folgenden Schwellenwerte (§ 221 UGB; seit 2024) überschritten werden:

• Bilanzsumme von 6,25 Mio. €
• Umsatzerlöse von 12,5 Mio. €
• durchschnittlich 50 Arbeitnehmer

Kleine und Kleinstkapitalgesellschaften haben gemäß § 278 UGB lediglich die Bilanz offenzulegen.

ratios · Kennzahlen

13 Kennzahlen, jede als Zeitreihen-Objekt. Margen- und Renditekennzahlen brauchen eine GuV und bleiben sonst leer.

Jedes Kennzahl-Objekt enthält u. a. latest, latest_year, history (Jahr → Wert), avg_3y/avg_5y, min_5y/max_5y, volatility, trend sowie Wachstumsmaße.

growth · Wachstum

employees · Beschäftigte

filings · Eingereichte Abschlüsse + events

events[] – Registerereignisse (Vollzüge), abgeleitet aus dem täglichen Änderungs-Feed ab 1. Juli 2026. Der amtliche Auszug liefert kein Vollzugs-Logbuch; wir vergleichen bei jeder Tages-Aktualisierung die Stammdaten und erfassen Abweichungen als typisierte Ereignisse (name_change, seat_change, legal_form_change, management_change, capital_change) mit date, description und source. Bei Kapitaländerungen zusätzlich capital_from/capital_to, bei Geschäftsführungs-Änderungen managers_added/managers_removed (Rolle + Name). Zwei Ebenen: die detaillierten Ereignisse (mit Vorher/Nachher) werden ab 1. Juli 2026 erfasst; zusätzlich gibt es gröbere historische Register-Ereignisse (nur Typ + Datum, source=change_feed: founding, deletion, merger, split, conversion, capital_change, legal_form_change u. a.) zurück bis ~2020. Firmenübergreifend abfragbar über list_events (siehe unten).

financial_institution · Reguliertes Finanzunternehmen

Nur bei Banken, Versicherungen und ähnlichen regulierten Instituten vorhanden. Quelle ist das amtliche Register (OeNB-Bankenliste, per Firmenbuchnummer verknüpft; Versicherer via EIOPA/GLEIF in Vorbereitung) – kein Namens-Raten.

Auf der Such-Karte erscheint dazu das Flag is_financial_institution (bool).

industry · Branche (ÖNACE / NACE)

Für rund 95 % der Firmen ist die Branche die amtliche ÖNACE-2025-Zuordnung des Registers (Statistik Austria, offener HVD-Datensatz, source = register) — deterministisch, monatlich aktualisiert, mit vollem Pfad bis zur 5-stelligen Subklasse. Nur die restlichen ~5 % (ohne amtliche Zuordnung) werden aus dem Firmenbuch-Geschäftszweig (Freitext) klassifiziert. oenace und nace sind symmetrisch aufgebaut und tragen per Konstruktion dieselben Codes (ÖNACE 2025 = EU NACE Rev. 2.1); ÖNACE mit deutschen und englischen Titeln, NACE mit den offiziellen englischen (NACE hat keine nationale Subklasse und endet auf Klassenebene). Der Original-Geschäftszweig bleibt immer erhalten. Hinweis: Dieser Block hieß früher branch und wurde umbenannt und erweitert.

Ohne Geschäftszweig gilt: kein Raten. Nur eindeutige Firmennamen werden klassifiziert (classified_from: name), sonst ist industry leer. Auf der Such-Karte erscheinen geschaeftszweig, industry_section sowie oenace_division/oenace_group (2025) und oenace_division_2008/oenace_group_2008 samt deutschen Labels.

Zwei Fassungen, beide durchsuchbar. Die Codes sind ÖNACE 2025 (= NACE Rev. 2.1); zusätzlich wird die ÖNACE 2008-Fassung geführt. Die Filter oenace_section/oenace_division/oenace_group matchen beide Fassungen – eine Abfrage in der älteren Systematik läuft also nie ins Leere. Achtung auf die Unterschiede: der Kfz-Handel ist in ÖNACE 2008 die Abteilung 45, in ÖNACE 2025 auf 46/47 aufgeteilt. Die Umschlüsselung ist die offizielle Statistik-Austria-Korrespondenztabelle (deterministisch). list_sectors zeigt, welche Abteilungen je Fassung vorkommen.

management · Geschäftsführung

3 get_full_record → voller Datensatz

Enthält alles aus dem Profil plus:

• financials.positions – vollständige 317-Positionen-Taxonomie (jede UGB-Position)
• financials.passthrough – unbekannte Quell-Codes inkl. Historie (verlustfrei)
• financials.completeness – Qualitätsmaß (Positionsanzahl je Jahr)
• financials.guv_years – Liste der Jahre mit GuV
• management.signatories_history – Zeichnungsberechtigte je Jahr
• derivations – metrics_version + Formel-Registry der Kennzahlen

Auch hier dieselbe Regel: Namen der Organe sind öffentliche Firmenbuch-Daten (Einzelabfrage), Geburtsdaten nur jahresgenau.

4 list_events · get_event_stats → Änderungs-Feed (Pro)

Firmenübergreifender Feed der Registeränderungen – die Markt- und Deal-Sourcing-Sicht: „welche Firmen haben Geschäftsführung geändert / Kapital erhöht / den Sitz verlegt – wo, seit wann". Für die Änderungshistorie einer bekannten Firma genügt get_company_details (Feld events[]).

list_events · Filter

Rückgabe je Ereignis: fnr, name, date, type, description, bei Kapital capital_from/capital_to, bei Geschäftsführung managers_added/managers_removed (Rolle + Name), plus bundesland, legal_form, industry_section. Sortiert nach Datum (neueste zuerst).

get_event_stats liefert zu denselben Filtern Zähler nach Typ und nach Bundesland – für Markt-Dashboards („wie viele Kapitalerhöhungen in OÖ diesen Monat").

Firmen statt Ereignisse? Wer Firmen sucht, die ein Ereignis hatten – mit Finanzkontext und nach Größe gereiht –, nutzt den Filter event_signal in search_companies (siehe Abschnitt 5). Die auslösenden Ereignisse hängen dann an jeder Firmenkarte.

5 Filter, Sortierung, Seiten

Argumente von search_companies.

Sortierung: sort = { field, descending } über bilanzsumme, revenue, equity_ratio, employees, last_filing_year, revenue_growth_1y, revenue_growth_3y, revenue_growth_5y (Umsatzwachstum: 1 Jahr, 3- und 5-Jahres-CAGR; nur bei mehrjähriger GuV, sonst zuletzt gereiht) (oder distance bei einer Umkreissuche). Standard: Bilanzsumme absteigend. Ein unbekanntes Sortierfeld wird mit der Liste der gültigen Felder abgewiesen. Seiten: page (ab 1), page_size (Standard 25).

6 Code-Tabellen

Bundesland (Code → Klarname): B Burgenland · K Kärnten · N Niederösterreich · O Oberösterreich · S Salzburg · St Steiermark · T Tirol · V Vorarlberg · W Wien.

Rechtsform: Der granulare Firmenbuch-Code steht im Profil (legal_form). Die GmbH-Familie ist das Präfix GE… (GES ≈ 99,7 %); die Suchkarte labelt das als GmbH.

Größenklasse gkl: W Kleinst/Mikro · K Klein · M Mittel · G Groß.

7 Beispiel-Antwort

So sieht eine vollständige get_company_details-Antwort für ein Musterunternehmen aus (gekürzt; Zeitreihen exemplarisch). Felder mit null bzw. leere Objekte/Listen sind ebenfalls Teil der Antwort und werden, wo sinnvoll, mitgesendet, damit der Agent den Unterschied zwischen „nicht vorhanden" und „unbekannt" auswerten kann.

Hinweis: Dieses Beispiel ist ein Musterdatensatz zur Veranschaulichung der Struktur.

// Antwort-Umschlag
"schema_version": "1.0",
"data_version": "2026-06-27",
"provenance": {
  "source":        "Österreichisches Firmenbuch / BMJ – Justiz",
  "license":       "CC BY 4.0",
  "data_version":  "2026-06-27",
  "schema_version": "1.0",
  "built_at":      "2026-06-27T07:32:14Z"
},
"result": {
  "identity": {
    "fnr":         "999999x",
    "register_id": "AT_999999x",
    "name":        "Beispiel Industrie GmbH",
    "legal_form":  "GES",           // Code → Label "GmbH" (siehe §5)
    "status":      "active",
    "court":       null
  },
  "location": {
    "country":     "AUT",
    "bundesland":  "O",             // Oberösterreich
    "city":        "Linz",
    "postal_code": "4020",
    "street":      null
  },
  "company": {
    "stammkapital":           35000,
    "first_filing_year":      2014,
    "last_filing_year":       2024,
    "filing_years_available": 11,
    "founded_year":           2013,
    "founded_source":         "first_filing-1",
    "description":            "Unternehmensberatung"
  },
  "size": {
    "gkl":               "M",           // Mittel
    "bilanzsumme_band":  "large",
    "peer_percentiles": {
      "bilanzsumme":    82.4,
      "equity_ratio":   71.3,
      "revenue":        68.9
    }
  },
  "financials": {
    "latest_year":     2024,
    "has_guv_latest":  true,
    "revenue_basis":   "umsatzerloese",
    "latest": {
      "bilanzsumme":    12450000,
      "eigenkapital":   5230000,
      "umsatzerloese":  18900000,
      "ebit":           1430000,
      "ebitda":         2210000,
      "jahresueberschuss": 980000
    },
    "bilanz": {
      "bilanzsumme": {
        "latest":      12450000,
        "latest_year": 2024,
        "history":     { "2022": 10840000, "2023": 11620000, "2024": 12450000 }
      },
      "eigenkapital":    { "latest": 5230000,  "history": { "2022": 4380000, "2023": 4790000, "2024": 5230000 } }
      // … weitere Bilanzpositionen (verbindlichkeiten, anlagevermoegen, vorraete, cash, …)
    },
    "guv": {
      "umsatzerloese":  { "latest": 18900000, "history": { "2022": 16200000, "2023": 17550000, "2024": 18900000 } },
      "ebit":           { "latest": 1430000,  "history": { "2022": 1180000, "2023": 1290000, "2024": 1430000 } }
      "materialaufwand":   { "latest": -9100000 },
      "personalaufwand":   { "latest": -5200000 },
      "abschreibungen":    { "latest": -780000 },
      "ebitda":            { "latest": 2210000 },
      "jahresueberschuss": { "latest": 980000 }
      // Umsatzkostenverfahren stattdessen: "rohergebnis" statt umsatzerloese + materialaufwand
    }
  },
  "ratios": {
    "equity_ratio": {
      "latest":        0.42,
      "latest_year":   2024,
      "history":       { "2022": 0.404, "2023": 0.412, "2024": 0.42 },
      "avg_3y":        0.412,
      "min_5y":        0.39,
      "max_5y":        0.42,
      "trend":         "rising",
      "growth_1y":     0.019,
      "growth_3y_cagr": 0.021
    },
    "ebit_margin":  { "latest": 0.076, "trend": "stable" }
    // … debt_ratio, debt_to_equity, working_capital_ratio, anlagedeckungsgrad_1,
    //    ebitda_margin, net_margin, personalkostenquote, materialaufwandsquote,
    //    roa, roe, capital_profile
  },
  "growth": {
    "profile": "growing",
    "method":  "revenue_3y_cagr"
  },
  "employees": null,                  // im Firmenbuch nur lückenhaft
  "management": {
    "n_signatories_latest":    2,
    "signatories_stable_years": 4,
    "primary_manager_name":    "Maria Beispiel",   // öffentliche Firmenbuch-Daten (Name serviert)
    "primary_manager": {
      "age":         52,
      "birth_year":  1974,            // nur Jahr (DSGVO)
      "role_label":  "GESCHÄFTSFÜHRER/IN (handelsrechtlich)",
      "vertretung":  "selbständig"
    }
  },
  "filings": [
    {
      "stichtag":     "2024-12-31",
      "format":       "jab40_semantic",
      "parsed":       true,
      "gkl":          "M",
      "eingereicht":  "2025-08-12",
      "document_url": "https://justizonline.gv.at/…",
      "pdf_doc_key":  null
    }
    // … ältere Abschlüsse, sortiert nach stichtag absteigend
  ],
  "events": [],
  "industry": {                              // Branche – aus dem Geschäftszweig abgeleitet
    "geschaeftszweig": "Unternehmensberatung",
    "oenace": {                              // ÖNACE 2025 (national), Titel DE + EN
      "section":           "N",
      "section_label_de":  "Erbringung von freiberuflichen, wissenschaftlichen und technischen Dienstleistungen",
      "section_label_en":  "Professional, scientific and technical activities",
      "division":          "70",
      "division_label_de": "Verwaltung und Führung von Unternehmen; Unternehmensberatung",
      "division_label_en": "Activities of head offices and management consultancy",
      "group":             "70.2",
      "group_label_de":    "Unternehmensberatung",
      "group_label_en":    "Business and other management consultancy activities",
      "version":           "OENACE_2025"
    },
    "nace": {                                // EU NACE Rev. 2.1 – gleiche Codes, engl. Titel
      "section":        "N",
      "section_label":  "Professional, scientific and technical activities",
      "division":       "70",
      "division_label": "Activities of head offices and management consultancy",
      "group":          "70.2",
      "group_label":    "Business and other management consultancy activities",
      "version":        "NACE_REV_2.1"
    },
    "oenace_2008": {                          // ÖNACE-2008-Zwilling, symmetrisch – auch durchsuchbar
      "section":           "M",
      "division":          "70",
      "division_label_de": "Verwaltung und Führung von Unternehmen; Unternehmensberatung",
      "group":             "70.2",
      "class":             "70.22",
      "version":           "OENACE_2008"
    },
    "code_2008":       "70.22",       // zugewiesene ÖNACE-2008-Klasse
    "source":          "llm",          // oder "lexicon"
    "classified_from": "geschaeftszweig"  // oder "name"
  }
}

In der Suchkarte (search_companies) sind bereits Codes als Labels aufgelöst (z. B. legal_form: "GmbH", bundesland: "Oberösterreich"). Im vollständigen Profil und im get_full_record stehen die Roh-Codes; die Tabellen oben in §5 erklären die Auflösung.

8 Stand & Gewähr

Jede Antwort trägt provenance.data_version und built_at (Erstellungszeit der ausgelieferten Daten). Die Daten stammen aus dem österreichischen Firmenbuch (BMJ – Justiz, EU High Value Dataset, CC BY 4.0), werden automatisiert verarbeitet und ohne Gewähr auf Richtigkeit, Vollständigkeit und Aktualität bereitgestellt. Maßgeblich ist stets der amtliche Firmenbuchauszug.

Entwickler-Variante dieser Seite: FIELD_REFERENCE.md im Repo.