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

# Abonnement-Übergänge

> Wechsle Produkte und Preispläne in einem Abonnement mit automatischer Proration und Gutschriften.

Mit Abonnement-Übergängen kannst du die Produkte und Preispläne eines bestehenden Abonnements ändern - z.B. für Upgrades, Downgrades oder Produktwechsel. Die Änderungen werden sauber verarbeitet mit automatischer Berechnung von Gutschriften und anteiliger Abrechnung.

<Warning>
  Gekündigte Abonnements können nicht mehr transitioniert werden. Der Übergangszeitpunkt muss in der Zukunft oder jetzt sein.
</Warning>

## Anwendungsfälle

| Szenario           | Beschreibung                                                |
| ------------------ | ----------------------------------------------------------- |
| **Upgrade**        | Kunde wechselt von Basic auf Pro Plan                       |
| **Downgrade**      | Kunde wechselt auf einen günstigeren Plan                   |
| **Produktwechsel** | Wechsel von einem Produkt zu einem anderen                  |
| **Planänderung**   | Gleiche Produkte, aber andere Preispläne                    |
| **Migration**      | Umstellung von nutzungsbasiert auf Festpreis oder umgekehrt |

***

## So funktioniert es

Ein Übergang führt folgende Schritte aus:

1. **Alte Items beenden** - Bestehende Abonnement-Items werden zum Übergangszeitpunkt beendet
2. **Gutschriften erstellen** - Optional werden Gutschriften für nicht genutzte Zeit erstellt
3. **Neue Items anlegen** - Die gewünschten Produkte werden als neue Items hinzugefügt
4. **Phase wechseln** - Eine neue Abonnement-Phase beginnt

***

## Proration (Gutschriften)

Bei der Beendigung von Festpreis-Produkten kannst du wählen, wie Gutschriften berechnet werden:

| Option                          | Beschreibung                                 |
| ------------------------------- | -------------------------------------------- |
| **Anteilig** (`creditProrated`) | Gutschrift basierend auf verbleibenden Tagen |
| **Keine** (`none`)              | Keine Gutschrift                             |

<Tip>
  Die Gutschrift wird sofort finalisiert und an den Kunden gesendet. Der Guthabenbetrag wird automatisch mit der nächsten Rechnung verrechnet.
</Tip>

<Note>
  Bei nutzungsbasierten Produkten werden **keine Gutschriften** erstellt, da diese im Nachhinein abgerechnet werden. Stattdessen wird die Nutzung bis zum Übergangszeitpunkt mit dem alten Preisplan abgerechnet.
</Note>

***

## Abrechnungszeitpunkt

Du kannst festlegen, wann die neuen Items abgerechnet werden:

| Option                         | Beschreibung                                                                                                                              |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Phasenstart** (`phaseStart`) | Rechnung wird zum Übergangszeitpunkt erstellt. Teilperioden von nutzungsbasierten Items werden ebenfalls zu diesem Zeitpunkt abgerechnet. |
| **Sofort** (`immediately`)     | Rechnung wird sofort erstellt. Teilperioden von nutzungsbasierten Items werden ebenfalls sofort abgerechnet.                              |

***

## Nutzungsbasierte Produkte

Bei nutzungsbasierten Produkten gibt es besondere Regeln:

### Keine Gutschriften

Nutzungsbasierte Produkte werden **nie** gutgeschrieben, da sie im Nachhinein abgerechnet werden. Die Proration-Einstellung wird ignoriert.

### Teilperioden-Abrechnung

Wenn ein nutzungsbasiertes Item beendet wird, erstellt das System automatisch Abrechnungsposten für die Teilperiode:

* **Zeitraum**: Letzte Abrechnung → Übergangszeitpunkt
* **Preis**: Alter Preisplan
* **Inklusiveinheiten**: Werden anteilig berechnet

**Beispiel:**

* Letzter Abrechnungszeitpunkt: 1. Februar
* Übergangszeitpunkt: 15. Februar
* Die Nutzung vom 1.-15. Februar wird mit dem alten Preisplan abgerechnet
* Ab 15. Februar gilt der neue Preisplan

### Wechsel zwischen Produkttypen

| Von             | Nach            | Gutschrift    | Teilperiode |
| --------------- | --------------- | ------------- | ----------- |
| Festpreis       | Festpreis       | Ja (optional) | Nein        |
| Festpreis       | Nutzungsbasiert | Ja (optional) | Nein        |
| Nutzungsbasiert | Festpreis       | Nein          | Ja          |
| Nutzungsbasiert | Nutzungsbasiert | Nein          | Ja          |

***

## API

Für Übergänge steht folgender API-Endpoint zur Verfügung:

| Method | Endpoint                             | Beschreibung         |
| ------ | ------------------------------------ | -------------------- |
| POST   | `/api/subscriptions/[id]/transition` | Übergang durchführen |

<Card title="API Referenz" icon="code" href="/api-reference/subscription/transition">
  Vollständige API-Dokumentation mit Request/Response-Strukturen und Beispielen
</Card>

***

## Verwandte Dokumentation

<CardGroup cols={2}>
  <Card title="Abonnements verwalten" icon="repeat" href="/guide/subscriptions/introduction">
    Grundlagen zu Abonnements
  </Card>

  <Card title="Nutzungsmetriken" icon="chart-line" href="/guide/catalogue/measurements/billable-metrics">
    Nutzungsbasierte Abrechnung konfigurieren
  </Card>
</CardGroup>