oneapi
Autentificare
Financiar v1 / Inflatie

Indicele armonizat al preţurilor (Eurostat)

Seria lunară a HICP-ului pentru o ţară şi o categorie ECOICOP.

Valorile sunt niveluri raportate la baza 2015 = 100, nu variaţii lunare. Codul de categorie se
întoarce împreună cu clasificarea şi versiunea ei, fiindcă acelaşi cod poate desemna altceva în
versiuni diferite ale ECOICOP.

GET
https://oneapi.ro/api/financiar/v1/hicp

Parametri de interogare

NumeTipDescriereValori acceptate
taraopțional string | null Opţional, implicit RO. Cod de 2 litere sau agregat Eurostat. ex. RO
categorieopțional string | null Opţional, implicit TOTAL (coşul complet; CP00 e acceptat ca sinonim). Cod ECOICOP ver. 2. ex. TOTAL
de_laobligatoriu string Obligatoriu, YYYY-MM. ex. 2024-06ex. 2024ex. 2024-06-15
pana_laopțional string | null Opţional, implicit ultima lună publicată. ex. 2024-06-30

Cum se comportă

  • Seria lunară a HICP-ului pentru o ţară şi o categorie ECOICOP. Acoperă 14 entităţi, inclusiv agregatele EA (zona euro) şi EU27_2020.
  • Valorile sunt NIVELURI raportate la baza 2015 = 100, nu variaţii lunare. Creşterea între două luni e RAPORTUL valorilor, nu diferenţa. E opusul IPC-ului, care e o variaţie — de aceea cele două stau pe rute separate.
  • Codul de categorie se întoarce întotdeauna împreună cu clasificarea şi versiunea ei. Din datele pe ianuarie 2026, Eurostat a trecut HICP la ECOICOP ver. 2 (COICOP 2018) şi a îngheţat seriile vechi la decembrie 2025; servim versiunea 2, retropolată din 1996. Acelaşi cod poate însemna altceva între versiuni — CP0111 e 162,69 în v1 şi 162,76 în v2 pe iunie 2024, fiindcă definiţia s-a schimbat —, deci codul singur nu e un identificator stabil. Totalul se numeşte acum TOTAL; CP00 e încă acceptat în cereri şi înseamnă acelaşi lucru.
  • HICP e coşul armonizat european, calculat cu altă metodologie decât IPC-ul naţional. Cele două nu se compară direct: pentru decembrie 2022, HICP dă 14,14% iar IPC 16,37% — apropiate şi diferite, exact cum trebuie.
  • Baza rămâne 2015 = 100, deşi Eurostat publică acum şi baza 2025 = 100: pe total, seria e aceeaşi cu cea servită înainte de trecerea la ECOICOP ver. 2 (abateri de cel mult 0,05 din revizii). meta.acoperire spune ultima lună publicată la fiecare cerere.

La ce folosește

  • Compararea inflaţiei între ţări.
  • Indexarea unui contract după coşul armonizat.

Structura răspunsului

CâmpTipDescriere
data.tara string Ţara la care se referă valoarea.
data.categorie string Categoria din clasificarea sursei.
data.clasificare string Clasificarea din care provine codul.
data.versiune_clasificare string Versiunea ei. Fără aceste două câmpuri, codul nu identifică stabil o categorie.
data.de_la string Începutul intervalului acoperit de răspuns.
data.pana_la string Sfârşitul intervalului acoperit de răspuns, inclusiv.
data.natura string Mereu indice_cu_baza.
data.baza string Baza indicelui: 2015 = 100.
data.valori[].luna string Luna la care se referă valoarea.
data.valori[].valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.valori integer Valorile seriei, pe perioade.
meta.acoperire string Cât acoperă datele pe care le avem, faţă de ce publică sursa.
meta.natura string
meta.nota string Precizare despre cum se citesc datele din răspuns — o capcană, o convenţie sau o limită a sursei.
meta.fara_date data e null, iar aici stă motivul. Nu avem HICP pentru ţara cerută, ori intervalul e în afara acoperirii.
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/hicp?de_la=2024-06
{
    "data": {
        "tara": "RO",
        "categorie": "TOTAL",
        "clasificare": "ecoicop",
        "versiune_clasificare": "2",
        "de_la": "2024-06",
        "pana_la": "2026-08",
        "natura": "indice_cu_baza",
        "baza": "2015 = 100",
        "valori": [
            {
                "luna": "2024-06",
                "valoare": "149.11"
            }
        ]
    },
    "meta": {
        "sursa": "Eurostat — prc_hicp_minr (ECOICOP ver. 2, indice cu baza 2015 = 100).",
        "valori": 27,
        "acoperire": "1996-01 → 2026-08",
        "natura": "Valorile sunt NIVELURI raportate la baza 2015 = 100, nu variaţii lunare. Creşterea între două luni e raportul valorilor, nu diferenţa.",
        "nota": "HICP e coşul armonizat european, calculat cu altă metodologie decât IPC-ul naţional al INS. Cele două nu se compară direct: pentru decembrie 2022, HICP dă 14,14% iar IPC 16,37% — apropiate şi diferite, exact cum trebuie."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitnegasit pentru categorie inexistentă (răspunsul listează categoriile disponibile).
422validareinterval_gol, interval_prea_lung, parametri malformaţ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": "validare",
        "mesaj": "interval_gol, interval_prea_lung, parametri malformaţi.",
        "detalii": {
            "tara": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}