oneapi
Autentificare
Energie v1 / Balanţe energetice

Balanţa energetică pe elemente

Cele 27 de elemente ale balanţei energetice — de la producţia de energie primară şi import, prin
intrările şi ieşirile din transformare, până la consumul final pe ramuri şi la diferenţele
statistice. 2.903 de valori, anual 1992-2024 (IND108A, IND110A, IND111A).

⚠️ Purtătorul face parte din identitatea seriei. Aceleaşi 27 de elemente sunt publicate pe
trei purtători, în unităţi diferite: total în mii tep, electrica în milioane kWh,
termica în mii Gcal şi terajouli. Adunaţi, s-ar număra de trei ori aceeaşi energie.
Implicit se întoarce purtătorul total.

⚠️ Energia termică e publicată în două unităţi deodată, pe toată perioada. Verificat pe 592
de perechi: 523 respectă exact factorul standard 4,1868 TJ / mie Gcal; cele 69 de abateri stau
pe valori mici (medie 28, faţă de 12.579 la cele conforme), deci sunt rotunjiri ale sursei.
Sunt aceeaşi mărime în două unităţi, nu două mărimi — nu se adună.

⚠️ Elementele nu sunt o partiţie. E un bilanţ: unele elemente sunt resurse, altele utilizări,
altele sub-poziţii ale acestora. Însumate la grămadă, nu înseamnă nimic. Identitatea pe care sursa
o respectă exact, verificată 33 de ani din 33: Resurse-total = producţia de energie primară

  • import + stocul la 1 ianuarie.
GET
https://oneapi.ro/api/energie/v1/balante/elemente

Parametri de interogare

NumeTipDescriereValori acceptate
purtatoropțional string | null total (implicit), electrica ori termica. totalelectricatermica
elementopțional string | null Slugul unui element de balanţă din nomenclator. ex. import
umopțional string | null Unitatea. Util doar la termica, unde sursa publică două. ex. terrajouli
de_laopțional string | null Primul an inclus, din 1992. ex. 2010
pana_laopțional string | null Ultimul an inclus. ex. 2024

Cum se comportă

  • Cele 27 de elemente ale balanţei energetice — de la producţia de energie primară şi import, prin intrările şi ieşirile din transformare, până la consumul final pe ramuri şi la diferenţele statistice. 2.903 de valori, anual 1992-2024 (IND108A, IND110A, IND111A).
  • Purtătorul face parte din identitatea seriei. Aceleaşi 27 de elemente sunt publicate pe trei purtători, în unităţi diferite: total în mii tep, electrica în milioane kWh, termica în mii Gcal şi terajouli. Adunaţi, s-ar număra de trei ori aceeaşi energie. Implicit se întoarce total.
  • Energia termică e publicată în două unităţi deodată, pe toată perioada. Verificat pe 592 de perechi: 523 respectă exact factorul standard 4,1868 TJ / mie Gcal; cele 69 de abateri stau pe valori mici (medie 28, faţă de 12.579 la cele conforme), deci sunt rotunjiri ale sursei. Sunt aceeaşi mărime în două unităţi, nu două mărimi.
  • Elementele nu sunt o partiţie. E un bilanţ: unele elemente sunt resurse, altele utilizări, altele sub-poziţii ale acestora. Însumate la grămadă, nu înseamnă nimic. Identitatea pe care sursa o respectă exact, verificată 33 de ani din 33: Resurse-total = producţia de energie primară + import + stocul la 1 ianuarie.

La ce folosește

  • Urmăreşti importul, exportul şi consumul intern brut de energie, an de an.
  • Vezi cât se pierde în transformare şi în transport, separat pe electric şi termic.
  • Compari consumul populaţiei cu cel al industriei, pe acelaşi purtător.

Structura răspunsului

CâmpTipDescriere
data.purtator string Purtătorul cerut — parte din identitatea seriei.
data.serii[].element string Slugul elementului de balanţă.
data.serii[].um string Unitatea. La termica apar două serii, în mii Gcal şi în terajouli.
data.serii[].ani_publicati integer Câţi ani au valoare din intervalul cerut.
data.serii[].valori object An → valoare, ca text zecimal.
data.granularitate string Pasul seriei. La balanțe e mereu anual: INS publică bilanțul o dată pe an.
data.de_la integer Primul an din răspuns.
data.pana_la integer Ultimul an din răspuns.
data.filtre object Filtrele efectiv aplicate, ca să se vadă ce a fost interpretat din cerere.
data.ani array Anii acoperiți, în ordine — cheile din valori.
data.serii[].um_denumire string Unitatea de măsură scrisă în clar. Citește-o: seriile din același răspuns pot fi în unități diferite, iar adunarea lor n-ar însemna nimic.
meta.sursa string Setul INS din care vine seria, cu matricea de origine.
meta.acoperire object Intervalul de ani disponibil în bază pentru zona asta, indiferent de filtrul cerut.
meta.serii_returnate integer Câte serii sunt în răspuns.
data.descriere_purtator string Ce cuprinde purtătorul respectiv.
data.serii[].element_denumire string Denumirea elementului.
meta.nota_purtator string Ce intră și ce nu intră în purtătorul cerut.
meta.nota_bilant string Cum se citește un bilanț energetic: intrări, transformări, consum final.
meta.nota_sen string Relația cu datele în timp real din zona sen.
meta.nota_lista string Unde se găsesc codurile: în nomenclator.

Exemple de răspuns

GEThttps://oneapi.ro/api/energie/v1/balante/elemente?element=import
{
    "data": {
        "purtator": "total",
        "descriere_purtator": "energie totală, în mii tone echivalent petrol (tep)",
        "granularitate": "anual",
        "de_la": 1992,
        "pana_la": 2024,
        "filtre": {
            "purtator": "total",
            "element": "import"
        },
        "ani": [
            1992,
            1993,
            1994,
            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
        ],
        "serii": [
            {
                "element": "import",
                "element_denumire": "Import",
                "um": "mii_tone_echivalent_petrol",
                "um_denumire": "Mii tone echivalent petrol",
                "ani_publicati": 33,
                "valori": {
                    "1992": "16181",
                    "1993": "15259",
                    "1994": "16434",
                    "1995": "19420",
                    "1996": "18806",
                    "1997": "17928",
                    "1998": "15148",
                    "1999": "10186",
                    "2000": "10925",
                    "2001": "12771",
                    "2002": "13949",
                    "2003": "14639",
                    "2004": "16672",
                    "2005": "17072",
                    "2006": "17605",
                    "2007": "17399",
                    "2008": "16324",
                    "2009": "11235",
                    "2010": "11239",
                    "2011": "11570",
                    "2012": "11615",
                    "2013": "9993",
                    "2014": "10757",
                    "2015": "11333",
                    "2016": "13113",
                    "2017": "13597",
                    "2018": "14168",
                    "2019": "15910",
                    "2020": "14014",
                    "2021": "15948",
                    "2022": "16400",
                    "2023": "15500",
                    "2024": "16456"
                }
            }
        ]
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — balanţele energetice (TEMPO, matricile IND107A-IND121A).",
        "acoperire": {
            "de_la": "1992-01-01",
            "pana_la": "2024-01-01"
        },
        "serii_returnate": 1,
        "nota_purtator": "⚠️ Cei trei purtători sunt aceleaşi elemente în unităţi diferite. Nu se adună între ei — ar însemna să numeri de trei ori aceeaşi energie.",
        "nota_bilant": "⚠️ Elementele nu formează o partiţie: e un bilanţ cu resurse, utilizări şi sub-poziţii la un loc. Identitatea verificată 33 de ani din 33: `Resurse-total` = producţie primară + import + stoc la 1 ianuarie.",
        "nota_sen": "Sunt date statistice anuale. Starea instantanee a sistemului, de la Transelectrica, e la /energie/v1/sen — altă natură, nu se compară.",
        "nota_lista": "Nomenclatoarele zonei: /energie/v1/balante/nomenclator."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404necunoscutElementul nu apare pe purtătorul cerut.
404in_afara_acopeririiIntervalul cerut e în întregime în afara anilor publicaţi.
422raspuns_prea_marePeste 20.000 de celule.
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": "raspuns_prea_mare",
        "mesaj": "Peste 20.000 de celule.",
        "detalii": {
            "purtator": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}