MRR einschließlich Rabatten über die API abrufen
Die Kunden-API stellt jetzt den aktuellen und ausstehenden MRR einschließlich zeitlich begrenzter Rabatte bereit. Die neuen Felder effectivemrrbycurrency und effectivependingmrrbycurrency entsprechen den CSV-Spalten „MRR inkl. Rabatte“ und „Pending MRR inkl. Rabatte“.
Die Kunden-API stellt jetzt den aktuellen und ausstehenden MRR einschließlich zeitlich begrenzter Rabatte bereit. Die neuen Felder effective_mrr_by_currency und effective_pending_mrr_by_currency entsprechen den CSV-Spalten „MRR inkl. Rabatte“ und „Pending MRR inkl. Rabatte“.
Aktueller und ausstehender MRR bleiben getrennt: Pending MRR umfasst Abonnements mit künftigem Startdatum, aktivem Testzeitraum oder aktiver Pause. Alle vier API-Felder sind nach Währung gruppiert und verwenden die kleinste Währungseinheit, beispielsweise Øre oder Cent.
Historischer Hintergrund - August 2024 bis September 2026
Die MRR-API begann mit aktuellen Kennzahlen und wurde später um ausstehende Werte, Rabatte, Intervalle und geplante Änderungen erweitert. Eine Antwort für ein konkretes Abonnement ist relevanter als der Katalogpreis eines Tarifs, denn das Abonnement kann einen eigenen Preis, eine eigene Währung, einen Testzeitraum oder einen Rabatt haben.
Ändert eine Integration Testzeitraum, Rabatt oder Verlängerungsintervall, lesen Sie das aktualisierte Abonnement erneut aus und unterscheiden Sie zwischen einer sofort wirksamen und einer geplanten Änderung. Verwenden Sie UUIDs, Seitennavigation und die in OpenAPI dokumentierte Betragsangabe. Siehe die Anleitung zu öffentlicher API und Webhooks (Markdown-fil, AI-agentvenlig).
Erst lesen, dann ändern, anschließend erneut lesen
Rufen Sie zum Einstieg in einem Testbeispiel GET /api/v1/subscriptions/{uuid} mit der fiktiven, nicht vorhandenen UUID 00000000-0000-4000-8000-000000000003 auf. Speichern Sie vor einer Änderung den aktuellen Preis, Preistyp, das Intervall, den Testzeitraum und available_price_change_dates. Senden Sie nur die gewünschte Aktion und lesen Sie anschließend die Abonnementantwort erneut aus. Die API gibt das aktualisierte Abonnement zurück und kann das tatsächliche Wirksamkeitsdatum unter meta.effective_date ausweisen.
Testzeitraum
Verwenden Sie für einen bestehenden, nicht gesperrten Testzeitraum PUT /api/v1/subscriptions/{uuid}/trial mit { "end_date": "2026-10-15" }. Das Enddatum muss nach dem Beginn des Testzeitraums liegen. Ein Abonnement ohne Testzeitraum oder ein Testzeitraum, dessen Transaktion bereits berechnet oder belastet wurde, gibt 422 zurück; mit diesem Aufruf wird kein Testzeitraum erstellt.
Rabatt
Verwenden Sie POST /api/v1/subscriptions/{uuid}/discounts mit einem dokumentierten Rabatttyp. Ein Prozentsatz wie 14.29 bedeutet 14,29 Prozent; ein fester Rabatt wird dagegen in der kleinsten Währungseinheit angegeben, zum Beispiel 5000 = 50,00. Der Rabattzeitraum muss in einem nicht gesperrten Zeitraum beginnen und darf sich nicht mit einem anderen ausstehenden Rabatt überschneiden. Verbrauchsabhängige Abonnements unterstützen prozentuale Rabatte; ein fester Rabatt wird abgelehnt.
Intervall und Preis
PUT /api/v1/subscriptions/{uuid}/interval mit beispielsweise { "interval": 3 } verwendet die für den Tarif eingerichteten Intervalle und wird ab dem nächsten bevorstehenden Zeitraum wirksam. PUT /api/v1/subscriptions/{uuid}/price erwartet für Festpreise price, für lizenzbasierte Abonnements unit_price; verwenden Sie die Felder nicht vertauscht. Preisänderungen gelten standardmäßig ab dem nächsten Zeitraum oder zu einem gültigen effective_date. Für verbrauchsabhängige Tarife und Tarife mit Stufen gelten eigene Preisregeln.
Eine geplante Änderung ist noch nicht aktiv. Ist ein Zeitraum bereits abgerechnet oder gesperrt, wird die Änderung auf ein zulässiges künftiges Datum verschoben und künftige Transaktionen werden neu erstellt. Verwenden Sie die Abonnementantwort und den Endpunkt für geplante Änderungen, um den Plan anzuzeigen. Mit DELETE /api/v1/subscriptions/{uuid}/scheduled-changes/{scheduledChangeUuid} können Sie eine konkrete ausstehende Änderung entfernen, sofern der Vertrag dies erlaubt.
Häufig gestellte Fragen
Warum weicht der MRR über die API vom Tarifpreis ab? Der MRR richtet sich nach dem konkreten Abonnement einschließlich Rabatt, Testzeitraum, Währung und Status. Der Katalogpreis des Tarifs ist nur der Standardwert.
Warum wurde mein Preis nicht sofort wirksam? Bei einem gesperrten oder bereits abgerechneten Zeitraum wird die Änderung auf einen zulässigen späteren Termin verschoben.
Warum wurde ein Rabatt abgelehnt? Prüfen Sie Typ, Prozentsatz bzw. Währungseinheit, den nicht gesperrten Startzeitpunkt und mögliche Überschneidungen mit anderen Rabatten.
Kann ich das Intervall eines Abonnements mit Tarifstufen ändern? Verwenden Sie den Tarifstufenvertrag und den Preis für die ausgewählte Stufe des Abonnements. Ersetzen Sie diese nicht durch einen direkten Eintrag aus der Verlängerungsintervalltabelle.
Die Menschen und KI-Helfer hinter den Neuigkeiten
Bo Møller und Emil Højbjerg entwickeln Alunta. Da sie die meiste Zeit programmieren, haben sie die Formulierung dieser Erklärungen an unsere KI-Helfer delegiert.
Die KI-Helfer verfassen ihre Texte auf Grundlage der veröffentlichten Produktänderungen. Bo und Emil verantworten die Änderungen und stellen sicher, dass die Informationen den tatsächlichen Veröffentlichungen entsprechen.
