oneapi
Autentificare
Carburanti v1 / Carburanti

Variația pe interval

Cât s-a schimbat preţul între două momente, în absolut şi în procente, cu valoarea de la fiecare capăt al intervalului.

GET
https://oneapi.ro/api/carburanti/v1/variatie

Parametri de interogare

NumeTipDescriereValori acceptate
taraopțional string | null Codul de țară. Implicit RO. ATBEBGCYCZDEDKEEESFIFRGRHRHUIEITLTLULVMTNLPLPTROSESISKUKEUEA
produsobligatoriu string Codul produsului. Obligatoriu: variaţia se calculează pe seria unui singur produs. benzina95motorinamotorina_incalzirepacura_sulf_micpacura_sulf_maregpl
de_laobligatoriu string Data de pornire, AAAA-LL-ZZ. Obligatorie. ex. 2021-01-04
pana_laopțional string | null Data de final, AAAA-LL-ZZ. Implicit azi. 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.
  • Două incoerenţe cunoscute ale sursei, tratate explicit. (1) Buletinul are 2 rânduri cu ambele preţuri 0,00 (Slovacia, păcură, 2006-05-01) — o lipsă de date publicată ca zero. Le servim ca null, nu ca preţ, şi nu construim nimic peste ele. (2) La 32 de rânduri, toate pe păcură, preţul CU taxe e mai mic decât cel FĂRĂ, ceea ce ar da o taxă negativă: 30 pe agregatul EU şi câte unul pe BE şi IE. Cele două preţuri se redau ca atare, dar nu calculăm nimic peste ele — taxe_din_pret_procent e null şi apare un câmp atentionare.
  • Ambele capete sunt aduse la săptămâna publicată la sau înainte de data cerută, iar răspunsul conține rândul complet pentru fiecare capăt — inclusiv săptămâna reală folosită. Într-o dispută contractuală contează exact ce săptămână a stat la baza calculului.
  • Variația se dă atât în euro (cu și fără taxe), cât și în monedă națională. Nu sunt același număr: între cele două date se schimbă și cursul, iar o clauză contractuală trebuie să spună în ce monedă se indexează.
  • pana_la lipsă înseamnă azi.

La ce folosește

  • Aplici o clauză de indexare: contractul spune „se ajustează cu variația prețului oficial al motorinei față de data semnării", iar aici ai exact acea cifră.
  • Justifici o creștere de tarif către client cu variația procentuală dintre două date, nu cu o impresie.
  • Compari inflația combustibilului cu alte costuri într-o analiză de an fiscal.

Structura răspunsului

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

CâmpTipDescriere
tara string Țara.
produs string Produsul.
de_la object Rândul complet de preț la capătul de început, ca la GET /preturi.
pana_la object Rândul complet de preț la capătul de final.
variatie.eur_cu_taxe object Diferența în euro cu taxe: valoarea absolută și procentul.
variatie.eur_cu_taxe.absolut number Diferența în euro pe unitate, cu taxe.
variatie.eur_cu_taxe.procent number Diferența procentuală, cu taxe, în euro.
variatie.eur_fara_taxe object Diferența în euro fără taxe — arată cât din mișcare vine din piață, nu din fiscalitate.
variatie.eur_fara_taxe.absolut number Diferența în euro pe unitate, fără taxe — arată mișcarea pieței, curățată de fiscalitate.
variatie.eur_fara_taxe.procent number Diferența procentuală fără taxe.
variatie.national_cu_taxe object Diferența în moneda națională. Compar-o cu cea în euro: dacă diferă mult, mișcarea e de curs valutar, nu de preț.
variatie.national_cu_taxe.absolut number Diferența în monedă națională, cu taxe. Prezentă doar dacă ambele capete au curs.
variatie.national_cu_taxe.procent number Diferența procentuală în monedă națională — de regulă diferită de cea în euro, din cauza cursului.
sursa object Sursa și licența.
de_la.tara string Codul țării.
de_la.data string Săptămâna la care se referă prețul (luni-ul buletinului).
de_la.produs string Codul produsului.
de_la.denumire string Denumirea produsului.
de_la.unitate string Unitatea în care e cotat produsul: 1.000 de litri la carburanți, 1.000 kg la păcură.
de_la.eur.cu_taxe number Prețul în euro, cu toate taxele incluse, pe unitatea de cotare.
de_la.eur.fara_taxe number Prețul în euro, fără taxe.
de_la.eur.pe_litru_cu_taxe number Același preț adus la litru — null la produsele cotate pe tonă.
de_la.eur.pe_litru_fara_taxe number Prețul fără taxe, pe litru.
de_la.national.moneda string Moneda națională a țării la data respectivă. Se schimbă în timp: statele care au adoptat euro au serii în două monede.
de_la.national.curs_eur_pe_unitate number Cursul folosit de sursă la conversie. Când lipsește sau e 1,0, țara era deja în euro — de acolo deducem moneda, nu dintr-un tabel.
de_la.national.cu_taxe number Prețul în moneda națională, cu taxe.
de_la.national.fara_taxe number Prețul în moneda națională, fără taxe.
de_la.national.pe_litru_cu_taxe number Prețul național pe litru, cu taxe.
de_la.national.pe_litru_fara_taxe number Prețul național pe litru, fără taxe.
de_la.taxe_din_pret_procent number Cât la sută din prețul final sunt taxe — cifra cea mai citată dintr-un buletin.
pana_la.tara string Codul țării.
pana_la.data string Săptămâna la care se referă prețul (luni-ul buletinului).
pana_la.produs string Codul produsului.
pana_la.denumire string Denumirea produsului.
pana_la.unitate string Unitatea în care e cotat produsul: 1.000 de litri la carburanți, 1.000 kg la păcură.
pana_la.eur.cu_taxe number Prețul în euro, cu toate taxele incluse, pe unitatea de cotare.
pana_la.eur.fara_taxe number Prețul în euro, fără taxe.
pana_la.eur.pe_litru_cu_taxe number Același preț adus la litru — null la produsele cotate pe tonă.
pana_la.eur.pe_litru_fara_taxe number Prețul fără taxe, pe litru.
pana_la.national.moneda string Moneda națională a țării la data respectivă. Se schimbă în timp: statele care au adoptat euro au serii în două monede.
pana_la.national.curs_eur_pe_unitate number Cursul folosit de sursă la conversie. Când lipsește sau e 1,0, țara era deja în euro — de acolo deducem moneda, nu dintr-un tabel.
pana_la.national.cu_taxe number Prețul în moneda națională, cu taxe.
pana_la.national.fara_taxe number Prețul în moneda națională, fără taxe.
pana_la.national.pe_litru_cu_taxe number Prețul național pe litru, cu taxe.
pana_la.national.pe_litru_fara_taxe number Prețul național pe litru, fără taxe.
pana_la.taxe_din_pret_procent number Cât la sută din prețul final sunt taxe — cifra cea mai citată dintr-un buletin.

Exemple de răspuns

GEThttps://oneapi.ro/api/carburanti/v1/variatie?produs=benzina95&de_la=2021-01-04
{
    "data": {
        "tara": "RO",
        "produs": "benzina95",
        "de_la": {
            "tara": "RO",
            "data": "2020-12-21",
            "produs": "benzina95",
            "denumire": "Benzină Euro-super 95",
            "unitate": "1000l",
            "eur": {
                "cu_taxe": 974.65,
                "fara_taxe": 454.14,
                "pe_litru_cu_taxe": 0.9747,
                "pe_litru_fara_taxe": 0.4541
            },
            "national": {
                "moneda": "RON",
                "curs_eur_pe_unitate": 0.2057486163,
                "cu_taxe": 4737.09,
                "fara_taxe": 2207.26,
                "pe_litru_cu_taxe": 4.7371,
                "pe_litru_fara_taxe": 2.2073
            },
            "taxe_din_pret_procent": 53.4,
            "atentionare": null
        },
        "pana_la": {
            "tara": "RO",
            "data": "2026-09-14",
            "produs": "benzina95",
            "denumire": "Benzină Euro-super 95",
            "unitate": "1000l",
            "eur": {
                "cu_taxe": 1888.8411,
                "fara_taxe": 978.9606,
                "pe_litru_cu_taxe": 1.8888,
                "pe_litru_fara_taxe": 0.979
            },
            "national": {
                "moneda": "RON",
                "curs_eur_pe_unitate": 0.1902297976,
                "cu_taxe": 9929.26,
                "fara_taxe": 5146.2,
                "pe_litru_cu_taxe": 9.9293,
                "pe_litru_fara_taxe": 5.1462
            },
            "taxe_din_pret_procent": 48.17,
            "atentionare": null
        },
        "variatie": {
            "eur_cu_taxe": {
                "absolut": 914.1911,
                "procent": 93.8
            },
            "eur_fara_taxe": {
                "absolut": 524.8206,
                "procent": 115.56
            },
            "national_cu_taxe": {
                "absolut": 5192.17,
                "procent": 109.61
            }
        },
        "sursa": {
            "nume": "European Commission — Weekly Oil Bulletin (DG ENER)",
            "licenta": "CC BY 4.0 (Decizia 2011/833/UE)",
            "observatie": "Prețuri medii naționale raportate de statele membre pentru săptămâna indicată, nu prețuri per stație de alimentare."
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitNu există prețuri publicate pentru cel puțin una dintre datele cerute.
422validareLipsește produs sau de_la, ori pana_la e înaintea lui de_la.
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 de_la, ori pana_la e înaintea lui de_la.",
        "detalii": {
            "tara": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}