oneapi
Autentificare
Financiar v1 / Inflatie

HICP comparat între ţări

Aceeaşi categorie, mai multe entităţi, acelaşi interval, renormalizate la o bază aleasă de tine.

Renormalizarea e miezul rutei, nu o comoditate. Indicii publicaţi au baza 2015 = 100, deci
răspund la „cât au crescut preţurile din 2015" — rareori întrebarea celui care compară. Rebazaţi la
ianuarie 2020, aceleaşi date spun altceva şi mai clar: în decembrie 2025 România e la 150,88 faţă de
124,14 în zona euro, adică +50,9% faţă de +24,1%. Fiecare punct vine cu ambele valori — nimic
ascuns, dar cifra utilă la vedere.

Acoperirea HICP e pe două paliere. Paisprezece entităţi au arborele COICOP întreg (381–467 de
categorii fiecare, 335 prezente la toate); celelalte cincisprezece au doar indicele total TOTAL,
care e şi categoria implicită. O categorie cerută pentru o entitate care n-o are întoarce 404 cu
lista celor care o au — nu o serie lipsă pe tăcute, pe care ai putea s-o ratezi.

Luna de bază trebuie să existe la toate entităţile cerute. Bulgaria începe în decembrie 1996,
Croaţia în ianuarie 1998, EU27 în decembrie 1999. Rebazarea pe o lună pe care o entitate n-o are ar
însemna puncte de pornire diferite — exact comparaţia falsă pe care ruta există s-o prevină.

Seriile vin ordonate descrescător după creşterea totală: ordinea e răspunsul, nu cea în care
ai scris ţările. variatie_totala e un nivel faţă de bază, nu o rată de inflaţie.

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

Parametri de interogare

NumeTipDescriereValori acceptate
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. 2020-01ex. 2023-01ex. 2022-01
pana_laopțional string | null Opţional, YYYY-MM. Implicit ultima lună publicată de toate. Maximum 360 de luni. ex. 2024-12ex. 2022-12
bazaopțional string | null Opţional, YYYY-MM. Luna care devine 100. Implicit de_la. ex. 2020-01ex. 2023-01ex. 2022-01
tarilistăopțional text Obligatoriu, între 2 şi 10, separate prin virgulă (?tari=RO,PL,EA). Coduri ca la sursă: RO, EL, EA, EU27_2020. ex. RO,PL,EAex. RO,DEex. RO,BG,HU

Cum se comportă

  • Aceeaşi categorie, mai multe entităţi, acelaşi interval, renormalizate la o lună de bază aleasă de tine.
  • Renormalizarea e miezul rutei, nu o comoditate. Indicii publicaţi au baza 2015 = 100, deci răspund la „cât au crescut preţurile din 2015" — rareori întrebarea celui care compară. Rebazaţi la ianuarie 2020, aceleaşi date spun altceva şi mai clar: în decembrie 2025 România e la 150,88 faţă de 124,14 în zona euro, adică +50,9% faţă de +24,1%. Fiecare punct vine cu ambele valori — nimic ascuns, dar cifra utilă la vedere.
  • Acoperirea HICP e pe două paliere. Paisprezece entităţi au arborele COICOP întreg — între 440 şi 550 de categorii ECOICOP ver. 2 fiecare, 371 prezente la toate — iar celelalte cincisprezece au doar indicele total TOTAL, care e şi categoria implicită. O categorie cerută pentru o entitate care n-o are întoarce 404 cu lista celor care o au: nu o serie lipsă pe tăcute, pe care ai putea s-o ratezi.
  • Luna de bază trebuie să existe la toate entităţile cerute. Bulgaria începe în decembrie 1996, Croaţia în decembrie 1997, EU27 în decembrie 1999. Rebazarea pe o lună pe care o entitate n-o are ar însemna puncte de pornire diferite — exact comparaţia falsă pe care ruta există s-o prevină. Refuzul spune fereastra pe care o au toate.
  • Fereastra poate începe totuşi înaintea unei entităţi: atunci fiecare serie îşi declară de_la propriu, iar meta.nota_inceputuri semnalează că nu încep toate deodată. Ce se aliniază tăcut e doar capătul din dreapta, la ultima lună publicată de toate.
  • Seriile vin ordonate descrescător după creşterea totală — ordinea e răspunsul, nu cea în care ai scris ţările.
  • variatie_totala e creşterea nivelului faţă de bază, în procente. Nu e o rată de inflaţie: pentru variaţii lunare şi anuale derivate corect din niveluri, vezi /hicp/variatie.

La ce folosește

  • Cât au crescut preţurile în România faţă de vecini sau faţă de zona euro, de la un moment ales.
  • Compararea unei categorii anume — energie, alimente — între ţările care o publică.
  • Materia primă pentru un grafic cu mai multe ţări, deja pe aceeaşi bază.

Structura răspunsului

CâmpTipDescriere
data.categorie string Categoria comparată.
data.baza string Luna faţă de care s-a renormalizat.
data.de_la string Începutul intervalului acoperit de răspuns.
data.pana_la string Sfârşitul intervalului acoperit de răspuns, inclusiv.
data.serii[].entitate string Codul entităţii, ca la sursă.
data.serii[].de_la string Prima lună cu valoare a acestei entităţi în fereastră — poate diferi de la o entitate la alta.
data.serii[].pana_la string Sfârşitul intervalului acoperit, inclusiv.
data.serii[].puncte integer Numărul de puncte de date.
data.serii[].indice_baza string Indicele publicat în luna de bază, din care iese renormalizarea.
data.serii[].indice_final_renormalizat string Nivelul la sfârşitul ferestrei, cu baza = 100.
data.serii[].variatie_totala string Creşterea faţă de bază, în procente. Un nivel, nu o rată anuală.
data.serii[].valori[].luna string Luna la care se referă valoarea.
data.serii[].valori[].indice string Cifra publicată, cu baza 2015 = 100.
data.serii[].valori[].indice_renormalizat string Aceeaşi cifră raportată la luna din baza.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.entitati integer
meta.luni_interval integer
meta.acoperire object Intervalul fiecărei entităţi pentru categoria cerută — nu pentru entitate în general.
meta.acoperire.EA.de_la string Începutul intervalului acoperit.
meta.acoperire.EA.pana_la string Sfârşitul intervalului acoperit, inclusiv.
meta.acoperire.PL.de_la string Începutul intervalului acoperit.
meta.acoperire.PL.pana_la string Sfârşitul intervalului acoperit, inclusiv.
meta.acoperire.RO.de_la string Începutul intervalului acoperit.
meta.acoperire.RO.pana_la string Sfârşitul intervalului acoperit, inclusiv.
meta.nota_renormalizare string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_ordine string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_variatie string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_acoperire string De ce totalul e o limită de jos, în proză. meta.total_e_limita_de_jos e cuvântul pe care comuţi în cod.
meta.categorii string Categoriile disponibile.
meta.fara_date data e null, iar aici stă motivul. Fereastra 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/hicp/comparat?de_la=2020-01&tari=RO,PL,EA
{
    "data": {
        "categorie": "TOTAL",
        "baza": "2020-01",
        "de_la": "2020-01",
        "pana_la": "2026-08",
        "serii": [
            {
                "entitate": "RO",
                "de_la": "2020-01",
                "pana_la": "2026-08",
                "puncte": 80,
                "indice_baza": "110.09",
                "indice_final_renormalizat": "157.55",
                "variatie_totala": "57.55",
                "valori": [
                    {
                        "luna": "2020-01",
                        "indice": "110.09",
                        "indice_renormalizat": "100.00"
                    }
                ]
            }
        ]
    },
    "meta": {
        "sursa": "Eurostat — HICP lunar (prc_hicp_minr, ECOICOP ver. 2), indici cu baza 2015 = 100.",
        "entitati": 3,
        "luni_interval": 80,
        "acoperire": {
            "EA": {
                "de_la": "1996-01",
                "pana_la": "2026-08"
            },
            "PL": {
                "de_la": "1996-01",
                "pana_la": "2026-08"
            },
            "RO": {
                "de_la": "1996-01",
                "pana_la": "2026-08"
            }
        },
        "nota_renormalizare": "`indice` e cifra publicată, cu baza 2015 = 100. `indice_renormalizat` o raportează la luna din `baza`, care e întrebarea obişnuită a unei comparaţii: cât a crescut fiecare de la un moment ales.",
        "nota_ordine": "Seriile vin ordonate descrescător după `variatie_totala` — ordinea e răspunsul, nu cea în care ai scris ţările.",
        "nota_variatie": "`variatie_totala` e creşterea nivelului faţă de bază, în procente. NU e o rată de inflaţie anuală; pentru variaţii derivate corect din niveluri, vezi `/financiar/v1/hicp/variatie`.",
        "nota_acoperire": "Paisprezece entităţi au arborele COICOP întreg; celelalte cincisprezece au doar `TOTAL`. `acoperire` dă intervalul fiecărei entităţi PENTRU CATEGORIA CERUTĂ.",
        "categorii": "/financiar/v1/hicp/categorii"
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422baza_indisponibilaLuna de bază lipseşte la cineva; răspunsul dă fereastra comună. interval_prea_lung peste 360 de luni. Sub două entităţi, sau lună malformată. categorie_indisponibila — categoria nu există la una dintre entităţi; răspunsul le dă pe cele care o au.
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": "baza_indisponibila",
        "mesaj": "Luna de bază lipseşte la cineva; răspunsul dă fereastra comună. interval_prea_lung peste 360 de luni. Sub două entităţi, sau lună malformată. categorie_indisponibila — categoria nu există la una dintre entităţi; răspunsul le dă pe cele care o au.",
        "detalii": {
            "categorie": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}