Abos
Überblick
Abos führen verkaufte Abonnements und Lizenzen entlang ihres Lebenszyklus — vom Abschluss über Verlängerungen bis zum Auslaufen. Die unbefristete Kauflizenz läuft als Laufzeit „unbefristet" in derselben Liste mit.
Sie sind die dritte Quelle wiederkehrender Erlöse neben Verträgen und Pauschalen und speisen wie diese die Abrechnung.
Kernaufgaben
Abo abschließen. Kunde, Umfang und Laufzeit.
Lebenszyklus führen. Testphase starten, aktivieren, verlängern, Plan wechseln, pausieren und fortsetzen, aussetzen, kündigen, auslaufen lassen — der Statuskatalog steht in den Abo-Einstellungen. Eine Testphase gibt Zugang ohne Erlös; mit automatischer Verlängerung wird daraus am Ende eine bezahlte Lizenz. Eine Pause sperrt den Zugang, die Abrechnung ruht, die Laufzeit verlängert sich um die Pause.
Zahlungsverzug. Ab der eingestellten Mahnstufe wird ein Abo überfällig; nach Ablauf der Karenzfrist setzt der Tageslauf es aus. Ein Zahlungseingang reaktiviert es.
Schlüssel vergeben. Schlüssel erzeugen vergibt einen eindeutigen Schlüssel mit dem Präfix aus den Einstellungen. Ist die Freigabe gesetzt, sieht der Kunde Lizenz und Schlüssel im Kundenportal — jeder Abruf wird protokolliert.
Verbrauch abrechnen. Je Leistungsmerkmal lässt sich ein Preis für die Menge über dem Limit hinterlegen; gemeldeter Verbrauch darüber wird mit der nächsten Abrechnung berechnet.
Shopware abgleichen. Der Abruf aus dem Shopware-Account schreibt nie still in den Bestand: Jede Abweichung erscheint in den Abo-Einstellungen als Vorschlag zum Übernehmen oder Ignorieren.
Mit einem externen Lizenzserver abgleichen. Prüft Ihre Software Schlüssel bei einem eigenen Lizenzserver (Keygen, Cryptlex oder ein eigener Dienst), liest Octibiz dessen Aktivierungen — Octibiz betreibt selbst keinen Aktivierungsserver. Der Abgleich ordnet je Lizenzschlüssel zu und schreibt an die Lizenz Zahl und Stand der Aktivierungen samt Zeitpunkt; das Detail zeigt sie als Aktivierungen (Lizenzserver), z. B. „7 / 5 · aktiv · mehr als lizenziert". Der Bericht des Laufs nennt Überbelegungen (mehr Aktivierungen als Plätze), Schlüssel, die der Server als gesperrt oder abgelaufen führt, während die Lizenz läuft, Schlüssel ohne Lizenz in Octibiz und laufende Lizenzen, die der Server nicht kennt (Stand dort unbekannt — nur bei vollständiger Liste). Plätze und Status der Lizenz ändert der Abgleich nicht — die Entscheidung bleibt bei Ihnen. Der Lauf startet täglich um 03:30 und über Lizenzserver abgleichen in den Abo-Einstellungen sofort.
Erlöse sehen. Die Erlössicht ist ein eigenes Recht: Wer Abos verwaltet, sieht deshalb nicht automatisch, was sie einbringen. Über der Liste stehen MRR, Net-Revenue-Retention und Churn, darunter der Erlös je Produkt und je Variante: je Variante der laufende MRR, die Zahl der Abos, die Veränderung im Betrachtungsfenster und der Abgang durch Kündigung oder Ablauf. Wechselt ein Abo die Variante, zählt das als Abgang bei der alten und als Zugang bei der neuen Variante; Abos ohne Variante stehen unter Basisvariante.
Kündigungsrisiko und Upsell-Chancen erkennen. Die Karte Kündigungsrisiko & Upsell am Abo zeigt je Richtung eine Stufe (keins, niedrig, mittel, hoch) und die Signale dahinter: vorgemerkte Kündigung, Zahlungsverzug, ausgesetzt oder pausiert, Ende ohne Verlängerung in den nächsten 60 Tagen, Herabstufung im letzten halben Jahr und geringe Nutzung eines Kontingents sprechen für ein Risiko; ein Kontingent ab 80 % oder darüber, eine bald endende Testphase und ein Monatsabo seit mindestens sechs Monaten (Jahreslaufzeit anbieten) für eine Upsell-Chance. KI-Einschätzung lässt die KI diese Signale gewichten und eine kurze Empfehlung formulieren — sie erfindet nichts hinzu; ist die KI abgeschaltet, bleibt es bei der Einschätzung nach Regeln. Die Liste zeigt Abos ab Stufe mittel mit einem Hinweis und filtert unter Hinweis nach Kündigungsrisiko oder Upsell-Chance (Stand des nächtlichen Laufs). Steigt eine Stufe auf hoch, löst das einmal den Automations-Auslöser Kündigungsrisiko oder Upsell-Chance hoch (LicenseInsightRaised) aus — etwa für eine Aufgabe an den Kundenbetreuer. Recht: products.revenue.view. Die genannten Werte sind Vorgaben: Unter Abo-Einstellungen → Kündigungsrisiko & Upsell stellen Sie ein, ab wann ein Abo einen Hinweis bekommt — Laufzeitende ohne Verlängerung (Vorgabe 60 Tage), Kontingent nahe am Limit ab (80 %), Geringe Nutzung unter (25 %), Geringe Nutzung zählt ab Laufzeit (30 Tage — vorher löst wenig Verbrauch nichts aus), Testphase endet in (14 Tage), Jahreslaufzeit anbieten nach (6 Monate) und Herabstufung zählt (180 Tage). Eine Änderung wirkt sofort auf die Karte am Abo und ab dem nächsten nächtlichen Lauf auf Liste und Auslöser.
Lebenszyklus jetzt ausführen. Jede Nacht um 02:00 verlängert das System fällige Abos, verschickt Vorwarnungen, schließt Kündigungen ab, lässt Abgelaufenes ablaufen, sperrt nach der Karenz, beendet Testphasen und Pausen und bewertet Kündigungsrisiko und Upsell-Chance. Lebenszyklus jetzt ausführen in den Abo-Einstellungen zieht diesen Lauf vor — gleich neben den Richtlinien (Karenz, Vorwarnung, Testphase), die er anwendet — und zeigt danach je Schritt, wie viele Abos betroffen waren. Recht: products.license.lifecycle.
Felder im Detail
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Kunde customerId | ja | bestehender Kunde | Wer die Lizenz hält. |
Artikel productId | ja | bestehender Artikel | Was lizenziert ist. |
Variante variantId bzw. variantUlid | nein | Variante des Artikels | Welche Ausführung — Edition, Ausbaustufe. |
Lizenzschlüssel licenseKey | nein | Text | Der Schlüssel, den der Kunde einsetzt. Leer gelassen bleibt die Lizenz ohne Schlüssel, bis ihn Schlüssel erzeugen vergibt. |
Vorhandenen Schlüssel ersetzen replaceKey | nein | Ja/Nein | Nur bei Schlüssel erzeugen: Ohne diese Bestätigung bleibt ein vorhandener Schlüssel stehen — ein neuer macht den alten ungültig. |
Schlüssel im Portal zeigen keyVisibleInPortal | nein | Ja/Nein | Ob der Kunde den Schlüssel im Portal sieht. Wirkt nur mit dem Portal-Recht „Lizenzen" am Zugang. |
Plätze seats | nein | Zahl, größer als 0 | Für wie viele Nutzer oder Geräte die Lizenz gilt. |
Laufzeit term | nein | monatlich, jährlich, unbefristet | Wie lange sie gilt. Unbefristet läuft nicht ab und wird nicht verlängert. |
Beginn startsAt | nein | Datum | Ab wann sie gilt. |
Automatisch verlängern autoRenew | nein | Ja/Nein | Ob sie sich am Ende erneuert. An heißt: Es entsteht eine neue Periode und damit eine Rechnung, ohne dass jemand handelt — der Grund, warum die Kündigungsfrist daneben wichtig ist. |
Kündigen zum cancelAt | nein | Datum | Wann die Lizenz enden soll. |
Sofort immediate | nein | Ja/Nein | Ob die Kündigung sofort wirkt statt zum Periodenende. Sofort heißt: Der Zugriff endet jetzt — mit allen Folgen für den Kunden. |
Marke brandId | nein | eine Ihrer Marken | Für welche Marke die Lizenz geführt wird. |
Dauer der Testphase trialDays | nein | Tage | Nur beim Start der Testphase; leer nimmt den Standard aus den Einstellungen. |
Pausieren bis pauseUntil | nein | Datum | Nur beim Pausieren; leer heißt offene Pause bis zum Fortsetzen. |
Leistungsmerkmal featureKey | nein | Schlüssel eines Merkmals | Bei Verbrauchsmeldung und Mehrmengen-Preis: welches Merkmal gemeint ist. |
Verbrauch usedAmount | nein | Zahl, 0 oder mehr | Der aktuelle Stand in der laufenden Periode. Abgerechnet wird nur der Zuwachs über dem Limit — eine wiederholte Meldung desselben Stands berechnet nichts doppelt. |
Mehrmengen-Preis overageUnitPriceAmount | nein | Betrag je Einheit | Was jede Einheit über dem Limit kostet. Leer schaltet die Abrechnung der Mehrmenge ab. |
Nur über Schnittstelle und Automation
| Feld | Werte / Format | Was es bewirkt |
|---|---|---|
currentVersionId | Kennung einer Version | Welche Programmversion die Lizenz abdeckt. |
sourceQuoteId | Kennung eines Angebots | Aus welchem angenommenen Angebot die Lizenz entstanden ist. |
Einstellungen & Rechte
- Modul
module.licensing. products.license.view,products.license.create,products.license.lifecyclefür
den Lebenszyklus, products.revenue.view für die Erlössicht, licensing.config.manage für Katalog, Regeln, Shopware- und Lizenzserver-Abgleich, products.license_key.manage zum Erzeugen von Schlüsseln, products.license_usage.report für Verbrauchsmeldungen.
- Abo-Regeln in den Abo-Einstellungen: Karenzfrist, Mahnstufe für „überfällig", Vorwarnung vor
der Verlängerung (geht an den Kundenbetreuer), Standard-Testphase und Schlüssel-Präfix.
- Kündigungsrisiko & Upsell in den Abo-Einstellungen: die sieben Schwellen der Hinweise (siehe oben).
Ändern dürfen beide Abschnitte nur Nutzer mit dem Recht, Systemeinstellungen zu verwalten (platform.settings.manage).
- Externer Lizenzserver: Integration vom Typ
license_server(Einstellungen → Integrationen,
abschaltbar über aktiv) mit base_url, optional activations_path (Vorgabe /activations), items_path (data), den Feldpfaden field_license_key, field_activations, field_status, field_last_seen (Punktschreibweise, z. B. attributes.key), Seiten pagination (page, link, none) mit page_param/per_page_param/per_page; das Zugangs-Token als token (verschlüsselt abgelegt), Kopfzeile über auth_header/auth_prefix (Vorgabe Authorization: Bearer). Schnittstelle POST /api/v1/licensing/license-server-sync; die Aktivierungs-Felder der Lizenz (activationCount, activationStatus, activationsCheckedAt) sind nur lesbar.
- Wiederkehrende Erlöse laufen über die Abrechnung.
FAQ & Fehlerbilder
Ein Abo wird weiter abgerechnet. Prüfen Sie ihren Status und den Plan in der Abrechnung.
Ich sehe keine Erlöse. Dann fehlt products.revenue.view — das ist Absicht, nicht ein Anzeigefehler.
Ein Abo lässt sich nicht verlängern. Dann fehlt products.license.lifecycle.
Abo oder Vertrag? Ein Abo berechtigt zur Nutzung eines Produkts und trägt MRR/ARR; ein Vertrag verpflichtet zu Leistungen — Retainer, Wartung, Hosting — und führt Kontingente. Wer Stunden oder Kontingente verbraucht, braucht den Vertrag.