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

# Abonnements

> Erstelle und verwalte deine Abonnements

Abonnements sind das Herzstück der wiederkehrenden Abrechnung in Fynn. Mit Abonnements kannst du flexible Abrechnungsmodelle für deine Kunden erstellen und verwalten.

<CardGroup cols={2}>
  <Card title="Abonnement erstellen" icon="plus" href="/guide/subscriptions/create">
    Erstelle neue Abonnements mit Produkten, Preisen und individuellen Laufzeiten.
  </Card>

  <Card title="Abonnement aktivieren" icon="bolt" href="/guide/subscriptions/activate">
    Aktiviere Abonnements und wähle Positionen und Abrechnungsstart aus.
  </Card>

  <Card title="Abonnement kündigen" icon="xmark" href="/guide/subscriptions/cancel">
    Kündige Abonnements und verwalte Kündigungsfristen.
  </Card>

  <Card title="Abonnement pausieren" icon="pause" href="/guide/subscriptions/pause">
    Pausiere Abonnements vorübergehend und setze sie fort.
  </Card>

  <Card title="Abrechnungsgruppen" icon="layer-group" href="/guide/subscriptions/billing-groups">
    Fasse mehrere Abonnements zu einer gemeinsamen Rechnung zusammen.
  </Card>
</CardGroup>

## Status-Übersicht

Jedes Abonnement durchläuft einen definierten Lebenszyklus. Der aktuelle Status bestimmt, ob und wie ein Abonnement abgerechnet wird.

| Status       | Bedeutung                                                                                                                                                |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `draft`      | Entwurf: Das Abonnement ist noch nicht aktiv und wird nicht abgerechnet.                                                                                 |
| `active`     | Aktiv: Das Abonnement wird regulär abgerechnet.                                                                                                          |
| `paused`     | Pausiert: Die Abrechnung ist vorübergehend ausgesetzt.                                                                                                   |
| `cancelled`  | Gekündigt: Die Kündigung wurde eingeleitet. Die Abrechnung läuft bis zum Kündigungsdatum weiter, danach wechselt der Status automatisch zu `terminated`. |
| `terminated` | Beendet: Endgültig beendet, keine weitere Abrechnung. Wird automatisch gesetzt, wenn das Kündigungsdatum oder Vertragsende erreicht ist.                 |
| `voided`     | Storniert: Das Abonnement wird aus allen Statistiken entfernt. Dies ist der stärkste "Lösch"-Status.                                                     |

### Cancelled vs. Terminated

Diese beiden Status werden häufig verwechselt, unterscheiden sich aber grundlegend:

**Cancelled** bedeutet, dass eine Kündigung eingeleitet wurde. Das Abonnement wird bis zum Kündigungsdatum weiter abgerechnet.

* Wird über die API via `PUT /subscriptions/{id}/cancel` ausgelöst
* Solange das Kündigungsdatum in der Zukunft liegt, kann die Kündigung widerrufen werden (siehe [Kündigung widerrufen](/guide/subscriptions/cancel#kündigung-widerrufen))
* Nach Erreichen des Kündigungsdatums wechselt der Status automatisch zu `terminated`

**Terminated** bedeutet, dass das Abonnement endgültig beendet ist. Es erfolgt keine weitere Abrechnung.

* Wird automatisch vom System gesetzt, wenn das Kündigungsdatum oder Vertragsende erreicht ist
* Kann nicht rückgängig gemacht werden

### Kündigungsdatum

Bei der Kündigung wird ein Kündigungsdatum festgelegt. Bis zu diesem Datum läuft die Abrechnung weiter. Es gibt drei Optionen:

| Typ             | Bedeutung                              |
| --------------- | -------------------------------------- |
| `immediate`     | Sofort wirksam                         |
| `next_possible` | Zum Ende der laufenden Vertragsperiode |
| `custom`        | Zu einem frei gewählten Datum          |

Der Ablauf nach einer Kündigung:

1. Die Kündigung wird erfasst, der Status wechselt zu `cancelled` und das Kündigungsdatum wird gesetzt
2. Die Abrechnung läuft bis zum Kündigungsdatum weiter
3. Nach Erreichen des Kündigungsdatums wird der Status automatisch auf `terminated` gesetzt

<Info>
  Wenn du per API prüfen möchtest, ob ein Kunde aktiv gekündigt hat, ist `cancelled` der relevante Status. `terminated` zeigt lediglich an, dass das Abonnement endgültig beendet ist.
</Info>

## Total Contract Value (TCV)

Der Total Contract Value (TCV) ist der Gesamtwert eines Abonnements über die gesamte Erst-Vertragslaufzeit. Der TCV ist ein wichtiger Indikator für den Wert eines Abonnements und wird häufig zur Bewertung von Abonnements verwendet.

Der TCV wird berechnet, indem der wiederkehrende Umsatz eines Abonnements über die gesamte Erst-Vertragslaufzeit summiert wird. Zudem werden Einmal-Zahlungen und Rabatte berücksichtigt.

Beispiel:

Ein Abonnement hat einen monatlichen Preis von 100€ und eine Vertragslaufzeit von 12 Monaten. Der TCV beträgt somit 1.200€.
Wenn das Abonnement einen Rabatt von 10% auf die ersten 3 Monate erhält, beträgt der TCV 1.080€.
Wird innerhalb der 1. Vertragslaufzeit ein Einmal-Zahlung von 100€ hinzugefügt (bspw. durch Consulting) beträgt der TCV 1.180€.

Wird anschleßend innerhalb der 1. Vertragslaufzeit ein Upgrade auf ein höherwertiges Abonnement durchgeführt, wird der TCV entsprechend angepasst.

<Info>
  Sind in einem Abonnement mehrere Währungen enthalten, wird der TCV in der Standard-Währung des Tenants nach dem aktuell gültigen EZB-Wechselkurs berechnet.
</Info>