Financiar v1 / Inflatie

Nomenclatorul producţiei fizice

Fiecare produs cu unitatea (ori unităţile) în care e publicat şi anii lor. Unitatea nu se poate
presupune: 13 produse apar în două unităţi deodată, iar 17 sunt măsurate în lei, nu fizic.

GET

https://oneapi.ro/api/financiar/v1/industrie/productie-fizica/nomenclator

Parametri de interogare

NumeTipDescriereValori acceptate

valoricopțional boolean | null Cu 1 întoarce produsele raportate valoric; implicit, cele raportate în unităţi fizice. ex. 1ex. 0

Cum se comportă

Fiecare produs cu unitatea — ori unităţile — în care e publicat şi anii lor.
Unitatea nu se poate presupune: 13 produse apar în două unităţi deodată, iar 17 sunt măsurate în lei, nu fizic. De aceea catalogul dă unitatea pe fiecare produs, nu o listă separată.

La ce folosește

Găsirea slugului de produs şi a unităţii corecte înainte de a cere seria.
Identificarea produselor măsurate valoric, ca să nu fie citite drept cantităţi.

Structura răspunsului

CâmpTipDescriere

data.produse[].produs string Produsul din nomenclatorul sursei.

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

data.produse[].unitati[] array Una sau două unităţi, fiecare cu anii ei. Două unităţi înseamnă măsuri paralele, nu o schimbare în timp.

data.produse[].unitati[].um string

data.produse[].unitati[].unitate string Unitatea de măsură a valorilor. Citeşte-o înainte de a le pune pe un grafic sau de a le aduna.

data.produse[].unitati[].valoric boolean

data.produse[].unitati[].de_la integer Începutul intervalului acoperit.

data.produse[].unitati[].pana_la integer Sfârşitul intervalului acoperit, inclusiv.

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

meta.produse_publicate integer

meta.produse_in_mai_multe_unitati integer Câte produse sunt publicate simultan în două unităţi.

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

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/industrie/productie-fizica/nomenclator

{
    "data": {
        "produse": [
            {
                "produs": "acid_acetic",
                "denumire": "Acid acetic",
                "unitati": [
                    {
                        "um": "tone_100_substanta_activa",
                        "unitate": "Tone 100% substanta activa",
                        "valoric": false,
                        "de_la": 1993,
                        "pana_la": 1998
                    }
                ]
            }
        ]
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatoarele matricilor IND106A şi IND106C (TEMPO).",
        "produse_publicate": 254,
        "produse_in_mai_multe_unitati": 13,
        "nota_unitati": "Produsele publicate în două unităţi sunt măsurate paralel, pe aceiaşi ani — navele în bucăţi şi în tone DW, ceramica în lei şi în mii de bucăţi. Cele două nu se adună şi niciuna nu o continuă pe cealaltă."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/industrie/productie-fizica/nomenclator?valoric=1

{
    "data": {
        "produse": [
            {
                "produs": "aparate_de_masura_si_control_electronice",
                "denumire": "Aparate de masura si control electronice",
                "unitati": [
                    {
                        "um": "lei_ron",
                        "unitate": "Lei RON",
                        "valoric": true,
                        "de_la": 1993,
                        "pana_la": 2024
                    }
                ]
            }
        ]
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatoarele matricilor IND106A şi IND106C (TEMPO).",
        "produse_publicate": 17,
        "produse_in_mai_multe_unitati": 0,
        "nota_unitati": "Produsele publicate în două unităţi sunt măsurate paralel, pe aceiaşi ani — navele în bucăţi şi în tone DW, ceramica în lei şi în mii de bucăţi. Cele două nu se adună şi niciuna nu o continuă pe cealaltă."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/industrie/productie-fizica/nomenclator?valoric=0

{
    "data": {
        "produse": [
            {
                "produs": "acid_acetic",
                "denumire": "Acid acetic",
                "unitati": [
                    {
                        "um": "tone_100_substanta_activa",
                        "unitate": "Tone 100% substanta activa",
                        "valoric": false,
                        "de_la": 1993,
                        "pana_la": 1998
                    }
                ]
            }
        ]
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatoarele matricilor IND106A şi IND106C (TEMPO).",
        "produse_publicate": 239,
        "produse_in_mai_multe_unitati": 11,
        "nota_unitati": "Produsele publicate în două unităţi sunt măsurate paralel, pe aceiaşi ani — navele în bucăţi şi în tone DW, ceramica în lei şi în mii de bucăţi. Cele două nu se adună şi niciuna nu o continuă pe cealaltă."
    }
}

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 (`valoric`); `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 (valoric); detalii spune care şi de ce.",
        "detalii": {
            "valoric": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}