Données financières

• Les montants sont en euros, en valeur entière sans arrondi au millier. Un chiffre d’affaires de 538,2 millions d’euros arrive sous la forme 538151607.13.
• Les signes : les charges portent le signe imprimé dans les comptes. Certains comptes les présentent en positif, d’autres en négatif. Compare donc les charges sans leur signe. Les pertes et déficits sont négatifs.
• Les ratios et marges sont des décimaux : 0.75 signifie 75 %. Les facteurs comme debt_to_equity et interest_coverage sont des multiples.
• L’exercice : year est l’année civile au cours de laquelle l’exercice se termine. Un exercice du 2024-10-01 au 2025-09-30 est donc 2025. Les dates exactes figurent dans _provenance.period_start et period_end.
• L’ordre : chaque fonctionnalité renvoie une liste avec une entrée par exercice, la plus récente en premier. Une année peut manquer entre deux années s’il n’existe pas de comptes pour elle.
• null signifie : les comptes n’indiquent pas la valeur, ou elle ne peut pas en être déduite. Une petite entreprise, par exemple, ne publie pas de compte de résultat, revenue reste donc vide.

Si une entreprise n’a pas de comptes correspondants, la fonctionnalité arrive sous forme de liste vide []. Nous ne facturons aucun crédit pour cela.

Des comptes individuels (Jahresabschluss) montrent l’entreprise elle-même, des comptes consolidés (Konzernabschluss) l’ensemble du groupe. Sans autre précision, chaque fonctionnalité choisit elle-même. Une réponse peut donc contenir des chiffres individuels et consolidés, même pour la même année dans des fonctionnalités différentes.

Chaque entrée indique dans _provenance de quels comptes proviennent ses chiffres. Ne compare les années qu’au sein du même statement_type. Sinon, tu compares une entreprise avec son groupe.

Avec financial_statement_type=annual, tu n’obtiens que des comptes individuels, avec consolidated que des comptes consolidés. financial_years limite la réponse aux exercices les plus récents, de 1 à 30. Les deux paramètres s’appliquent aux cinq fonctionnalités et ne changent pas le prix. Plus d’informations dans Analyser les indicateurs financiers.

Chaque entrée des indicateurs financiers, du bilan et du compte de résultat contient _provenance, dans chaque plan et aussi sans plan. Les champs sont les mêmes dans les trois fonctionnalités. Dans les indicateurs financiers, _provenance est toujours la dernière clé de la ligne.

Ce qu’une entreprise publie est fixé par la loi, selon la forme juridique et la catégorie de taille. Cela détermine les champs qui ont des valeurs.

Les GmbH et UG, AG, SE et KGaA, la GmbH & Co. KG et l’eG publient leurs comptes. Une KG ou une OHG avec une personne physique comme associé indéfiniment responsable ne publie que si elle est très grande. Il en va de même pour les commerçants individuels. Les sociétés de professions libérales (PartG) ne publient pas de comptes. Une filiale de groupe peut, sous certaines conditions, se dispenser de publier ses propres comptes. Elle doit pour cela être incluse dans les comptes consolidés de sa société mère (§ 264 (3) HGB).

Les micro-entreprises peuvent aussi se contenter de déposer leur bilan. Il n’est alors pas librement accessible. Plus d’informations sur les catégories de taille et les délais dans Disponibilité des données.

Les entreprises ont douze mois après la clôture de l’exercice pour publier, et beaucoup utilisent tout le délai. L’entrée la plus récente porte donc souvent sur l’avant-dernière année ou une année plus ancienne.

La colonne Disponibilité des tableaux ci-dessous résume cela par forme juridique. « en partie » signifie : la valeur arrive si la catégorie de taille de l’entreprise la publie.

Tu obtiens ces indicateurs avec chaque compte, avec ou sans plan, dans la fonctionnalité financial_kpi (Indicateurs financiers).

Par exemple, un exercice de notre requête d’exemple pour Hetzner Online GmbH, Ansbach HRB 6089, avec les indicateurs de base et leur origine :

Avec les plans Pro et Max, chaque ligne des indicateurs financiers contient plus de 90 indicateurs supplémentaires. Ils arrivent dans la même ligne et au même prix.

Nous calculons les ratios, marges et totaux comme ebitda ou net_debt_broad à partir des postes des comptes. S’il manque un poste nécessaire, l’indicateur vaut null.

Les entreprises établissent leurs comptes selon des règles différentes. La plupart suivent le Code de commerce allemand (HGB). Les groupes cotés établissent leurs comptes consolidés selon les normes internationales IFRS.

Même selon le HGB, les comptes ont des aspects différents. Le bilan suit le schéma du § 266 HGB ; les petites entreprises le publient sous forme abrégée. Le compte de résultat suit la méthode par nature ou la méthode par destination (§ 275 HGB). Chaque méthode a ses propres postes.

Pour que tu puisses comparer les postes entre les années et entre les entreprises, nous donnons à chaque ligne reconnue un nom uniforme. Il figure dans name.de et name.en, quelle que soit la norme et quel que soit le libellé que les comptes impriment pour la ligne. « 5. Personalaufwand » devient ainsi partout Personalaufwand et Personnel expenses.

name.in_report conserve le libellé exactement tel qu’il figure dans les comptes, avec sa numérotation. Utilise-le pour l’affichage et pour la vérification par rapport à l’original. Nous reprenons montants, ordre et structure des comptes.

Si nous ne rattachons pas une ligne à un poste uniforme, name.en manque et name.de reprend le libellé imprimé. name.en t’indique donc si une ligne a un nom uniforme.

Pour des indicateurs calculés de la même façon pour chaque entreprise, utilise les indicateurs financiers. Le référentiel selon lequel des comptes ont été établis figure dans audit.accounting_framework dans les comptes annuels, si les comptes contiennent une opinion d’audit.

La fonctionnalité balance_sheet_accounts renvoie le bilan de chaque exercice avec tous les postes. Les postes forment un arbre, structuré comme dans les comptes. Nous normalisons leurs noms ; plus d’informations sous Normes comptables.

Les racines sont Aktivseite (actif) et Passivseite (passif). Reconnais-les, ainsi que chaque poste connu, par name.de, pas par leur position. La profondeur d’un poste peut différer entre deux comptes. Parcours donc tout l’arbre.

Les enfants d’un poste ne s’additionnent pas forcément à son total. Les lignes « davon » (« dont ») font partie de la valeur parente, elles ne s’y ajoutent pas.

Avec le plan Max, tu obtiens aussi les comptes d’activité des fournisseurs d’énergie, sans supplément. Ce sont les bilans séparés qu’un fournisseur d’énergie publie pour chaque activité régulée selon le § 6b EnWG. Ils figurent dans activity_statements, chacun avec activity.name, l’arbre et _provenance. Les activités ne couvrent généralement qu’une partie de l’entreprise. Ne les additionne donc pas et ne les compare pas aux totaux de l’entreprise.

Dans l’exemple de Hetzner Online GmbH, le début du bilan 2023, raccourci à la première branche de l’actif :

La fonctionnalité profit_and_loss_account renvoie le compte de résultat de chaque exercice. Les nœuds sont structurés comme dans le bilan ; la liste s’appelle ici profit_and_loss_accounts.

Le premier niveau contient des postes et des sous-totaux imprimés côte à côte, par exemple la marge brute ou le résultat net. Ne les additionne donc pas ; utilise les résultats imprimés.

Les moyennes et grandes entreprises publient un compte de résultat. Les moyennes entreprises peuvent le faire commencer par la marge brute ; le chiffre d’affaires manque alors comme ligne séparée.

Ici aussi, le plan Max renvoie les comptes d’activité des fournisseurs d’énergie dans activity_statements, avec le compte de résultat de chaque activité sous profit_and_loss_accounts. Tu rapproches le bilan et le compte de résultat d’une activité via activity.name.de.

Les fonctionnalités annual_financial_statements et annual_financial_statements__html renvoient les comptes publiés en texte intégral. Cela comprend bilan, compte de résultat, annexe et rapport de gestion, dans la mesure où l’entreprise les publie.

La variante Markdown est surtout destinée aux agents IA. Elle est bien plus compacte que HTML et économise des tokens. Les originaux n’ont souvent pas de structure propre. Les moteurs de rendu Markdown courants n’affichent donc pas le texte proprement sans traitement supplémentaire. Pour un affichage avec tableaux, utilise la variante HTML. Les deux variantes ont les mêmes champs ; seul le texte figure dans document_md ou dans document_html.

Sans financial_years, tu obtiens les cinq comptes les plus récents. Avec financial_years=3, tu obtiens tous les comptes des trois exercices les plus récents. Un document de comptes peut être très long. La variante HTML en particulier devient volumineuse avec de nombreuses années.

Si des comptes contiennent une opinion d’audit, audit décrit l’audit : qui a audité, selon quel référentiel et quand l’opinion a été signée. Sans opinion, audit vaut null.

Les comptes les plus récents de Hetzner Online GmbH au moment de notre requête d’exemple, texte raccourci :