> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fynn.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Definitionen

> Der versionierte Katalog aller Finanzkennzahlen per API, mit Definition und Formel je Kennzahl, dem Änderungsverlauf und dem Glossar der Finanzberichte.

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`.

```bash theme={null}
curl https://coreapi.io/api/analytics/finance/definitions \
  -H "Authorization: Bearer api_DEIN_TOKEN"
```

Im Beispiel ist `entries` auf drei der 80 Einträge gekürzt, `changelog` ist vollständig:

```json theme={null}
{
  "version": "v7",
  "validFrom": "2026-10-22",
  "entries": [
    {
      "id": "arr",
      "title": "ARR",
      "definition": "MRR am Monatsende, auf ein Jahr gerechnet. Bei nutzungsabhängigen Produkten zählt die feste Gebühr je Intervall.",
      "formula": "MRR × 12"
    },
    {
      "id": "variable_12m",
      "title": "Variabel, 12 Monate",
      "definition": "Nettoumsatz nutzungsabhängiger und prozentualer Positionen des Monats und der elf Monate davor.",
      "formula": "Σ Variabel (Monat) der letzten zwölf Monate"
    },
    {
      "id": "billing_gap",
      "title": "Differenz Vertrag zu Rechnung",
      "definition": "MRR laut Vertrag am Monatsende abzüglich Accounted MRR, also Vertrag minus Rechnung, je Ursache: Vertragsänderung im Monat, Abrechnung beginnt später, Rechnung ausstehend, Nicht abgerechnet, Rechnung folgt, Abrechnung angehalten, Abrechnung deaktiviert, Testphase, Gutschrift oder Storno, Abgerechnet nach Vertragsende, Periodenverschiebung (Zeitzone), Rechnungsbetrag weicht ab, ohne Zuordnung. Rechnung ausstehend: eine offene Abrechnungsposition deckt den vergangenen Monat, der nächste Lauf stellt sie in Rechnung. Nicht abgerechnet: ein vergangener Monat ohne Rechnung und ohne offene Abrechnungsposition. Rechnung folgt: laufender und künftige Monate. Bei nutzungsabhängigen Produkten zählt auf beiden Seiten die feste Gebühr.",
      "formula": "MRR (Periodenende) − Accounted MRR = Σ Ursachen"
    }
  ],
  "changelog": [
    {
      "version": "v7",
      "validFrom": "2026-10-22",
      "changes": []
    },
    {
      "version": "v6",
      "validFrom": "2026-09-29",
      "changes": [
        {
          "id": "owed_to_customers",
          "change": "Eine Gutschrift auf dem Kundenguthaben zählt mit, bis das Guthaben angerechnet oder ausgezahlt ist."
        }
      ]
    },
    {
      "version": "v5",
      "validFrom": "2026-09-29",
      "changes": [
        {
          "id": "cash_refunded",
          "change": "Zählt Rücklastschrift-Gebühren als eigene Zeile darunter."
        },
        {
          "id": "cash_refunded_return_fee",
          "change": "Neue Zeile für Bankgebühren von Rücklastschriften ohne Rücklastschrift-Fall."
        },
        {
          "id": "cash_refunded_chargeback",
          "change": "Zählt eine negative Lastschrift-Zahlung ohne Rücklastschrift-Fall, wenn sie einer eingezogenen Zahlung plus Bankgebühr entspricht."
        },
        {
          "id": "receivables_eop",
          "change": "Die Bankgebühr einer Rücklastschrift zählt nicht zum offenen Betrag, und ein zurückgebuchtes Guthaben ohne erneut erhöhte Zahlungsaufforderung zählt als offen."
        }
      ]
    },
    {
      "version": "v4",
      "validFrom": "2026-09-29",
      "changes": [
        {
          "id": "cash_collected",
          "change": "Zählt zurückgekommene Erstattungen als eigene Zeile darunter."
        },
        {
          "id": "cash_collected_refund_returned",
          "change": "Neue Zeile für Erstattungen, die vom Bankkonto zurückgekommen sind."
        },
        {
          "id": "cash_refunded_refund",
          "change": "Eine negative Erstattung zählt nie als zweite Erstattung."
        },
        {
          "id": "cash_corrections",
          "change": "Neue Zeile für von Hand stornierte Zahlungen und Erstattungen, außerhalb von Zahlungseingang und Zahlungsausgang."
        },
        {
          "id": "cash_refunded_chargeback",
          "change": "Zählt nur Rückbuchungen mit Nachweis und heißt jetzt Rücklastschriften und Chargebacks."
        },
        {
          "id": "cash_corrections_reversed",
          "change": "Neue Zeile unter Korrekturen."
        },
        {
          "id": "cash_corrections_counter",
          "change": "Neue Zeile unter Korrekturen."
        },
        {
          "id": "receivables_eop",
          "change": "Eine Rechnung mit negativem Betrag ist keine offene Forderung. Eine nicht verrechnete Gutschrift mindert den offenen Betrag, bezahlte Teile bleiben bezahlt."
        },
        {
          "id": "owed_to_customers",
          "change": "Enthält Rechnungen mit negativem Betrag bis zur Auszahlung."
        }
      ]
    },
    {
      "version": "v3",
      "validFrom": "2026-09-28",
      "changes": [
        {
          "id": "lost",
          "change": "Annullierte Abos zählen nicht mehr als „Verloren“."
        },
        {
          "id": "lost_by_cancellation_reason",
          "change": "Annullierungen sind keine eigene Zeile mehr."
        },
        {
          "id": "restatement",
          "change": "Neue Definition für Nachträge zu abgeschlossenen Monaten."
        },
        {
          "id": "restatement_voided",
          "change": "Annullierte Abos zählen in keinem Monat, nur als Nachtrag."
        },
        {
          "id": "cash_refunded",
          "change": "Heißt jetzt Zahlungsausgang und zählt Erstattungen, Rücklastschriften und Auszahlungen, jeweils als eigene Zeile darunter."
        },
        {
          "id": "cash_net",
          "change": "Zieht den ganzen Zahlungsausgang ab, nicht nur Erstattungen."
        },
        {
          "id": "cash_in_for_month",
          "change": "Heißt jetzt Bezahlt bis heute und steht bei den Rechnungen des Monats, nicht mehr im Cash-Block."
        },
        {
          "id": "mrr_waterfall",
          "change": "Neue Definition für den Weg vom Monatsbeginn zum Monatsende."
        }
      ]
    },
    {
      "version": "v2",
      "validFrom": "2026-09-28",
      "changes": [
        {
          "id": "dso_3m",
          "change": "Basis ist jetzt der Rechnungsbetrag brutto, und die Tage zählen erst ab dem ersten Rechnungsmonat, im laufenden Monat nur bis heute."
        },
        {
          "id": "dso_12m",
          "change": "Basis ist jetzt der Rechnungsbetrag brutto, und die Tage zählen erst ab dem ersten Rechnungsmonat, im laufenden Monat nur bis heute."
        },
        {
          "id": "accounted_mrr",
          "change": "Zählt nach Leistungszeitraum, unabhängig vom Buchungszeitpunkt."
        },
        {
          "id": "arr",
          "change": "Nutzungsabhängiger Umsatz zählt nicht mehr dazu, auch nicht auf der Umsatzseite."
        },
        {
          "id": "variable",
          "change": "Heißt jetzt Variabel (Monat)."
        },
        {
          "id": "variable_12m",
          "change": "Neue Kennzahl für den variablen Umsatz der letzten zwölf Monate, nicht Teil des ARR."
        },
        {
          "id": "invoiced_recurring",
          "change": "Zeigt den abgerechneten wiederkehrenden Umsatz je Monat."
        },
        {
          "id": "invoiced_net",
          "change": "Gutschriften und Stornos zählen im Monat ihrer Ausstellung."
        },
        {
          "id": "billed_net",
          "change": "Der Rechnungsbetrag netto ohne Gutschriften und Stornos ist dazugekommen."
        },
        {
          "id": "billing_gap",
          "change": "Rechnet jetzt Vertrag minus Rechnung und kennt die neue Ursache „Nicht abgerechnet“."
        },
        {
          "id": "cash_forecast",
          "change": "Zeigt je Rechnung den Abrechnungszeitraum, und eine Gutschrift zählt nur mit offener Gutschriftsposition."
        },
        {
          "id": "invoice_forecast_net",
          "change": "Zeigt je Rechnung den Abrechnungszeitraum, und eine Gutschrift zählt nur mit offener Gutschriftsposition."
        },
        {
          "id": "lost",
          "change": "Pausen und Annullierungen stehen als Ursachen darunter."
        }
      ]
    },
    {
      "version": "v1",
      "validFrom": "2026-09-27",
      "changes": []
    }
  ]
}
```

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

| Feld | Bedeutung |
| - | - |
| `version` | Version des Katalogs, heute `v7` |
| `validFrom` | Datum, ab dem die Version gilt (`YYYY-MM-DD`), für `v7` der 22.10.2026 |
| `entries[].id` | stabile Kennung, ändert sich auch in einer neuen Version nicht |
| `changelog` | je Version die Kennzahlen, deren Bedeutung sich geändert hat, mit einem Satz je Änderung; neueste Version zuerst |

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`):

| Version | Kennzahl | Änderung |
| - | - | - |
| `v7` | alle | Neuer Wortlaut der Definitionen. Regeln und Zahlen bleiben gleich. |
| `v6` | `owed_to_customers` | Eine Gutschrift auf dem Kundenguthaben zählt mit, bis das Guthaben angerechnet oder ausgezahlt ist. |
| `v5` | `cash_refunded`, `cash_refunded_return_fee` | Bankgebühren von Rücklastschriften ohne Rücklastschrift-Fall stehen als eigene Zeile unter dem Zahlungsausgang. |
| `v5` | `receivables_eop` | Die Bankgebühr einer Rücklastschrift zählt nicht zum offenen Betrag. |
| `v4` | `cash_collected_refund_returned` | Erstattungen, die vom Bankkonto zurückgekommen sind, stehen als eigene Zeile unter dem Zahlungseingang. |
| `v4` | `cash_corrections` | Von Hand stornierte Zahlungen und Erstattungen stehen als Korrekturen außerhalb von Zahlungseingang und Zahlungsausgang. |
| `v4` | `receivables_eop`, `owed_to_customers` | Eine Rechnung mit negativem Betrag ist keine offene Forderung, sie zählt bis zur Auszahlung als Guthaben an Kunden. |
| `v3` | `lost`, `restatement_voided` | Annullierte Abos zählen nicht mehr als Verloren, nur als Nachtrag. |
| `v3` | `cash_refunded`, `cash_net` | Heißt jetzt Zahlungsausgang und zählt Erstattungen, Rücklastschriften und Auszahlungen; Netto-Cash zieht den ganzen Zahlungsausgang ab. |
| `v2` | `arr` | ARR ist auf allen Seiten MRR × 12. Nutzungsabhängiger Umsatz zählt nicht mehr dazu, auch nicht auf der Umsatzseite. |
| `v2` | `variable`, `variable_12m` | Der variable Umsatz eines Monats heißt Variabel (Monat). Der variable Umsatz der letzten zwölf Monate ist eine eigene Kennzahl. |
| `v2` | `billing_gap` | Rechnet Vertrag minus Rechnung und kennt die Ursache „Nicht abgerechnet". |
| `v2` | `invoiced_net`, `invoiced_recurring`, `billed_net` | Umsatz zählt Gutschriften und Stornos im Monat ihrer Ausstellung. Der Rechnungsbetrag netto ohne Gutschriften und Stornos ist eine eigene Kennzahl. |
| `v2` | `dso_3m`, `dso_12m` | Basis ist der Rechnungsbetrag brutto, die Tage zählen ab dem ersten Rechnungsmonat. |

## 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

| `id` | Kennzahl | Definition | Formel | Seit |
| - | - | - | - | - |
| `mrr_waterfall` | MRR-Waterfall | Weg vom MRR am Monatsbeginn zum MRR am Monatsende über die fünf Bewegungen. Nach einem Monatsabschluss beginnt er beim Stand zum Abschluss, die Nachträge seitdem führen zum Monatsbeginn. | Beginn + Neu + Expansion + Reaktiviert − Kontraktion − Verloren = Ende | `v3` |
| `movement_reasons` | Ursachen der Bewegungen | Bewegungen eines Monats, aufgeteilt nach der Änderung, die sie ausgelöst hat, z. B. Preisänderung, Mengenänderung oder Vertragsende. Die Ursachen einer Bewegung ergeben zusammen ihren Betrag. | Bewegung = Σ Ursachen | |
| `logo_movements` | Logo-Bewegungen | Anzahl der Konten, die im Monat dazukommen oder wegfallen. | Neu: Konten mit erstem MRR; Verloren: Konten mit MRR am Monatsende 0 | |
| `segment_comparison` | Segmentvergleich | Dieselben Kennzahlen je Segment für denselben Zeitraum. | Kennzahl je Segment | |
| `mrr_table` | MRR-Tabelle | MRR-Stände, Bewegungen, Kennzahlen, einmaliger und variabler Umsatz und Cash je Monat. Jede Zelle öffnet die Zeilen dahinter. | Periodenende = Periodenbeginn + Σ Bewegungen | |
| `cashflow` | Cashflow | Zahlungseingang und Zahlungsausgang je Monat nach Zahldatum, ab dem laufenden Monat dazu die Rechnungsprognose. | Netto-Cash = Zahlungseingang − Zahlungsausgang | |
| `receivables_table` | Forderungen | Rechnungen je Abschlussmonat mit ihrem Status heute, Zahlungen nach Zahldatum und offene Beträge zum Monatsende. | Rechnungsbetrag brutto = Summe Status | |
| `ageing` | Altersstruktur | Heute offene Beträge abgeschlossener Rechnungen nach Tagen seit Fälligkeit. | Σ offener Betrag je Stufe = offene Forderungen heute | |
| `revenue_by_country` | Umsatz je Land | Nettoumsatz der im Zeitraum abgeschlossenen Rechnungen, Gutschriften und Stornos nach Land der Rechnungsadresse. | Σ Netto je Land = Umsatz netto | |
| `revenue_by_product` | Umsatz je Produkt | Nettoumsatz der im Zeitraum abgeschlossenen Rechnungen, Gutschriften und Stornos nach Produkt der Position. Positionen ohne Produkt stehen unter „Ohne Produkt“. | Σ Netto je Produkt = Umsatz netto | |
| `revenue_by_customer` | Umsatz je Kunde | Nettoumsatz der im Zeitraum abgeschlossenen Rechnungen, Gutschriften und Stornos je Kunde und Produkt. | Σ Netto je Kunde = Umsatz netto | |

### MRR und Bewegungen

| `id` | Kennzahl | Definition | Formel | Seit |
| - | - | - | - | - |
| `mrr_eop` | MRR (Periodenende) | Monatlich wiederkehrender Nettoumsatz aller laufenden Verträge in der letzten Sekunde des Monats. Testphasen, Pausen, Einmalpreise und Provisionen zählen mit 0. Bei nutzungsabhängigen Produkten zählt nur eine feste Gebühr je Intervall, der nutzungsabhängige Teil zählt mit 0. Umrechnung auf den Monat mit 30 Tagen: eine Woche ist 7/30 Monat, ein Tag 1/30 Monat, 70,00 je Woche sind 300,00 im Monat. | Σ Monatsbeitrag aller Positionen am Monatsende; Monatsbeitrag = Preis je Intervall ÷ Intervall in Monaten | |
| `mrr_bop` | MRR (Periodenbeginn) | MRR am Ende des Vormonats. | MRR(Monatsende des Vormonats) | |
| `arr` | ARR | MRR am Monatsende, auf ein Jahr gerechnet. Bei nutzungsabhängigen Produkten zählt die feste Gebühr je Intervall. | MRR × 12 | `v2` |
| `new` | Neu | MRR von Konten, die zum ersten Mal zahlen. | MRR Ende, wenn erstes Monatsende des Kontos mit MRR > 0 | |
| `expansion` | Expansion | Anstieg bei Konten, die am Monatsbeginn und am Monatsende zahlen. | Ende − Beginn, wenn Ende > Beginn > 0 | |
| `contraction` | Kontraktion | Rückgang bei Konten, die am Monatsbeginn und am Monatsende zahlen. | Beginn − Ende, wenn Beginn > Ende > 0 | |
| `lost` | Verloren | MRR am Monatsbeginn von Konten mit MRR 0 am Monatsende. Pausen stehen als Ursache darunter. Annullierte Abos zählen in jedem Monat mit 0. | MRR Beginn, wenn MRR Ende = 0 | `v3` |
| `resurrecting` | Reaktiviert | MRR von Konten, die nach Pause oder Vertragsende wieder zahlen. | MRR Ende, wenn MRR Beginn = 0 und früher > 0 | |
| `expansion_with_reactivation` | Expansion und Reaktiviert | Expansion und Reaktiviert eines Monats zusammen. | Expansion + Reaktiviert | |
| `churn_mrr` | Churn MRR | Kontraktion und Verloren eines Monats zusammen. | Kontraktion + Verloren | |
| `movement_netting` | Bewegung je Konto | Ein Konto hat höchstens eine Bewegung je Monat, deren Art das Vorzeichen seiner Netto-Änderung bestimmt. Die Ursachen sind ihre Bestandteile. | Bewegung = Σ Ursachen des Kontos | |
| `reason_counter` | Gegenläufige Ursache | Ursache mit dem umgekehrten Vorzeichen ihrer Bewegung, z. B. ein entferntes Produkt in einer Expansion. | Vorzeichen der Ursache ≠ Vorzeichen der Bewegung | |
| `movement_scope` | Ebene (je Abo, Rechnungsadresse, Kunde, Organisation) | Ebene, auf der ein Konto gebildet wird. Bewegungen, Ursachen und Kontenzahlen gelten je Konto dieser Ebene. Voreinstellung aus den Einstellungen. | Konto = Abo \| Rechnungsadresse \| Kunde \| Organisation | |
| `cockpit_organisation` | Organisation in der Kundenakte | Der Kunde und seine direkten Unterkunden. Die Finanzseiten fassen auf der Ebene Organisation alle Kunden unter derselben obersten Mutter zusammen. | Kunde + direkte Unterkunden | |
| `net_new_mrr` | Netto-Neu-MRR | Summe aller Bewegungen eines Monats. | Neu + Expansion + Reaktiviert − Kontraktion − Verloren | |
| `quick_ratio` | Quick Ratio | Zuwachs im Verhältnis zum Rückgang. | (Neu + Expansion + Reaktiviert) / (Kontraktion + Verloren) | |
| `revenue_churn_rate` | Umsatz-Churn-Rate | Rückgang im Verhältnis zum MRR am Monatsbeginn. | (Kontraktion + Verloren) / MRR Beginn | |
| `mom_growth` | Wachstum (MoM) | Veränderung des MRR im Verhältnis zum Monatsbeginn. | (MRR Ende − MRR Beginn) / MRR Beginn | |

### Nachträge

| `id` | Kennzahl | Definition | Formel | Seit |
| - | - | - | - | - |
| `restatement` | Nachträge | Änderungen an einem abgeschlossenen Monat, erfasst nach dessen Abschluss, je Ursache. Der MRR-Waterfall des Folgemonats beginnt beim Stand zum Abschluss und zeigt die Nachträge vor dem Periodenbeginn. | Stand zum Abschluss + Nachträge = MRR Beginn des Folgemonats | `v3` |
| `restatement_voided` | Annulliert | Ein annulliertes Abo zählt in jedem Monat mit 0. War es in einem abgeschlossenen Monat enthalten, steht sein MRR dort als Nachtrag unter „Annulliert“. | − MRR des Abos zum Abschluss | `v3` |

### Vertraglich gebunden und bekannter MRR

| `id` | Kennzahl | Definition | Formel | Seit |
| - | - | - | - | - |
| `committed_remaining` | Vertraglich gebunden | MRR je Position mal verbleibende feste Vertragsmonate: bis zum bekannten Vertragsende, sonst bis zum frühesten Ende bei Kündigung zum Monatsende nach Laufzeit und Kündigungsfrist, bei jederzeit kündbaren Verträgen ein Monat. Eine Kündigung zählt ab dem Tag, an dem sie erfasst wurde. | Σ MRR je Position × Restmonate | |
| `average_remaining_term` | Durchschnittliche Restlaufzeit | Feste Restlaufzeit in Monaten, gewichtet mit dem MRR. | Vertraglich gebunden / MRR | |
| `known_forward_mrr` | Bekannter 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. | MRR(Monatsende) nach bekannten Ereignissen | |
| `manual_start_pending` | Vertraglich gebunden, Start manuell ausstehend | Monatlicher Betrag von Positionen aus Zeitplänen, deren Start auf eine manuelle Aktivierung wartet. Ab der Aktivierung zählen sie im MRR, im gebundenen und im bekannten MRR. | Σ monatlicher Betrag der Positionen mit ausstehendem manuellem Start | |

### Kundenbasis

| `id` | Kennzahl | Definition | Formel | Seit |
| - | - | - | - | - |
| `active_accounts` | Aktive Konten | Konten mit MRR über 0 am Monatsende. | Anzahl Konten mit MRR > 0 | |
| `active_customers` | Aktive Kunden | Kunden mit MRR über 0 am Ende des Zeitraums, je Währung gezählt. | Anzahl Kunden mit MRR > 0 | |
| `active_subscriptions` | Aktive Abonnements | Abos mit MRR über 0 am Ende des Zeitraums. Testphasen, Pausen und Einmalpreise zählen wie im MRR mit 0. | Anzahl Abos mit MRR > 0 | |
| `arpa` | ARPA | Durchschnittlicher MRR je aktivem Konto. | MRR / aktive Konten | |
| `nrr` | NRR 12 Monate | MRR heute der Konten, die vor zwölf Monaten zahlten, im Verhältnis zu ihrem MRR damals. Expansion zählt mit. | Σ MRR(m) / Σ MRR(m − 12), Konten mit MRR(m − 12) > 0 | |
| `grr` | GRR 12 Monate | Wie NRR, je Konto aber höchstens der MRR von vor zwölf Monaten. | Σ min(MRR(m), MRR(m − 12)) / Σ MRR(m − 12) | |
| `cohort_retention` | Kohortenbindung | MRR der Konten eines Startmonats nach n Monaten im Verhältnis zu ihrem MRR im Startmonat. Startmonat ist der erste Monat mit MRR. | MRR(Kohorte, Alter n) / MRR(Kohorte, Alter 0) | |
| `concentration` | Kundenkonzentration | Anteil der größten Konten am MRR. | Σ MRR der Top n / MRR | |
| `lost_by_cancellation_reason` | Verloren nach Kündigungsgrund | Verlorener MRR je Kündigungsgrund. Pausen und Kündigungen ohne Grund sind eigene Zeilen. | Σ Vertragsende-Anteile je Grund | `v3` |

### Umsatz

| `id` | Kennzahl | Definition | Formel | Seit |
| - | - | - | - | - |
| `invoiced_net` | Umsatz netto (abgerechnet) | Nettobetrag nach Rabatten der im Zeitraum abgeschlossenen Rechnungen, Gutschriften und Stornos, jeweils im Monat ihrer Ausstellung. Gutschriften und Stornos zählen negativ. Summe aus Wiederkehrend, Einmalig und Variabel, gleich der Summe je Land und je Produkt. Mahngebühren zählen als sonstiger betrieblicher Ertrag. | Wiederkehrend + Einmalig + Variabel | `v2` |
| `invoiced_recurring` | Wiederkehrend (abgerechnet) | Nettobetrag nach Rabatten der wiederkehrenden Positionen der im Monat abgeschlossenen Rechnungen, Gutschriften und Stornos. Gutschriften und Stornos zählen negativ im Monat ihrer Ausstellung. | Σ Netto wiederkehrender Positionen | `v2` |
| `one_off` | Einmalig | Nettoumsatz einmaliger Positionen der im Monat abgeschlossenen Rechnungen. Gutschriften und Stornos zählen negativ. | Σ Netto einmaliger Positionen | |
| `variable` | Variabel (Monat) | Nettoumsatz nutzungsabhängiger und prozentualer Positionen der im Monat abgeschlossenen Rechnungen. | Σ Netto variabler Positionen | `v2` |
| `variable_12m` | Variabel, 12 Monate | Nettoumsatz nutzungsabhängiger und prozentualer Positionen des Monats und der elf Monate davor. | Σ Variabel (Monat) der letzten zwölf Monate | `v2` |

### Vertrag und Rechnung

| `id` | Kennzahl | Definition | Formel | Seit |
| - | - | - | - | - |
| `accounted_mrr` | Accounted MRR | Wiederkehrender Umsatz nach Leistungszeitraum (30/360). Netto laut Rechnungen, weicht deshalb von den Erlösbuchungen des Monats ab. Jede wiederkehrende Position abgeschlossener Rechnungen nach Rabatten, Gutschriften und Stornos negativ, mit ihrem Anteil am Monat nach Leistungszeitraum. Tage nach 30/360: eine Jahresrechnung über 1.200,00 für ein Kalenderjahr ergibt 100,00 je Monat. Nachträge betreffen nur den MRR laut Vertrag. | Σ Netto × Tage im Monat / Tage des Leistungszeitraums | `v2` |
| `billing_gap` | Differenz Vertrag zu Rechnung | MRR laut Vertrag am Monatsende abzüglich Accounted MRR, also Vertrag minus Rechnung, je Ursache: Vertragsänderung im Monat, Abrechnung beginnt später, Rechnung ausstehend, Nicht abgerechnet, Rechnung folgt, Abrechnung angehalten, Abrechnung deaktiviert, Testphase, Gutschrift oder Storno, Abgerechnet nach Vertragsende, Periodenverschiebung (Zeitzone), Rechnungsbetrag weicht ab, ohne Zuordnung. Rechnung ausstehend: eine offene Abrechnungsposition deckt den vergangenen Monat, der nächste Lauf stellt sie in Rechnung. Nicht abgerechnet: ein vergangener Monat ohne Rechnung und ohne offene Abrechnungsposition. Rechnung folgt: laufender und künftige Monate. Bei nutzungsabhängigen Produkten zählt auf beiden Seiten die feste Gebühr. | MRR (Periodenende) − Accounted MRR = Σ Ursachen | `v2` |

### Zahlungen

| `id` | Kennzahl | Definition | Formel | Seit |
| - | - | - | - | - |
| `cash_collected` | Zahlungseingang | Im Monat eingegangene Zahlungen, aufgeteilt nach der Rechnung, die sie bezahlen, und zurückgekommene Erstattungen. | Σ Zahlungen nach Zahldatum = für Rechnungen des Monats + für Rechnungen anderer Monate + ohne Rechnung + Erstattung zurückgekommen | `v4` |
| `cash_collected_this_month` | Zahlungseingang für Rechnungen des Monats | Zahlungen im Monat für Rechnungen, die im selben Monat abgeschlossen wurden. | Σ Zahlungen nach Zahldatum, Rechnungsmonat = Zahlmonat | |
| `cash_collected_other_months` | Zahlungseingang für Rechnungen anderer Monate | Zahlungen im Monat für Rechnungen aus anderen Monaten, meist früheren. | Σ Zahlungen nach Zahldatum, Rechnungsmonat ≠ Zahlmonat | |
| `cash_collected_unassigned` | Zahlungseingang ohne Rechnung | Zahlungen im Monat für Guthaben-Aufladungen und Vorauszahlungen vor dem Rechnungsabschluss, dazu der Betrag über dem Bruttobetrag einer überzahlten Rechnung. | Σ Zahlungen ohne Rechnung + Σ Überzahlungen | |
| `cash_collected_refund_returned` | Erstattung zurückgekommen | Im Monat zurückgekommene Erstattungen: eine negative Erstattung, die vom Bankkonto zugeordnet wurde. Teil des Zahlungseingangs. | Σ zurückgekommene Erstattungen nach Zahldatum | `v4` |
| `cash_refunded` | Zahlungsausgang | Im Monat abgeflossenes Geld nach Zahldatum: Erstattungen, Rücklastschriften, Auszahlungen von Kundenguthaben und Rücklastschrift-Gebühren. | Σ Geldabflüsse nach Zahldatum = Erstattungen + Rücklastschriften + Auszahlungen + Rücklastschrift-Gebühren | `v5` |
| `cash_refunded_refund` | Erstattungen | Im Monat ausgezahlte Erstattungen an Kunden, z. B. nach einer Gutschrift, und vom Bankkonto zugeordnete negative Zahlungen ohne Rücklastschrift. Eine negative Erstattung zählt vom Bankkonto unter „Erstattung zurückgekommen“, von Hand erfasst unter „Korrekturen“. | Σ Erstattungen mit positivem Betrag + Σ vom Bankkonto zugeordnete negative Zahlungen ohne Nachweis, nach Zahldatum | `v4` |
| `cash_refunded_chargeback` | Rücklastschriften und Chargebacks | Im Monat zurückgebuchte Zahlungen mit Nachweis (Rücklastschrift-Fall oder Chargeback des Zahlungsanbieters), am Tag der Rückbuchung: SEPA-Rücklastschriften und Kartenrückbuchungen. Eine negative Lastschrift-Zahlung ohne Rücklastschrift-Fall zählt mit dem eingezogenen Betrag, wenn sie einer eingezogenen Zahlung plus Bankgebühr bis 15,00 entspricht. | Σ Rückbuchungen mit Nachweis + Σ eingezogene Beträge der Lastschrift-Rückbuchungen mit Gebühr, nach Rückbuchungsdatum | `v5` |
| `cash_refunded_payout` | Auszahlungen | Im Monat an Kunden ausgezahlte Guthaben, am Tag der Ausführung. | Σ Auszahlungen von Kundenguthaben nach Ausführungsdatum | |
| `cash_refunded_return_fee` | Rücklastschrift-Gebühren | Bankgebühren von Rücklastschriften ohne Rücklastschrift-Fall, am Tag der Rückbuchung: der Teil einer negativen Lastschrift-Zahlung über der eingezogenen Zahlung. Die Gebühr zählt im Zahlungsausgang, die Rechnung wird um den eingezogenen Betrag wieder offen. | Σ (negative Lastschrift-Zahlung − eingezogene Zahlung) nach Rückbuchungsdatum | `v5` |
| `cash_corrections` | Korrekturen | Von Hand erfasste Zahlungen und Erstattungen, die mit einer Gegenbuchung über denselben Betrag storniert wurden. Eigene Zeile neben Zahlungseingang und Zahlungsausgang. Über einen Zeitraum mit beiden Buchungen 0. | storniert + Gegenbuchung | `v4` |
| `cash_corrections_reversed` | Storniert | Die stornierten Zahlungen und Erstattungen der Korrekturen, im Monat ihres Zahldatums. | Σ stornierte Buchungen nach Zahldatum | `v4` |
| `cash_corrections_counter` | Gegenbuchung | Die Gegenbuchungen der Korrekturen, negativ, im Monat ihres Zahldatums. | Σ Gegenbuchungen nach Zahldatum | `v4` |
| `cash_net` | Netto-Cash | Zahlungseingang abzüglich Zahlungsausgang. | Zahlungseingang − Zahlungsausgang | `v3` |
| `average_per_month` | Durchschnitt je Monat | Durchschnitt über die Monate des Zeitraums mit einem Wert: Zahlungen bis zum aktuellen Monat, Rechnungsprognose ab dem aktuellen Monat. Auf den Cent gerundet. | Σ Werte / Anzahl Monate mit Wert | |

### Forderungen und Prognose

| `id` | Kennzahl | Definition | Formel | Seit |
| - | - | - | - | - |
| `billed_net` | Rechnungsbetrag netto | Nettobetrag der im Monat abgeschlossenen Rechnungen. Gutschriften und Stornos mindern den Rechnungsbetrag nach Gutschriften im Monat der Rechnung, auf die sie sich beziehen, und den Umsatz im Monat ihrer Ausstellung. | Σ Netto der Rechnungen des Monats | `v2` |
| `status_total` | Summe Status | Summe der Status-Zeilen der im Monat abgeschlossenen Rechnungen. Sie entspricht dem Rechnungsbetrag brutto. | Bezahlt + Verrechnet + Offen + Überfällig + Gutgeschrieben + Abgeschrieben = Rechnungsbetrag brutto | |
| `billed_after_credits` | Rechnungsbetrag nach Gutschriften und Stornos | Bruttobetrag der im Monat abgeschlossenen Rechnungen abzüglich späterer Gutschriften und Stornos zu diesen Rechnungen. Gutschriften ohne Rechnungsbezug zählen im Monat der Gutschrift. | Rechnungsbetrag brutto − Gutgeschrieben − Gutschriften ohne Rechnungsbezug | |
| `cash_in_for_month` | Bezahlt bis heute (Rechnungen dieses Monats) | Zahlungen zu den Rechnungen dieses Monats mit jedem Zahldatum bis heute. Der Monat richtet sich nach dem Rechnungsdatum. | Σ Zahlungen zu Rechnungen des Monats, jedes Zahldatum bis heute | `v3` |
| `receivables_eop` | Offene Forderungen (Periodenende) | Offener Bruttobetrag abgeschlossener Rechnungen am Monatsende. Je Rechnung zählt ein positiver offener Betrag. Eine Gutschrift zur Rechnung mindert den offenen Betrag auch vor der Verrechnung. Bei einer Rücklastschrift wird der eingezogene Betrag wieder offen, die Bankgebühr zählt im Zahlungsausgang. Ein zurückgebuchtes Guthaben zählt als offen, auch bei unveränderter Zahlungsaufforderung. | Σ max(0, Brutto − Zahlungen − Verrechnungen − nicht verrechnete Gutschriften) | `v5` |
| `receivables_forward` | Offene Forderungen, Prognose (Stand heute) | Für Monate nach dem aktuellen werden die heute offenen Rechnungen mit ihrem heutigen offenen Betrag fortgeschrieben. | offener Betrag heute, je Monatsende | |
| `receivables_overdue_eop` | Überfällig zum Monatsende | Teil der offenen Forderungen, dessen Fälligkeit vor dem letzten Tag des Monats liegt. Der Rest wird am letzten Tag des Monats oder später fällig. Gilt auch für den laufenden Monat: eine am 20. fällige Rechnung zählt schon am 5. als überfällig zum Monatsende. Überfällig heute zeigt die Altersstruktur. | Σ offener Betrag, wenn Fälligkeit \< letzter Tag des Monats | |
| `owed_to_customers` | Guthaben an Kunden | Gutschriften und Überzahlungen am Monatsende bis zur Erstattung, Anrechnung oder Auszahlung. Eine Gutschrift auf dem Kundenguthaben zählt mit, bis das Guthaben angerechnet oder ausgezahlt ist. Eine Überzahlung zählt bis zum Übertrag auf das Kundenguthaben. Rechnungen mit negativem Betrag zählen bis zur Auszahlung. Steht getrennt von den offenen Forderungen. | Σ max(0, Zahlungen − Erstattungen + Verrechnungen + Gutschriften − Brutto − angerechnetes oder ausgezahltes Kundenguthaben aus Gutschriften) je Rechnung am Monatsende | `v6` |
| `cash_forecast` | Rechnungsprognose (brutto) | Erwartete Rechnungen nach Rechnungsdatum aus der Abrechnungsprognose, je Rechnung mit Abrechnungszeitraum. Offene Abrechnungspositionen früherer Zeiträume stellt der nächste Lauf in eine Rechnung. Eine Gutschrift zählt nur mit offener Gutschriftsposition. | Σ Brutto der erwarteten Rechnungen mit Rechnungsdatum im Monat | `v2` |
| `invoice_forecast_net` | Rechnungsprognose (netto) | Erwartete Rechnungen nach Rechnungsdatum aus der Abrechnungsprognose, netto, je Rechnung mit Abrechnungszeitraum. Offene Abrechnungspositionen früherer Zeiträume stellt der nächste Lauf in eine Rechnung. Eine Gutschrift zählt nur mit offener Gutschriftsposition. | Σ Netto der erwarteten Rechnungen mit Rechnungsdatum im Zeitraum | `v2` |
| `dso_3m` | DSO 3 Monate | Offene Forderungen am Monatsende in Tagen Rechnungsbetrag brutto der letzten drei Monate. Tage zählen erst ab dem ersten Rechnungsmonat, im laufenden Monat nur bis heute. | Forderungen / Rechnungsbetrag brutto(3 Monate) × Tage mit Rechnungen(3 Monate) | `v2` |
| `dso_12m` | DSO 12 Monate | Offene Forderungen am Monatsende in Tagen Rechnungsbetrag brutto der letzten zwölf Monate. Tage zählen erst ab dem ersten Rechnungsmonat, im laufenden Monat nur bis heute. | Forderungen / Rechnungsbetrag brutto(12 Monate) × Tage mit Rechnungen(12 Monate) | `v2` |
| `days_to_payment` | Tage bis Zahlung | Kalendertage vom Rechnungsabschluss bis zur vollständigen Zahlung. | Zahldatum − Abschlussdatum | |
| `paid_within_term` | Innerhalb des Zahlungsziels | Anteil der bezahlten Rechnungen mit Fälligkeit, die spätestens am Fälligkeitstag bezahlt wurden. | bezahlt bis Fälligkeit / bezahlt mit Fälligkeit | |

## Glossar

> **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](https://docs.fynn.eu/v2-finance-api/drill-downs.md).

> **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](https://docs.fynn.eu/v2-finance-api/datasets.md).

> **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)**
>
> 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](https://docs.fynn.eu/v2-finance-api/concepts.md).

> **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)**
>
> 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](https://docs.fynn.eu/v2-finance-api/concepts.md#hinweise).

> **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](https://docs.fynn.eu/v2-finance-api/snapshots.md).

> **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**
>
> 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**
>
> 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.