Proration
Proration bezeichnet die anteilige Berechnung oder Korrektur von Gebühren, wenn eine Subscription nicht exakt am Anfang oder Ende einer Serviceperiode beginnt, endet oder geändert wird.
In der Praxis ist das häufig relevant, weil Subscriptions oft mitten in einer Periode starten, pausiert werden, vorzeitig enden oder während einer laufenden Periode geändert werden.
Proration sorgt dafür, dass Gebühren möglichst passend zum tatsächlich genutzten Zeitraum berechnet werden.
Typische Fälle sind:
- Subscription startet mitten in einer Serviceperiode
- Subscription endet vor Ende einer bereits berechneten Serviceperiode
- Subscription wird pausiert oder reaktiviert
- Produkt oder Option wird während einer laufenden Periode geändert
- Menge oder Leistungsumfang ändert sich während einer laufenden Periode
- Kunde wechselt während der Laufzeit in ein anderes Produkt oder eine andere Option
In tebio wird Proration vor allem über zwei Produktparameter gesteuert:
prorataStartprorataEnd
Grundprinzip
Abschnitt betitelt „Grundprinzip“Proration betrachtet immer den relevanten Zeitraum innerhalb einer Serviceperiode.
Die Serviceperiode beschreibt, für welchen Zeitraum eine wiederkehrende Gebühr gilt.
Beispiel:
Ein Produkt kostet 30,00 € pro Monat. Die Serviceperiode läuft vom 1. bis zum letzten Tag des Monats.
Wenn eine Subscription erst am 16. März startet, nutzt der Kunde die Leistung nicht für den gesamten März, sondern nur für einen Teil der Serviceperiode.
Je nach Konfiguration kann tebio daher nur den anteiligen Betrag für den genutzten Zeitraum berechnen.
prorataStart
Abschnitt betitelt „prorataStart“Der Parameter prorataStart bestimmt, wie die erste Gebühr berechnet wird, wenn eine Subscription mitten in einer Serviceperiode beginnt.
prorataStart = true
Abschnitt betitelt „prorataStart = true“Wenn prorataStart aktiv ist, wird die erste Serviceperiode anteilig berechnet.
Der Kunde zahlt nur für den Zeitraum ab dem Start der Subscription bis zum Ende der laufenden Serviceperiode.
Beispiel:
- Produktpreis: 30,00 € pro Monat
- Serviceperiode: 1. März bis 31. März
- Start der Subscription: 16. März
prorataStart = true
tebio berechnet nur den anteiligen Betrag für den Zeitraum ab dem 16. März bis zum Ende der Serviceperiode.
Die reguläre volle Monatsgebühr wird erst ab der nächsten vollständigen Serviceperiode berechnet.
prorataStart = false
Abschnitt betitelt „prorataStart = false“Wenn prorataStart nicht aktiv ist, wird für die erste Serviceperiode der volle Preis berechnet, auch wenn die Subscription mitten in der Periode startet.
Beispiel:
- Produktpreis: 30,00 € pro Monat
- Serviceperiode: 1. März bis 31. März
- Start der Subscription: 16. März
prorataStart = false
tebio berechnet für die erste Serviceperiode den vollen Monatsbetrag.
Diese Einstellung kann sinnvoll sein, wenn die erste Gebühr unabhängig vom Startdatum vollständig berechnet werden soll, zum Beispiel bei festen Bereitstellungs-, Mindest- oder Pauschalentgelten.
prorataEnd
Abschnitt betitelt „prorataEnd“Der Parameter prorataEnd bestimmt, ob am Ende oder bei Änderung einer Subscription anteilige Korrekturen erfolgen.
Das ist besonders relevant, wenn eine wiederkehrende Gebühr bereits im Voraus für eine vollständige Serviceperiode berechnet wurde.
prorataEnd = true
Abschnitt betitelt „prorataEnd = true“Wenn prorataEnd aktiv ist, kann tebio den nicht genutzten Teil einer Serviceperiode anteilig korrigieren oder erstatten.
Typische Fälle:
- Subscription wird vor Ende der Serviceperiode deaktiviert
- Subscription wird sofort gekündigt
- Subscription wird pausiert
- Option wird deaktiviert
- Produkt oder Option wird gewechselt
- Menge oder Leistungsumfang wird reduziert
Beispiel:
- Produktpreis: 30,00 € pro Monat
- Serviceperiode: 1. März bis 31. März
- Gebühr wurde im Voraus für den gesamten März berechnet
- Subscription endet am 22. März
prorataEnd = true
tebio kann den nicht genutzten Zeitraum nach dem Ende der Subscription anteilig korrigieren.
Je nach Abrechnungsmodell erscheint diese Korrektur zum Beispiel als anteilige Erstattung, negative Rechnungsposition, Gutschrift oder Korrekturposition.
prorataEnd = false
Abschnitt betitelt „prorataEnd = false“Wenn prorataEnd nicht aktiv ist, erfolgt am Ende der Serviceperiode keine anteilige Korrektur.
Beispiel:
Eine Subscription wurde für den gesamten März berechnet und endet am 22. März.
Bei prorataEnd = false bleibt der bereits berechnete Betrag für die Serviceperiode unverändert.
Diese Einstellung kann sinnvoll sein, wenn der Kunde bei vorzeitiger Beendigung keinen Anspruch auf anteilige Erstattung haben soll oder wenn das Produktmodell immer volle Perioden berechnet.
Zusammenspiel mit chargingType
Abschnitt betitelt „Zusammenspiel mit chargingType“Proration hängt eng mit dem chargingType zusammen.
Der chargingType bestimmt, ob wiederkehrende Gebühren im Voraus oder nachträglich berechnet werden.
| chargingType | Bedeutung |
|---|---|
IN_ADVANCE | Die Gebühr wird zu Beginn der Serviceperiode für die kommende Periode berechnet. |
IN_ARREAR | Die Gebühr wird nachträglich für die vergangene Serviceperiode berechnet. |
IN_ADVANCE
Abschnitt betitelt „IN_ADVANCE“Bei IN_ADVANCE ist Proration besonders wichtig, weil die Gebühr bereits im Voraus für eine gesamte Serviceperiode berechnet wurde.
Wenn während dieser Periode eine Änderung eintritt, kann eine anteilige Korrektur erforderlich sein.
Typische Fälle:
- Kündigung vor Periodenende
- Pause während der Periode
- Downgrade während der Periode
- Option wird vor Periodenende entfernt
- Menge wird reduziert
In diesen Fällen steuert prorataEnd, ob der nicht genutzten Teil der bereits berechneten Periode korrigiert wird.
IN_ARREAR
Abschnitt betitelt „IN_ARREAR“Bei IN_ARREAR wird die Gebühr nachträglich berechnet.
Da die Abrechnung erst nach der Leistungserbringung erfolgt, kann tebio den tatsächlich relevanten Zeitraum bei der Abrechnung berücksichtigen.
Eine klassische Erstattung für bereits im Voraus berechnete Gebühren steht hier weniger im Vordergrund, weil die Gebühr noch nicht vorab für die gesamte Periode berechnet wurde.
Proration kann dennoch relevant sein, wenn eine Serviceperiode nur teilweise aktiv war und die Abrechnung anteilig erfolgen soll.
Zusammenspiel mit Prepaid und Postpaid
Abschnitt betitelt „Zusammenspiel mit Prepaid und Postpaid“Proration ist nicht dasselbe wie Prepaid oder Postpaid.
| Begriff | Bedeutung |
|---|---|
| Prepaid | Der Kunde zahlt im Voraus. |
| Postpaid | Der Kunde zahlt nach Leistungserbringung oder nach Abschluss einer Abrechnungsperiode. |
| Proration | Gebühren werden anteilig für Teilzeiträume berechnet oder korrigiert. |
Proration kann grundsätzlich in verschiedenen Abrechnungsmodellen relevant sein.
Typische Zusammenhänge:
- Bei Prepaid können anteilige Korrekturen erforderlich sein, wenn eine bereits bezahlte Leistung vorzeitig endet.
- Bei Postpaid kann die Rechnung den tatsächlich genutzten Zeitraum berücksichtigen.
- Bei IN_ADVANCE sind Korrekturen besonders relevant, weil Gebühren bereits vorab berechnet wurden.
- Bei IN_ARREAR wird eher nachträglich für den tatsächlich relevanten Zeitraum abgerechnet.
Produktwechsel und Optionswechsel
Abschnitt betitelt „Produktwechsel und Optionswechsel“Proration ist besonders wichtig bei Produkt- oder Optionswechseln während einer laufenden Serviceperiode.
Upgrade
Abschnitt betitelt „Upgrade“Bei einem Upgrade wechselt der Kunde in ein höherwertiges Produkt oder bucht eine zusätzliche Option.
Typisches Verhalten:
- Der bisherige Tarif oder die bisherige Option wird für den nicht mehr genutzten Zeitraum anteilig korrigiert.
- Der neue Tarif oder die neue Option wird für den verbleibenden Zeitraum anteilig berechnet.
- Ab der nächsten vollständigen Serviceperiode gilt der reguläre Preis des neuen Produkts oder der neuen Option.
Downgrade
Abschnitt betitelt „Downgrade“Bei einem Downgrade wechselt der Kunde in ein günstigeres Produkt oder entfernt eine Option.
Typisches Verhalten:
- Der bisherige höhere Preis kann anteilig für den nicht mehr genutzten Zeitraum korrigiert werden.
- Der neue niedrigere Preis gilt für den verbleibenden Zeitraum oder ab der nächsten Periode, abhängig von der Konfiguration.
- Je nach Produktlogik kann ein Downgrade sofort oder erst zum Periodenende wirksam werden.
Pause und Reaktivierung
Abschnitt betitelt „Pause und Reaktivierung“Wenn eine Subscription pausiert wird, nutzt der Kunde die Leistung während der Pause nicht.
Proration kann dazu führen, dass der pausierte Zeitraum anteilig berücksichtigt wird.
Typische Fälle:
- Subscription wird mitten in einer Serviceperiode pausiert.
- Subscription wird später reaktiviert.
- Die nicht genutzten Tage werden anteilig korrigiert.
- Die Leistung wird ab Reaktivierung wieder berechnet.
Je nach Konfiguration kann die Korrektur beim Pausieren, beim Reaktivieren oder in einem späteren Billrun berücksichtigt werden.
Wichtig ist, dass die Abrechnung den tatsächlich berechnungsrelevanten Zeitraum nachvollziehbar abbildet.
Kündigung und Deaktivierung
Abschnitt betitelt „Kündigung und Deaktivierung“Bei einer Kündigung zum Periodenende ist Proration häufig nicht erforderlich, weil der Kunde die Leistung bis zum Ende der laufenden Periode weiter nutzen darf.
Anders ist es bei einer sofortigen Kündigung oder vorzeitigen Deaktivierung.
Beispiel:
- Subscription wurde für den gesamten März im Voraus berechnet.
- Kunde kündigt sofort zum 22. März.
- Kunde nutzt die Leistung ab dem 23. März nicht mehr.
- Bei aktivem
prorataEndkann tebio den nicht genutzten Zeitraum anteilig korrigieren.
Wenn die Kündigung dagegen regulär zum 31. März erfolgt, wurde die volle Periode genutzt. In diesem Fall entsteht typischerweise keine anteilige Korrektur für März.
Berechnungslogik
Abschnitt betitelt „Berechnungslogik“Die anteilige Berechnung erfolgt auf Basis des relevanten Zeitraums innerhalb der Serviceperiode.
Vereinfachtes Prinzip:
Anteiliger Betrag = regulärer Preis der Serviceperiode × genutzter Zeitraum / gesamte ServiceperiodeDie genaue Berechnung hängt von der jeweiligen Serviceperiode, Preislogik, Steuerlogik und Rundungslogik ab.
Ein Monatsbetrag wird daher nicht immer mit einem festen 30-Tage-Monat berechnet. Entscheidend ist die konkrete Serviceperiode.
Beispiele:
- Februar hat weniger Tage als März.
- Eine wöchentliche Serviceperiode hat andere Grenzen als eine monatliche Serviceperiode.
- Eine individuell gestartete Serviceperiode kann andere Start- und Enddaten haben als ein Kalendermonat.
- Bei B2C wird brutto zu netto gerechnet.
- Bei B2B wird netto zu brutto gerechnet.
Darstellung auf Rechnungen und Detailreports
Abschnitt betitelt „Darstellung auf Rechnungen und Detailreports“Prorated Charges oder anteilige Korrekturen sollten auf Abrechnungsdokumenten nachvollziehbar sein.
Je nach Rechnungseinstellungen können Informationen sichtbar sein wie:
- betroffene Leistung
- Zeitraum der anteiligen Berechnung
- genutzter Zeitraum
- korrigierter Zeitraum
- Betrag
- Steuer
- Produkt oder Option
- Gebührentyp
Auf der Rechnung können Positionen aggregiert dargestellt werden.
Der Invoice Detail Report kann eine detailliertere Aufschlüsselung enthalten, zum Beispiel nach Serviceperiode, Produkt, Option oder Gebührentyp.
Auswirkungen auf Steuern
Abschnitt betitelt „Auswirkungen auf Steuern“Proration beeinflusst die Bemessungsgrundlage für Steuerberechnungen.
Die Steuer wird auf den anteilig berechneten oder korrigierten Betrag angewendet.
Dabei ist relevant, ob das Konto auf B2B oder B2C konfiguriert ist:
| Kontokonfiguration | Preislogik |
|---|---|
| B2C | Preise inklusive Steuern, Berechnung von brutto zu netto |
| B2B | Preise exklusive Steuern, Berechnung von netto zu brutto |
Diese Steuerlogik kann beeinflussen, wie Rundungen auf Positionsebene aussehen.
Beispiel: Start mitten im Monat
Abschnitt betitelt „Beispiel: Start mitten im Monat“Ein Produkt kostet 30,00 € pro Monat.
Die Serviceperiode läuft vom 1. März bis 31. März.
Der Kunde startet am 16. März.
Bei aktivem prorataStart berechnet tebio nur den Anteil vom 16. März bis zum Ende der Serviceperiode.
Ab der nächsten vollständigen Serviceperiode wird der reguläre Preis berechnet.
Bei inaktivem prorataStart wird für die erste Serviceperiode der volle Betrag berechnet.
Beispiel: Sofortige Kündigung mitten im Monat
Abschnitt betitelt „Beispiel: Sofortige Kündigung mitten im Monat“Ein Produkt kostet 30,00 € pro Monat und wird im Voraus berechnet.
Die Serviceperiode läuft vom 1. März bis 31. März.
Der Kunde kündigt sofort zum 22. März.
Bei aktivem prorataEnd kann tebio den nicht genutzten Zeitraum nach der Deaktivierung anteilig korrigieren.
Bei inaktivem prorataEnd bleibt die bereits berechnete Gebühr unverändert.
Beispiel: Upgrade während der Serviceperiode
Abschnitt betitelt „Beispiel: Upgrade während der Serviceperiode“Ein Kunde nutzt ein Produkt für 30,00 € pro Monat und wechselt am 16. März in ein Produkt für 60,00 € pro Monat.
Bei anteiliger Berechnung kann tebio:
- den nicht mehr genutzten Restzeitraum des alten Produkts korrigieren,
- den verbleibenden Zeitraum des neuen Produkts anteilig berechnen,
- ab der nächsten Serviceperiode den regulären Preis des neuen Produkts berechnen.
Dadurch zahlt der Kunde im Wechselmonat nicht doppelt für denselben Zeitraum.
Beispiel: Pause innerhalb einer Serviceperiode
Abschnitt betitelt „Beispiel: Pause innerhalb einer Serviceperiode“Ein Kunde pausiert eine im Voraus berechnete Subscription vom 10. März bis zum 20. März.
Bei entsprechender Konfiguration kann tebio den pausierten Zeitraum anteilig berücksichtigen.
Je nach Prozess kann die Korrektur im Zusammenhang mit Pause, Reaktivierung oder einem späteren Billrun entstehen.
Typische Fehler vermeiden
Abschnitt betitelt „Typische Fehler vermeiden“Proration mit Rabatt verwechseln
Abschnitt betitelt „Proration mit Rabatt verwechseln“Proration ist kein Rabatt.
Proration berechnet oder korrigiert einen Betrag zeitanteilig. Ein Rabatt reduziert dagegen den Preis nach einer Rabattlogik.
Serviceperiode mit Bill Cycle verwechseln
Abschnitt betitelt „Serviceperiode mit Bill Cycle verwechseln“Die Serviceperiode bestimmt, für welchen Zeitraum eine Gebühr gilt.
Der Bill Cycle bestimmt, wann Gebühren in einem Billrun abgerechnet werden.
Diese beiden Zeiträume können gleich sein, müssen es aber nicht.
prorataStart und prorataEnd gleichsetzen
Abschnitt betitelt „prorataStart und prorataEnd gleichsetzen“prorataStart betrifft den Beginn einer Subscription oder Leistung.
prorataEnd betrifft das Ende oder Änderungen während einer bereits laufenden oder bereits berechneten Serviceperiode.
Proration bei Kündigung zum Periodenende erwarten
Abschnitt betitelt „Proration bei Kündigung zum Periodenende erwarten“Wenn der Kunde bis zum Periodenende weiter nutzen darf, ist die volle Periode in der Regel berechtigt berechnet.
Proration ist vor allem bei vorzeitiger Beendigung, Pause oder Änderung relevant.
IN_ADVANCE und IN_ARREAR nicht berücksichtigen
Abschnitt betitelt „IN_ADVANCE und IN_ARREAR nicht berücksichtigen“Bei im Voraus berechneten Gebühren entstehen häufiger Korrekturen.
Bei nachträglicher Berechnung kann der tatsächlich relevante Zeitraum direkt in der Rechnung berücksichtigt werden.
Rundung und Steuerlogik ignorieren
Abschnitt betitelt „Rundung und Steuerlogik ignorieren“Anteilig berechnete Beträge können Rundungen erzeugen.
Die Rundung hängt auch davon ab, ob Preise brutto oder netto verwaltet werden.
API-Hinweis
Abschnitt betitelt „API-Hinweis“Für API-Nutzer sind insbesondere folgende Punkte relevant:
| Bereich | Bedeutung |
|---|---|
| Product | enthält Standardparameter wie prorataStart, prorataEnd, Serviceperiode und Charging Type |
| Subscription | konkrete gebuchte Leistung, ggf. mit individuellen Abweichungen |
| Order | kann Start, Wechsel oder Änderung einer Subscription auslösen |
| Billing | bewertet Ereignisse und erzeugt anteilige Positionen |
| Invoice / Receipt | zeigt anteilige Positionen oder Korrekturen auf Abrechnungsdokumenten |
| Webhooks | informieren externe Systeme über Status- und Folgeprozesse |
| Event History | hilft bei der Nachvollziehbarkeit von Start, Änderung, Pause oder Deaktivierung |
Die genaue technische Umsetzung der Parameter, Endpunkte und Statuswerte ist in der API-Referenz beschrieben.