oneapi
Autentificare
Financiar v1 / Inflatie

Variaţia HICP

Variaţia preţurilor derivată corect din niveluri — raportul valorilor, nu diferenţa — şi în
toate cele trei definiţii care circulă.

HICP-ul e un NIVEL, nu o variaţie, iar cine scade două niveluri şi citeşte rezultatul ca procent
greşeşte. Greşeala nu e nici măcar consecventă: în decembrie 2022 raportul dă +14,14%, dar scăderea
dă 16,79 — supraevaluare cu 2,65 puncte; în decembrie 2008 raportul dă +6,38%, iar scăderea
4,81 — subevaluare. Nu e o abatere cu semn constant, pe care cineva să şi-o corecteze din
obişnuinţă.

Cele trei definiţii diferă mult între ele. Pentru decembrie 2022, variaţia anuală dă 14,14%, iar
media ultimelor douăsprezece luni raportată la media celor douăsprezece anterioare dă 12,02% —
două puncte pe aceleaşi date. A doua e definiţia din Protocolul nr. 13, cea folosită de
/convergenta/criteriu-dobanda. Ruta le întoarce pe toate trei, cu nume care spun ce sunt: alegerea
tăcută a uneia ar fi o decizie luată în locul tău.

Nimic nu presupune semn pozitiv: seria românească are 17 luni cu variaţie anuală negativă
(2015–2016, tăierea TVA), cu minimul de −2,96% în mai 2016. Şi nimic nu presupune valori mici: iunie
1997 dă +177,70%, corect.

Primele luni ale ferestrei n-au întotdeauna de unde să aibă variaţie — anuala cere douăsprezece luni
în urmă, media pe douăsprezece cere douăzeci şi patru. Seria se citeşte cu istoricul necesar în
spate, iar unde tot nu ajunge, câmpul e null, nu 0: un zero ar spune „preţurile n-au mişcat".

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

Parametri de interogare

NumeTipDescriereValori acceptate
taraopțional string | null Opţional, implicit RO. Cod ca la sursă: RO, EL, EA, EU27_2020. max 16 car.
categorieopțional string | null Opţional, implicit TOTAL (indicele total; CP00 e acceptat ca sinonim). Alte categorii există doar la paisprezece entităţi. max 32 car.
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ă publicată. Maximum 360 de luni. ex. 2024-06-30

Cum se comportă

  • Variaţia preţurilor derivată corect din niveluri — raportul valorilor, nu diferenţa — şi în toate cele trei definiţii care circulă.
  • HICP-ul e un NIVEL, nu o variaţie, iar cine scade două niveluri şi citeşte rezultatul ca procent greşeşte. Greşeala nu e nici măcar consecventă: în decembrie 2022 raportul dă +14,14%, dar scăderea dă 16,79 — supraevaluare cu 2,65 puncte; în decembrie 2008 raportul dă +6,38%, iar scăderea 4,81 — subevaluare. Nu e o abatere cu semn constant, pe care cineva să şi-o corecteze din obişnuinţă.
  • Cele trei definiţii diferă mult între ele. Pentru decembrie 2022: variaţia anuală dă 14,14%, iar media ultimelor douăsprezece luni raportată la media celor douăsprezece anterioare dă 12,02% — două puncte pe aceleaşi date. A doua e definiţia din Protocolul nr. 13, cea folosită de /convergenta/criteriu-dobanda. Ruta le întoarce pe toate trei, cu nume care spun ce sunt: alegerea tăcută a uneia ar fi o decizie luată în locul tău.
  • Nimic nu presupune semn pozitiv. Seria românească are 17 luni cu variaţie anuală negativă — 2015–2016, tăierea TVA — cu minimul de −2,96% în mai 2016, şi 41 de luni cu variaţie lunară negativă. rezumat.*.luni_negative le numără în fereastra cerută.
  • Şi nimic nu presupune valori mici: iunie 1997 dă +177,70% anual. Seria acoperă hiperinflaţia, iar cifra e corectă, nu o eroare de calcul.
  • Primele luni ale ferestrei n-au întotdeauna de unde să aibă variaţie: anuala cere douăsprezece luni în urmă, media pe douăsprezece cere douăzeci şi patru. Seria se citeşte cu istoricul necesar în spate, iar unde tot nu ajunge, câmpul e null, nu 0 — un zero ar spune „preţurile n-au mişcat", ceea ce e altceva decât „nu se poate calcula".
  • O fereastră incompletă se refuză, nu se completează cu ce e: o medie pe unsprezece luni prezentată ca medie pe douăsprezece ar fi o cifră care arată la fel şi înseamnă altceva.
  • O singură entitate. Comparaţia între ţări e altă întrebare şi are ruta ei: /hicp/comparat.

La ce folosește

  • Rata de inflaţie armonizată, în definiţia potrivită întrebării.
  • Compararea propriei cifre cu cea din criteriul de convergenţă, fără a le confunda.
  • Urmărirea unei categorii anume — energie, alimente — în variaţie, nu în nivel.

Structura răspunsului

CâmpTipDescriere
data.tara string Ţara la care se referă valoarea.
data.categorie string Categoria din clasificarea sursei.
data.de_la string Începutul intervalului acoperit de răspuns.
data.pana_la string Sfârşitul intervalului acoperit de răspuns, inclusiv.
data.unitate string Mereu procent.
data.rezumat object Pentru fiecare definiţie: ultima valoare, minimul, maximul, câte luni au fost negative şi câte puncte au putut fi calculate.
data.rezumat.variatie_lunara.ultima.luna string Luna la care se referă valoarea.
data.rezumat.variatie_lunara.ultima.valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.
data.rezumat.variatie_lunara.minim.luna string Luna la care se referă valoarea.
data.rezumat.variatie_lunara.minim.valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.
data.rezumat.variatie_lunara.maxim.luna string Luna la care se referă valoarea.
data.rezumat.variatie_lunara.maxim.valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.
data.rezumat.variatie_lunara.luni_negative integer
data.rezumat.variatie_lunara.puncte integer Numărul de puncte de date.
data.rezumat.variatie_anuala.ultima.luna string Luna la care se referă valoarea.
data.rezumat.variatie_anuala.ultima.valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.
data.rezumat.variatie_anuala.minim.luna string Luna la care se referă valoarea.
data.rezumat.variatie_anuala.minim.valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.
data.rezumat.variatie_anuala.maxim.luna string Luna la care se referă valoarea.
data.rezumat.variatie_anuala.maxim.valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.
data.rezumat.variatie_anuala.luni_negative integer
data.rezumat.variatie_anuala.puncte integer Numărul de puncte de date.
data.rezumat.variatie_medie_12luni.ultima.luna string Luna la care se referă valoarea.
data.rezumat.variatie_medie_12luni.ultima.valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.
data.rezumat.variatie_medie_12luni.minim.luna string Luna la care se referă valoarea.
data.rezumat.variatie_medie_12luni.minim.valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.
data.rezumat.variatie_medie_12luni.maxim.luna string Luna la care se referă valoarea.
data.rezumat.variatie_medie_12luni.maxim.valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.
data.rezumat.variatie_medie_12luni.luni_negative integer
data.rezumat.variatie_medie_12luni.puncte integer Numărul de puncte de date.
data.valori[].luna string Luna la care se referă valoarea.
data.valori[].indice string Nivelul publicat, cu baza 2015 = 100.
data.valori[].variatie_lunara string Faţă de luna precedentă.
data.valori[].variatie_anuala string Faţă de aceeaşi lună a anului trecut — rata de inflaţie obişnuită.
data.valori[].variatie_medie_12luni string Media ultimelor 12 luni faţă de media celor 12 anterioare — definiţia din Protocolul nr. 13.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.acoperire object Intervalul entităţii pentru categoria cerută.
meta.acoperire.de_la string Prima perioadă pentru care avem date.
meta.acoperire.pana_la string Ultima perioadă pentru care avem date.
meta.puncte integer Numărul de puncte de date.
meta.luni_interval integer
meta.nota_derivare string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_definitii string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_null string De ce lipsesc unele valori: sursa nu le-a publicat, nu le-a calculat ori le-a suprimat.
meta.nota_semn string Ce înseamnă semnul valorii (intrare/ieşire, creştere/scădere).
meta.comparatie_intre_tari string
meta.fara_date data e null, iar aici stă motivul. Fereastra 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/variatie?de_la=2024-06
{
    "data": {
        "tara": "RO",
        "categorie": "TOTAL",
        "de_la": "2024-06",
        "pana_la": "2026-08",
        "unitate": "procent",
        "rezumat": {
            "variatie_lunara": {
                "ultima": {
                    "luna": "2026-08",
                    "valoare": "0.26"
                },
                "minim": {
                    "luna": "2026-06",
                    "valoare": "-0.06"
                },
                "maxim": {
                    "luna": "2025-08",
                    "valoare": "2.10"
                },
                "luni_negative": 1,
                "puncte": 27
            },
            "variatie_anuala": {
                "ultima": {
                    "luna": "2026-08",
                    "valoare": "6.27"
                },
                "minim": {
                    "luna": "2024-09",
                    "valoare": "4.84"
                },
                "maxim": {
                    "luna": "2026-05",
                    "valoare": "9.75"
                },
                "luni_negative": 0,
                "puncte": 27
            },
            "variatie_medie_12luni": {
                "ultima": {
                    "luna": "2026-08",
                    "valoare": "8.58"
                },
                "minim": {
                    "luna": "2025-05",
                    "valoare": "5.24"
                },
                "maxim": {
                    "luna": "2026-07",
                    "valoare": "8.77"
                },
                "luni_negative": 0,
                "puncte": 27
            }
        },
        "valori": [
            {
                "luna": "2024-06",
                "indice": "149.11",
                "variatie_lunara": "0.06",
                "variatie_anuala": "5.34",
                "variatie_medie_12luni": "7.31"
            }
        ]
    },
    "meta": {
        "sursa": "Eurostat — HICP lunar (prc_hicp_minr, ECOICOP ver. 2), indici cu baza 2015 = 100.",
        "acoperire": {
            "de_la": "1996-01",
            "pana_la": "2026-08"
        },
        "puncte": 27,
        "luni_interval": 27,
        "nota_derivare": "Variaţiile sunt RAPORTUL nivelurilor, nu diferenţa lor. Scăderea a două niveluri citită ca procent greşeşte în ambele sensuri: decembrie 2022 dă 16,79 în loc de 14,14%, decembrie 2008 dă 4,81 în loc de 6,38%.",
        "nota_definitii": "`variatie_anuala` e nivelul faţă de nivelul de acum douăsprezece luni — rata de inflaţie obişnuită. `variatie_medie_12luni` e media ultimelor 12 luni faţă de media celor 12 anterioare, definiţia din Protocolul nr. 13 folosită de /financiar/v1/convergenta/criteriu-dobanda. Diferă real: 14,14% faţă de 12,02% în decembrie 2022.",
        "nota_null": "`null` înseamnă „nu se poate calcula\" — lipseşte luna de referinţă — nu „zero\". Anuala cere 12 luni în urmă, media pe 12 luni cere 24.",
        "nota_semn": "Variaţiile pot fi negative: seria românească are 17 luni cu variaţie anuală sub zero (2015–2016), minimul −2,96% în mai 2016. `rezumat.*.luni_negative` le numără în fereastra cerută.",
        "comparatie_intre_tari": "/financiar/v1/hicp/comparat"
    }
}

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ă. entitate_necunoscuta — nu avem HICP pentru entitatea cerută; răspunsul le listează pe cele disponibile. categorie_indisponibila — entitatea există dar n-are categoria.
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ă. entitate_necunoscuta — nu avem HICP pentru entitatea cerută; răspunsul le listează pe cele disponibile. categorie_indisponibila — entitatea există dar n-are categoria.",
        "detalii": {
            "tara": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}