oneapi
Autentificare
Energie v1 / Balanţe energetice

Consumul final energetic în industrie

Câtă energie consumă efectiv industria, pe 19 activităţi — 2.413 de valori, anual 1992-2024
(IND109A, IND112A, IND113A), pe aceiaşi trei purtători ca balanţa.

⚠️ Purtătorul face parte din identitatea seriei, ca la balanţă: aceleaşi 19 activităţi în
mii tep, milioane kWh şi mii Gcal / terajouli. Nu se adună între ei.

⚠️ E consum final energetic — energia arsă ca energie, nu cea folosită ca materie primă;
consumul neenergetic e un element separat în balanţă, la ruta /balante/elemente.

GET
https://oneapi.ro/api/energie/v1/balante/consum-industrie

Parametri de interogare

NumeTipDescriereValori acceptate
purtatoropțional string | null total (implicit), electrica ori termica. totalelectricatermica
umopțional string | null Unitatea. Util doar la termica. ex. mii_gigacalorii
de_laopțional string | null Primul an inclus, din 1992. ex. 2010
pana_laopțional string | null Ultimul an inclus. ex. 2024
caenopțional string | null Orice cod CAEN — secţiune, diviziune, grupă, clasă — din orice revizie; se aduce la activitatea balanţei care îl cuprinde. ex. 2410
caen_versiuneopțional string | null Revizia codului din caen (1, 2, 3), când forma lui e ambiguă. Fără ea, codul se caută întâi în Rev.2. 123
grupareopțional string | null industrie_inclusiv_constructii — totalul, care nu e un cod CAEN. Nu se trimite împreună cu caen. ex. industrie_inclusiv_constructii

Cum se comportă

  • Câtă energie consumă efectiv industria, pe 19 activităţi — 2.413 de valori, anual 1992-2024 (IND109A, IND112A, IND113A), pe aceiaşi trei purtători ca balanţa.
  • Purtătorul face parte din identitatea seriei, ca la balanţă: aceleaşi 19 activităţi în mii tep, milioane kWh şi mii Gcal / terajouli. Nu se adună între ei.
  • E consum final energetic — energia arsă ca energie, nu cea folosită ca materie primă. Consumul neenergetic e un element separat în balanţă, la /energie/v1/balante/elemente.
  • Activitatea se cere ca pe toată platforma: caen primeşte orice cod CAEN, din orice revizie, şi îl aduce la activitatea balanţei care îl cuprinde — o diviziune (24 metalurgie), un grup de diviziuni (25–30 construcţii metalice, maşini şi echipamente) ori secţiunea F; meta.caen spune ce s-a folosit. grupare=industrie_inclusiv_constructii e totalul. Nomenclatorul dă, pe fiecare activitate, cerere.

La ce folosește

  • Vezi care ramuri industriale consumă cea mai multă energie şi cum s-a schimbat asta.
  • Compari consumul electric cu cel termic al aceleiaşi activităţi.
  • Măsori dezindustrializarea prin energia consumată, nu prin producţie.

Structura răspunsului

CâmpTipDescriere
data.purtator string Purtătorul cerut.
data.serii[].activitate string Slugul activităţii industriale.
data.serii[].um string Unitatea seriei.
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.
data.serii[].ani_publicati integer Câți ani au valoare efectivă. Diferența față de lungimea lui ani sunt găurile din publicarea INS.
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[].activitate_denumire string Denumirea ramurii.
meta.nota_purtator string Ce intră în purtătorul cerut.
meta.nota_concept string Ce înseamnă „consum în industrie" la INS — nu e tot consumul economiei.
meta.nota_sen string Relația cu datele în timp real din zona sen.
meta.nota_lista string Unde se găsesc codurile de activitate.
meta.caen object Cum s-a înţeles parametrul caen: codul cerut, revizia în care s-a citit şi codul pe care l-a folosit ruta. La o listă de coduri, câte un obiect pe cod.
meta.caen.cerut string Codul CAEN trimis, normalizat (litere mari, fără puncte).
meta.caen.versiune_cerut string Revizia în care s-a citit codul trimis: cea din caen_versiune, altfel prima în care există.
meta.caen.folosit string Codul pe care l-a folosit seria: cel cerut, primul lui părinte publicat ori agregatul sursei care îl cuprinde (02-03).
meta.caen.cod string Codul CAEN pe care îl reprezintă cheia folosită, când seria îşi numeşte activităţile altfel (agricultura = 01) ori când cheia e un agregat (62-63).
meta.caen.nivel string Nivelul codului folosit — la rutele de firme, al codului cerut: sectiune, subsectiune, diviziune, grupa, clasa sau agregat.
meta.caen.denumire string Denumirea codului, din nomenclatorul CAEN.
meta.caen.versiune_serie string Revizia CAEN în care publică seria.
meta.caen.conversie boolean true când codul a fost tradus dintr-o revizie în alta prin corespondenţa oficială INS.
meta.caen.urcat boolean true când seria nu publică codul cerut şi s-a folosit un nivel superior.

Exemple de răspuns

GEThttps://oneapi.ro/api/energie/v1/balante/consum-industrie?de_la=2015
{
    "data": {
        "purtator": "total",
        "descriere_purtator": "energie totală, în mii tone echivalent petrol (tep)",
        "granularitate": "anual",
        "de_la": 2015,
        "pana_la": 2024,
        "filtre": {
            "purtator": "total"
        },
        "ani": [
            2015,
            2016,
            2017,
            2018,
            2019,
            2020,
            2021,
            2022,
            2023,
            2024
        ],
        "serii": [
            {
                "activitate": "alimentara_bauturi_si_tutun",
                "activitate_denumire": "Alimentara, bauturi si tutun",
                "um": "mii_tone_echivalent_petrol",
                "um_denumire": "Mii tone echivalent petrol",
                "ani_publicati": 10,
                "valori": {
                    "2015": "565",
                    "2016": "574",
                    "2017": "582",
                    "2018": "537",
                    "2019": "575",
                    "2020": "553",
                    "2021": "570",
                    "2022": "609",
                    "2023": "528",
                    "2024": "539"
                }
            }
        ]
    },
    "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": 19,
        "nota_purtator": "⚠️ Cei trei purtători sunt aceleaşi activităţi în unităţi diferite. Nu se adună între ei.",
        "nota_concept": "E consumul FINAL ENERGETIC — energia arsă ca energie. Cea folosită ca materie primă e „Neenergetic\", element separat la /energie/v1/balante/elemente.",
        "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.
404caen_nepublicatNici codul, nici părinţii lui nu sunt în balanţă; detalii.disponibile dă cheile.
404grupare_nepublicataGruparea nu e în balanţă.
404necunoscutActivitatea nu apare pe purtătorul cerut.
404in_afara_acopeririiIntervalul cerut e în afara anilor publicaţi.
422caen_inexistentCodul nu există în nicio revizie CAEN.
422validarecaen şi grupare trimise împreună, caen_versiune fără caen, ori un cod fără forma CAEN.
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": "caen_inexistent",
        "mesaj": "Codul nu există în nicio revizie CAEN.",
        "detalii": {
            "purtator": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}