Codurile de producţie

Parametri de interogare

Cum se comportă

• Lista are doar codurile care apar efectiv în datele noastre, nu tot nomenclatorul ENTSO-E.
• Etichetele au fost stabilite empiric, prin trei metode. Şapte coduri s-au potrivit direct cu mărimile publicate de Transelectrica în acelaşi moment. B05 a ieşit prin ELIMINARE pe ianuarie 2015: restul codurilor acoperă toată producţia ţării, iar cele 2.147 MW rămase nu pot fi decât cărbune. B25 a fost încadrat din profilul orar — produce 407 MW pe vârful de preţ de seara şi 8 MW la prânz, când fotovoltaicul e maxim şi preţul minim.
• ⚠️ Codurile NU sunt stabile în timp. Aceleaşi centrale pe cărbune apar sub B05 în seriile vechi şi sub B02 în cele recente: comutarea s-a produs în mai-iunie 2015, iar suma celor două rămâne aceeaşi peste ea. Nu s-au mutat centralele, s-a schimbat raportarea — o serie construită pe un singur cod se rupe acolo. Foloseşte grupa. Din acelaşi motiv niciunul nu poartă „lignit" sau „huilă" în nume: sursa noastră de verificare are o singură categorie de cărbune, deci nu avem cu ce le distinge. Nu inventăm nume: o etichetă ghicită e o eroare care se propagă în toate rapoartele construite peste ea.

La ce folosește

• Traduci codurile din seria de producţie în denumiri, în propria aplicaţie.
• Îţi construieşti gruparea proprie de surse, pornind de la grupa.
• Vezi care coduri n-au etichetă confirmată, înainte de a raporta ponderi.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

Exemple de răspuns

{
    "data": {
        "inregistrari": 10,
        "surse": [
            {
                "cod": "B01",
                "nume": "Biomasă",
                "grupa": "biomasa",
                "regenerabila": true,
                "confirmat": true
            }
        ],
        "observatie": "Etichetele NU vin dintr-o listă copiată: lista oficială de coduri ENTSO-E nu e accesibilă programatic. Au fost stabilite EMPIRIC — prin comparaţie cu Transelectrica pentru acelaşi moment (vezi zona `sen`), prin eliminare pe istoricul din 2015, ori din profilul orar. `confirmat` spune că încadrarea (grupa şi regenerabil/neregenerabil) e verificată; `nume` poate fi `null` chiar şi atunci, dacă dovada ajunge pentru încadrare dar nu pentru un nume de combustibil. ⚠️ Codurile NU sunt stabile în timp: cărbunele s-a raportat sub `B05` în seriile vechi şi sub `B02` în cele recente — `grupa` e ce rămâne comparabil.",
        "sursa": {
            "nume": "ENTSO-E Transparency Platform",
            "url": "https://transparency.entsoe.eu",
            "atribuire": "Date din ENTSO-E Transparency Platform.",
            "licenta": "Reutilizare permisă cu ATRIBUIRE obligatorie către Transparency Platform. Drepturile nu sunt sublicențiabile.",
            "observatie": "Zona `piata` e seria oficială europeană; zona `sen` e instantaneul Transelectrica. Au surse, pași și definiții diferite — cifrele lor nu se compară direct."
        }
    }
}

Coduri de eroare

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": "Ruta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat."
    }
}