Zum Hauptinhalt springen
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.
Gekündigte Abonnements können nicht mehr transitioniert werden. Der Übergangszeitpunkt muss in der Zukunft oder jetzt sein.

​
Anwendungsfälle

SzenarioBeschreibung
UpgradeKunde wechselt von Basic auf Pro Plan
DowngradeKunde wechselt auf einen günstigeren Plan
ProduktwechselWechsel von einem Produkt zu einem anderen
PlanänderungGleiche Produkte, aber andere Preispläne
MigrationUmstellung 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:
OptionBeschreibung
Anteilig (creditProrated)Gutschrift basierend auf verbleibenden Tagen
Keine (none)Keine Gutschrift
Die Gutschrift wird sofort finalisiert und an den Kunden gesendet. Der Guthabenbetrag wird automatisch mit der nächsten Rechnung verrechnet.
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:
OptionBeschreibung
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

VonNachGutschriftTeilperiode
FestpreisFestpreisJa (optional)Nein
FestpreisNutzungsbasiertJa (optional)Nein
NutzungsbasiertFestpreisNeinJa
NutzungsbasiertNutzungsbasiertNeinJa

​
API

Für Übergänge steht folgender API-Endpoint zur Verfügung:
MethodEndpointBeschreibung
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