Den Katalog abrufen
GET /api/analytics/finance/definitions liefert den aktuellen Katalog mit seinem Änderungsverlauf. Der Endpunkt braucht analytics:read.
entries auf drei der 80 Einträge gekürzt, changelog ist vollständig:
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 seitv1.
Seiten und Karten
MRR und Bewegungen
Nachträge
Vertraglich gebunden und bekannter MRR
Kundenbasis
Umsatz
Vertrag und Rechnung
Zahlungen
Forderungen und Prognose
Glossar
Accounted MRR
Accounted MRR
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.Backlog (Vertraglich gebunden)
Backlog (Vertraglich gebunden)
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.Bekannter MRR (Known forward MRR)
Bekannter MRR (Known forward MRR)
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.Ebene (Scope)
Ebene (Scope)
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.Guthaben an Kunden
Guthaben an Kunden
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.Hinweis (Finding)
Hinweis (Finding)
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.Nachtrag
Nachtrag
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.
Rechnungsprognose
Rechnungsprognose
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.Snapshot
Snapshot
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.Überzahlung
Überzahlung
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.