oneapi
Autentificare
Financiar v1 / Calcul

Deflatarea unei sume

Inversul indexării: cât valora ATUNCI o sumă de ACUM. 1.000 de lei de decembrie 2025 valorează
635,53 lei în banii lui ianuarie 2020, 581,20 în ai lui ianuarie 2015, 360,20 în ai lui ianuarie 2005.

Nu e /calcul/indexare cu argumentele inversate. Acolo o cerere cu de_la după pana_la
întoarce corect 422 — sensul e parte din contract. Aici se împarte, nu se înmulţeşte; suma dată
trăieşte la celălalt capăt al intervalului, e bani de la pana_la, nu de la de_la; iar
rezultatul răspunde la altă întrebare.

Cu suma_de_referinta răspunde direct la „ce parte din creşterea unui salariu a fost doar
inflaţie". 3.000 de lei în ianuarie 2020 deveniţi 5.000 în decembrie 2025 înseamnă o creştere
nominală de +66,67%, dar una reală de doar +5,92%: inflaţia perioadei a fost 57,35%.

Capcana denominării e mai ascuţită aici decât la indexare. Acolo suma intră şi iese în aceeaşi
epocă. Aici intră în lei noi şi iese într-o lună în care circulau lei vechi: 1.000 de lei de azi
deflataţi la ianuarie 1991 dau 0,22 — corect ca putere de cumpărare, dar un număr care arată ca o
eroare. Rezultatul rămâne în unitatea sumei date, iar când epocile diferă apare şi in_moneda_epocii,
cu factorul alături.

Coeficientul e acelaşi obiect ca la indexare: produsul indicilor lunari, cu luna de plecare exclusă.
putere_de_cumparare e inversul lui — cât dintr-un leu de azi rămâne în banii lunii-ţintă.

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

Parametri de interogare

NumeTipDescriereValori acceptate
sumaopțional string | null Opţional, bani de la pana_la. Fără ea se întoarce doar coeficientul. ex. 1000ex. 5000
suma_de_referintaopțional string | null Opţional, cât era suma chiar la de_la. Cere şi suma; dă creşterea reală, nu doar cea nominală. ex. 1200.00
de_laobligatoriu string Obligatoriu, YYYY-MM. Luna în ai cărei bani se aduce suma. Nu intră în produs. Se acceptă şi o dată completă. ex. 2024-06-15ex. 2024ex. 2015-01
pana_laopțional string | null Opţional, implicit ultima lună acoperită. Luna din care vine suma. ex. 2024-01
categorieopțional string | null Opţional, implicit total. Restul: alimentare, nealimentare, servicii. totalalimentarenealimentareservicii

Cum se comportă

  • Inversul indexării: cât valora ATUNCI o sumă de ACUM. 1.000 de lei de decembrie 2025 valorează 635,53 lei în banii lui ianuarie 2020, 581,20 în ai lui ianuarie 2015 şi 360,20 în ai lui ianuarie 2005.
  • Nu e /calcul/indexare cu argumentele inversate. Acolo o cerere cu de_la după pana_la întoarce corect 422 — sensul e parte din contract. Aici se împarte, nu se înmulţeşte; suma dată trăieşte la celălalt capăt al intervalului, e bani de la pana_la, nu de la de_la; iar rezultatul răspunde la altă întrebare.
  • Cu suma_de_referinta răspunde direct la „ce parte din creşterea unui salariu a fost doar inflaţie". 3.000 de lei în ianuarie 2020 deveniţi 5.000 în decembrie 2025 înseamnă o creştere nominală de +66,67%, dar una reală de doar +5,92%: inflaţia perioadei a fost 57,35%.
  • Capcana denominării e mai ascuţită aici decât la indexare. Acolo suma intră şi iese în aceeaşi epocă. Aici intră în lei noi şi iese într-o lună în care circulau lei vechi: 1.000 de lei de azi deflataţi la ianuarie 1991 dau 0,22 — corect ca putere de cumpărare, dar un număr care arată ca o eroare. suma_deflatata rămâne în unitatea sumei date, iar in_moneda_epocii dă aceeaşi valoare în banii care circulau atunci: 2.239,35 lei vechi.
  • Coeficientul e acelaşi obiect ca la indexare: produsul indicilor lunari împărţiţi la 100, cu luna de plecare exclusă — indicele ei descrie o schimbare petrecută înainte de reper. putere_de_cumparare e inversul lui: cât dintr-un leu de azi rămâne în banii lunii-ţintă.
  • Categoria total e coşul complet; alimentare, nealimentare şi servicii deflatează după o componentă anume.
  • 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. Altfel ar arăta ca o deflatare 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 ce folosește

  • Ce parte din creşterea unui salariu sau a unei pensii a fost doar inflaţie.
  • Compararea a două preţuri din ani diferiţi, la aceeaşi putere de cumpărare.
  • Exprimarea unei sume de azi în banii unui an de referinţă dintr-un contract sau un studiu.

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âte luni au intrat efectiv în produs.
data.luni_asteptate integer Câte ar fi trebuit. Diferenţa înseamnă luni lipsă din serie.
data.coeficient string Produsul indicilor lunari — acelaşi ca la indexare.
data.coeficient_exact string Factorul nerotunjit, pentru calcule în lanţ.
data.inflatie_perioadei_procent string Cât au crescut preţurile pe interval.
data.putere_de_cumparare string Inversul coeficientului: cât dintr-un leu de azi rămâne în banii lunii-ţintă.
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_sens string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.inversul string
data.suma_deflatata string Suma adusă în banii lui de_la, în unitatea sumei date.
data.suma_deflatata_exacta string Aceeaşi, nerotunjită.
data.pierdere string suma − suma_deflatata: cât s-a topit între cele două luni.
data.in_moneda_epocii Apare doar când intervalul trece peste 1 iulie 2005: aceeaşi valoare, în lei vechi, cu factorul alături.
data.comparatie.crestere_nominala_procent Cât a crescut suma pe hârtie.
data.comparatie.crestere_reala_procent Cât a crescut în putere de cumpărare.
meta.fara_date data e null, iar aici stă motivul. Nu există date de IPC în bază. O lună e în afara seriei IPC; răspunsul dă acoperirea. Intervalul n-are indici.
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.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/calcul/deflatare?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_perioadei_procent": "17.36",
        "putere_de_cumparare": "0.852073"
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — indicele preţurilor de consum, serie lunară.",
        "formula": "Suma se ÎMPARTE la coeficientul de indexare al perioadei, care e produsul indicilor lunari împărţiţi la 100, pentru lunile de după `de_la` până la `pana_la` inclusiv.",
        "acoperire": "1991-01 → 2026-07",
        "nota_sens": "`suma` e bani de la `pana_la`, aduşi în banii lui `de_la` — invers faţă de /financiar/v1/calcul/indexare, unde suma e de la `de_la`.",
        "inversul": "/financiar/v1/calcul/indexare"
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422interval_golLuna-ţintă nu e înaintea celei din care vine suma. Sau suma_de_referinta fără suma.
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": "interval_gol",
        "mesaj": "Luna-ţintă nu e înaintea celei din care vine suma. Sau suma_de_referinta fără suma.",
        "detalii": {
            "suma": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}