Financiar v1 / Inflatie

Nomenclatorul structurii comerţului exterior

Cele şapte dimensiuni cu categoriile fiecăreia, măsurile pe care le publică, frecvenţele şi anii.
De aici se citesc, fără o a doua cerere, cele patru neregularităţi: schimbarea de revizie CSCI,
dubla măsură a dimensiunilor de firme, seria cumulată a concentrării şi categoria necunoscut.

GET

https://oneapi.ro/api/financiar/v1/comert-exterior/structura/nomenclator

Parametri de interogare

NumeTipDescriereValori acceptate

dimensiunelistăopțional listă Maxim 7. cscitransportsectormarimecapitalproprietateconcentrare

Cum se comportă

Cele şapte dimensiuni cu categoriile fiecăreia, măsurile pe care le publică, frecvenţele şi anii.
De aici se citesc, fără o a doua cerere, cele patru neregularităţi ale familiei: schimbarea de revizie CSCI din 2006, dubla măsură a dimensiunilor de firme, seria cumulată a concentrării şi categoria necunoscut.

La ce folosește

Alegerea dimensiunii şi a categoriei înainte de a cere seria.
Verificarea măsurii disponibile — nu toate dimensiunile publică numărul de firme.

Structura răspunsului

CâmpTipDescriere

data.categorii integer Categoriile disponibile.

data.pe_dimensiune object Câte categorii are fiecare dimensiune.

data.pe_dimensiune.capital integer

data.pe_dimensiune.concentrare integer

data.pe_dimensiune.csci integer

data.pe_dimensiune.marime integer Clasa de mărime folosită de sursă.

data.pe_dimensiune.proprietate integer Forma de proprietate.

data.pe_dimensiune.sector integer Sectorul instituţional ori economic.

data.pe_dimensiune.transport integer

data.dimensiuni.capital[].categorie string Categoria din clasificarea sursei.

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

data.dimensiuni.capital[].masuri array Măsurile disponibile pentru dimensiunea asta.

data.dimensiuni.capital[].frecvente array Frecvenţele la care se publică seriile din răspuns.

data.dimensiuni.capital[].de_la integer Începutul intervalului acoperit.

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

data.dimensiuni.concentrare[].categorie string Categoria din clasificarea sursei.

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

data.dimensiuni.concentrare[].masuri array Măsurile disponibile pentru dimensiunea asta.

data.dimensiuni.concentrare[].frecvente array Frecvenţele la care se publică seriile din răspuns.

data.dimensiuni.concentrare[].de_la integer Începutul intervalului acoperit.

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

data.dimensiuni.csci[].categorie string Categoria din clasificarea sursei.

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

data.dimensiuni.csci[].revizie string Revizia în care apare secţiunea; aceleaşi numere, alt conţinut.

data.dimensiuni.csci[].masuri array Măsurile disponibile pentru dimensiunea asta.

data.dimensiuni.csci[].frecvente array Frecvenţele la care se publică seriile din răspuns.

data.dimensiuni.csci[].de_la integer Începutul intervalului acoperit.

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

data.dimensiuni.marime[].categorie string Categoria din clasificarea sursei.

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

data.dimensiuni.marime[].masuri array Măsurile disponibile pentru dimensiunea asta.

data.dimensiuni.marime[].frecvente array Frecvenţele la care se publică seriile din răspuns.

data.dimensiuni.marime[].de_la integer Începutul intervalului acoperit.

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

data.dimensiuni.proprietate[].categorie string Categoria din clasificarea sursei.

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

data.dimensiuni.proprietate[].masuri array Măsurile disponibile pentru dimensiunea asta.

data.dimensiuni.proprietate[].frecvente array Frecvenţele la care se publică seriile din răspuns.

data.dimensiuni.proprietate[].de_la integer Începutul intervalului acoperit.

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

data.dimensiuni.sector[].categorie string Categoria din clasificarea sursei.

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

data.dimensiuni.sector[].masuri array Măsurile disponibile pentru dimensiunea asta.

data.dimensiuni.sector[].frecvente array Frecvenţele la care se publică seriile din răspuns.

data.dimensiuni.sector[].de_la integer Începutul intervalului acoperit.

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

data.dimensiuni.transport[].categorie string Categoria din clasificarea sursei.

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

data.dimensiuni.transport[].masuri array Măsurile disponibile pentru dimensiunea asta.

data.dimensiuni.transport[].frecvente array Frecvenţele la care se publică seriile din răspuns.

data.dimensiuni.transport[].de_la integer Începutul intervalului acoperit.

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

data.nota_revizie string Ce s-a schimbat la ultima revizie a sursei şi ce nu se mai compară.

data.nota_masuri string

data.nota_cumulata string

data.nota_necunoscut string

data.nota_frecventa string Ce frecvenţe publică sursa şi care dintre ele nu se compară între ele.

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

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/comert-exterior/structura/nomenclator

{
    "data": {
        "categorii": 73,
        "pe_dimensiune": {
            "capital": 5,
            "concentrare": 8,
            "csci": 22,
            "marime": 6,
            "proprietate": 4,
            "sector": 23,
            "transport": 5
        },
        "dimensiuni": {
            "capital": [
                {
                    "categorie": "integral_romanesc",
                    "denumire": "Integral romanesc",
                    "masuri": [
                        "numar_firme",
                        "valoare"
                    ],
                    "frecvente": [
                        "anual"
                    ],
                    "de_la": 2013,
                    "pana_la": 2024
                }
            ],
            "concentrare": [
                {
                    "categorie": "primele_1000_firme",
                    "denumire": "Primele 1000 firme",
                    "masuri": [
                        "pondere"
                    ],
                    "frecvente": [
                        "anual"
                    ],
                    "de_la": 2013,
                    "pana_la": 2024
                }
            ],
            "csci": [
                {
                    "categorie": "articole_manufacturate_diverse",
                    "denumire": "Articole manufacturate diverse",
                    "revizie": "csci_rev4",
                    "masuri": [
                        "valoare"
                    ],
                    "frecvente": [
                        "anual",
                        "lunar"
                    ],
                    "de_la": 2006,
                    "pana_la": 2026
                }
            ],
            "marime": [
                {
                    "categorie": "0_4_salariati",
                    "denumire": "0-4 salariati",
                    "masuri": [
                        "numar_firme",
                        "valoare"
                    ],
                    "frecvente": [
                        "anual"
                    ],
                    "de_la": 2013,
                    "pana_la": 2024
                }
            ],
            "proprietate": [
                {
                    "categorie": "majoritar_de_stat",
                    "denumire": "Majoritar de stat",
                    "masuri": [
                        "numar_firme",
                        "valoare"
                    ],
                    "frecvente": [
                        "anual"
                    ],
                    "de_la": 2013,
                    "pana_la": 2024
                }
            ],
            "sector": [
                {
                    "categorie": "a_agricultura_silvicultura_si_pescuit",
                    "denumire": "A  AGRICULTURA, SILVICULTURA SI PESCUIT",
                    "masuri": [
                        "numar_firme",
                        "valoare"
                    ],
                    "frecvente": [
                        "anual"
                    ],
                    "de_la": 2013,
                    "pana_la": 2024
                }
            ],
            "transport": [
                {
                    "categorie": "total",
                    "denumire": "Total",
                    "masuri": [
                        "valoare"
                    ],
                    "frecvente": [
                        "anual"
                    ],
                    "de_la": 2001,
                    "pana_la": 2025
                }
            ]
        },
        "nota_revizie": "⚠️ CSCI îşi schimbă revizia în 2006: `sitc_rev3` până atunci, `csci_rev4` după. Cele unsprezece secţiuni poartă aceleaşi numere, dar şi-au schimbat denumirile şi conţinutul — seriile nu se lipesc.",
        "nota_masuri": "⚠️ Dimensiunile de firme (`sector`, `marime`, `capital`, `proprietate`) publică DOUĂ măsuri pe acelaşi rând: numărul de firme (coduri de TVA) şi valoarea comerţului lor. Nu sunt variante ale aceleiaşi cifre.",
        "nota_cumulata": "⚠️ `concentrare` e o serie CUMULATĂ, nu o partiţie: „primele 10 firme\" le include pe primele 5. Adunate, ar număra aceleaşi firme de mai multe ori.",
        "nota_necunoscut": "⚠️ `necunoscut` e o categorie reală la mărime, capital şi proprietate — firme pe care sursa nu le poate încadra. Cine o sare pierde o parte din total.",
        "nota_frecventa": "Numai CSCI e publicată şi lunar (2013-2026, doar în euro, cu defalcare intra/extra-UE); restul dimensiunilor sunt anuale."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatoarele familiei EXP10x (TEMPO)."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/comert-exterior/structura/nomenclator?dimensiune[]=csci

{
    "data": {
        "categorii": 22,
        "pe_dimensiune": {
            "csci": 22
        },
        "dimensiuni": {
            "csci": [
                {
                    "categorie": "articole_manufacturate_diverse",
                    "denumire": "Articole manufacturate diverse",
                    "revizie": "csci_rev4",
                    "masuri": [
                        "valoare"
                    ],
                    "frecvente": [
                        "anual",
                        "lunar"
                    ],
                    "de_la": 2006,
                    "pana_la": 2026
                }
            ]
        },
        "nota_revizie": "⚠️ CSCI îşi schimbă revizia în 2006: `sitc_rev3` până atunci, `csci_rev4` după. Cele unsprezece secţiuni poartă aceleaşi numere, dar şi-au schimbat denumirile şi conţinutul — seriile nu se lipesc.",
        "nota_masuri": "⚠️ Dimensiunile de firme (`sector`, `marime`, `capital`, `proprietate`) publică DOUĂ măsuri pe acelaşi rând: numărul de firme (coduri de TVA) şi valoarea comerţului lor. Nu sunt variante ale aceleiaşi cifre.",
        "nota_cumulata": "⚠️ `concentrare` e o serie CUMULATĂ, nu o partiţie: „primele 10 firme\" le include pe primele 5. Adunate, ar număra aceleaşi firme de mai multe ori.",
        "nota_necunoscut": "⚠️ `necunoscut` e o categorie reală la mărime, capital şi proprietate — firme pe care sursa nu le poate încadra. Cine o sare pierde o parte din total.",
        "nota_frecventa": "Numai CSCI e publicată şi lunar (2013-2026, doar în euro, cu defalcare intra/extra-UE); restul dimensiunilor sunt anuale."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatoarele familiei EXP10x (TEMPO)."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/comert-exterior/structura/nomenclator?dimensiune[]=transport

{
    "data": {
        "categorii": 5,
        "pe_dimensiune": {
            "transport": 5
        },
        "dimensiuni": {
            "transport": [
                {
                    "categorie": "total",
                    "denumire": "Total",
                    "masuri": [
                        "valoare"
                    ],
                    "frecvente": [
                        "anual"
                    ],
                    "de_la": 2001,
                    "pana_la": 2025
                }
            ]
        },
        "nota_revizie": "⚠️ CSCI îşi schimbă revizia în 2006: `sitc_rev3` până atunci, `csci_rev4` după. Cele unsprezece secţiuni poartă aceleaşi numere, dar şi-au schimbat denumirile şi conţinutul — seriile nu se lipesc.",
        "nota_masuri": "⚠️ Dimensiunile de firme (`sector`, `marime`, `capital`, `proprietate`) publică DOUĂ măsuri pe acelaşi rând: numărul de firme (coduri de TVA) şi valoarea comerţului lor. Nu sunt variante ale aceleiaşi cifre.",
        "nota_cumulata": "⚠️ `concentrare` e o serie CUMULATĂ, nu o partiţie: „primele 10 firme\" le include pe primele 5. Adunate, ar număra aceleaşi firme de mai multe ori.",
        "nota_necunoscut": "⚠️ `necunoscut` e o categorie reală la mărime, capital şi proprietate — firme pe care sursa nu le poate încadra. Cine o sare pierde o parte din total.",
        "nota_frecventa": "Numai CSCI e publicată şi lunar (2013-2026, doar în euro, cu defalcare intra/extra-UE); restul dimensiunilor sunt anuale."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatoarele familiei EXP10x (TEMPO)."
    }
}

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