Abo-Produkt bearbeiten

Im tebio Business-Portal können Sie angelegte Abo-Produkte nachträglich anpassen.

Um ein Produkt zu bearbeiten, navigieren Sie zunächst in die Produktsuche. Klicken Sie dort auf das gewünschte Produkt, um in die Detailansicht des Produkts zu gelangen.

Klicken Sie in der Detailansicht unten links auf den Button Produkt bearbeiten, um das Formular zu öffnen.

Eingefrorene Felder nach Verkaufsstart

tebio schützt laufende Subscriptions vor strukturellen Widersprüchen. Daher gilt eine wichtige Grundregel:

Hinweis

Sobald ein Produkt als verkäuflich gilt (das Datum Verkäuflich von liegt in der Vergangenheit oder wurde auf “Sofort” gesetzt), werden alle grundlegenden Abrechnungs- und Laufzeitparameter unwiderruflich gesperrt.

Folgende Felder können bei einem aktiven Produkt nicht mehr geändert werden:

• Laufzeiten: Mindestlaufzeit, Verlängerungszeitraum, Kündigungsfrist.
• Abrechnung: Zahlungsstrategie (Prepaid/Postpaid), Abrechnungsart (vorab/nachträglich), Rechnungszyklus (inkl. Starttag/Startmonat).
• Zahlungsarten: Bestehende erlaubte Zahlungsmethoden können nicht mehr entfernt werden (Neue Zahlungsmethoden können jedoch hinzugefügt werden).
• Externe Produkt-Referenz
• Datumsfelder: Gültig von, Verkäuflich von.

In der Benutzeroberfläche erkennen Sie diese gesperrten Felder daran, dass sie ausgegraut sind.

Strukturelle Änderungen

Wenn Sie fundamentale Änderungen an einem aktiven Produkt vornehmen müssen (z. B. Wechsel des Rechnungszyklus), navigieren Sie zum Ende der Seite, setzen Sie über Verkäuflich bis ein Enddatum für den Verkauf und erstellen Sie stattdessen ein neues Produkt mit den gewünschten Parametern.

Was bleibt bearbeitbar?

Viele Stammdaten, Inhalte und Preisinformationen lassen sich weiterhin anpassen:

1. Stammdaten und Medien: Name, Beschreibung, Übersetzungen, Produktbild.
2. Pausierungsregeln: Sie können das Pausieren des Abos nachträglich erlauben oder Limits (minimale und maximale Pausendauer) justieren.
3. Eigenschaften: Benutzerdefinierte Eigenschaften (Custom Properties) sind jederzeit modifizierbar.
4. Hosted Page: URL, AGB/Datenschutz-Dokumente und die Weiterleitungs-URL können jederzeit geändert werden.

Voraussetzungen

• Sie benötigen die erforderlichen Berechtigungen im Business-Portal für diesen Vorgang.

Schritt-für-Schritt-Anleitung

Preisänderungen durchführen

Preise können auch im laufenden Betrieb geändert werden. Das Formular bietet Ihnen hierfür am Ende des Abrechnungsblocks erweiterte Funktionen:

Datum des Inkrafttretens der Preisänderung

• Sofort: Die neuen Preise (wiederkehrende Gebühr, Einrichtungsgebühr und Kündigungsgebühr) gelten ab dem Moment des Speicherns für alle neuen Vertragsabschlüsse.
• Später (Datum in der Zukunft): Sie können eine Preiserhöhung oder Preissenkung für ein bestimmtes Datum terminieren.

Konflikte mit bereits geplanten Preisänderungen Sollten Sie in der Vergangenheit bereits künftige Preisänderungen für dieses Produkt eingeplant haben, können Sie durch das Setzen des Häkchens “Im Konflikt stehende Preisänderungen invalidieren” sicherstellen, dass Ihre jetzige, aktuelle Änderung Vorrang hat und ältere Entwürfe invalidiert.

Produktverkauf stoppen (Enddatum setzen)

Wenn Sie den Verkauf eines Produkts einstellen möchten, können Sie im untersten Block (“Das Produkt ist gültig/verkäuflich ab”) über den Link + Enddatum hinzufügen ein Ablaufdatum festlegen.

• Verkäuflich bis: Ab diesem Stichtag kann das Produkt nicht mehr von neuen Kunden gebucht werden (es wird in Checkouts nicht mehr angeboten). Bestehende Abonnements laufen jedoch weiter.
• Gültig bis: Ab diesem Stichtag verliert das Produkt generell seine Gültigkeit. (Dies kann für Auswertungen und Lifecycle-Management relevant sein).

Ergebnis

Die Änderungen werden gespeichert. Je nach Art der Änderung gelten sie sofort oder ab dem festgelegten Datum.

API-Hinweise

Wenn Sie Produktdaten programmatisch aus Drittsystemen (wie einem ERP) aktualisieren möchten, verwenden Sie den Service:

Endpunkt	Methode	Beschreibung	OperationId
/v1/product/{uuid}	PATCH	Abo-Produkt aktualisieren	updateProduct

Hinweis zum PATCH-Endpunkt

Obwohl es sich um einen PATCH-Endpunkt handelt, verhalten sich bestimmte Objekte und Arrays so, dass sie die bisherigen Werte in der Datenbank vollständig ersetzen (“ersetzen die bisherigen Elemente vollständig”).

Wenn Sie diese Parameter im Payload mitsenden, müssen Sie stets den kompletten gewünschten Zielzustand (inkl. bisheriger Werte, die Sie behalten möchten) übergeben. Hierzu zählen unter anderem:

• name, description (Ihre Sprach-Übersetzungen)
• properties (Eigenschaften)
• media, billingDetails, allowedPaymentMethods, requiredDocuments, relatedDocuments
• Sowie Teile von classDetailsSubscription (wie z. B. prolongationPeriod, minimumDuration, billCycle, pausing, cleanUp)

Bitte achten Sie im Payload außerdem strikt darauf, dass Sie für verkäufliche Produkte (sellableFrom <= NOW) die oben gelisteten “eingefrorenen” Parameter nicht unerlaubt mitsenden oder sie absolut identisch zum Ist-Zustand belassen, da die API sonst einen Validierungsfehler zurückgeben kann.

Verwandte Themen