Zum Hauptinhalt springen
Jede Kennzahl der Finanzberichte hat genau eine Definition und eine Formel. Die App, die Excel-Bücher und die API drucken dieselben Einträge. Der Katalog ist versioniert: Ändert sich eine Definition, entsteht eine neue Version mit neuem Gültigkeitsdatum, und der Änderungsverlauf sagt, was sich geändert hat.

Den Katalog abrufen

GET /api/analytics/finance/definitions liefert den aktuellen Katalog mit seinem Änderungsverlauf. Der Endpunkt braucht analytics:read.
Im Beispiel ist entries auf drei der 80 Einträge gekürzt, changelog ist vollständig:
Dasselbe Objekt steht als Feld definitions im Datensatz Wiederkehrender Umsatz. Jedes Excel-Buch enthält den Katalog als letztes Blatt Definitionen, und das Blatt Info nennt die Version. Mit den Zahlen der Taktwerk GmbH für September 2026: ARR = 53.414,80 € × 12 = 640.977,60 €. Die Differenz Vertrag zu Rechnung ist 53.414,80 € − 53.414,80 € = 0,00 €, im August waren es +79,00 €, weil eine Rechnung noch ausstand.

Versionen

Eine geänderte Definition wird nie still überschrieben. Sie erscheint in einer neuen Version mit eigenem validFrom und einem Eintrag im Änderungsverlauf. Jeder Monatsabschluss hält in definitionsVersion fest, unter welcher Version er entstanden ist. Vergleiche bei einer eigenen Auswertung version mit dem Stand, den du zuletzt übernommen hast, und lies bei einer neuen Version den Änderungsverlauf. Die wichtigsten Änderungen seit v1 (den vollständigen Verlauf liefert changelog):

Katalog v7

Der Katalog enthält 80 Einträge. Die Texte stammen unverändert aus der API. Die Spalte Seit nennt die Version, in der sich die Bedeutung einer Kennzahl zuletzt geändert hat oder in der sie neu dazukam; leer heißt dieselbe Bedeutung seit v1.

Seiten und Karten

MRR und Bewegungen

Nachträge

Vertraglich gebunden und bekannter MRR

Kundenbasis

Umsatz

Vertrag und Rechnung

Zahlungen

Forderungen und Prognose

Glossar

Wiederkehrender Umsatz nach Leistungszeitraum (30/360). Grundlage sind die wiederkehrenden Positionen abgeschlossener Rechnungen. Beispiel: Eine Jahresrechnung über 1.200,00 € für 2026 ergibt 100,00 € Accounted MRR in jedem Monat. Zeilen: metric=accounted_mrr in den Drill-downs.
MRR je Position mal die verbleibenden festen Vertragsmonate. Beispiel: Ein Abo über 100,00 € im Monat, das in sechs Monaten fest endet, bindet 600,00 €. Bei der Taktwerk GmbH sind es im September 2026 zusammen 303.835,60 €. Feld: recurring.backlog.committed in den Datensätzen.
MRR der nächsten zwölf Monate aus den heute erfassten Verträgen und ihren bekannten Vertragsdaten: Vertragsenden, geplante Änderungen, Preisänderungen, Ende von Testphasen und Rabatten. Ein Vertrag zählt bis zu seinem bekannten Ende. Beispiel: Im Oktober 2026 endet ein Rabatt über 116,00 €, der bekannte MRR steigt von 53.414,80 € auf 53.530,80 €. Feld: recurring.backlog.forward.
Die Einheit, auf der Bewegungen gezählt werden: Abonnement, Rechnungsadresse, Kunde oder Organisation. Beispiel: Ein Kunde erhöht bei einem Abo die Menge um 100,00 € und kündigt ein zweites über 60,00 €. Je Abo sind das eine Expansion und ein Verlust, je Kunde eine Expansion über 40,00 €. Parameter: scope, siehe Konzepte.
Gutschriften und Überzahlungen am Monatsende bis zur Erstattung, Anrechnung oder Auszahlung. Beispiel: Ein Kunde bezahlt eine Rechnung über 1.190,00 €, danach wird sie um 119,00 € gutgeschrieben. Bis zur Erstattung, Anrechnung oder Auszahlung zählen die 119,00 € als Guthaben an Kunden. Zeile: owed_to_customers der Forderungstabelle. Sie steht getrennt von den offenen Forderungen.
Eine Meldung der Berechnung über eine getroffene Annahme oder auffällige Daten, mit Code, Stufe und Erklärung. Beispiel: BILLED_VS_CONTRACT_DIFF für die Eichenhof Senioren GmbH, die im Juli 2026 mit 298,00 € statt 149,00 € abgerechnet wurde. Siehe Konzepte.
Die Differenz zwischen dem festgehaltenen Wert eines abgeschlossenen Monats und dem heutigen Wert. Beispiel: Ein Abo mit Start im August wird am 04.09. angelegt, MRR am Ende des August steigt von 51.646,00 € auf 51.846,00 €, der Nachtrag beträgt +200,00 €. Siehe Snapshots.
Bruttobetrag der Rechnungen, die die Abrechnung für den laufenden und die folgenden Monate erwartet, nach Rechnungsdatum und mit Abrechnungszeitraum. Für vergangene Monate ist der Wert null. Fehlt die Prognose einzelner Abos, meldet meta.forecast sie als unvollständig. Zeile: cash_forecast der MRR-Tabelle, Reihe forecastBilled im Cashflow.
Die festgehaltenen Zahlen eines abgeschlossenen Monats in einer Version. Version 1 entsteht am 1. des Folgemonats um 05:00 Uhr, weitere Versionen mit Grund. Beispiel: September 2026 hat Version 1 vom 01.10.2026 mit MRR 53.414,80 € und Zahlungseingang 59.869,28 €. Endpunkt: GET /api/analytics/finance/snapshots.
Der Betrag, der über den Bruttobetrag einer Rechnung hinaus bezahlt wurde, zum Beispiel bei einer doppelt bezahlten Rechnung. Er zählt im Zahlungseingang als „ohne Rechnung” und steht in der Forderungstabelle als status_overpaid, außerhalb der Status-Buckets. Beispiel: Eine Rechnung über 595,00 € wird zweimal bezahlt, 595,00 € sind Überzahlung.