oneapi
Autentificare
Financiar v1 / Calcul

Indexarea unei sume cu inflaţia

Coeficientul de indexare între două luni, potrivit indicelui preţurilor de consum publicat de INS,
şi — dacă se dă o sumă — suma indexată.

IPC-ul e publicat ca indice lunar faţă de luna anterioară, deci coeficientul e PRODUSUL factorilor
lunari. Formula e validată pe inflaţia dec/dec a INS: 8,19% pentru 2021, 16,37% pentru 2022, 6,61%
pentru 2023 — exact cifrele oficiale.

Luna de plecare nu intră în produs: indicele ei descrie o variaţie petrecută înainte de reper. O
chirie stabilită în ianuarie se indexează începând cu februarie.

GET
https://oneapi.ro/api/financiar/v1/calcul/indexare

Parametri de interogare

NumeTipDescriereValori acceptate
sumaopțional string | null Opţional. Fără ea se întoarce doar coeficientul. ex. 10000ex. 1000
de_laobligatoriu string Obligatoriu, YYYY-MM. Luna de referinţă; nu intră în produs. Se acceptă şi o dată completă. ex. 2024-06-15ex. 2024-01ex. 2024
pana_laopțional string | null Opţional, implicit ultima lună acoperită. ex. 2025-01
categorieopțional string | null total (implicit), alimentare, nealimentare sau servicii. totalalimentarenealimentareservicii
indiceopțional string | null Seria folosită: ipc (implicit), constructii, productie-industriala, cost-forta-munca sau castig-salarial. Ramura se ia de aici, nu se deduce — cele două familii se calculează diferit (IPC e indice faţă de luna anterioară, restul au bază fixă). ipcconstructiiproductie-industrialacost-forta-muncacastig-salarial
tipopțional string | null Doar la indice=constructii: tipul lucrării (total, constructii_noi, reparatii_capitale, reparatii_curente, cladiri, cladiri_rezidentiale, cladiri_nerezidentiale, constructii_ingineresti). totalconstructii_noireparatii_capitalereparatii_curentecladiricladiri_rezidentialecladiri_nerezidentialeconstructii_ingineresticost_materiale
caenopțional string | null Doar la indice=productie-industriala, cost-forta-munca şi castig-salarial: orice cod CAEN, din orice revizie, adus la ce publică seria indicelui — clasa ori diviziunea/secţiunea la preţurile producţiei, secţiunea la costul muncii, diviziunea ori intervalul la câştigul salarial. Ce s-a folosit e în meta.caen. ex. 1011
caen_versiuneopțional string | null Opţional: revizia codului din caen — 1, 2 sau 3 — când forma lui e ambiguă (4932 înseamnă altceva în Rev.2 şi în Rev.3). Fără ea, codul se caută întâi în revizia seriei. 123
grupareopțional string | null Doar la aceiaşi trei indici: total, grupele MIG la preţurile producţiei (energie, bunuri_capital…), intervalele la câştigul salarial (62-63). Nu se trimite împreună cu caen. ex. 62-63ex. energie
piataopțional string | null Doar la indice=productie-industriala: total (implicit), interna sau externa. totalinternaexterna
ajustareopțional string | null Doar la indice=cost-forta-munca: bruta, zile_lucratoare sau zile_si_sezonier. brutazile_lucratoarezile_si_sezonier
componentaopțional string | null Doar la indice=cost-forta-munca: total, total_fara_premii, directe sau indirecte. totaltotal_fara_premiidirecteindirecte
masuraopțional string | null Doar la indice=castig-salarial: brut sau net. brutnet
versiuneopțional string | null Doar la indice=castig-salarial: clasificarea CAEN folosită, rev2 sau rev3. rev2rev3

Cum se comportă

  • Coeficientul de indexare între două luni, potrivit indicelui preţurilor de consum publicat de INS, şi — dacă se dă o sumă — suma indexată. suma e opţională: fără ea se întoarce doar coeficientul.
  • IPC-ul e publicat ca indice LUNAR faţă de luna anterioară (100,06 = +0,06%), nu ca indice cu bază fixă. Deci coeficientul pe o perioadă e PRODUSUL factorilor lunari, nu un raport între două valori. Formula e validată pe inflaţia dec/dec publicată de INS: produsul lunilor ianuarie–decembrie dă 8,19% pentru 2021, 16,37% pentru 2022 şi 6,61% pentru 2023 — exact cifrele oficiale.
  • Luna de plecare nu intră în produs. Indicele ei descrie variaţia faţă de luna precedentă, adică o schimbare petrecută înainte de reper. O chirie stabilită în ianuarie se indexează începând cu februarie.
  • Categoria total e coşul complet. Celelalte — alimentare, nealimentare, servicii — indexează după o componentă anume, utile când contractul o prevede explicit.
  • Atenţie la denominare: pentru perioade care încep înainte de 1 iulie 2005, suma dată e presupus în lei vechi, iar rezultatul e tot în lei vechi (1 RON = 10.000 ROL). Coeficientul nu e afectat, fiind adimensional, dar un rezultat de 16 milioane arată ca o eroare dacă nu se ştie în ce monedă e. Răspunsul avertizează.
  • INS publică indicele cu aproximativ două luni întârziere, deci pana_la nu poate depăşi ultima lună acoperită — meta.acoperire o spune la fiecare cerere.
  • Dacă din interval lipsesc luni, coeficientul e calculat pe mai puţine şi se raportează: luni faţă de luni_asteptate, plus un avertisment. Altfel ar arăta ca o indexare completă.
  • Tot calculul e în aritmetică zecimală exactă. Un produs de câteva sute de factori în virgulă mobilă acumulează eroare exact acolo unde rezultatul e o sumă de bani — la 341 de luni sunt 341 de înmulţiri.
  • indice=constructii foloseşte ALTĂ METODĂ. Indicele de cost în construcţii are bază fixă (2021 = 100), deci coeficientul e raportul indicilor celor două luni, nu produsul lunilor dintre ele; lunile din mijloc nu intră în calcul. Răspunsul poartă metoda folosită şi cei doi indici, ca cifra să fie trasabilă — ajunge într-o clauză de ajustare, deci într-un act. Fără indice, se foloseşte IPC-ul, ca până acum.
  • indice=productie-industriala foloseşte aceeaşi metodă de raport, pe indicele preţurilor producţiei industriale. Codul din caen merge la clasa cu indice, altfel la diviziune ori secţiune; fără cod, totalul pe industrie. Contează mult care: din 2020-01 până în 2026-06 totalul creşte cu 85,6%, metalurgia cu 60,4%, iar hârtia şi cartonul (clasa 1712) cu 17,9% — toate pe piaţa totală.
  • indice=cost-forta-munca foloseşte seria trimestrială de NIVEL, tot prin raport. Params proprii: caen (orice cod, adus la secţiunea lui) ori grupare=total, ajustare şi componenta. O lună cerută se ancorează pe trimestrul ei. ⚠️ Baza e 2020 = 100, faţă de 2021 la ceilalţi doi indici — nu se raportează unul la altul. Reper 2020-T1 → 2026-T1: total ×1,822, construcţii ×2,110, sănătate ×1,441.
  • indice=castig-salarial e singurul care lucrează cu NIVELURI, nu cu indici: coeficientul e raportul direct al câştigurilor din cele două luni. Params proprii: masura (brut implicit / net), caen şi versiune. Ambele luni trebuie să fie din aceeaşi revizie CAEN — un raport peste ruptura din 2025 ar amesteca două definiţii ale aceleiaşi activităţi, aşa că se refuză explicat.
  • Activitatea se cere ca pe toată platforma. caen primeşte orice cod CAEN, de orice nivel şi din orice revizie, iar ruta îl aduce la ce publică seria — urcând la părinte ori traducându-l prin corespondenţa oficială INS; meta.caen spune codul cerut, cel folosit şi dacă a fost urcat ori convertit. grupare e pentru agregatele sursei care nu sunt coduri CAEN.

La ce folosește

  • Indexarea unei chirii sau a unei rente cu inflaţia.
  • Actualizarea unei pensii de întreţinere.
  • Aducerea la valoarea de azi a unei creanţe vechi.

Structura răspunsului

CâmpTipDescriere
data.de_la string Începutul intervalului acoperit de răspuns.
data.pana_la string Sfârşitul intervalului acoperit de răspuns, inclusiv.
data.categorie string Categoria din clasificarea sursei.
data.luni integer Câţi indici lunari au intrat efectiv în produs.
data.luni_asteptate integer Câţi ar trebui să fie pentru intervalul cerut. Diferenţa semnalează indici lipsă.
data.coeficient string Factorul de indexare, 6 zecimale.
data.coeficient_exact string Factorul nerotunjit, pentru calcule în lanţ.
data.inflatie_cumulata_procent string Creşterea cumulată, în procente.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.formula string
meta.acoperire string Cât acoperă datele pe care le avem, faţă de ce publică sursa.
meta.nota string Precizare despre cum se citesc datele din răspuns — o capcană, o convenţie sau o limită a sursei.
data.suma_indexata string Suma după indexare, rotunjită la doi bani.
data.diferenta string Cât s-a adăugat.
meta.fara_date data e null, iar aici stă motivul. Nu există date de IPC în bază. Luna cerută e înainte de 1991 sau după ultima lună publicată; nedeterminabil — nu există indici pentru interval.
meta.fara_date_cod Cuvântul scurt şi STABIL al motivului, pentru clienţii care comută pe el în cod: fara_date e proză şi se poate reformula, ăsta nu.
meta.caen object Cum s-a înţeles parametrul caen: codul cerut, revizia în care s-a citit şi codul pe care l-a folosit ruta. La o listă de coduri, câte un obiect pe cod.
meta.caen.cerut string Codul CAEN trimis, normalizat (litere mari, fără puncte).
meta.caen.versiune_cerut string Revizia în care s-a citit codul trimis: cea din caen_versiune, altfel prima în care există.
meta.caen.folosit string Codul pe care l-a folosit seria: cel cerut, primul lui părinte publicat ori agregatul sursei care îl cuprinde (02-03).
meta.caen.nivel string Nivelul codului folosit — la rutele de firme, al codului cerut: sectiune, subsectiune, diviziune, grupa, clasa sau agregat.
meta.caen.denumire string Denumirea codului, din nomenclatorul CAEN.
meta.caen.versiune_serie string Revizia CAEN în care publică seria.
meta.caen.conversie boolean true când codul a fost tradus dintr-o revizie în alta prin corespondenţa oficială INS.
meta.caen.urcat boolean true când seria nu publică codul cerut şi s-a folosit un nivel superior.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/calcul/indexare?per_pagina=3&de_la=2024-06-15
{
    "data": {
        "de_la": "2024-06",
        "pana_la": "2026-07",
        "categorie": "total",
        "luni": 25,
        "luni_asteptate": 25,
        "coeficient": "1.173609",
        "coeficient_exact": "1.17360901213229",
        "inflatie_cumulata_procent": "17.36"
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — indicele preţurilor de consum, serie lunară.",
        "formula": "Coeficientul e produsul indicilor lunari împărţiţi la 100, pentru lunile de după `de_la` până la `pana_la` inclusiv. Validat pe inflaţia dec/dec publicată de INS.",
        "acoperire": "1991-01 → 2026-07",
        "nota": "Categoria `total` e coşul complet. Celelalte (alimentare, nealimentare, servicii) indexează după o componentă anume, utile când contractul o prevede explicit."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404caen_nepublicatNici codul, nici părinţii lui nu sunt publicaţi în serie; detalii.disponibile dă cheile. grupare_nepublicata — gruparea nu e în serie; răspunsul dă lista.
422caen_inexistentCodul din caen nu există în nicio revizie CAEN; e o valoare de FILTRU greşită, deci 422, nu 404. interval_gol — luna de plecare nu e înaintea celei finale; sumă sau lună malformată; categorie inexistentă. caen şi grupare trimise împreună, caen_versiune fără caen, ori un cod fără forma CAEN. caen/grupare la ipc ori constructii, care n-au activităţi.
429cota_depasitaCota lunară a planului a fost depăşită (vezi Retry-After).

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "caen_inexistent",
        "mesaj": "Codul din caen nu există în nicio revizie CAEN; e o valoare de FILTRU greşită, deci 422, nu 404. interval_gol — luna de plecare nu e înaintea celei finale; sumă sau lună malformată; categorie inexistentă. caen şi grupare trimise împreună, caen_versiune fără caen, ori un cod fără forma CAEN. caen/grupare la ipc ori constructii, care n-au activităţi.",
        "detalii": {
            "suma": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}