Finanse

• Kwoty są w euro, jako pełne kwoty bez zaokrąglania do tysięcy. Przychody 538,2 mln € przychodzą jako 538151607.13.
• Znaki: koszty mają znak, który drukuje sprawozdanie. Niektóre sprawozdania pokazują je jako dodatnie, inne jako ujemne. Porównuj więc koszty bez znaku. Straty i niedobory są ujemne.
• Wskaźniki i marże to ułamki dziesiętne: 0.75 oznacza 75 %. Współczynniki takie jak debt_to_equity i interest_coverage to krotności.
• Rok obrotowy: year to rok kalendarzowy, w którym kończy się rok obrotowy. Rok obrotowy od 2024-10-01 do 2025-09-30 to więc 2025. Dokładne daty są w _provenance.period_start i period_end.
• Kolejność: każdy feature zwraca listę z jednym wpisem na rok obrotowy, od najnowszego. Między dwoma latami może brakować roku, jeśli nie ma za niego sprawozdania.
• null oznacza: sprawozdanie nie podaje wartości albo nie da się jej z niego wyprowadzić. Mała firma na przykład nie publikuje RZiS, więc revenue pozostaje puste.

Jeśli firma nie ma pasujących sprawozdań, feature przychodzi jako pusta lista []. Nie naliczamy za to kredytów.

Sprawozdanie jednostkowe (Jahresabschluss) pokazuje samą firmę, skonsolidowane (Konzernabschluss) całą grupę. Bez dalszych parametrów każdy feature wybiera sam. Odpowiedź może więc zawierać liczby jednostkowe i grupowe, nawet za ten sam rok w różnych features.

Każdy wpis podaje w _provenance, z jakiego sprawozdania pochodzą jego liczby. Porównuj lata tylko w obrębie tego samego statement_type. W przeciwnym razie porównujesz firmę z jej grupą.

Z financial_statement_type=annual dostajesz tylko sprawozdania jednostkowe, z consolidated tylko skonsolidowane. financial_years ogranicza odpowiedź do najnowszych lat obrotowych, od 1 do 30. Oba parametry dotyczą wszystkich pięciu features i nie zmieniają ceny. Więcej w Analizuj KPI finansowe.

Każdy wpis KPI finansowych, bilansu i RZiS zawiera _provenance, w każdym planie i także bez planu. Pola są takie same we wszystkich trzech features. W KPI finansowych _provenance jest zawsze ostatnim kluczem wiersza.

Co firma publikuje, określa prawo, zależnie od formy prawnej i klasy wielkości. To decyduje, które pola mają wartości.

GmbH i UG, AG, SE i KGaA, GmbH & Co. KG oraz eG publikują sprawozdania. KG lub OHG z osobą fizyczną jako wspólnikiem osobiście odpowiedzialnym publikuje tylko wtedy, gdy jest bardzo duża. To samo dotyczy kupców jednoosobowych. Spółki partnerskie (PartG) nie publikują sprawozdań. Spółka zależna w grupie może pod pewnymi warunkami pominąć ujawnienie własnego sprawozdania. Musi być w tym celu ujęta w skonsolidowanym sprawozdaniu spółki dominującej (§ 264 ust. 3 HGB).

Mikrofirmy mogą też jedynie zdeponować bilans. Nie jest on wtedy swobodnie dostępny. Więcej o klasach wielkości i terminach w Dostępność danych.

Firmy mają dwanaście miesięcy po końcu roku obrotowego na publikację, a wiele wykorzystuje cały okres. Najnowszy wpis dotyczy więc często roku przedostatniego lub starszego.

Kolumna Dostępność w tabelach poniżej podsumowuje to dla każdej formy prawnej. „częściowo” oznacza: wartość przychodzi, jeśli klasa wielkości firmy ją publikuje.

Te KPI dostajesz na każdym koncie, z planem lub bez, w feature financial_kpi (Wskaźniki finansowe).

Na przykład jeden rok obrotowy z naszego przykładowego zapytania o Hetzner Online GmbH, Ansbach HRB 6089, z podstawowymi KPI i pochodzeniem:

W planach Pro i Max każdy wiersz KPI finansowych zawiera ponad 90 dodatkowych KPI. Przychodzą w tym samym wierszu i w tej samej cenie.

Wskaźniki, marże i sumy, np. ebitda lub net_debt_broad, wyliczamy z pozycji sprawozdania. Jeśli brakuje potrzebnej pozycji, KPI ma wartość null.

Firmy sporządzają sprawozdania według różnych zasad. Większość stosuje niemiecki kodeks handlowy (HGB). Grupy notowane na rynku kapitałowym sporządzają skonsolidowane sprawozdanie według międzynarodowych standardów IFRS.

Także według HGB sprawozdania wyglądają różnie. Bilans stosuje schemat z § 266 HGB; małe firmy publikują go w formie skróconej. RZiS stosuje wariant kalkulacyjny lub porównawczy (§ 275 HGB). Każdy wariant ma własne pozycje.

Aby porównywać pozycje między latami i firmami, każdej rozpoznanej linii nadajemy jednolitą nazwę. Jest w name.de i name.en, niezależnie od standardu i od etykiety, którą sprawozdanie drukuje dla linii. „5. Personalaufwand” staje się więc wszędzie Personalaufwand i Personnel expenses.

name.in_report zachowuje etykietę dokładnie tak, jak stoi w sprawozdaniu, z numerem w konspekcie. Używaj jej do wyświetlania i do sprawdzania z oryginałem. Kwoty, kolejność i strukturę przejmujemy ze sprawozdania.

Jeśli nie przypiszemy linii do jednolitej pozycji, name.en brakuje, a name.de powtarza wydrukowaną etykietę. name.en mówi ci więc, czy linia ma jednolitą nazwę.

Dla KPI liczonych tak samo dla każdej firmy używaj KPI finansowych. Według jakich ram sporządzono sprawozdanie, podaje audit.accounting_framework w sprawozdaniach finansowych, jeśli sprawozdanie zawiera opinię biegłego rewidenta.

Feature balance_sheet_accounts zwraca bilans każdego roku obrotowego ze wszystkimi pozycjami. Pozycje tworzą drzewo o strukturze jak w sprawozdaniu. Ich nazwy ujednolicamy; więcej w Standardach rachunkowości.

Korzenie to Aktivseite (aktywa) i Passivseite (pasywa). Rozpoznawaj je i każdą znaną pozycję po name.de, nie po pozycji w drzewie. Jak głęboko leży pozycja, może się różnić między dwoma sprawozdaniami. Przeszukuj więc całe drzewo.

Dzieci pozycji nie muszą sumować się do jej wartości. Linie „davon” („w tym”) są częścią wartości nadrzędnej, a nie dodatkiem.

W planie Max dostajesz też sprawozdania z działalności przedsiębiorstw energetycznych, bez dodatkowych kosztów. To osobne bilanse, które przedsiębiorstwo energetyczne publikuje dla każdej działalności regulowanej według § 6b EnWG. Są w activity_statements, każde z activity.name, drzewem i _provenance. Działalności obejmują zwykle tylko część firmy. Nie sumuj ich więc i nie porównuj z sumami firmy.

W przykładzie Hetzner Online GmbH początek bilansu za 2023, skrócony do pierwszej gałęzi aktywów:

Feature profit_and_loss_account zwraca rachunek zysków i strat każdego roku obrotowego. Węzły mają strukturę jak w bilansie; lista nazywa się tu profit_and_loss_accounts.

Najwyższy poziom zawiera obok siebie pozycje i wydrukowane sumy częściowe, np. wynik brutto lub wynik netto. Nie sumuj ich więc; używaj wydrukowanych wyników.

Średnie i duże firmy publikują RZiS. Średnie firmy mogą zaczynać go od wyniku brutto; wtedy przychodów brakuje jako osobnej linii.

Także tutaj plan Max zwraca sprawozdania z działalności przedsiębiorstw energetycznych w activity_statements, z RZiS każdej działalności pod profit_and_loss_accounts. Bilans i RZiS jednej działalności łączysz przez activity.name.de.

Features annual_financial_statements i annual_financial_statements__html zwracają opublikowane sprawozdania w pełnym tekście. Obejmuje to bilans, RZiS, informację dodatkową i sprawozdanie z działalności, o ile firma je publikuje.

Wariant Markdown jest przeznaczony głównie dla agentów AI. Jest znacznie bardziej kompaktowy niż HTML i oszczędza tokeny. Oryginały często nie mają czystej struktury. Popularne renderery Markdown nie wyświetlą więc tekstu czysto bez dalszego przetwarzania. Do wyświetlania z tabelami używaj wariantu HTML. Oba warianty mają te same pola; tylko tekst jest w document_md albo w document_html.

Bez financial_years dostajesz pięć najnowszych sprawozdań. Z financial_years=3 dostajesz wszystkie sprawozdania trzech najnowszych lat obrotowych. Sprawozdanie może być bardzo długie. Szczególnie wariant HTML robi się duży przy wielu latach.

Jeśli sprawozdanie zawiera opinię biegłego rewidenta, audit opisuje badanie: kto badał, według jakich ram i kiedy podpisano opinię. Bez opinii audit ma wartość null.

Najnowsze sprawozdanie Hetzner Online GmbH w chwili naszego przykładowego zapytania, tekst skrócony: