oneapi
Autentificare
Financiar v1 / Inflatie

Contul gospodăriilor populaţiei pe regiuni

De unde vine şi cât rămâne din venitul gospodăriilor, regiune cu regiune, anual din 2000: veniturile
primare încasate, impozitele şi cotizaţiile plătite, prestaţiile sociale primite şi cele două
solduri — soldul veniturilor primare şi venitul disponibil net.

Altă logică decât restul conturilor regionale: n-are ramuri deloc, are laturi de cont şi solduri
care se verifică unul din celălalt.

GET
https://oneapi.ro/api/financiar/v1/conturi-regionale/gospodarii

Parametri de interogare

NumeTipDescriereValori acceptate
laturaopțional string | null Opţional: resurse ori utilizari. resurseutilizari
de_laopțional integer | null Opţional, an, din 2000. 2000 – 2100
pana_laopțional integer | null Opţional, an. 2000 – 2100
teritoriulistăopțional text Opţional, coduri scurte separate prin virgulă. Fără el se întoarce ţara. ex. total
operatiunelistăopțional text Opţional, sluguri de operaţiune separate prin virgulă. excedent_net_venit_mixtremunerare_angajativenituri_proprietatesold_venituri_primareimpozite_curentecotizatii_socialeprestatii_socialealte_transferurivenit_disponibil_net

Cum se comportă

  • Contul regional al gospodăriilor populaţiei — 4.368 de valori, anual din 2000 până în 2023, din matricea TEMPO CON120A. Nouă operaţiuni × resurse şi utilizări × 14 teritorii, în milioane lei.
  • Altă logică decât restul conturilor regionale: n-are ramuri deloc. Are laturi de cont şi două solduri care se verifică unul din celălalt — soldul veniturilor primare şi venitul disponibil net.
  • ✅ sold_venituri_primare = excedentul net + remunerarea încasată + veniturile din proprietate încasate − cele plătite: 336 din 336.
  • ✅ venit_disponibil_net = soldul primar + prestaţiile sociale + transferurile încasate − impozitele curente − cotizaţiile sociale − transferurile plătite: 336 din 336.
  • Ce arată cifrele, în 2023 pe ţară: din 932.862,1 milioane lei sold al veniturilor primare — din care remunerarea angajaţilor 638.943 şi excedentul net 268.302 — se scad 220.086 cotizaţii sociale şi 43.332,2 impozite curente, se adaugă 190.973,6 prestaţii sociale, şi rămâne un venit disponibil net de 878.853,1 milioane lei.
  • ⚠️ Soldurile sunt publicate pe latura utilizărilor, aşa cere convenţia contabilă — un sold închide latura pe care stă. Câmpul este_sold le marchează, ca să nu fie citite ca nişte cheltuieli.
  • ⚠️ Contul gospodăriilor nu se publică pe judeţe, doar pe ţară, macroregiuni, regiuni şi extra_regiuni. Pentru ocupare şi salarii la nivel de judeţ: /financiar/v1/conturi-regionale.

La ce folosește

  • Venitul disponibil al gospodăriilor pe regiune, în serie lungă.
  • Cât din venitul primar al unei regiuni se duce în impozite şi cotizaţii.
  • Ponderea prestaţiilor sociale în venitul gospodăriilor, pe regiuni.

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.teritoriu array Teritoriul la care se referă valoarea.
data.ani array Anii pentru care există valori.
data.serii[].teritoriu string Teritoriul la care se referă valoarea.
data.serii[].denumire_teritoriu string Denumirea exactă de la sursă, aşa cum e scrisă în matricea ei.
data.serii[].nivel_teritoriu string Nivelul teritorial al valorii (ţară, regiune, judeţ, localitate).
data.serii[].cont string Contul din secvenţă: alocarea veniturilor primare ori distribuirea secundară.
data.serii[].operatiune string
data.serii[].denumire_operatiune string
data.serii[].latura string Latura contului (resurse ori utilizări).
data.serii[].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.serii[].ani_publicati integer Anii pe care sursa i-a publicat efectiv pentru seria asta.
data.serii[].valori object Valorile seriei, pe perioade.
data.identitati.toleranta string Cât se acceptă ca abatere înainte ca identitatea să fie considerată neînchisă — rotunjirea sursei, nu o eroare.
data.identitati.sold_primar.identitate string Identitatea verificată — ce sumă trebuie să dea ce total.
data.identitati.sold_primar.nota string Precizare despre cum se citesc datele — o capcană, o convenţie sau o limită a sursei.
data.identitati.sold_primar.verificari integer Câte combinaţii au fost verificate.
data.identitati.sold_primar.inchise integer Câte verificări s-au închis în toleranţă.
data.identitati.venit_disponibil.identitate string Identitatea verificată — ce sumă trebuie să dea ce total.
data.identitati.venit_disponibil.nota string Precizare despre cum se citesc datele — o capcană, o convenţie sau o limită a sursei.
data.identitati.venit_disponibil.verificari integer Câte combinaţii au fost verificate.
data.identitati.venit_disponibil.inchise integer Câte verificări s-au închis în toleranţă.
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_implicit string Ce valoare s-a folosit când parametrul n-a fost trimis.
meta.nota_solduri string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_judet string Ce trebuie ştiut despre defalcarea pe judeţe: ce cuprinde şi ce rămâne neatribuit.
meta.nota_identitate string Cum se verifică identitatea de mai sus şi ce înseamnă când nu se închide.
meta.nota_national string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
data.serii[].este_sold Marchează cele două solduri, publicate pe latura utilizărilor.
meta.fara_date string data e null, iar aici stă motivul. Proiecţia peste datele INS e goală. Contul nu se publică pe judeţe. Ca la celelalte serii.
meta.fara_date_cod string 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/conturi-regionale/gospodarii
{
    "data": {
        "unitate": "milioane lei",
        "de_la": 2000,
        "pana_la": 2023,
        "filtre": {
            "teritoriu": [
                "total"
            ]
        },
        "ani": [
            2000,
            2001,
            2002,
            2003,
            2004,
            2005,
            2006,
            2007,
            2008,
            2009,
            2010,
            2011,
            2012,
            2013,
            2014,
            2015,
            2016,
            2017,
            2018,
            2019,
            2020,
            2021,
            2022,
            2023
        ],
        "serii": [
            {
                "teritoriu": "total",
                "denumire_teritoriu": "Total",
                "nivel_teritoriu": "tara",
                "cont": "II.1.2",
                "operatiune": "excedent_net_venit_mixt",
                "denumire_operatiune": "II.1.2 Contul de alocare a veniturilor primare B2N/ B3N  Excedentul net de exploatare/ Venitul mixt net",
                "latura": "resurse",
                "unitate": "milioane lei",
                "ani_publicati": 24,
                "valori": {
                    "2000": "15457.5",
                    "2001": "25124.4",
                    "2002": "27517.2",
                    "2003": "30737.5",
                    "2004": "47345.8",
                    "2005": "50459.8",
                    "2006": "59985.7",
                    "2007": "80491.3",
                    "2008": "94253.9",
                    "2009": "87543",
                    "2010": "108681.7",
                    "2011": "118941.1",
                    "2012": "113591.9",
                    "2013": "137018.5",
                    "2014": "132354.3",
                    "2015": "143336.7",
                    "2016": "149507.4",
                    "2017": "167068.2",
                    "2018": "163145.4",
                    "2019": "204654.9",
                    "2020": "201740.4",
                    "2021": "212356.6",
                    "2022": "238172.7",
                    "2023": "268302"
                }
            }
        ],
        "identitati": {
            "toleranta": "0.5",
            "sold_primar": {
                "identitate": "`sold_venituri_primare` = excedentul net + remunerarea încasată + veniturile din proprietate încasate − cele plătite",
                "nota": "Verificat pe toată proiecţia: 336 din 336.",
                "verificari": 24,
                "inchise": 24
            },
            "venit_disponibil": {
                "identitate": "`venit_disponibil_net` = soldul primar + prestaţiile sociale + transferurile încasate − impozitele curente − cotizaţiile sociale − transferurile plătite",
                "nota": "Verificat pe toată proiecţia: 336 din 336. În 2023, pe ţară, venitul disponibil net e 878.853,1 milioane lei.",
                "verificari": 24,
                "inchise": 24
            }
        }
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — conturile regionale ale gospodăriei populaţiei (TEMPO, matricea CON120A).",
        "acoperire": {
            "de_la": 2000,
            "pana_la": 2023
        },
        "serii_returnate": 13,
        "nota_implicit": "Fără `teritoriu`, răspunsul se opreşte la ţară.",
        "nota_solduri": "Soldurile sunt publicate pe latura utilizărilor, aşa cere convenţia contabilă; câmpul `este_sold` le marchează.",
        "nota_judet": "Contul gospodăriilor se publică doar pe ţară, macroregiuni, regiuni şi `extra_regiuni` — nu şi pe judeţe.",
        "nota_identitate": "Verificat pe acest răspuns: venitul disponibil net se închide din componentele lui în 24 din 24 celule.",
        "nota_national": "Pentru acelaşi cont pe sectoare instituţionale, la nivel naţional: /financiar/v1/conturi-integrate."
    }
}

Coduri de eroare

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