Upgrade während der Laufzeit

Im Subscription-Geschäft ist es ein gewünschtes Szenario, dass Kunden während einer laufenden Vertragsperiode in einen höheren Tarif wechseln (Upgrade) oder zusätzliche Kapazitäten hinzubuchen.

In tebio haben Sie zwei grundlegende kaufmännische Werkzeuge, um ein solches Upgrade durchzuführen: den Produktwechsel (Product Change) und den Optionswechsel (Option Alternate). Beide Vorgänge können entweder sofort wirksam werden oder für einen zukünftigen Zeitpunkt geplant (scheduled) werden.

Dieser Use Case Artikel erklärt die Unterschiede und zeigt, wie Sie Upgrades durchführen.

1. Die zwei Wege für ein Upgrade

Entscheiden Sie zunächst, auf welcher Ebene das Upgrade stattfinden soll.

A. Produktwechsel (Product Change)

Ein Produktwechsel verändert den Basistarif des Kunden (z. B. von “Basic Software” auf “Pro Software”).

• Technisches Verhalten: Ein Produktwechsel ist ein tiefer Eingriff. Das System deaktiviert (storniert) technisch gesehen die alte Subscription und erstellt eine völlig neue Subscription mit dem neuen Produkt.
• Folge: Die Subscription-UUID ändert sich. Externe Systeme (wie ERP oder Provisioning) müssen über Webhooks darauf vorbereitet sein, die neue Referenz zu verarbeiten.
• Voraussetzung: Ein Produktwechsel ist nur möglich, wenn das Produktmanagement eine entsprechende “Route” vom Quell- zum Zielprodukt freigegeben hat (siehe Produktwechsel konfigurieren).

B. Optionswechsel (Option Alternate)

Ein Optionswechsel verändert nur eine bestimmte Zusatzleistung innerhalb des bestehenden Basistarifs (z. B. ein Upgrade von “10 GB Cloud-Speicher” auf “50 GB Cloud-Speicher”).

• Technisches Verhalten: Die Haupt-Subscription bleibt bestehen. Lediglich die Instanz der Option wird ausgetauscht.
• Folge: Die Subscription-UUID bleibt unverändert.
• Voraussetzung: Die neue Option muss dem bestehenden Hauptprodukt zugeordnet sein und der Kunde darf nicht durch Restriktionen (z. B. Limitierung auf 1 Speicher-Option) blockiert sein.

2. Der Zeitpunkt: Sofort vs. Geplant

Unabhängig davon, ob Sie das Produkt oder eine Option wechseln, bietet tebio Ihnen bei der Ausführung die Wahl des Zeitpunkts.

Sofortiges Upgrade (Immediate)

Das Upgrade greift in der gleichen Sekunde.

• Der Zugang zum neuen Tarif oder zur neuen Option steht dem Kunden sofort zur Verfügung.
• Kaufmännische Auswirkung: Wenn das Produkt im Voraus abgerechnet wird (IN_ADVANCE) und die Proration-Regeln (prorataStart / prorataEnd) aktiv sind, erzeugt das System automatisch eine Proration (anteilige Abrechnung). Der Kunde erhält eine Gutschrift für die nicht genutzte Zeit des alten Tarifs und zahlt anteilig den neuen, teureren Tarif.

Geplantes Upgrade (Scheduled)

Sie können das Upgrade auf ein spezifisches Zukunftsdatum oder an das Ende der aktuellen Serviceperiode (Bill Cycle) legen.

• Der Vorgang wird in die Warteschlange (Event Queue) des Systems gelegt.
• Zum Stichtag führt das System den Wechsel vollautomatisch durch.
• Vorteil: Es entsteht keine komplexe, anteilige Proration, da das Upgrade exakt zum neuen Abrechnungsmonat greift. Die Rechnungen bleiben glatt und übersichtlich.
• Stornierbar: Geplante Wechsel können jederzeit vor Erreichen des Stichtags widerrufen werden.

3. Workflow: So führen Sie ein Upgrade durch

Variante A: Produktwechsel im Portal durchführen

1. Öffnen Sie die Kundenakte und wählen Sie den Reiter Subscriptions.
2. Klicken Sie bei der aktiven Subscription auf den Button Aktion und wählen Sie Produkt wechseln.
3. Wählen Sie im folgenden Dialog das Zielprodukt aus (es werden nur erlaubte Produkte angezeigt).
4. Entscheidend: Wählen Sie aus, ob der Wechsel sofort oder geplant (z. B. zum Laufzeitende) erfolgen soll.
5. Bestätigen Sie den Wechsel.

Variante B: Optionswechsel im Portal durchführen

1. Öffnen Sie die Detailansicht der Subscription (Klick auf die Abo-Nummer).
2. Gehen Sie auf den Button Abo verwalten (oder im Tab “Zugeordnete Optionen”).
3. Wählen Sie bei der bestehenden Option (z. B. “10 GB Speicher”) die Funktion zum Bearbeiten/Wechseln.
4. Wählen Sie die höhere Ziel-Option.
5. Auch hier definieren Sie, ob der Wechsel sofort oder geplant (Scheduled) ausgeführt wird.

4. API-Hinweise für geplante Upgrades

Wenn Sie ein eigenes Frontend (Self-Care-Portal) anbinden, in dem Kunden ihre Tarife selbst upgraden können, nutzen Sie folgende REST-Endpunkte:

Endpunkt	Methode	Beschreibung
/v1/subscription/{uuid}/product-change	POST	Produktwechsel durchführen (Parameter für sofort oder geplantes Datum übergeben)
/v1/subscription/{uuid}/option-instance/{optionInstanceUuid}/alternate	POST	Optionswechsel durchführen
/v1/subscription/{sourceSubscriptionUuid}/cancel-productchange	POST	Einen geplanten Produktwechsel wieder abbrechen, bevor er aktiv wird
/v1/subscription/{subscriptionUuid}/rescind-scheduled-option-change	POST	Einen geplanten Optionswechsel widerrufen

Tipp für Entwickler: Achten Sie bei product-change darauf, ob Ihr lokales System die neu generierte Subscription-UUID aus der API-Response oder dem Webhook aufnimmt!

---

Verwandte Themen:

• Produktwechsel konfigurieren
• Subscription bearbeiten
• Option buchen / wechseln
• Proration