Jedes Kreditsystem hat einen Tilgungsplan im Kern, und jedes Team, das einen baut, stößt auf dasselbe kleine Problem: Die Zahlen gehen nicht auf den Cent auf. Dieser Artikel zeigt, wie Sie einen Tilgungsplan berechnen, mit Annuität oder Ratentilgung, in Java: die Formel, die Rundung mit BigDecimal, die letzte Rate, die die Differenz aufnimmt, Zinstagekonventionen und wie Sie das Ergebnis testen.

Es ist ein Technikartikel, keine Beschreibung des Produkts eines Kreditgebers. Das Verbraucherkreditrecht regelt, wie Zinsen und der effektive Jahreszins berechnet und angegeben werden; wir verweisen unten auf einige Regeln, aber prüfen Sie die in jedem Land geltenden Vorschriften, bevor Sie sich darauf stützen.

Annuität oder Ratentilgung

Für die Rückzahlung in regelmäßigen Raten gibt es zwei übliche Wege:

MethodeRateTilgungsanteilZinsanteil
AnnuitätIn jeder Periode gleichSteigt mit der ZeitSinkt mit der Zeit
Ratentilgung (gleiche Tilgung)Sinkt mit der ZeitIn jeder Periode gleichSinkt mit der Zeit

Bei der Annuität zahlt der Kreditnehmer jeden Monat denselben Betrag, und der Tilgungsanteil darin steigt, während die Restschuld sinkt. Bei der Ratentilgung ist der Tilgungsanteil fest und die Zinsen kommen hinzu, sodass die ersten Raten die höchsten sind.

Die Wahl liegt nicht immer beim Kreditgeber. Das rumänische Verbraucherkreditrecht etwa sieht vor, dass ein Kredit in gleichen Raten (Annuitäten) oder in fallenden Raten zurückgezahlt werden kann und dass der Verbraucher das Recht hat zu wählen (Art. 38 der OUG 50/2010, konsolidierte Fassung, veröffentlicht von der ANPC). Eine Tilgungsplan-Engine sollte beides können.

Tilgungsplan berechnen mit der Annuitätenformel in Java

Für eine Annuität ist die periodische Rate A bei einem Darlehensbetrag P, einem Periodenzins r und n Zahlungen die übliche Annuitätenformel:

A = P × r × (1 + r)^n / ((1 + r)^n − 1)      for r > 0
A = P / n                                   for r = 0

Bei einem nominalen Jahreszins mit monatlicher Zahlung ist r der Jahreszins geteilt durch 12. In jeder Periode sind die Zinsen die Restschuld mal r, der Tilgungsanteil ist A minus Zinsen, und die Restschuld sinkt um den Tilgungsanteil.

In Java verlangt Geld nach BigDecimal, und wie Sie es erzeugen, ist wichtig. Die BigDecimal-Dokumentation warnt, dass new BigDecimal(0.1) nicht genau 0,1 ist, weil 0,1 keine exakte Binärdarstellung hat, und empfiehlt den String-Konstruktor. Zwei weitere Fallen von derselben Seite: divide ohne Rundungsregel wirft eine ArithmeticException, wenn der Quotient keine endliche Dezimaldarstellung hat, etwa 1 geteilt durch 3; und equals vergleicht auch die Skala, sodass 2.0 und 2.00 nicht gleich sind, während compareTo sie als dieselbe Zahl behandelt.

Java
static final MathContext MC = MathContext.DECIMAL128;
static final int CENTS = 2;

static BigDecimal annuityPayment(BigDecimal principal, BigDecimal rate, int n) {
  if (rate.signum() == 0) {
    return principal.divide(BigDecimal.valueOf(n), CENTS, RoundingMode.HALF_EVEN);
  }
  BigDecimal factor = BigDecimal.ONE.add(rate).pow(n, MC);         // (1 + r)^n
  return principal.multiply(rate, MC).multiply(factor, MC)
      .divide(factor.subtract(BigDecimal.ONE), MC)
      .setScale(CENTS, RoundingMode.HALF_EVEN);
}

MathContext.DECIMAL128 liefert laut MathContext-Dokumentation 34 signifikante Stellen mit HALF_EVEN-Rundung. Zwischenwerte behalten diese Genauigkeit; nur die Rate wird auf Cent gerundet.

Rundung und die letzte Rate

Eine gerundete Rate, n-mal gezahlt, tilgt das Darlehen nicht genau. Ein paar Cent bleiben übrig oder werden zu viel gezahlt. Die übliche Lösung: Die letzte Rate nimmt die Differenz auf. Sie tilgt die verbleibende Restschuld plus deren Zinsen.

Java
record Instalment(int number, BigDecimal payment, BigDecimal interest,
                  BigDecimal principal, BigDecimal balance) {}

static List<Instalment> schedule(BigDecimal principal, BigDecimal rate, int n) {
  BigDecimal payment = annuityPayment(principal, rate, n);
  BigDecimal balance = principal;
  List<Instalment> rows = new ArrayList<>();
  for (int k = 1; k <= n; k++) {
    BigDecimal interest = balance.multiply(rate).setScale(CENTS, RoundingMode.HALF_EVEN);
    BigDecimal principalPart = (k == n) ? balance : payment.subtract(interest);
    balance = balance.subtract(principalPart);
    rows.add(new Instalment(k, interest.add(principalPart), interest, principalPart, balance));
  }
  return rows;
}

Für 10.000,00 zu 12 % im Jahr über 12 Monate (r = 0,01) ergibt das elf Raten zu 888,49 und eine letzte Rate von 888,47, mit einer Restschuld von genau 0,00. Die Ratentilgung hat dasselbe Problem: 10.000,00 / 12 sind 833,33 im Monat, und der letzte Tilgungsanteil ist 833,37.

Welcher Rundungsmodus? Die RoundingMode-Dokumentation definiert HALF_UP als Rundung eines Gleichstands weg von null („wie in der Schule gelernt“) und HALF_EVEN als Rundung zum geraden Nachbarn, sodass 2,5 mit HALF_EVEN zu 2 und mit HALF_UP zu 3 wird. Dieselbe Seite merkt an, dass HALF_EVEN den kumulierten Fehler bei wiederholter Anwendung statistisch minimiert und manchmal „Banker's Rounding“ genannt wird. Keiner ist von sich aus richtig: Vertrag, Aufsicht oder Bilanzierungsrichtlinie können einen vorgeben. Wie die Regel auch lautet: Schreiben Sie sie auf, verwenden Sie sie an einer Stelle und testen Sie sie.

Drei weitere Entscheidungen gehören in die Spezifikation, nicht in den Code:

  • ob die Zinsen je Periode gerundet werden (wie oben) oder nur die Rate;
  • ob die Differenz in die letzte oder in die erste Rate geht;
  • was passiert, wenn die letzte Rate um mehr als ein paar Cent abweichen würde, was meist auf einen Fehler hinweist.

Zinstagekonventionen

Den Jahreszins durch 12 zu teilen behandelt jeden Monat gleich. Das ist eine Konvention unter mehreren. Die gängigen, wie sie der Wikipedia-Artikel zu Day-Count-Konventionen zusammenfasst:

KonventionZinsen für eine Periode
30/360Jeder Monat zählt 30 Tage, das Jahr 360
Actual/360Tatsächliche Tage der Periode, geteilt durch 360
Actual/365 FixedTatsächliche Tage der Periode, geteilt durch 365
Actual/ActualTatsächliche Tage, geteilt durch die tatsächliche Länge des Jahres

Das Verbraucherkreditrecht kann die Wahl einschränken. Derselbe Art. 38 der rumänischen OUG 50/2010 erlaubt, die monatlichen Zinsen entweder auf Basis des Kalenderjahres mit 365 Tagen (366 im Schaltjahr) oder mit 30 Tagen auf 360 zu berechnen.

Mit einer Konvention nach tatsächlichen Tagen schwanken die Zinsen von Monat zu Monat, sodass eine zu Beginn festgelegte Annuität die Restschuld nicht mehr genau tilgt. Die letzte Rate nimmt mehr auf, oder der Plan wird neu berechnet. Eine erste Periode, die länger oder kürzer als ein Monat ist, weil der Kredit mitten im Monat beginnt, hat denselben Effekt.

Der effektive Jahreszins ist eine eigene Berechnung

Der effektive Jahreszins ist nicht der Nominalzins des Tilgungsplans. Er wird aus allen Zahlungen und Kosten mit einer gesetzlich festgelegten Formel berechnet. Die rumänischen Regeln in Anhang 1 der OUG 50/2010 setzen ein Jahr mit 365 Tagen (366 im Schaltjahr), 52 Wochen oder 12 gleich langen Monaten zu 30,41666 Tagen an und verlangen das Ergebnis mit mindestens einer Nachkommastelle, wobei die erste Stelle aufgerundet wird, wenn die zweite 5 oder größer ist. In Deutschland verlangt § 16 der Preisangabenverordnung (PAngV), den effektiven Jahreszins mit der mathematischen Formel aus ihrer Anlage zu berechnen. Die neue EU-Verbraucherkreditrichtlinie (EU) 2023/2225 gilt ab dem 20. November 2026 und regelt die Berechnung in ihrem Anhang III, sodass sich nationale Vorschriften ändern können; prüfen Sie die geltende Fassung.

Einen Tilgungsplan testen

Ein Tilgungsplan eignet sich gut für Tests, die Regeln prüfen statt einzelner Werte:

  • Die Tilgungsanteile ergeben zusammen den Darlehensbetrag, auf den Cent.
  • Die Restschuld nach der letzten Rate ist genau null.
  • Alle Annuitätenraten sind gleich, außer der letzten, und die letzte weicht nur begrenzt ab.
  • Die Zinsanteile ergeben zusammen die Gesamtzinsen, die dem Kreditnehmer angezeigt werden.
  • Zinssatz null, eine einzige Rate und ein sehr kleiner Darlehensbetrag funktionieren.

Ergänzen Sie einige Referenzpläne, unabhängig berechnet und von jemandem aus dem Finanzbereich geprüft, und vergleichen Sie auf den Cent. Lassen Sie die Regelprüfungen über viele generierte Kombinationen aus Betrag, Zins und Laufzeit laufen. Rundungsfehler zeigen sich meist in einem von Tausenden Fällen, nicht im Beispiel aus der Spezifikation.

Wie wir helfen können

Wir entwickeln Kreditsoftware mit Kreditverwaltung und Tilgungsplänen: Annuitäten- und Ratentilgungspläne, vorzeitige Rückzahlung, Änderungen während der Laufzeit und die Tests, die jeden Cent nachvollziehbar halten.