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.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.
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:- Alte Items beenden - Bestehende Abonnement-Items werden zum Übergangszeitpunkt beendet
- Gutschriften erstellen - Optional werden Gutschriften für nicht genutzte Zeit erstellt
- Neue Items anlegen - Die gewünschten Produkte werden als neue Items hinzugefügt
- 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 |
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.
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
- 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 |
API Referenz
Vollständige API-Dokumentation mit Request/Response-Strukturen und Beispielen
Verwandte Dokumentation
Abonnements verwalten
Grundlagen zu Abonnements
Nutzungsmetriken
Nutzungsbasierte Abrechnung konfigurieren