oneapi
Autentificare
Carburanti v1 / Carburanti

Istoricul taxelor

Fiecare schimbare de acciză şi de TVA, cu data de la care s-a aplicat. Pentru a reconstitui corect un preţ dintr-un an trecut.

GET
https://oneapi.ro/api/carburanti/v1/taxe/serie

Parametri de interogare

NumeTipDescriereValori acceptate
taraopțional string | null Codul de țară. Implicit RO. ATBEBGCYCZDEDKEEESFIFRGRHRHUIEITLTLULVMTNLPLPTROSESISKUK
produsobligatoriu string Codul produsului. Obligatoriu: o serie de taxe e a unui singur produs. benzina95motorinamotorina_incalzirepacura_sulf_micpacura_sulf_maregpl
tipopțional string | null Restrânge la un tip: tva, acciza sau alte_indirecte. Implicit toate. tvaaccizaalte_indirecte
de_laopțional string | null Doar schimbările intrate în vigoare la sau după data asta. ex. 2020-01-01
pana_laopțional string | null Doar schimbările intrate în vigoare la sau înainte de data asta. ex. 2026-08-31

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.
  • Când sursa publică preţul CU taxe mai mic decât cel FĂRĂ, reconciliere.posibila e false şi motiv spune exact asta. Fără regula asta, ruta oferea explicaţia generică („statul aplică o componentă nepublicată") — plauzibilă, dar greşită în cazul ăsta, cu un sfat care nu ţine: nu poţi „folosi preţul publicat" când tocmai el e incoerent.
  • Fiecare rând e o schimbare, nu o valoare săptămânală: o intrare rămâne în vigoare până apare următoarea. România are 23 de modificări de acciză din 2008 și 5 modificări de TVA din 2000.
  • Unitățile diferă pe tip și sunt explicate în legenda: TVA e procent, acciza și alte taxe indirecte sunt sume în monedă națională pe unitatea produsului.
  • Ordinea e descrescătoare după data intrării în vigoare.

La ce folosește

  • Refaci un calcul de acum trei ani cu acciza care se aplica atunci, nu cu cea de azi.
  • Documentezi într-o analiză fiscală toate modificările de acciză dintr-o perioadă, cu datele lor.
  • Verifici dacă o creștere de preț observată coincide cu o modificare fiscală sau e mișcare de piață.

Structura răspunsului

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

CâmpTipDescriere
tara string Țara.
produs string Produsul.
moneda string Moneda sumelor (nu se aplică la tva, care e procent).
unitate string Unitatea la care se raportează sumele.
inregistrari integer Câte schimbări conține răspunsul.
schimbari[].tip string tva, acciza sau alte_indirecte.
schimbari[].in_vigoare_de_la string Data de la care se aplică.
schimbari[].valoare number Procent la tva, sumă pe unitate la celelalte.
legenda object Ce înseamnă valoarea pentru fiecare tip.
sursa object Sursa și licența.

Exemple de răspuns

GEThttps://oneapi.ro/api/carburanti/v1/taxe/serie?produs=benzina95&tip=acciza
{
    "data": {
        "tara": "RO",
        "produs": "benzina95",
        "moneda": "RON",
        "unitate": "1000l",
        "inregistrari": 21,
        "schimbari": [
            {
                "tip": "acciza",
                "in_vigoare_de_la": "2026-01-01",
                "valoare": 3059.8
            }
        ],
        "legenda": {
            "tva": "Procent.",
            "acciza": "Monedă națională pe unitatea produsului.",
            "alte_indirecte": "Monedă națională pe unitatea produsului."
        },
        "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 tip nu e unul dintre cele trei.
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 tip nu e unul dintre cele trei.",
        "detalii": {
            "tara": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}