oneapi
Autentificare
Financiar v1 / Inflatie

IPC şi HICP, comparate

Cei doi indici de preţuri ai României pe acelaşi interval, cu ambele cifre şi diferenţa dintre ele.

Diferenţa e reală şi îşi schimbă semnul. Măsurat decembrie faţă de decembrie: 2022 dă 16,37% la
IPC faţă de 14,14% la HICP — plus 2,23 puncte; 2023 dă 6,61% faţă de 7,01% — minus 0,40;
2024 minus 0,32; 2025 plus 1,11. Nu e o abatere constantă pe care cineva să şi-o poată corecta din
obişnuinţă, şi tocmai de aceea cele două cifre trebuie văzute alături.

Se compară doar TOTALUL. IPC-ul are patru categorii naţionale — total, alimentare, nealimentare,
servicii — iar HICP-ul are arborele ECOICOP. „Mărfuri alimentare" al INS nu e CP01 al
Eurostat: coşurile şi definiţiile diferă, iar perechea ar fi o echivalenţă pe care n-o susţine
niciuna dintre instituţii. De aceea ruta n-are parametru de categorie.

Cele două serii sunt publicate în forme diferite, iar aducerea lor pe acelaşi picior e chiar munca
rutei: INS publică variaţie lunară, Eurostat publică nivel. hicp e derivat din niveluri, ipc e
cifra publicată minus 100, iar hicp_indice rămâne alături ca nivelul să fie verificabil.

Fereastra e cea comună. IPC-ul merge mai departe decât HICP-ul — la ultima măsurare, iunie 2026
faţă de decembrie 2025 — iar o coadă în care doar una publică ar arăta ca o cădere a celeilalte.
meta.acoperire dă şi acoperirea fiecăreia separat.

cumulat dă inflaţia pe toată fereastra, după fiecare metodă. IPC-ul se cumulează prin înmulţirea
variaţiilor lunare, nu prin adunarea lor.

GET
https://oneapi.ro/api/financiar/v1/inflatie/comparat

Parametri de interogare

NumeTipDescriereValori acceptate
de_laobligatoriu string Obligatoriu, YYYY-MM. ex. 2024-06ex. 2024ex. 2024-06-15
pana_laopțional string | null Opţional, YYYY-MM. Implicit ultima lună comună. Maximum 360 de luni. ex. 2024-06-30

Cum se comportă

  • Cei doi indici de preţuri ai României pe acelaşi interval, cu ambele cifre şi diferenţa dintre ele. Azi ar cere două rute, produsul pe una şi raportul pe cealaltă — şi abia apoi ai afla că nu se compară direct.
  • Diferenţa e reală şi ÎŞI SCHIMBĂ SEMNUL. Măsurat decembrie faţă de decembrie: 2022 dă 16,37% la IPC faţă de 14,14% la HICP (+2,23 puncte); 2023 dă 6,61% faţă de 7,01% (−0,40); 2024 −0,32; 2025 +1,11. Nu e o abatere constantă pe care cineva să şi-o poată corecta din obişnuinţă — de aceea cele două cifre trebuie văzute alături, nu una în locul celeilalte.
  • Se compară doar TOTALUL. IPC-ul are patru categorii naţionale — total, alimentare, nealimentare, servicii — iar HICP-ul are arborele ECOICOP. „Mărfuri alimentare" al INS nu e CP01 al Eurostat: coşurile şi definiţiile diferă, iar perechea ar fi o echivalenţă pe care n-o susţine niciuna dintre instituţii. De aceea ruta n-are parametru de categorie.
  • Cele două serii sunt publicate în forme diferite, iar aducerea lor pe acelaşi picior e chiar munca rutei: INS publică variaţie lunară (100,58 = +0,58%), Eurostat publică nivel cu baza 2015 = 100. ipc e cifra publicată minus 100, hicp e derivat din niveluri, iar hicp_indice rămâne alături ca derivarea să fie verificabilă.
  • Fereastra e cea comună. Cele două se publică la date diferite, deci ultima lună diferă adesea — la 15 sep 2026, HICP-ul ajungea la iulie, IPC-ul la iunie —, iar o coadă în care doar una publică ar arăta ca o cădere a celeilalte. meta.acoperire dă şi acoperirea fiecăreia separat, ca decalajul să fie vizibil.
  • cumulat dă inflaţia pe toată fereastra, după fiecare metodă. IPC-ul se cumulează prin ÎNMULŢIREA variaţiilor lunare, nu prin adunarea lor — creşterile se aplică una peste alta. HICP-ul se cumulează prin raportul nivelurilor de la capete: acelaşi drum, măsurat într-un pas.
  • Ambele cumulate pornesc de la închiderea lunii dinaintea ferestrei — cumulat.fereastra o spune. Când acea lună nu există în seria HICP (cazul ferestrei care începe chiar în ianuarie 1996), cumulat.hicp lipseşte şi cumulat.hicp_indisponibil spune de ce, ca să nu pară lipsă de date.

La ce folosește

  • Care e „inflaţia din România" după fiecare dintre cele două măsuri oficiale.
  • Verificarea unei cifre citate, când nu se ştie din care indice provine.
  • Contracte sau analize care trebuie să declare explicit indicele folosit.

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 Mereu total — singura pereche onestă între cele două nomenclatoare.
data.unitate string Mereu procent.
data.cumulat.ipc string Inflaţia cumulată pe fereastră, din produsul variaţiilor lunare.
data.cumulat.hicp string Aceeaşi, din raportul nivelurilor de la capete.
data.cumulat.diferenta string
data.cumulat.luni_ipc integer
data.cumulat.fereastra object Drumul măsurat de amândouă: de la închiderea lunii dinaintea ferestrei până la ultima lună din ea.
data.cumulat.fereastra.de_la string Începutul intervalului acoperit.
data.cumulat.fereastra.pana_la string Sfârşitul intervalului acoperit, inclusiv.
data.cumulat.reper_hicp object Nivelul de pornire al cumulatului HICP.
data.cumulat.reper_hicp.luna string Luna la care se referă valoarea.
data.cumulat.reper_hicp.indice string
data.valori[].luna string Luna la care se referă valoarea.
data.valori[].ipc string Variaţia lunară publicată de INS, ca procent.
data.valori[].hicp string Variaţia lunară derivată din nivelurile Eurostat.
data.valori[].hicp_indice string Nivelul publicat, cu baza 2015 = 100.
data.valori[].diferenta string ipc − hicp, în puncte procentuale.
meta.surse.ipc string
meta.surse.hicp string
meta.acoperire object Fereastra comună, plus acoperirea fiecărei serii separat.
meta.acoperire.de_la string Prima perioadă pentru care avem date.
meta.acoperire.pana_la string Ultima perioadă pentru care avem date.
meta.acoperire.ipc.de_la string Începutul intervalului acoperit.
meta.acoperire.ipc.pana_la string Sfârşitul intervalului acoperit, inclusiv.
meta.acoperire.hicp.de_la string Începutul intervalului acoperit.
meta.acoperire.hicp.pana_la string Sfârşitul intervalului acoperit, inclusiv.
meta.puncte integer Numărul de puncte de date.
meta.luni_interval integer
meta.nota_diferenta string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_categorie string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_derivare string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_fereastra string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_cumulat string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.serie_ipc string
meta.serie_hicp string
data.cumulat.hicp_indisponibil Apare doar când luna de ancorare lipseşte din serie; explică absenţa lui cumulat.hicp.
meta.fara_date data e null, iar aici stă motivul. Una dintre serii lipseşte din bază. Intervalul e în întregime în afara ferestrei comune, pe care răspunsul o dă. Se suprapune peste ea, dar n-are valori.
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/inflatie/comparat?de_la=2024-06
{
    "data": {
        "de_la": "2024-06",
        "pana_la": "2026-07",
        "categorie": "total",
        "unitate": "procent",
        "cumulat": {
            "ipc": "17.64",
            "hicp": "16.09",
            "diferenta": "1.55",
            "luni_ipc": 26,
            "fereastra": {
                "de_la": "2024-05",
                "pana_la": "2026-07"
            },
            "reper_hicp": {
                "luna": "2024-05",
                "indice": "149.02"
            }
        },
        "valori": [
            {
                "luna": "2024-06",
                "ipc": "0.24",
                "hicp": "0.06",
                "hicp_indice": "149.11",
                "diferenta": "0.18"
            }
        ]
    },
    "meta": {
        "surse": {
            "ipc": "INS — indicele preţurilor de consum, publicat ca variaţie lunară.",
            "hicp": "Eurostat — HICP, publicat ca nivel cu baza 2015 = 100."
        },
        "acoperire": {
            "de_la": "1996-01",
            "pana_la": "2026-07",
            "ipc": {
                "de_la": "1991-01",
                "pana_la": "2026-07"
            },
            "hicp": {
                "de_la": "1996-01",
                "pana_la": "2026-08"
            }
        },
        "puncte": 26,
        "luni_interval": 26,
        "nota_diferenta": "Diferenţa dintre cei doi indici e reală şi ÎŞI SCHIMBĂ SEMNUL. Dec/dec: 2022 +2,23 puncte (16,37% vs 14,14%), 2023 −0,40 (6,61% vs 7,01%), 2024 −0,32, 2025 +1,11. Nu e o abatere constantă, deci nu poate fi corectată din obişnuinţă.",
        "nota_categorie": "Se compară doar TOTALUL. „Mărfuri alimentare\" al INS nu e `CP01` al Eurostat — coşurile şi definiţiile diferă — iar perechea ar fi o echivalenţă pe care n-o susţine niciuna dintre instituţii.",
        "nota_derivare": "`ipc` e cifra publicată de INS minus 100. `hicp` e derivat din niveluri, ca raport faţă de luna precedentă; `hicp_indice` e nivelul publicat, ca derivarea să fie verificabilă.",
        "nota_fereastra": "Fereastra e intersecţia celor două acoperiri. IPC-ul merge de obicei mai departe decât HICP-ul; o coadă în care doar una publică ar arăta ca o cădere a celeilalte.",
        "nota_cumulat": "IPC-ul se cumulează prin ÎNMULŢIREA variaţiilor lunare, nu prin adunare. HICP-ul se cumulează prin raportul nivelurilor de la capete, pornind de la luna dinaintea ferestrei — acelaşi drum, măsurat într-un pas.",
        "serie_ipc": "/financiar/v1/ipc",
        "serie_hicp": "/financiar/v1/hicp/variatie"
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareinterval_prea_lung peste 360 de luni, sau lună malformată.
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": "validare",
        "mesaj": "interval_prea_lung peste 360 de luni, sau lună malformată.",
        "detalii": {
            "de_la": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}