oneapi
Autentificare
Financiar v1 / Inflatie

Nomenclatorul entităţilor înregistrate

Cele patru categorii cu tipurile fiecăreia, anii în care fiecare tip e publicat şi valorile pe care
le ia defalcarea a doua — activitate, teritoriu ori formă de proprietate.

⚠️ De aici se vede schimbarea de nomenclator din 2012 la organizaţiile private şi lipsa rândului
total la instituţiile publice.

GET
https://oneapi.ro/api/financiar/v1/intreprinderi/entitati/nomenclator

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • Cele patru categorii cu tipurile fiecăreia, anii în care fiecare tip e publicat şi valorile pe care le ia defalcarea a doua — activitate, teritoriu ori formă de proprietate.
  • De aici se citesc cele două neregularităţi ale sursei fără o a doua cerere: schimbarea de nomenclator din 2012 la organizaţiile private, vizibilă în valabil_de_la şi valabil_pana_la, şi lipsa rândului total la instituţiile publice, marcată prin are_total.
  • valori_defalcari dă, pe categorie, codurile pe care le ia defalcarea: cele şapte activităţi ale întreprinzătorilor privaţi şi cele trei forme de proprietate ale întreprinderilor financiar-bancare.

La ce folosește

  • Alegerea tipului şi a defalcării înainte de a cere seria.
  • Verificarea anilor în care un tip chiar există, înainte de a-l compara cu altul.

Structura răspunsului

CâmpTipDescriere
data.categorii[].categorie string Categoria din clasificarea sursei.
data.categorii[].denumire string Denumirea, aşa cum o publică sursa.
data.categorii[].defalcari array Ce defalcări are categoria: niciuna, una sau două.
data.categorii[].are_total boolean false la instituţiile publice, singura categorie fără agregat.
data.categorii[].tipuri[].tip string
data.categorii[].tipuri[].denumire string Denumirea, aşa cum o publică sursa.
data.categorii[].tipuri[].valabil_de_la integer Primul an publicat — aici se vede ruptura din 2012.
data.categorii[].tipuri[].valabil_pana_la integer
data.categorii[].tipuri[].valori integer Valorile seriei, pe perioade.
data.valori_defalcari object Codurile fiecărei defalcări, grupate pe categorie.
data.valori_defalcari.financiar_bancare.proprietate[].cod string Codul din nomenclatorul sursei — cheia pe care se filtrează.
data.valori_defalcari.financiar_bancare.proprietate[].denumire string Denumirea, aşa cum o publică sursa.
data.valori_defalcari.intreprinzatori_privati.activitate[].cod string Codul din nomenclatorul sursei — cheia pe care se filtrează.
data.valori_defalcari.intreprinzatori_privati.activitate[].denumire string Denumirea, aşa cum o publică sursa.
data.nota_defalcari string
data.nota_nomenclator string
data.nota_total string Ce cuprinde totalul şi ce rămâne în afara lui.
data.nota_financiar string
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.nota_teritorii 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/intreprinderi/entitati/nomenclator
{
    "data": {
        "categorii": [
            {
                "categorie": "administratie_privata",
                "denumire": "Organizaţii ale administraţiei private",
                "defalcari": [],
                "are_total": true,
                "tipuri": [
                    {
                        "tip": "fundatii_culturale_sportive",
                        "denumire": "Fundatii, asociatii culturale si sportive",
                        "valabil_de_la": 1997,
                        "valabil_pana_la": 2011,
                        "valori": 15
                    }
                ]
            }
        ],
        "valori_defalcari": {
            "financiar_bancare": {
                "proprietate": [
                    {
                        "cod": "majoritar_de_stat",
                        "denumire": "Proprietate majoritar de stat"
                    }
                ]
            },
            "intreprinzatori_privati": {
                "activitate": [
                    {
                        "cod": "alte_servicii",
                        "denumire": "Alte servicii"
                    }
                ]
            }
        },
        "nota_defalcari": "Defalcarea a doua diferă de la o categorie la alta: activitatea şi teritoriul există numai la întreprinzătorii privaţi, forma de proprietate numai la cele financiar-bancare, iar administraţia publică şi cea privată n-au niciuna.",
        "nota_nomenclator": "⚠️ `administratie_privata` îşi schimbă nomenclatorul în 2012: până în 2011 sursa publică cinci tipuri, dintre care trei comasate, iar din 2012 le desface în nouă. `valabil_de_la` şi `valabil_pana_la` o arată pe fiecare tip. Cele două scrieri ale uniunilor profesionale au acelaşi cod, fiindcă e aceeaşi categorie redenumită.",
        "nota_total": "⚠️ `administratie_publica` n-are rând `total`: cele zece tipuri se publică fără agregat.",
        "nota_financiar": "Categoria `financiar_bancare` acoperă exact sectorul EXCLUS din ancheta întreprinderilor: intermedierile financiare nu apar în /financiar/v1/intreprinderi/indicatori."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatorul familiei INT101 (TEMPO).",
        "nota_teritorii": "Teritoriile folosesc aceleaşi coduri ca `teritoriu_cod` din /financiar/v1/pib/judete şi /financiar/v1/conturi-regionale."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă sau invalid.
403feature_indisponibilfinanciar.indici nu e în planul curent.
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": "neautentificat",
        "mesaj": "Token lipsă sau invalid."
    }
}