oneapi
Autentificare
Financiar v1 / Inflatie

Principalele agregate pe locuitor

Cinci agregate ale conturilor naţionale raportate la un locuitor, în lei, din 1995: produsul intern
brut, venitul disponibil brut, economia brută a gospodăriilor, consumul final individual efectiv al
gospodăriilor şi capacitatea sau necesarul lor de finanţare.

GET
https://oneapi.ro/api/financiar/v1/agregate-pe-locuitor

Parametri de interogare

NumeTipDescriereValori acceptate
de_laopțional integer | null Opţional, an, din 1995. 1995 – 2100
pana_laopțional integer | null Opţional, an. 1995 – 2100
agregatlistăopțional text Opţional, sluguri separate prin virgulă. pibvenit_disponibil_bruteconomie_bruta_gospodariiconsum_final_gospodariicapacitate_finantare_gospodarii

Cum se comportă

  • Cinci agregate ale conturilor naţionale raportate la un locuitor, în lei — 155 de valori, anual din 1995 până în 2025, din matricea TEMPO CON107B: produsul intern brut, venitul disponibil brut, economia brută a gospodăriilor, consumul final individual efectiv al gospodăriilor şi capacitatea sau necesarul lor de finanţare.
  • E singurul loc din modul unde agregatele naţionale sunt deja împărţite la populaţie — cifra care se compară direct cu alte ţări, fără să mai fie nevoie de seria demografică.
  • ⚠️ capacitate_finantare_gospodarii poate fi negativă. Atunci gospodăriile împrumută net în loc să economisească — la fel ca soldul B9 din /financiar/v1/conturi-sectoare, unde gospodăriile ies pe minus în 2024.
  • Pentru aceleaşi agregate în valoare absolută, nu pe locuitor: /financiar/v1/conturi-integrate şi /financiar/v1/conturi-sectoare.

La ce folosește

  • PIB-ul pe locuitor în serie lungă, fără să calculezi tu raportul.
  • Venitul disponibil pe locuitor faţă de consumul pe locuitor.
  • Rata de economisire a gospodăriilor, din raportul dintre economia brută şi venitul disponibil.

Structura răspunsului

CâmpTipDescriere
data.unitate string Unitatea de măsură a valorilor. Citeşte-o înainte de a le pune pe un grafic sau de a le aduna.
data.de_la integer Începutul intervalului acoperit de răspuns.
data.pana_la integer Sfârşitul intervalului acoperit de răspuns, inclusiv.
data.filtre array Filtrele aplicate efectiv, aşa cum le-a înţeles ruta — util când o valoare a fost normalizată.
data.ani array Anii pentru care există valori.
data.serii[].agregat string Agregatul din care face parte valoarea.
data.serii[].denumire string Denumirea, aşa cum o publică sursa.
data.serii[].unitate string Lei pe locuitor, la preţuri curente ale fiecărui an.
data.serii[].valori object Valorile seriei, pe perioade.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.acoperire.de_la integer Prima perioadă pentru care avem date.
meta.acoperire.pana_la integer Ultima perioadă pentru care avem date.
meta.serii_returnate integer Câte serii s-au întors efectiv, după filtre şi după plafonul de celule.
meta.nota_semn string Ce înseamnă semnul valorii (intrare/ieşire, creştere/scădere).
meta.nota_agregate string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.fara_date data e null, iar aici stă motivul. Proiecţia peste datele INS e goală. Ca la celelalte serii.
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/agregate-pe-locuitor
{
    "data": {
        "unitate": "lei pe locuitor",
        "de_la": 1995,
        "pana_la": 2025,
        "filtre": [],
        "ani": [
            1995,
            1996,
            1997,
            1998,
            1999,
            2000,
            2001,
            2002,
            2003,
            2004,
            2005,
            2006,
            2007,
            2008,
            2009,
            2010,
            2011,
            2012,
            2013,
            2014,
            2015,
            2016,
            2017,
            2018,
            2019,
            2020,
            2021,
            2022,
            2023,
            2024,
            2025
        ],
        "serii": [
            {
                "agregat": "capacitate_finantare_gospodarii",
                "denumire": "Capacitatea (+) sau necesarul (-) de finantare a gospodariilor populatiei",
                "unitate": "lei pe locuitor",
                "valori": {
                    "1995": "12.9",
                    "1996": "23",
                    "1997": "101.9",
                    "1998": "375.7",
                    "1999": "24.3",
                    "2000": "222.6",
                    "2001": "1326.3",
                    "2002": "83.5",
                    "2003": "637.4",
                    "2004": "584.8",
                    "2005": "379.1",
                    "2006": "413.2",
                    "2007": "-2363.3",
                    "2008": "-1901.6",
                    "2009": "-2137",
                    "2010": "-2280.9",
                    "2011": "-2515.6",
                    "2012": "-3232.2",
                    "2013": "-2461.3",
                    "2014": "-2759.2",
                    "2015": "-3498.9",
                    "2016": "-2838",
                    "2017": "-4857",
                    "2018": "-6777.5",
                    "2019": "-3985.6",
                    "2020": "-1977",
                    "2021": "-5972.1",
                    "2022": "-9274.1",
                    "2023": "-7887.4",
                    "2024": "-4651.9",
                    "2025": "-3977.6"
                }
            }
        ]
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — principalele agregate pe locuitor (TEMPO, matricea CON107B).",
        "acoperire": {
            "de_la": 1995,
            "pana_la": 2025
        },
        "serii_returnate": 5,
        "nota_semn": "`capacitate_finantare_gospodarii` poate fi negativă: atunci gospodăriile împrumută net, nu economisesc.",
        "nota_agregate": "Aceleaşi agregate în valoare absolută, nu pe locuitor: /financiar/v1/conturi-integrate."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă sau invalid.
403feature_indisponibilfinanciar.indici nu e în planul curent.
422validareAgregat ori an în afara formei aşteptate.
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": "Agregat ori an în afara formei aşteptate.",
        "detalii": {
            "de_la": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}