Financiar v1 / Inflatie

Nomenclatorul tabelului intrări-ieşiri

Cele 91 de rânduri de produs — 88 de diviziuni CAEN Rev.2, două corecţii şi totalul — şi cele 30 de
categorii, fiecare cu latura şi cu rolul ei, ca să se ştie dinainte care se adună şi care nu.

GET

https://oneapi.ro/api/financiar/v1/intrari-iesiri/nomenclator

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Rândurile de produs şi categoriile publicate în echilibrul resurse-utilizări, cu denumirea exactă de la sursă şi cu anii în care apar. 91 de rânduri — 88 de diviziuni CAEN Rev.2, două corecţii şi totalul — şi 30 de categorii, grupate pe latură.
⚠️ Rolul spune care se adună şi care nu. componenta intră în total; detaliu e defalcarea unei componente; memorandum — adică taxe_vamale — e deja cuprins într-o componentă şi nu se adună a doua oară.
Câmpul compun_totalul dă explicit cele şapte componente ale resurselor şi cele şase ale utilizărilor, ca nimeni să nu le deducă din nume.

La ce folosește

Găsirea diviziunii CAEN potrivite înainte de a cere seria.
Verificarea rolului unei categorii, ca să nu fie amestecată în însumări.

Structura răspunsului

CâmpTipDescriere

data.produse integer

data.categorii integer Categoriile disponibile.

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

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

data.lista_produse[].nivel string diviziune pentru cele 88 de coduri CAEN, special pentru corecţii şi total.

data.lista_produse[].de_la integer Începutul intervalului acoperit.

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

data.lista_categorii.resurse[].categorie string Categoria din clasificarea sursei.

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

data.lista_categorii.resurse[].rol string

data.lista_categorii.utilizari[].categorie string Categoria din clasificarea sursei.

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

data.lista_categorii.utilizari[].rol string

data.compun_totalul object Componentele care se adună, pe fiecare latură.

data.compun_totalul.resurse array

data.compun_totalul.utilizari array

data.nota_rol string

data.nota_marja string

data.nota_semn string Ce înseamnă semnul valorii (intrare/ieşire, creştere/scădere).

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

meta.nota_unitate string Ce trebuie ştiut despre unitatea de măsură înainte de a compara sau aduna valorile.

meta.nota_baze 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/intrari-iesiri/nomenclator

{
    "data": {
        "produse": 91,
        "categorii": 30,
        "lista_produse": [
            {
                "produs": "01",
                "denumire": "Agricultura, vanatoare si servicii anexe",
                "nivel": "diviziune",
                "de_la": 1995,
                "pana_la": 2023
            }
        ],
        "lista_categorii": {
            "resurse": [
                {
                    "categorie": "corectie_cif_fob",
                    "denumire": "Corectie CIF - FOB",
                    "rol": "componenta"
                }
            ],
            "utilizari": [
                {
                    "categorie": "consum_final",
                    "denumire": "Consum final total",
                    "rol": "componenta"
                }
            ]
        },
        "compun_totalul": {
            "resurse": [
                "productie",
                "import",
                "impozite",
                "subventii",
                "marja_transport_comert",
                "corectie_cif_fob",
                "redistribuire_productie"
            ],
            "utilizari": [
                "consum_intermediar",
                "consum_final",
                "formare_capital_fix",
                "variatie_stoc",
                "obiecte_de_valoare",
                "export"
            ]
        },
        "nota_rol": "Se adună doar rândurile cu `rol: componenta`. Cele cu `detaliu` sunt defalcări ale unei componente, iar `taxe_vamale` e `memorandum`: e deja cuprins în `impozite`, iar adunat separat ar strica identitatea.",
        "nota_marja": "`marja_transport_comert` se adună la fiecare produs, dar e zero pe `total`: e o redistribuire între produse, care se anulează pe ansamblu.",
        "nota_semn": "`subventii` e publicată cu semn NEGATIV şi se ADUNĂ în identitate, nu se scade."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatorul matricilor CON111A şi CON111E (TEMPO).",
        "nota_unitate": "Toate valorile seriei sunt în milioane lei.",
        "nota_baze": "Două baze de preţ: `curente` din 1995 şi `comparabile` din 1996, acestea din urmă fiind preţurile anului precedent."
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă sau invalid.
403	feature_indisponibil	`financiar.indici` nu e în planul curent.
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": "neautentificat",
        "mesaj": "Token lipsă sau invalid."
    }
}