Finanzas

• Los importes están en euros, como importes completos sin redondear a miles. Una facturación de 538,2 millones de euros llega como 538151607.13.
• Signos: los gastos llevan el signo que imprimen las cuentas. Algunas cuentas los muestran en positivo, otras en negativo. Así que compara los gastos sin su signo. Las pérdidas y los déficits son negativos.
• Ratios y márgenes son decimales: 0.75 significa 75 %. Los factores como debt_to_equity e interest_coverage son múltiplos.
• Ejercicio: year es el año natural en el que termina el ejercicio. Un ejercicio del 2024-10-01 al 2025-09-30 es por tanto 2025. Las fechas exactas están en _provenance.period_start y period_end.
• Orden: cada función devuelve una lista con una entrada por ejercicio, la más reciente primero. Entre dos años puede faltar uno si no hay cuentas de ese año.
• null significa: las cuentas no indican el valor o no se puede derivar de ellas. Una empresa pequeña, por ejemplo, no publica cuenta de pérdidas y ganancias, así que revenue queda vacío.

Si una empresa no tiene cuentas que encajen, la función llega como lista vacía []. No cobramos créditos por ello.

Las cuentas individuales (Jahresabschluss) muestran la propia empresa; las consolidadas (Konzernabschluss), todo el grupo. Sin más indicaciones, cada función elige por sí misma. Por eso una respuesta puede contener cifras individuales y de grupo, incluso para el mismo año en funciones distintas.

Cada entrada indica en _provenance de qué cuentas proceden sus cifras. Compara años solo dentro del mismo statement_type. Si no, comparas una empresa con su grupo.

Con financial_statement_type=annual obtienes solo cuentas individuales, con consolidated solo consolidadas. financial_years limita la respuesta a los ejercicios más recientes, de 1 a 30. Ambos parámetros se aplican a las cinco funciones y no cambian el precio. Más en Analizar KPI financieros.

Cada entrada de KPI financieros, balance y cuenta de resultados contiene _provenance, en todos los planes y también sin plan. Los campos son los mismos en las tres funciones. En los KPI financieros, _provenance es siempre la última clave de la fila.

Lo que publica una empresa lo fija la ley, según la forma jurídica y la clase de tamaño. Esto decide qué campos tienen valores.

GmbH y UG, AG, SE y KGaA, la GmbH & Co. KG y la eG publican sus cuentas. Una KG u OHG con una persona física como socio con responsabilidad personal solo publica si es muy grande. Lo mismo vale para los comerciantes individuales. Las sociedades profesionales (PartG) no publican cuentas. Una filial de un grupo puede, bajo ciertas condiciones, omitir la publicación de sus propias cuentas. Para ello debe estar incluida en las cuentas consolidadas de su matriz (§ 264 (3) HGB).

Las microempresas también pueden limitarse a depositar su balance. Entonces no está libremente disponible. Más sobre clases de tamaño y plazos en Disponibilidad de datos.

Las empresas tienen doce meses tras el cierre del ejercicio para publicar, y muchas agotan el plazo. Por eso la entrada más reciente suele ser la del penúltimo año o una anterior.

La columna Disponibilidad de las tablas siguientes lo resume por forma jurídica. “a veces” significa: el valor llega si la clase de tamaño de la empresa lo publica.

Estos KPI los obtienes con cualquier cuenta, con o sin plan, en la función financial_kpi (KPI financieros).

Por ejemplo, un ejercicio de nuestra solicitud de ejemplo para Hetzner Online GmbH, Ansbach HRB 6089, con los KPI básicos y su origen:

Con los planes Pro y Max, cada fila de los KPI financieros contiene más de 90 KPI adicionales. Llegan en la misma fila y al mismo precio.

Calculamos ratios, márgenes y totales como ebitda o net_debt_broad a partir de las partidas de las cuentas. Si falta una partida necesaria, el KPI es null.

Las empresas elaboran sus cuentas con reglas distintas. La mayoría sigue el Código de Comercio alemán (HGB). Los grupos cotizados elaboran sus cuentas consolidadas según las normas internacionales IFRS.

Incluso con HGB, las cuentas tienen aspectos distintos. El balance sigue el esquema del § 266 HGB; las empresas pequeñas lo publican abreviado. La cuenta de resultados sigue el método del coste total o el del coste de las ventas (§ 275 HGB). Cada método tiene sus propias partidas.

Para que puedas comparar partidas entre años y entre empresas, damos a cada línea reconocida un nombre uniforme. Está en name.de y name.en, sea cual sea la norma y la denominación que imprimen las cuentas para la línea. Así “5. Personalaufwand” pasa a ser en todas partes Personalaufwand y Personnel expenses.

name.in_report conserva la denominación exactamente como figura en las cuentas, con su número de epígrafe. Úsala para mostrar y para comparar con el original. Importes, orden y estructura los tomamos de las cuentas.

Si no asignamos una línea a una partida uniforme, falta name.en y name.de repite la denominación impresa. Así name.en te indica si una línea tiene un nombre uniforme.

Para KPI calculados igual para todas las empresas, usa los KPI financieros. Con qué marco se elaboraron unas cuentas se indica en audit.accounting_framework en las cuentas anuales, si contienen un informe de auditoría.

La función balance_sheet_accounts devuelve el balance de cada ejercicio con todas sus partidas. Las partidas forman un árbol, estructurado como en las cuentas. Normalizamos sus nombres; más sobre esto en Normas contables.

Las raíces son Aktivseite (activo) y Passivseite (patrimonio neto y pasivo). Reconócelas, y cada partida conocida, por name.de, no por su posición. A qué profundidad está una partida puede variar entre dos cuentas. Así que busca en todo el árbol.

Los hijos de una partida no tienen por qué sumar su total. Las líneas “davon” (“de ello”) forman parte del valor superior, no son un añadido.

Con el plan Max obtienes además las cuentas por actividad de las empresas energéticas, sin coste adicional. Son los balances separados que una empresa energética publica para cada actividad regulada según el § 6b EnWG. Están en activity_statements, cada una con activity.name, el árbol y _provenance. Las actividades suelen cubrir solo una parte de la empresa. Así que no las sumes ni las compares con los totales de la empresa.

En el ejemplo de Hetzner Online GmbH, el inicio del balance de 2023, abreviado a la primera rama del activo:

La función profit_and_loss_account devuelve la cuenta de pérdidas y ganancias de cada ejercicio. Los nodos están estructurados como en el balance; la lista se llama aquí profit_and_loss_accounts.

El nivel superior contiene partidas y subtotales impresos uno junto a otro, por ejemplo el resultado bruto o el resultado del ejercicio. Así que no los sumes; usa los resultados impresos.

Las empresas medianas y grandes publican una cuenta de resultados. Las medianas pueden empezarla con el resultado bruto; entonces falta la facturación como línea propia.

También aquí, el plan Max devuelve las cuentas por actividad de las empresas energéticas en activity_statements, con la cuenta de resultados de cada actividad en profit_and_loss_accounts. El balance y la cuenta de resultados de una actividad los relacionas mediante activity.name.de.

Las funciones annual_financial_statements y annual_financial_statements__html devuelven las cuentas publicadas en texto completo. Esto incluye balance, cuenta de resultados, memoria e informe de gestión, en la medida en que la empresa los publique.

La variante Markdown está pensada sobre todo para agentes de IA. Es mucho más compacta que HTML y ahorra tokens. Los originales a menudo no tienen una estructura limpia. Por eso los renderizadores de Markdown habituales no muestran bien el texto sin procesarlo más. Para mostrarlo con tablas, usa la variante HTML. Ambas variantes tienen los mismos campos; solo el texto está en document_md o en document_html.

Sin financial_years obtienes las cinco cuentas más recientes. Con financial_years=3 obtienes todas las cuentas de los tres ejercicios más recientes. Unas cuentas pueden ser muy largas. Sobre todo la variante HTML crece mucho con muchos años.

Si unas cuentas contienen un informe de auditoría, audit describe la auditoría: quién auditó, con qué marco y cuándo se firmó el informe. Sin informe, audit es null.

Las cuentas más recientes de Hetzner Online GmbH en el momento de nuestra solicitud de ejemplo, texto abreviado: