Finanças

• Valores estão em euros, como valores completos, sem arredondar para milhares. Um faturamento de 538,2 milhões de euros vem como 538151607.13.
• Sinais: despesas trazem o sinal que a demonstração imprime. Algumas demonstrações as mostram positivas, outras negativas. Por isso, compare despesas sem o sinal. Prejuízos e déficits são negativos.
• Índices e margens são decimais: 0.75 significa 75 %. Fatores como debt_to_equity e interest_coverage são múltiplos.
• Exercício: year é o ano civil em que o exercício termina. Um exercício de 2024-10-01 a 2025-09-30 é, portanto, 2025. As datas exatas estão em _provenance.period_start e period_end.
• Ordem: cada recurso retorna uma lista com uma entrada por exercício, a mais recente primeiro. Pode faltar um ano entre dois anos se não houver demonstração para ele.
• null significa: a demonstração não informa o valor, ou ele não pode ser derivado dela. Uma empresa pequena, por exemplo, não publica DRE, então revenue fica vazio.

Se uma empresa não tem demonstrações correspondentes, o recurso vem como lista vazia []. Não cobramos créditos por isso.

Uma demonstração individual (Jahresabschluss) mostra a própria empresa; uma consolidada (Konzernabschluss), o grupo inteiro. Sem outra indicação, cada recurso escolhe por conta própria. Uma resposta pode, portanto, conter números individuais e do grupo, até para o mesmo ano em recursos diferentes.

Cada entrada informa em _provenance de qual demonstração vêm seus números. Compare anos só dentro do mesmo statement_type. Caso contrário, você compara uma empresa com o seu grupo.

Com financial_statement_type=annual você recebe só demonstrações individuais; com consolidated, só consolidadas. financial_years limita a resposta aos exercícios mais recentes, de 1 a 30. Os dois parâmetros valem para os cinco recursos e não mudam o preço. Mais em Analisar indicadores financeiros.

Cada entrada de KPIs financeiros, balanço e DRE contém _provenance, em todo plano e também sem plano. Os campos são os mesmos nos três recursos. Nos KPIs financeiros, _provenance é sempre a última chave da linha.

O que uma empresa publica é definido por lei, conforme a forma jurídica e a classe de porte. Isso decide quais campos têm valores.

GmbH e UG, AG, SE e KGaA, a GmbH & Co. KG e a eG publicam suas demonstrações. Uma KG ou OHG com uma pessoa física como sócia de responsabilidade pessoal só publica se for muito grande. O mesmo vale para empresários individuais. Sociedades de profissionais liberais (PartG) não publicam demonstrações. Uma subsidiária de grupo pode, sob certas condições, deixar de divulgar sua própria demonstração. Para isso, precisa estar incluída na demonstração consolidada da controladora (§ 264 (3) HGB).

Microempresas também podem apenas depositar o balanço. Ele então não fica livremente disponível. Mais sobre classes de porte e prazos em Disponibilidade de dados.

As empresas têm doze meses após o fim do exercício para publicar, e muitas usam o prazo inteiro. Por isso, a entrada mais recente muitas vezes cobre o ano retrasado ou um mais antigo.

A coluna Disponibilidade nas tabelas abaixo resume isso por forma jurídica. “em parte” significa: o valor vem se a classe de porte da empresa o publica.

Você recebe estes indicadores com qualquer conta, com ou sem plano, no recurso financial_kpi (KPIs financeiros).

Por exemplo, um exercício da nossa requisição de exemplo para a Hetzner Online GmbH, Ansbach HRB 6089, com os indicadores básicos e sua origem:

Com os planos Pro e Max, cada linha dos KPIs financeiros contém mais de 90 indicadores adicionais. Eles vêm na mesma linha e pelo mesmo preço.

Calculamos índices, margens e totais como ebitda ou net_debt_broad a partir das contas da demonstração. Se faltar uma conta necessária, o indicador é null.

As empresas preparam suas demonstrações segundo regras diferentes. A maioria segue o Código Comercial alemão (HGB). Grupos no mercado de capitais preparam sua demonstração consolidada segundo as normas internacionais IFRS.

Mesmo sob o HGB, as demonstrações têm aparência diferente. O balanço segue o esquema do § 266 HGB; empresas pequenas o publicam de forma resumida. A DRE segue o método do custo total ou o método do custo das vendas (§ 275 HGB). Cada método tem suas próprias contas.

Para que você possa comparar contas entre anos e entre empresas, damos a cada linha reconhecida um nome uniforme. Ele está em name.de e name.en, independentemente da norma e do rótulo que a demonstração imprime para a linha. “5. Personalaufwand” vira assim Personalaufwand e Personnel expenses em todo lugar.

name.in_report mantém o rótulo exatamente como aparece na demonstração, com o número da estrutura. Use-o para exibição e para conferir com o original. Valores, ordem e estrutura vêm da demonstração.

Se não associamos uma linha a uma conta uniforme, name.en não aparece e name.de repete o rótulo impresso. Assim, name.en indica se uma linha tem nome uniforme.

Para indicadores calculados da mesma forma para toda empresa, use os KPIs financeiros. A norma sob a qual uma demonstração foi preparada está em audit.accounting_framework nas demonstrações anuais, se a demonstração contiver um parecer de auditoria.

O recurso balance_sheet_accounts retorna o balanço de cada exercício com todas as contas. As contas formam uma árvore, estruturada como na demonstração. Normalizamos os nomes; mais sobre isso em Normas contábeis.

As raízes são Aktivseite (ativo) e Passivseite (passivo e patrimônio líquido). Reconheça-as e toda conta conhecida pelo name.de, não pela posição. A profundidade de uma conta pode variar entre duas demonstrações. Por isso, busque na árvore inteira.

Os filhos de uma conta não precisam somar o total dela. Linhas “davon” (“dos quais”) são parte do valor pai, não um acréscimo.

Com o plano Max, você também recebe os relatórios de atividade de empresas de energia, sem custo adicional. São os balanços separados que uma empresa de energia publica para cada atividade regulada segundo o § 6b EnWG. Eles estão em activity_statements, cada um com activity.name, a árvore e _provenance. As atividades geralmente cobrem só parte da empresa. Por isso, não as some e não as compare com os totais da empresa.

No exemplo da Hetzner Online GmbH, o início do balanço de 2023, resumido ao primeiro ramo do ativo:

O recurso profit_and_loss_account retorna a demonstração de resultados de cada exercício. Os nós são estruturados como no balanço; a lista aqui se chama profit_and_loss_accounts.

O nível superior contém contas e subtotais impressos lado a lado, por exemplo resultado bruto ou lucro líquido. Por isso, não os some; use os resultados impressos.

Empresas médias e grandes publicam DRE. Empresas médias podem começá-la pelo resultado bruto; então o faturamento não aparece como linha separada.

Aqui também, o plano Max retorna os relatórios de atividade de empresas de energia em activity_statements, com a DRE de cada atividade em profit_and_loss_accounts. Você associa balanço e DRE de uma atividade por activity.name.de.

Os recursos annual_financial_statements e annual_financial_statements__html retornam as demonstrações publicadas em texto completo. Isso inclui balanço, DRE, notas explicativas e relatório da administração, na medida em que a empresa os publica.

A variante Markdown é pensada principalmente para agentes de IA. Ela é muito mais compacta que o HTML e economiza tokens. Os originais muitas vezes não têm estrutura limpa. Por isso, renderizadores de Markdown comuns não exibem o texto de forma limpa sem processamento adicional. Para exibição com tabelas, use a variante HTML. As duas variantes têm os mesmos campos; só o texto fica em document_md ou em document_html.

Sem financial_years, você recebe as cinco demonstrações mais recentes. Com financial_years=3, recebe todas as demonstrações dos três exercícios mais recentes. Uma demonstração pode ser muito longa. A variante HTML, em especial, fica grande com muitos anos.

Se uma demonstração contém um parecer de auditoria, audit descreve a auditoria: quem auditou, sob qual norma e quando o parecer foi assinado. Sem parecer, audit é null.

A demonstração mais recente da Hetzner Online GmbH na data da nossa requisição de exemplo, texto resumido: