oneapi
Autentificare
Financiar v1 / Inflatie

Catalogul categoriilor IPC

Cele 106 mărfuri şi servicii pe care se publică indicele preţurilor de consum, grupate pe nivel, cu
codul de folosit în /financiar/v1/ipc/produse şi intervalul publicat al fiecăreia.

Catalogul depinde de bază: pe an_anterior sursa publică o categorie mai puţin — „jocuri de
noroc" lipseşte cu totul — de unde 105 în loc de 106.

GET
https://oneapi.ro/api/financiar/v1/ipc/categorii

Parametri de interogare

NumeTipDescriereValori acceptate
bazaopțional string | null Opţional: luna_anterioara (implicit), decembrie, an_anterior. Schimbă lista. luna_anterioaradecembriean_anterior

Cum se comportă

  • Categoriile pe care se publică indicele preţurilor de consum, grupate pe nivel, cu codul de folosit în /financiar/v1/ipc/produse şi intervalul publicat al fiecăreia.
  • Catalogul depinde de bază. Pe luna_anterioara şi decembrie sunt 106 categorii; pe an_anterior doar 105 — „jocuri de noroc" lipseşte, fiind introdusă abia în 2026-01, prea recent pentru o rată anuală.
  • Structura: 1 total, 3 agregate, 35 de grupe, 67 de subcategorii. Primele patru sunt publicate din 1991, restul din 2001 — de_la şi pana_la din catalog o arată pentru fiecare.
  • ⚠️ Subcategoriile poartă în sursă prefixul - , dar sursa nu spune sub ce grupă stau. Ruta nu deduce legătura: nu există coduri, iar ordinea din tabel nu se păstrează.

La ce folosește

  • Găsirea codului unei mărfi înainte de a cere seria ei.
  • Verificarea din ce an e publicată o categorie anume.
  • Lista completă a ce se poate cere pe fiecare bază.

Structura răspunsului

CâmpTipDescriere
data.baza string
data.descriere_baza string Ce reprezintă baza de raportare, în cuvinte.
data.categorii integer Categoriile disponibile.
data.pe_nivel object Câte categorii are fiecare nivel pe baza cerută.
data.pe_nivel.agregat integer Agregatul din care face parte valoarea.
data.pe_nivel.grupa integer
data.pe_nivel.subcategorie integer
data.pe_nivel.total integer
data.niveluri.agregat[].categorie string Categoria din clasificarea sursei.
data.niveluri.agregat[].denumire string Denumirea, aşa cum o publică sursa.
data.niveluri.agregat[].de_la string Începutul intervalului acoperit.
data.niveluri.agregat[].pana_la string Sfârşitul intervalului acoperit, inclusiv.
data.niveluri.agregat[].luni integer Numărul de luni acoperite.
data.niveluri.grupa[].categorie string Categoria din clasificarea sursei.
data.niveluri.grupa[].denumire string Denumirea, aşa cum o publică sursa.
data.niveluri.grupa[].de_la string Începutul intervalului acoperit.
data.niveluri.grupa[].pana_la string Sfârşitul intervalului acoperit, inclusiv.
data.niveluri.grupa[].luni integer Numărul de luni acoperite.
data.niveluri.subcategorie[].categorie string Categoria din clasificarea sursei.
data.niveluri.subcategorie[].denumire string Denumirea, aşa cum o publică sursa.
data.niveluri.subcategorie[].de_la string Începutul intervalului acoperit.
data.niveluri.subcategorie[].pana_la string Sfârşitul intervalului acoperit, inclusiv.
data.niveluri.subcategorie[].luni integer Numărul de luni acoperite.
data.niveluri.total[].categorie string Categoria din clasificarea sursei.
data.niveluri.total[].denumire string Denumirea, aşa cum o publică sursa.
data.niveluri.total[].de_la string Începutul intervalului acoperit.
data.niveluri.total[].pana_la string Sfârşitul intervalului acoperit, inclusiv.
data.niveluri.total[].luni integer Numărul de luni acoperite.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.nota_niveluri string Ce înseamnă fiecare nivel şi care dintre ele se pot compara.
meta.nota_ierarhie string Cum se citeşte ierarhia clasificării şi ce niveluri nu se adună între ele.
data.niveluri[].de_la Prima lună publicată pentru acea categorie.
data.niveluri[].luni Câte luni are seria ei — util ca să se vadă golurile.
meta.fara_date data e null, iar aici stă motivul. Proiecţia peste datele INS e goală.
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/ipc/categorii
{
    "data": {
        "baza": "luna_anterioara",
        "descriere_baza": "faţă de luna anterioară — variaţia lunii, singura bază care se înlănţuie",
        "categorii": 106,
        "pe_nivel": {
            "agregat": 3,
            "grupa": 35,
            "subcategorie": 67,
            "total": 1
        },
        "niveluri": {
            "agregat": [
                {
                    "categorie": "alimentare",
                    "denumire": "Marfuri alimentare",
                    "de_la": "1991-01",
                    "pana_la": "2026-07",
                    "luni": 427
                }
            ],
            "grupa": [
                {
                    "categorie": "alte_marfuri_nealimentare",
                    "denumire": "Alte marfuri nealimentare",
                    "de_la": "2001-01",
                    "pana_la": "2026-07",
                    "luni": 307
                }
            ],
            "subcategorie": [
                {
                    "categorie": "abonament_radio_televiziune",
                    "denumire": "Abonament radio, televiziune",
                    "de_la": "2001-01",
                    "pana_la": "2026-07",
                    "luni": 307
                }
            ],
            "total": [
                {
                    "categorie": "total",
                    "denumire": "Total",
                    "de_la": "1991-01",
                    "pana_la": "2026-07",
                    "luni": 427
                }
            ]
        }
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — indicii preţurilor de consum (TEMPO, matricile IPC102A–IPC102E).",
        "nota_niveluri": "`total` şi `agregat` sunt cele patru categorii mari, publicate din 1991; `grupa` şi `subcategorie` sunt detaliul, publicat din 2001.",
        "nota_ierarhie": "Subcategoriile poartă în sursă prefixul `- `, dar sursa nu spune sub ce grupă stau. Ruta nu deduce legătura."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă sau invalid.
403feature_indisponibilfinanciar.inflatie nu e în planul curent.
422validareUn parametru nu a trecut validarea (baza); detalii spune care şi de ce.
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": "Un parametru nu a trecut validarea (baza); detalii spune care şi de ce.",
        "detalii": {
            "baza": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}