Dati finanziari

• Gli importi sono in euro, come importi interi senza arrotondamento alle migliaia. Un fatturato di 538,2 milioni di euro arriva come 538151607.13.
• Segni: i costi portano il segno che stampa il bilancio. Alcuni bilanci li mostrano positivi, altri negativi. Confronta quindi i costi senza il loro segno. Perdite e disavanzi sono negativi.
• Indici e margini sono decimali: 0.75 significa 75 %. I fattori come debt_to_equity e interest_coverage sono multipli.
• Esercizio: year è l’anno solare in cui termina l’esercizio. Un esercizio dal 2024-10-01 al 2025-09-30 è quindi 2025. Le date esatte sono in _provenance.period_start e period_end.
• Ordine: ogni feature restituisce una lista con una voce per esercizio, la più recente per prima. Tra due anni può mancarne uno se per esso non c’è un bilancio.
• null significa: il bilancio non indica il valore, oppure non se ne può ricavare. Una piccola azienda, ad esempio, non pubblica il conto economico, quindi revenue resta vuoto.

Se un’azienda non ha bilanci corrispondenti, la feature arriva come lista vuota []. In quel caso non addebitiamo crediti.

Un bilancio d’esercizio (Jahresabschluss) mostra l’azienda stessa, un bilancio consolidato (Konzernabschluss) l’intero gruppo. Senza altre indicazioni, ogni feature sceglie da sé. Una risposta può quindi contenere cifre d’esercizio e di gruppo, anche per lo stesso anno in feature diverse.

Ogni voce indica in _provenance da quale bilancio provengono le sue cifre. Confronta gli anni solo all’interno dello stesso statement_type. Altrimenti confronti un’azienda con il suo gruppo.

Con financial_statement_type=annual ricevi solo bilanci d’esercizio, con consolidated solo bilanci consolidati. financial_years limita la risposta agli esercizi più recenti, da 1 a 30. Entrambi i parametri valgono per tutte e cinque le feature e non cambiano il prezzo. Maggiori dettagli in Analizzare i KPI finanziari.

Ogni voce di KPI finanziari, stato patrimoniale e conto economico contiene _provenance, in ogni piano e anche senza piano. I campi sono gli stessi in tutte e tre le feature. Nei KPI finanziari _provenance è sempre l’ultima chiave della riga.

Cosa pubblica un’azienda lo stabilisce la legge, a seconda di forma giuridica e classe dimensionale. Questo decide quali campi hanno valori.

GmbH e UG, AG, SE e KGaA, la GmbH & Co. KG e la eG pubblicano i loro bilanci. Una KG o OHG con una persona fisica come socio a responsabilità illimitata pubblica solo se è molto grande. Lo stesso vale per gli imprenditori individuali. Le società tra professionisti (PartG) non pubblicano bilanci. Una controllata di un gruppo può, a determinate condizioni, omettere la pubblicazione del proprio bilancio. Per questo deve essere inclusa nel bilancio consolidato della sua capogruppo (§ 264 (3) HGB).

Le micro imprese possono anche solo depositare il loro stato patrimoniale. Non è allora liberamente accessibile. Maggiori dettagli su classi dimensionali e termini in Disponibilità dei dati.

Le aziende hanno dodici mesi dalla chiusura dell’esercizio per pubblicare, e molte sfruttano tutto il periodo. La voce più recente riguarda quindi spesso l’anno precedente a quello scorso o uno più vecchio.

La colonna Disponibilità nelle tabelle sotto riassume questo per forma giuridica. “in parte” significa: il valore arriva se la classe dimensionale dell’azienda lo pubblica.

Questi KPI li ricevi con ogni account, con o senza piano, nella feature financial_kpi (KPI finanziari).

Ad esempio, un esercizio dalla nostra richiesta di esempio per Hetzner Online GmbH, Ansbach HRB 6089, con i KPI di base e la sua origine:

Con i piani Pro e Max ogni riga dei KPI finanziari contiene oltre 90 KPI aggiuntivi. Arrivano nella stessa riga e allo stesso prezzo.

Indici, margini e totali come ebitda o net_debt_broad li calcoliamo dalle voci del bilancio. Se manca una voce necessaria, il KPI è null.

Le aziende redigono i loro bilanci secondo regole diverse. La maggior parte segue il codice commerciale tedesco (HGB). I gruppi quotati redigono il bilancio consolidato secondo i principi internazionali IFRS.

Anche secondo l’HGB i bilanci hanno aspetti diversi. Lo stato patrimoniale segue lo schema del § 266 HGB; le piccole aziende lo pubblicano in forma abbreviata. Il conto economico segue il metodo dei costi per natura o il metodo dei costi del venduto (§ 275 HGB). Ogni metodo ha le proprie voci.

Perché tu possa confrontare le voci tra anni e tra aziende, diamo a ogni riga riconosciuta un nome uniforme. È in name.de e name.en, indipendentemente dal principio contabile e dall’etichetta che il bilancio stampa per la riga. “5. Personalaufwand” diventa così ovunque Personalaufwand e Personnel expenses.

name.in_report conserva l’etichetta esattamente come compare nel bilancio, con il suo numero di schema. Usalo per la visualizzazione e per il confronto con l’originale. Importi, ordine e struttura li prendiamo dal bilancio.

Se non associamo una riga a una voce uniforme, name.en manca e name.de ripete l’etichetta stampata. Quindi name.en ti dice se una riga ha un nome uniforme.

Per KPI calcolati allo stesso modo per ogni azienda, usa i KPI finanziari. Secondo quale quadro normativo è stato redatto un bilancio lo indica audit.accounting_framework nei bilanci d’esercizio, se il bilancio contiene un giudizio del revisore.

La feature balance_sheet_accounts restituisce lo stato patrimoniale di ogni esercizio con tutte le voci. Le voci formano un albero, strutturato come nel bilancio. Normalizziamo i loro nomi; maggiori dettagli in Principi contabili.

Le radici sono Aktivseite (attivo) e Passivseite (passivo e patrimonio netto). Riconoscile, come ogni voce nota, da name.de, non dalla posizione. Quanto in profondità si trova una voce può differire tra due bilanci. Cerca quindi in tutto l’albero.

I figli di una voce non devono per forza sommarsi al suo totale. Le righe “davon” (“di cui”) fanno parte del valore superiore, non si aggiungono.

Con il piano Max ricevi anche i bilanci di attività dei fornitori di energia, senza costi aggiuntivi. Sono gli stati patrimoniali separati che un fornitore di energia pubblica per ogni attività regolamentata ai sensi del § 6b EnWG. Sono in activity_statements, ciascuno con activity.name, l’albero e _provenance. Le attività coprono di solito solo una parte dell’azienda. Non sommarle quindi e non confrontarle con i totali dell’azienda.

Nell’esempio di Hetzner Online GmbH, l’inizio dello stato patrimoniale 2023, abbreviato al primo ramo dell’attivo:

La feature profit_and_loss_account restituisce il conto economico di ogni esercizio. I nodi sono strutturati come nello stato patrimoniale; qui la lista si chiama profit_and_loss_accounts.

Il livello superiore contiene voci e subtotali stampati uno accanto all’altro, ad esempio il risultato lordo o l’utile netto. Non sommarli quindi; usa i risultati stampati.

Le aziende medie e grandi pubblicano un conto economico. Le aziende medie possono iniziarlo con il risultato lordo; allora il fatturato manca come riga separata.

Anche qui il piano Max restituisce i bilanci di attività dei fornitori di energia in activity_statements, con il conto economico di ogni attività in profit_and_loss_accounts. Abbini stato patrimoniale e conto economico di un’attività tramite activity.name.de.

Le feature annual_financial_statements e annual_financial_statements__html restituiscono i bilanci pubblicati come testo integrale. Comprendono stato patrimoniale, conto economico, nota integrativa e relazione sulla gestione, per quanto l’azienda li pubblichi.

La variante Markdown è pensata soprattutto per gli agenti AI. È molto più compatta dell’HTML e fa risparmiare token. Gli originali spesso non hanno una struttura pulita. I comuni renderer Markdown quindi non mostrano il testo in modo pulito senza ulteriore elaborazione. Per la visualizzazione con tabelle usa la variante HTML. Entrambe le varianti hanno gli stessi campi; solo il testo è in document_md oppure in document_html.

Senza financial_years ricevi i cinque bilanci più recenti. Con financial_years=3 ricevi tutti i bilanci dei tre esercizi più recenti. Un bilancio può essere molto lungo. Soprattutto la variante HTML diventa grande con molti anni.

Se un bilancio contiene un giudizio del revisore, audit descrive la revisione: chi l’ha eseguita, secondo quale quadro normativo e quando è stato firmato il giudizio. Senza giudizio, audit è null.

Il bilancio più recente di Hetzner Online GmbH al momento della nostra richiesta di esempio, testo abbreviato: