oneapi
Autentificare
Financiar v1 / Inflatie

Nomenclatorul producţiei industriale în valoare

Categoriile fiecărei revizii CAEN şi ale fiecărei defalcări, cu nivelul, codul şi anii lor.
Nomenclatoarele celor două revizii nu se traduc unul în altul — de aceea sunt date separat.

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

Parametri de interogare

NumeTipDescriereValori acceptate
revizieopțional string | null Clasificarea CAEN a nomenclatorului: caen_rev1 sau caen_rev2. Codurile şi denumirile diferă între ele. caen_rev1caen_rev2

Cum se comportă

  • Categoriile fiecărei revizii CAEN şi ale fiecărei defalcări, cu nivelul, codul şi anii lor.
  • ⚠️ Nomenclatoarele celor două revizii nu se traduc unul în altul — acelaşi cod numeric înseamnă activităţi diferite. De aceea sunt date separat, nu într-o listă comună.

La ce folosește

  • Găsirea slugului corect în revizia potrivită perioadei studiate.
  • Verificarea nivelului unei categorii, ca să nu fie însumată cu altele de alt nivel.

Structura răspunsului

CâmpTipDescriere
data.niveluri[].nivel string Nivelul din ierarhia clasificării — cu cât e mai adânc, cu atât e mai detaliat.
data.niveluri[].descriere string Explicaţia în cuvinte a valorii.
data.revizii[].revizie string Revizia sursei din care vin valorile; reviziile nu se compară între ele.
data.revizii[].descriere string Explicaţia în cuvinte a valorii.
data.revizii[].defalcari[] array Defalcările publicate în revizia aceea — pe activitate mereu, pe proprietate doar în Rev.1.
data.revizii[].defalcari[].defalcare string Defalcarea aplicată valorilor.
data.revizii[].defalcari[].categorii[].categorie string Categoria din clasificarea sursei.
data.revizii[].defalcari[].categorii[].denumire string Denumirea, aşa cum o publică sursa.
data.revizii[].defalcari[].categorii[].cod_caen string
data.revizii[].defalcari[].categorii[].cerere.caen string Codul CAEN de trimis în caen pentru cheia asta.
data.revizii[].defalcari[].categorii[].nivel string Nivelul din ierarhia clasificării — cu cât e mai adânc, cu atât e mai detaliat.
data.revizii[].defalcari[].categorii[].masuri array Dacă acea categorie e publicată ca valoare, ca structură ori ca amândouă.
data.revizii[].defalcari[].categorii[].de_la integer Începutul intervalului acoperit.
data.revizii[].defalcari[].categorii[].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.nota_revizii 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/industrie/productie-valoare/nomenclator
{
    "data": {
        "niveluri": [
            {
                "nivel": "total",
                "descriere": "totalul industriei"
            }
        ],
        "revizii": [
            {
                "revizie": "caen_rev1",
                "descriere": "CAEN Rev.1, publicată 1997-2008 — 3 secţiuni şi 28 de diviziuni, care formează o partiţie completă",
                "defalcari": [
                    {
                        "defalcare": "activitate",
                        "categorii": [
                            {
                                "categorie": "alimentara_si_bauturi",
                                "denumire": "Alimentara si bauturi",
                                "cod_caen": "15",
                                "cerere": {
                                    "caen": "15"
                                },
                                "nivel": "diviziune",
                                "masuri": [
                                    "structura",
                                    "valoare"
                                ],
                                "de_la": 1997,
                                "pana_la": 2008
                            }
                        ]
                    }
                ]
            }
        ]
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatoarele matricilor IND103A-IND103E (TEMPO).",
        "nota_revizii": "Acelaşi cod numeric înseamnă activităţi diferite în cele două revizii — „10\" e extracţia cărbunelui în Rev.1 şi industria alimentară în Rev.2. Nomenclatoarele nu se traduc unul în altul."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă sau invalid.
403feature_indisponibilfinanciar.indici nu e în planul curent.
422validareUn parametru nu a trecut validarea (revizie); detalii spune care şi de ce.
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": "Un parametru nu a trecut validarea (revizie); detalii spune care şi de ce.",
        "detalii": {
            "revizie": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}