Financiar v1 / Inflatie

Nomenclatorul preţurilor agricole

Produsele fiecărui concept, cu unităţile de măsură şi anii lor, teritoriile pe niveluri şi
frecvenţele publicate. Nomenclatoarele diferă de la un concept la altul — de aceea sunt date
împreună, nu presupuse.

GET

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

Parametri de interogare

NumeTipDescriereValori acceptate

conceptopțional string | null Conceptul de preţ pentru care vrei lista de produse: piata, achizitie sau poarta_fermei. Sunt trei colectări diferite, cu nomenclatoare diferite. piataachizitiepoarta_fermei

Cum se comportă

Produsele fiecărui concept, cu unităţile de măsură şi anii lor, teritoriile pe niveluri şi frecvenţele publicate.
Nomenclatoarele diferă de la un concept la altul — 61 de produse în pieţe, 25 la achiziţie, 102 la poarta fermei — de aceea sunt date împreună, nu presupuse. La fel şi nivelul teritorial: fiecare concept coboară până la alt nivel.
⚠️ De aici se citesc, fără o a doua cerere, cele trei avertismente ale zonei: conceptele nu se compară, unităţile fac parte din identitatea seriei, iar preţurile sunt unitare şi nu se adună.

La ce folosește

Găsirea slugului de produs potrivit conceptului ales.
Verificarea nivelului teritorial până la care coboară un concept.

Structura răspunsului

CâmpTipDescriere

data.produse integer

data.pe_concept object Câte produse are fiecare concept.

data.pe_concept.achizitie integer

data.pe_concept.piata integer

data.pe_concept.poarta_fermei integer

data.concepte.achizitie[].produs string Produsul din nomenclatorul sursei.

data.concepte.achizitie[].denumire string Denumirea, aşa cum o publică sursa.

data.concepte.achizitie[].unitati array

data.concepte.achizitie[].de_la integer Începutul intervalului acoperit.

data.concepte.achizitie[].pana_la integer Sfârşitul intervalului acoperit, inclusiv.

data.concepte.piata[].produs string Produsul din nomenclatorul sursei.

data.concepte.piata[].denumire string Denumirea, aşa cum o publică sursa.

data.concepte.piata[].unitati array

data.concepte.piata[].de_la integer Începutul intervalului acoperit.

data.concepte.piata[].pana_la integer Sfârşitul intervalului acoperit, inclusiv.

data.concepte.poarta_fermei[].produs string Produsul din nomenclatorul sursei.

data.concepte.poarta_fermei[].denumire string Denumirea, aşa cum o publică sursa.

data.concepte.poarta_fermei[].unitati array

data.concepte.poarta_fermei[].de_la integer Începutul intervalului acoperit.

data.concepte.poarta_fermei[].pana_la integer Sfârşitul intervalului acoperit, inclusiv.

data.teritorii object Teritoriile fiecărui concept, numărate pe niveluri, cu detaliul dedesubt.

data.teritorii.achizitie.judet integer Judeţul la care se referă valoarea.

data.teritorii.achizitie.tara integer Ţara la care se referă valoarea.

data.teritorii.achizitie.detaliu.judet[].teritoriu string Teritoriul la care se referă valoarea.

data.teritorii.achizitie.detaliu.judet[].denumire string Denumirea, aşa cum o publică sursa.

data.teritorii.achizitie.detaliu.tara[].teritoriu string Teritoriul la care se referă valoarea.

data.teritorii.piata.localitate integer

data.teritorii.piata.tara integer Ţara la care se referă valoarea.

data.teritorii.piata.detaliu.localitate[].teritoriu string Teritoriul la care se referă valoarea.

data.teritorii.piata.detaliu.localitate[].denumire string Denumirea, aşa cum o publică sursa.

data.teritorii.piata.detaliu.localitate[].cod_siruta integer Codul SIRUTA al unităţii teritoriale.

data.teritorii.piata.detaliu.tara[].teritoriu string Teritoriul la care se referă valoarea.

data.teritorii.poarta_fermei.regiune integer

data.teritorii.poarta_fermei.tara integer Ţara la care se referă valoarea.

data.teritorii.poarta_fermei.detaliu.regiune[].teritoriu string Teritoriul la care se referă valoarea.

data.teritorii.poarta_fermei.detaliu.regiune[].denumire string Denumirea, aşa cum o publică sursa.

data.teritorii.poarta_fermei.detaliu.tara[].teritoriu string Teritoriul la care se referă valoarea.

data.granularitati object Ce frecvenţe publică fiecare concept.

data.granularitati.piata array

data.granularitati.achizitie array

data.granularitati.poarta_fermei array

data.nota_concepte string

data.nota_unitati string Ce trebuie ştiut despre unităţile de măsură din răspuns.

data.nota_preturi string

meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.

meta.nota_siruta string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.

meta.fara_date data e null, iar aici stă motivul. Proiecţia peste datele INS e goală.

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/nomenclator

{
    "data": {
        "produse": 189,
        "pe_concept": {
            "achizitie": 25,
            "piata": 61,
            "poarta_fermei": 103
        },
        "concepte": {
            "achizitie": [
                {
                    "produs": "carne_de_bovine_in_greutate_vie",
                    "denumire": "Carne de bovine in greutate vie",
                    "unitati": [
                        "kg_viu"
                    ],
                    "de_la": 2001,
                    "pana_la": 2003
                }
            ],
            "piata": [
                {
                    "produs": "ardei_capia",
                    "denumire": "Ardei capia",
                    "unitati": [
                        "kg"
                    ],
                    "de_la": 1990,
                    "pana_la": 2026
                }
            ],
            "poarta_fermei": [
                {
                    "produs": "ardei_gogosar",
                    "denumire": "Ardei gogosar",
                    "unitati": [
                        "kg"
                    ],
                    "de_la": 2004,
                    "pana_la": 2026
                }
            ]
        },
        "teritorii": {
            "achizitie": {
                "judet": 42,
                "tara": 1,
                "detaliu": {
                    "judet": [
                        {
                            "teritoriu": "alba",
                            "denumire": "Alba"
                        }
                    ],
                    "tara": [
                        {
                            "teritoriu": "total"
                        }
                    ]
                }
            },
            "piata": {
                "localitate": 126,
                "tara": 1,
                "detaliu": {
                    "localitate": [
                        {
                            "teritoriu": "buciumi",
                            "denumire": "BUCIUMI",
                            "cod_siruta": 140379
                        }
                    ],
                    "tara": [
                        {
                            "teritoriu": "total"
                        }
                    ]
                }
            },
            "poarta_fermei": {
                "regiune": 8,
                "tara": 1,
                "detaliu": {
                    "regiune": [
                        {
                            "teritoriu": "bucuresti_ilfov",
                            "denumire": "Regiunea BUCURESTI - ILFOV"
                        }
                    ],
                    "tara": [
                        {
                            "teritoriu": "total"
                        }
                    ]
                }
            }
        },
        "granularitati": {
            "piata": [
                "anual",
                "lunar"
            ],
            "achizitie": [
                "anual",
                "cumulat"
            ],
            "poarta_fermei": [
                "anual",
                "trimestrial",
                "lunar"
            ]
        },
        "nota_concepte": "⚠️ Cele trei concepte NU se compară între ele: `piata` e preţ cu amănuntul, `achizitie` şi `poarta_fermei` sunt preţuri de producător. Iar `achizitie` (2001-2003) şi `poarta_fermei` (2004-) acoperă perioade adiacente, dar nu sunt aceeaşi mărime — nu se lipesc într-o serie.",
        "nota_unitati": "⚠️ 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ă.",
        "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ă."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatoarele matricilor PPA (TEMPO).",
        "nota_siruta": "Oraşele-pieţe poartă codul SIRUTA, acelaşi cu `cod_siruta` din /locations/v1."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/preturi-agricole/nomenclator?concept=piata

{
    "data": {
        "produse": 61,
        "pe_concept": {
            "piata": 61
        },
        "concepte": {
            "piata": [
                {
                    "produs": "ardei_capia",
                    "denumire": "Ardei capia",
                    "unitati": [
                        "kg"
                    ],
                    "de_la": 1990,
                    "pana_la": 2026
                }
            ]
        },
        "teritorii": {
            "piata": {
                "localitate": 126,
                "tara": 1,
                "detaliu": {
                    "localitate": [
                        {
                            "teritoriu": "buciumi",
                            "denumire": "BUCIUMI",
                            "cod_siruta": 140379
                        }
                    ],
                    "tara": [
                        {
                            "teritoriu": "total"
                        }
                    ]
                }
            }
        },
        "granularitati": {
            "piata": [
                "anual",
                "lunar"
            ],
            "achizitie": [
                "anual",
                "cumulat"
            ],
            "poarta_fermei": [
                "anual",
                "trimestrial",
                "lunar"
            ]
        },
        "nota_concepte": "⚠️ Cele trei concepte NU se compară între ele: `piata` e preţ cu amănuntul, `achizitie` şi `poarta_fermei` sunt preţuri de producător. Iar `achizitie` (2001-2003) şi `poarta_fermei` (2004-) acoperă perioade adiacente, dar nu sunt aceeaşi mărime — nu se lipesc într-o serie.",
        "nota_unitati": "⚠️ 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ă.",
        "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ă."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatoarele matricilor PPA (TEMPO).",
        "nota_siruta": "Oraşele-pieţe poartă codul SIRUTA, acelaşi cu `cod_siruta` din /locations/v1."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/preturi-agricole/nomenclator?concept=achizitie

{
    "data": {
        "produse": 25,
        "pe_concept": {
            "achizitie": 25
        },
        "concepte": {
            "achizitie": [
                {
                    "produs": "carne_de_bovine_in_greutate_vie",
                    "denumire": "Carne de bovine in greutate vie",
                    "unitati": [
                        "kg_viu"
                    ],
                    "de_la": 2001,
                    "pana_la": 2003
                }
            ]
        },
        "teritorii": {
            "achizitie": {
                "judet": 42,
                "tara": 1,
                "detaliu": {
                    "judet": [
                        {
                            "teritoriu": "alba",
                            "denumire": "Alba"
                        }
                    ],
                    "tara": [
                        {
                            "teritoriu": "total"
                        }
                    ]
                }
            }
        },
        "granularitati": {
            "piata": [
                "anual",
                "lunar"
            ],
            "achizitie": [
                "anual",
                "cumulat"
            ],
            "poarta_fermei": [
                "anual",
                "trimestrial",
                "lunar"
            ]
        },
        "nota_concepte": "⚠️ Cele trei concepte NU se compară între ele: `piata` e preţ cu amănuntul, `achizitie` şi `poarta_fermei` sunt preţuri de producător. Iar `achizitie` (2001-2003) şi `poarta_fermei` (2004-) acoperă perioade adiacente, dar nu sunt aceeaşi mărime — nu se lipesc într-o serie.",
        "nota_unitati": "⚠️ 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ă.",
        "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ă."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatoarele matricilor PPA (TEMPO).",
        "nota_siruta": "Oraşele-pieţe poartă codul SIRUTA, acelaşi cu `cod_siruta` din /locations/v1."
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă sau invalid.
403	feature_indisponibil	`financiar.indici` nu e în planul curent.
422	validare	Un parametru nu a trecut validarea (`concept`); `detalii` spune care şi de ce.
429	cota_depasita	Cota 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": "Un parametru nu a trecut validarea (concept); detalii spune care şi de ce.",
        "detalii": {
            "concept": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}