Financiar v1 / Inflatie

Categoriile ECOICOP

Nomenclatorul categoriilor de consum folosite de HICP, filtrabil pe prefix de cod sau pe text din
denumire. Fiecare cod vine cu clasificarea şi versiunea ei.

GET

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

Parametri de interogare

NumeTipDescriereValori acceptate

prefixopțional string | null Opţional. Bucată de cod ECOICOP, ex. CP01. ex. CP01

cautaopțional string | null Opţional. Text căutat în denumire, minim 2 caractere. Denumirile sunt în engleză, ca la Eurostat (bread, nu pâine). max 60 car.

Cum se comportă

Nomenclatorul categoriilor de consum folosite de HICP, filtrabil pe prefix de cod sau pe text din denumire.
Fiecare cod vine cu clasificarea şi versiunea ei, din acelaşi motiv ca în seria de valori: codul singur nu identifică stabil o categorie între versiuni ale clasificării.
Filtrul pe prefix e util pentru a coborî în ierarhie: CP01 întoarce categoria alimentară şi toate subdiviziunile ei.

La ce folosește

Găsirea codului unei categorii înainte de a cere seria.
Popularea unei liste de selecţie a categoriilor.

Structura răspunsului

CâmpTipDescriere

data.categorii[] object[] Categoriile disponibile.

meta.categorii integer Categoriile disponibile.

meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.

meta.nota string Precizare despre cum se citesc datele din răspuns — o capcană, o convenţie sau o limită a sursei.

data.categorii[].cod string Codul ECOICOP. ⚠️ Singur NU identifică stabil o categorie — acelaşi cod poate desemna altceva în altă versiune.

data.categorii[].denumire string Denumirea Eurostat, în engleză (nomenclatorul nu e tradus la sursă).

data.categorii[].clasificare string Clasificarea din care vine codul, de obicei ecoicop.

data.categorii[].versiune string Versiunea clasificării. Se trimite împreună cu codul, aici şi în seria de valori.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/hicp/categorii?per_pagina=3

{
    "data": {
        "categorii": [
            {
                "cod": "AP",
                "denumire": "Administered prices",
                "clasificare": "ecoicop",
                "versiune": "2"
            }
        ]
    },
    "meta": {
        "categorii": 555,
        "sursa": "Eurostat — nomenclatorul ECOICOP.",
        "nota": "Codul singur nu identifică stabil o categorie: acelaşi cod poate desemna altceva în versiuni diferite ale clasificării. De aceea `clasificare` şi `versiune` însoţesc mereu codul, aici şi în seria de valori."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/hicp/categorii?per_pagina=3&cauta=bread

{
    "data": {
        "categorii": [
            {
                "cod": "CP01113",
                "denumire": "Bread and bakery products (ND)",
                "clasificare": "ecoicop",
                "versiune": "2"
            }
        ]
    },
    "meta": {
        "categorii": 2,
        "sursa": "Eurostat — nomenclatorul ECOICOP.",
        "nota": "Codul singur nu identifică stabil o categorie: acelaşi cod poate desemna altceva în versiuni diferite ale clasificării. De aceea `clasificare` şi `versiune` însoţesc mereu codul, aici şi în seria de valori."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/hicp/categorii?cauta=Cluj

{
    "data": {
        "categorii": []
    },
    "meta": {
        "categorii": 0,
        "sursa": "Eurostat — nomenclatorul ECOICOP.",
        "nota": "Codul singur nu identifică stabil o categorie: acelaşi cod poate desemna altceva în versiuni diferite ale clasificării. De aceea `clasificare` şi `versiune` însoţesc mereu codul, aici şi în seria de valori."
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
422	validare	Prefix malformat sau căutare prea scurtă.
429	cota_depasita	Cota 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": "Prefix malformat sau căutare prea scurtă.",
        "detalii": {
            "prefix": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}