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… ohne GEN (GES ≈ 99,7 %); die Suchkarte labelt sie als GmbH. GEN ist die Genossenschaft (Label eGen) und fällt nicht in den GmbH-Filter.

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 Abschnitt 6)
    "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 in Abschnitt 6 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.