oneapi
Autentificare
Carburanti v1 / Carburanti

Defalcarea bio/fosil a accizei

Cât din acciza unui carburant ţine de componenta biologică şi cât de cea fosilă — defalcare pe care preţul la pompă n-o arată.

GET
https://oneapi.ro/api/carburanti/v1/accize/componente

Parametri de interogare

NumeTipDescriereValori acceptate
taraopțional string | null Codul de țară. Implicit RO. ATBEBGCYCZDEDKEEESFIFRGRHRHUIEITLTLULVMTNLPLPTROSESISK
produsobligatoriu string Codul produsului. Obligatoriu: componentele accizei (fosil/bio) se publică pe produs. Doar benzina95 și motorina au componente; alt produs dă 422, la fel o țară din afara statelor membre (EU, EA, UK). benzina95motorina
de_laopțional string | null Doar intrările de la data asta încolo. ex. 2024-01-01
pana_laopțional string | null Doar intrările până la data asta. ex. 2026-08-31
limitaopțional integer | null Câte intrări să întoarcă, maximum 1200. Implicit 260. 1 – 1200

Cum se comportă

  • Seria săptămânală are goluri, şi sunt ale sursei. Din 1.082 de săptămâni publicate între 2005 şi azi, 37 de intervale sar peste o săptămână sau două: 17 se reiau în ianuarie şi 15 în aprilie — Comisia nu publică buletinul în săptămânile de Crăciun şi de Paşte. Nu sunt importuri ratate. Dacă desenezi un grafic săptămânal, aşteaptă-te la pauze şi nu le umple prin interpolare: n-a existat o cotaţie în săptămânile alea.
  • Sursa publică defalcarea doar pentru benzină și motorină, și doar începând din 2015. Pentru celelalte produse răspunsul e gol — nu e o lipsă la noi.
  • Rândurile sunt „în vigoare de la", ca la restul taxelor, dar sursa le republică des, deci seria are multe intrări cu aceleași valori.
  • Sumele sunt în monedă națională pe 1000 de litri.

La ce folosește

  • Analizezi cum se reflectă politica de biocarburanți în fiscalitatea unei țări.
  • Compari tratamentul componentei bio între state membre, pe date oficiale.

Structura răspunsului

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

CâmpTipDescriere
tara string Țara.
produs string Produsul.
moneda string Moneda sumelor.
unitate string Întotdeauna 1000l.
inregistrari integer Câte intrări conține răspunsul.
serie[].in_vigoare_de_la string Data de la care e valabilă defalcarea.
serie[].total number Acciza totală.
serie[].bio object Partea de biocarburant: valoare și pondere din total.
serie[].bio.acciza number Acciza aferentă componentei bio.
serie[].bio.procent number Ponderea componentei bio.
serie[].fosil object Partea fosilă: valoare și pondere din total.
serie[].fosil.acciza number Acciza aferentă componentei fosile.
serie[].fosil.procent number Ponderea componentei fosile.
sursa object Sursa și licența.

Exemple de răspuns

GEThttps://oneapi.ro/api/carburanti/v1/accize/componente?produs=motorina&limita=10
{
    "data": {
        "tara": "RO",
        "produs": "motorina",
        "moneda": "RON",
        "unitate": "1000l",
        "inregistrari": 10,
        "serie": [
            {
                "in_vigoare_de_la": "2024-02-19",
                "total": 1850.95,
                "bio": {
                    "acciza": 0,
                    "procent": 0
                },
                "fosil": {
                    "acciza": 1850.95,
                    "procent": 100
                }
            }
        ],
        "sursa": {
            "nume": "European Commission — Weekly Oil Bulletin (DG ENER)",
            "licenta": "CC BY 4.0 (Decizia 2011/833/UE)"
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareLipsește produs, sau limita depășește 1200.
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": "Lipsește produs, sau limita depășește 1200.",
        "detalii": {
            "tara": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}