oneapi
Autentificare
Financiar v1 / Inflatie

Preţurile produselor agricole

Preţurile la care se vând produsele agricole — 1.064.340 de valori, din 1990 până în 2026, în
trei concepte diferite, din matricile TEMPO PPA101A, PPA102B, PPA102C şi PPA103A.

⚠️ Cele trei concepte NU se compară între ele. piata e preţul de vânzare în pieţele
agroalimentare şi oboare — preţ cu amănuntul, singurul care coboară la localitate (127 de
oraşe-piaţă, cu cod SIRUTA). achizitie (2001-2003, pe judeţe) şi poarta_fermei (din 2004, pe
regiuni şi naţional) sunt preţuri de producător. Ultimele două acoperă perioade adiacente, dar
nu sunt aceeaşi mărime şi nu se lipesc într-o serie.

⚠️ Sunt preţuri UNITARE — lei pe kilogram, pe litru, pe bucată. Nu se adună, nici pe produse,
nici pe teritorii, iar o medie a lor n-are sens fără ponderi, pe care sursa nu le publică.

⚠️ Unitatea de măsură e o dimensiune, nu o etichetă: acelaşi produs poate fi cotat pe kilogram,
pe bucată, pe litru, pe kilogram viu ori pe kilogram carcasă.

⚠️ Denominarea taie la 1 ianuarie 2005, nu la 1 iulie cum spune legea — INS a republicat tot
anul în lei noi. Verificat pe serie continuă: merele costau 14.539,66 lei în decembrie 2004 şi
1,51 în ianuarie 2005. Valorile de dinainte sunt împărţite la 10.000; blocul publicat păstrează
cifra brută.

⚠️ Nu orice concept are orice frecvenţă: preţul din piaţă e anual şi lunar, cel de achiziţie
anual şi pe perioade cumulate de la 1 ianuarie (cumulat: 2002-01..03, 2002-01..06,
2002-01..09 — nu trimestre), cel de la poarta fermei anual, trimestrial şi lunar. Cerută altfel,
frecvenţa primeşte un refuz explicit.

GET
https://oneapi.ro/api/financiar/v1/preturi-agricole

Parametri de interogare

NumeTipDescriereValori acceptate
conceptopțional string | null Opţional: piata (implicit), achizitie, poarta_fermei. piataachizitiepoarta_fermei
granularitateopțional string | null Opţional: lunar (implicit), trimestrial, anual, cumulat (doar achizitie) — după ce publică conceptul ales. anualtrimestriallunarcumulat
nivel_teritoriuopțional string | null Opţional: tara (implicit), regiune, judet, localitate. tararegiunejudetlocalitate
umopțional string | null Opţional: kg, litru, buc, kg_viu, kg_carcasa, fir, cap. ex. kg
de_laopțional string | null Opţional, AAAA ori AAAA-LL, din 1990. ex. 2024-01ex. 2024-06-15
pana_laopțional string | null Opţional, AAAA ori AAAA-LL. ex. 2024-06ex. 2024-06-30
produslistăopțional text Opţional, sluguri separate prin virgulă. Nomenclatorul diferă de la un concept la altul. ex. ardei_grasex. ardei_capia
teritoriulistăopțional text Opţional, sluguri — total, un judeţ, o regiune ori un oraş-piaţă. ex. total

Cum se comportă

  • Preţurile la care se vând produsele agricole — 1.064.340 de valori, din 1990 până în 2026, în trei concepte diferite, din matricile TEMPO PPA101A, PPA102B, PPA102C şi PPA103A.
  • ⚠️ Cele trei concepte NU se compară între ele. piata e preţul de vânzare în pieţele agroalimentare şi oboare — preţ cu amănuntul, şi singurul care coboară la localitate: 127 de oraşe-pieţe, fiecare cu codul SIRUTA în etichetă. achizitie (doar 2001-2003, pe judeţe) şi poarta_fermei (din 2004, pe regiuni şi naţional) sunt preţuri de producător. Ultimele două acoperă perioade adiacente şi arată la fel — dar nu sunt aceeaşi mărime şi nu se lipesc într-o serie.
  • ⚠️ Sunt preţuri UNITARE — lei pe kilogram, pe litru, pe bucată. Nu se adună, nici pe produse, nici pe teritorii, iar o medie a lor n-are sens fără ponderi, pe care sursa nu le publică. De aceea ruta nu calculează niciun agregat peste ele.
  • ⚠️ Unitatea de măsură e o dimensiune, nu o etichetă: acelaşi produs poate fi cotat pe kilogram, pe bucată, pe litru, pe kilogram viu ori pe kilogram carcasă. Două preţuri ale aceluiaşi produs în unităţi diferite nu se compară.
  • ⚠️ Denominarea taie la 1 ianuarie 2005, nu la 1 iulie cum spune legea — INS a republicat tot anul în lei noi. Verificat pe serie continuă: merele costau 14.539,66 lei în decembrie 2004 şi 1,51 în ianuarie 2005. Valorile de dinainte sunt împărţite la 10.000, iar blocul publicat păstrează cifra brută şi factorul.
  • ⚠️ Nu orice concept are orice frecvenţă. Preţul din piaţă e publicat anual şi lunar, cel de achiziţie anual şi pe perioade cumulate, cel de la poarta fermei anual, trimestrial şi lunar. Cerută altfel, frecvenţa primeşte un refuz explicit cu lista celor disponibile — nu o listă goală.
  • ⚠️ Fiecare matrice a sursei conţine mai multe frecvenţe deodată, toate aşezate pe prima zi a perioadei: ianuarie şi anul întreg cad pe aceeaşi dată. Proiecţia le desparte prin granularitate; implicit se întoarce seria lunară.
  • ⚠️ Preţul de achiziţie nu are trimestre, ci perioade cumulate de la 1 ianuarie — ianuarie-martie, ianuarie-iunie, ianuarie-septembrie —, chiar dacă sursa le etichetează „Trimestrul I/II/III". Granularitatea lor e cumulat, iar eticheta spune intervalul: 2002-01..03, 2002-01..06, 2002-01..09; perioada ianuarie-decembrie e anul (anual). Sunt medii, nu sume: diferenţa dintre două perioade nu dă preţul trimestrului.

La ce folosește

  • Preţul unui produs într-un oraş anume, lună de lună, pe treizeci şi cinci de ani.
  • Diferenţa dintre preţul de producător şi cel din piaţă, pe acelaşi produs.
  • Sezonalitatea preţurilor la legume şi fructe, măsurată, nu presupusă.
  • Contextul de preţ pentru o analiză agricolă teritorială, legat prin SIRUTA.

Structura răspunsului

CâmpTipDescriere
data.concept string
data.descriere_concept string
data.granularitate string Cât de fin e pasul de timp al valorilor.
data.de_la string Începutul intervalului acoperit de răspuns.
data.pana_la string Sfârşitul intervalului acoperit de răspuns, inclusiv.
data.filtre.concept string
data.filtre.granularitate string Cât de fin e pasul de timp al valorilor.
data.filtre.nivel_teritoriu string Nivelul teritorial al valorii (ţară, regiune, judeţ, localitate).
data.perioade array Anii, lunile AAAA-LL, trimestrele AAAA-Tn ori perioadele cumulate de la 1 ianuarie AAAA-01..LL, după granularitate.
data.serii[].produs string Produsul din nomenclatorul sursei.
data.serii[].denumire string Denumirea, aşa cum o publică sursa.
data.serii[].teritoriu string Teritoriul la care se referă valoarea.
data.serii[].nivel_teritoriu string Nivelul teritorial al valorii (ţară, regiune, judeţ, localitate).
data.serii[].um string Unitatea, parte din identitatea seriei — două serii ale aceluiaşi produs în unităţi diferite sunt lucruri diferite.
data.serii[].unitate string Unitatea exactă de la sursă — parte din identitatea seriei, nu decor.
data.serii[].perioade_publicate integer Câte perioade a publicat efectiv sursa.
data.serii[].valori object Valorile seriei, pe perioade.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.acoperire.de_la string Prima perioadă pentru care avem date.
meta.acoperire.pana_la string Ultima perioadă pentru care avem date.
meta.serii_returnate integer Câte serii s-au întors efectiv, după filtre şi după plafonul de celule.
meta.nota_preturi string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_implicit string Ce valoare s-a folosit când parametrul n-a fost trimis.
meta.nota_concept string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_lista string Ce conţine lista şi ce nu — limitele ei.
data.serii[].publicat Prezent doar pe perioadele de dinainte de 2005: valoarea brută în lei vechi şi factorul aplicat.
data.serii[].cod_siruta Prezent doar pe oraşele-pieţe; acelaşi cod ca în /locations/v1.
meta.fara_date data e null, iar aici stă motivul. Proiecţia peste datele INS e goală. Nomenclatorul e la /financiar/v1/preturi-agricole/nomenclator. Ca la celelalte serii.
meta.fara_date_cod Cuvântul scurt şi STABIL al motivului, pentru clienţii care comută pe el în cod: fara_date e proză şi se poate reformula, ăsta nu.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/preturi-agricole?de_la=2024-01&pana_la=2024-06
{
    "data": {
        "concept": "piata",
        "descriere_concept": "preţul de vânzare în pieţele agroalimentare şi oboare — preţ cu amănuntul",
        "granularitate": "lunar",
        "de_la": "2024-01",
        "pana_la": "2024-06",
        "filtre": {
            "concept": "piata",
            "granularitate": "lunar",
            "nivel_teritoriu": "tara"
        },
        "perioade": [
            "2024-01",
            "2024-02",
            "2024-03",
            "2024-04",
            "2024-05",
            "2024-06"
        ],
        "serii": [
            {
                "produs": "ardei_gras",
                "denumire": "Ardei gras",
                "teritoriu": "total",
                "nivel_teritoriu": "tara",
                "um": "kg",
                "unitate": "Lei / kg",
                "perioade_publicate": 1,
                "valori": {
                    "2024-01": null,
                    "2024-02": null,
                    "2024-03": null,
                    "2024-04": null,
                    "2024-05": null,
                    "2024-06": "7.54"
                }
            }
        ]
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — preţurile produselor agricole în pieţe, la achiziţie şi la poarta fermei (TEMPO, matricile PPA101A, PPA102B, PPA102C şi PPA103A).",
        "acoperire": {
            "de_la": "1990-01-01",
            "pana_la": "2026-07-01"
        },
        "serii_returnate": 42,
        "nota_preturi": "⚠️ Sunt preţuri UNITARE. Nu se adună — nici pe produse, nici pe teritorii — iar o medie a lor n-are sens fără ponderi, pe care sursa nu le publică.",
        "nota_implicit": "Fără `teritoriu` sau `nivel_teritoriu`, răspunsul ar purta toate cele 127 de oraşe-pieţe. Implicit: totalul ţării.",
        "nota_concept": "Conceptul ales: preţul de vânzare în pieţele agroalimentare şi oboare — preţ cu amănuntul. Cele trei nu se compară între ele.",
        "nota_lista": "Nomenclatoarele — produse, teritorii şi frecvenţe pe fiecare concept: /financiar/v1/preturi-agricole/nomenclator."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă sau invalid.
403feature_indisponibilfinanciar.indici nu e în planul curent.
422raspuns_prea_marePeste 20.000 de celule. Plus concept, granularitate, produs, teritoriu ori unitate în afara formei aşteptate. granularitate_indisponibila — conceptul nu se publică pe frecvenţa cerută; răspunsul dă lista.
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": "raspuns_prea_mare",
        "mesaj": "Peste 20.000 de celule. Plus concept, granularitate, produs, teritoriu ori unitate în afara formei aşteptate. granularitate_indisponibila — conceptul nu se publică pe frecvenţa cerută; răspunsul dă lista.",
        "detalii": {
            "concept": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}