oneapi
Sign in
Financiar v1 / Inflatie

Nomenclature of agricultural prices

The products of each concept, with their units of measure and their years, the territories by level and the frequencies published. The code lists differ from one concept to another — which is why they are given together rather than assumed.

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

Query parameters

NameTypeDescriptionAccepted values
conceptoptional string | null The price concept you want the product list for: piata, achizitie or poarta_fermei. These are three different collections, with different nomenclatures. piataachizitiepoarta_fermei

How it behaves

  • The products of each concept, with their units of measure and years, the territories by level and the published frequencies.
  • The nomenclatures differ from concept to concept — 61 products in markets, 25 at procurement, 102 at the farm gate — which is why they are given together rather than assumed. The same goes for territorial depth: each concept reaches a different level.
  • ⚠️ This is where the area’s three warnings can be read without a second request: the concepts do not compare, the units are part of the series identity, and the prices are unit prices that do not add up.

What it is for

  • Finding the product slug that matches the chosen concept.
  • Checking how deep a concept goes territorially.

Response structure

FieldTypeDescription
data.produse integer
data.pe_concept object How many products each concept holds.
data.pe_concept.achizitie integer
data.pe_concept.piata integer
data.pe_concept.poarta_fermei integer
data.concepte.achizitie[].produs string Product from the source code list.
data.concepte.achizitie[].denumire string The name, exactly as the source publishes it.
data.concepte.achizitie[].unitati array
data.concepte.achizitie[].de_la integer Start of the covered interval.
data.concepte.achizitie[].pana_la integer End of the covered interval, inclusive.
data.concepte.piata[].produs string Product from the source code list.
data.concepte.piata[].denumire string The name, exactly as the source publishes it.
data.concepte.piata[].unitati array
data.concepte.piata[].de_la integer Start of the covered interval.
data.concepte.piata[].pana_la integer End of the covered interval, inclusive.
data.concepte.poarta_fermei[].produs string Product from the source code list.
data.concepte.poarta_fermei[].denumire string The name, exactly as the source publishes it.
data.concepte.poarta_fermei[].unitati array
data.concepte.poarta_fermei[].de_la integer Start of the covered interval.
data.concepte.poarta_fermei[].pana_la integer End of the covered interval, inclusive.
data.teritorii object Each concept’s territories, counted by level, with the detail underneath.
data.teritorii.achizitie.judet integer The county the value refers to.
data.teritorii.achizitie.tara integer The country the value refers to.
data.teritorii.achizitie.detaliu.judet[].teritoriu string The territory the value refers to.
data.teritorii.achizitie.detaliu.judet[].denumire string The name, exactly as the source publishes it.
data.teritorii.achizitie.detaliu.tara[].teritoriu string The territory the value refers to.
data.teritorii.piata.localitate integer
data.teritorii.piata.tara integer The country the value refers to.
data.teritorii.piata.detaliu.localitate[].teritoriu string The territory the value refers to.
data.teritorii.piata.detaliu.localitate[].denumire string The name, exactly as the source publishes it.
data.teritorii.piata.detaliu.localitate[].cod_siruta integer SIRUTA code of the territorial unit.
data.teritorii.piata.detaliu.tara[].teritoriu string The territory the value refers to.
data.teritorii.poarta_fermei.regiune integer
data.teritorii.poarta_fermei.tara integer The country the value refers to.
data.teritorii.poarta_fermei.detaliu.regiune[].teritoriu string The territory the value refers to.
data.teritorii.poarta_fermei.detaliu.regiune[].denumire string The name, exactly as the source publishes it.
data.teritorii.poarta_fermei.detaliu.tara[].teritoriu string The territory the value refers to.
data.granularitati object Which frequencies each concept publishes.
data.granularitati.piata array
data.granularitati.achizitie array
data.granularitati.poarta_fermei array
data.nota_concepte string
data.nota_unitati string What to know about the units of measure in the response.
data.nota_preturi string
meta.sursa string The official source the data comes from, with its licence where one is required.
meta.nota_siruta string A note on how to read the response: a caveat, a convention or a limit of the source.
meta.fara_date data is null and this says why. The projection over the INS data is empty.
meta.fara_date_cod The short, STABLE word for the reason, for clients that branch on it in code: fara_date is prose and may be rephrased, this is not.

Response examples

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."
    }
}

Error codes

CodeSlugWhen it occurs
401neautentificatMissing or invalid token.
403feature_indisponibilfinanciar.indici is not in the current plan.
422validareA parameter failed validation (concept); detalii says which and why.
429cota_depasitaThe plan's monthly quota has been exceeded (see Retry-After).

All errors share the same shape. eroare.cod is stable and is the value you should branch on in code — not the text in mesaj, which may change.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "A parameter failed validation (concept); detalii says which and why.",
        "detalii": {
            "concept": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}