Orice sistem de creditare are în centru un grafic de rambursare și orice echipă care îl construiește dă de aceeași problemă mică: cifrele nu se adună la ban. Articolul acoperă calculul unui grafic de rambursare în Java, de la alegerea dintre anuitate și rate egale de principal la formulă, rotunjirea cu BigDecimal, ultima rată care preia diferența, convențiile de calcul al zilelor și testarea rezultatului.

Este un articol de inginerie, nu descrierea produsului vreunui creditor. Legislația creditului pentru consumatori stabilește reguli pentru cum se calculează și se afișează dobânda și dobânda anuală efectivă; indicăm câteva mai jos, dar verificați regulile în vigoare din fiecare țară înainte să vă bazați pe ele.

Grafic de rambursare: anuitate vs rate egale de principal

Există două moduri obișnuite de a rambursa un credit în rate periodice:

MetodăRataPartea de principalPartea de dobândă
AnuitateAceeași în fiecare perioadăCrește în timpScade în timp
Principal egalScade în timpAceeași în fiecare perioadăScade în timp

La anuitate, împrumutatul plătește aceeași sumă în fiecare lună, iar ponderea principalului în ea crește pe măsură ce soldul scade. La principal egal, partea de principal este fixă și dobânda se adaugă peste ea, așa că primele rate sunt cele mai mari.

Atenție la termeni: în limbajul legal românesc, „rate egale” înseamnă anuități, iar varianta cu principal egal se numește „rate descrescătoare”. Legislația română a creditului pentru consumatori spune că un credit poate fi rambursat prin rate egale (anuități) sau prin rate descrescătoare și că consumatorul are dreptul să aleagă (art. 38 din OUG 50/2010, forma consolidată publicată de ANPC). Un motor de grafice ar trebui să le suporte pe amândouă.

Formula pentru calculul graficului de rambursare în Java

Pentru o anuitate, plata periodică A pentru un principal P, o rată a dobânzii pe perioadă r și n plăți este formula standard a anuității:

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

Pentru o dobândă nominală anuală plătită lunar, r este rata anuală împărțită la 12. În fiecare perioadă, dobânda este soldul deschis înmulțit cu r, partea de principal este A minus dobânda, iar soldul scade cu partea de principal.

În Java, banii cer BigDecimal, iar felul în care îl creați contează. Documentația BigDecimal avertizează că new BigDecimal(0.1) nu este exact 0,1, pentru că 0,1 nu are o reprezentare binară exactă, și recomandă constructorul cu String. Încă două capcane din aceeași pagină: divide fără regulă de rotunjire aruncă ArithmeticException când câtul nu are o expansiune zecimală finită, de exemplu 1 împărțit la 3; iar equals compară și scala, așa că 2.0 și 2.00 nu sunt egale, în timp ce compareTo le tratează ca același număr.

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 oferă 34 de cifre semnificative cu rotunjire HALF_EVEN, conform documentației MathContext. Valorile intermediare păstrează această precizie; doar plata se rotunjește la bani.

Rotunjirea și ultima rată

O plată rotunjită, repetată de n ori, nu rambursează exact principalul. Rămân câțiva bani sau se plătește puțin în plus. Soluția obișnuită este ca ultima rată să preia diferența: rambursează soldul rămas, plus dobânda lui.

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;
}

Pentru 10.000,00 la 12% pe an, pe 12 luni (r = 0,01), rezultă unsprezece plăți de 888,49 și o ultimă plată de 888,47, cu soldul exact 0,00. Principalul egal are aceeași problemă: 10.000,00 / 12 înseamnă 833,33 pe lună, iar ultima parte de principal este 833,37.

Ce mod de rotunjire? Documentația RoundingMode definește HALF_UP ca rotunjirea unui caz de egalitate departe de zero („cea învățată de obicei la școală”) și HALF_EVEN ca rotunjirea la vecinul par, așa că 2,5 devine 2 cu HALF_EVEN și 3 cu HALF_UP. Aceeași pagină notează că HALF_EVEN minimizează statistic eroarea cumulată când este aplicat repetat și că se numește uneori „rotunjirea bancherului”. Niciunul nu este corect din oficiu: contractul, autoritatea de reglementare sau politica contabilă pot impune unul. Oricare ar fi regula, scrieți-o, folosiți-o într-un singur loc și testați-o.

Încă trei decizii țin de specificație, nu de cod:

  • dacă dobânda se rotunjește pe fiecare perioadă (ca mai sus) sau se rotunjește doar plata;
  • dacă diferența merge în ultima rată sau în prima;
  • ce se întâmplă când ultima rată ar diferi cu mai mult de câțiva bani, ceea ce de obicei înseamnă un bug.

Convenții de calcul al zilelor

Împărțirea ratei anuale la 12 tratează toate lunile la fel. Este o convenție dintre mai multe. Cele uzuale, așa cum le rezumă articolul Wikipedia despre convențiile de calcul al zilelor:

ConvențieDobânda pentru o perioadă
30/360Fiecare lună are 30 de zile, anul 360
Actual/360Zilele reale din perioadă, împărțite la 360
Actual/365 FixedZilele reale din perioadă, împărțite la 365
Actual/ActualZilele reale, împărțite la lungimea reală a anului

Legislația creditului pentru consumatori poate limita alegerea. Același art. 38 din OUG 50/2010 permite calculul ratei lunare a dobânzii fie pe baza anului calendaristic de 365 de zile (366 în an bisect), fie cu 30 de zile la 360.

Cu o convenție pe zile reale, dobânda diferă de la lună la lună, așa că o anuitate fixată la început nu mai stinge exact soldul. Ultima rată preia mai mult sau graficul se recalculează. O primă perioadă mai lungă sau mai scurtă de o lună, pentru că creditul începe la mijlocul lunii, are același efect.

Dobânda anuală efectivă este un calcul separat

Dobânda anuală efectivă (DAE) nu este rata nominală din grafic. Se calculează din toate plățile și costurile, cu o formulă stabilită de lege. Regulile românești, din anexa nr. 1 la OUG 50/2010, consideră anul de 365 de zile (366 în an bisect), 52 de săptămâni sau 12 luni egale de câte 30,41666 zile și cer rezultatul cu cel puțin o zecimală, adăugând unu la prima zecimală când a doua este 5 sau mai mare. În Germania, § 16 din Regulamentul privind indicarea prețurilor (PAngV) cere ca dobânda efectivă anuală (effektiver Jahreszins) să fie calculată cu formula din anexa sa. Noua Directivă (UE) 2023/2225 privind creditul de consum se aplică de la 20 noiembrie 2026 și stabilește calculul DAE în anexa III, așa că regulile naționale se pot schimba; verificați versiunea în vigoare.

Testarea unui grafic

Un grafic este un bun candidat pentru teste care verifică reguli, nu valori izolate:

  • Părțile de principal se adună la principal, la ban.
  • Soldul după ultima rată este exact zero.
  • Fiecare plată de anuitate este egală, cu excepția ultimei, iar ultima diferă cu o sumă limitată.
  • Părțile de dobândă se adună la dobânda totală afișată împrumutatului.
  • Dobânda zero, o singură rată și un principal foarte mic funcționează toate.

Adăugați câteva grafice de referință, calculate independent și verificate de cineva din finanțe, și comparați-le la ban. Rulați verificările pe reguli pe multe combinații generate de principal, dobândă și durată. Bug-urile de rotunjire apar de obicei într-un caz din mii, nu în exemplul din specificație.

Cum vă putem ajuta

Construim software de creditare cu administrarea creditelor și grafice de rambursare: grafice cu anuitate și cu principal egal, rambursare anticipată, modificări pe durata creditului și testele care țin evidența fiecărui ban.