oneapi
Autentificare
Financiar v1 / Inflatie

Nomenclatorul comerţului exterior pe produse

Nomenclatorul combinat, pe cele trei niveluri peste care se publică datele: 22 de secţiuni
(cifre romane), 97 de capitole (două cifre) şi 1.260 de poziţii la export / 1.358 la import
(patru cifre), plus totalul. Cu denumirea exactă de la sursă, fluxurile pe care apare fiecare cod
şi anii lui.

⚠️ Sunt trei tăieturi ale aceloraşi mărfuri, nu categorii disjuncte. Nu se adună între ele;
primele două cifre ale unei poziţii sunt chiar capitolul ei, dat în capitol.

⚠️ Defalcarea sursei se completează în timp: secţiunile închid totalul pe toată seria, capitolele
şi poziţiile abia din 2024. nota_completitudine dă cifrele măsurate.

Serveşte şi codurile folosite de /financiar/v1/comert-exterior/judete, care lucrează pe primele
două niveluri.

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

Parametri de interogare

NumeTipDescriereValori acceptate
nivel_ncopțional string | null Nivelul din Nomenclatura Combinată pentru care vrei lista de coduri: total, sectiune, capitol sau pozitie. Nivelurile acoperă aceleaşi mărfuri şi NU se adună între ele. totalsectiunecapitolpozitie

Cum se comportă

  • Nomenclatorul combinat pe cele trei niveluri peste care se publică datele: 22 de secţiuni (cifre romane), 97 de capitole (două cifre) şi 1.360 de poziţii de patru cifre, plus totalul — 1.480 de coduri. Cu denumirea exactă de la sursă, fluxurile pe care apare fiecare cod şi anii lui. nivel_nc filtrează un singur nivel.
  • ⚠️ Sunt trei tăieturi ale aceloraşi mărfuri, nu categorii disjuncte. Nu se adună între ele; primele două cifre ale unei poziţii sunt chiar capitolul ei, dat în capitol.
  • ⚠️ Defalcarea sursei se completează în timp: secţiunile închid totalul pe toată seria, capitolele şi poziţiile abia din 2024. nota_completitudine dă cifrele măsurate. Iar exportul şi importul n-au acelaşi set de poziţii — fluxuri spune pe care apare fiecare cod.

La ce folosește

  • Alegerea nivelului potrivit înainte de a cere seria.
  • Verificarea anilor în care un cod chiar e publicat.

Structura răspunsului

CâmpTipDescriere
data.coduri integer
data.pe_nivel object Câte coduri are fiecare nivel.
data.pe_nivel.capitol integer
data.pe_nivel.pozitie integer Poziţia elementului în ordinea răspunsului.
data.pe_nivel.sectiune integer Secţiunea din clasificare — nivelul cel mai larg.
data.pe_nivel.total integer
data.niveluri.capitol[].nc string Codul din Nomenclatorul Combinat al mărfurilor.
data.niveluri.capitol[].denumire string Denumirea, aşa cum o publică sursa.
data.niveluri.capitol[].fluxuri array Sensurile de flux pentru care există valori.
data.niveluri.capitol[].de_la integer Începutul intervalului acoperit.
data.niveluri.capitol[].pana_la integer Sfârşitul intervalului acoperit, inclusiv.
data.niveluri.pozitie[].nc string Codul din Nomenclatorul Combinat al mărfurilor.
data.niveluri.pozitie[].denumire string Denumirea, aşa cum o publică sursa.
data.niveluri.pozitie[].capitol string
data.niveluri.pozitie[].fluxuri array Sensurile de flux pentru care există valori.
data.niveluri.pozitie[].de_la integer Începutul intervalului acoperit.
data.niveluri.pozitie[].pana_la integer Sfârşitul intervalului acoperit, inclusiv.
data.niveluri.sectiune[].nc string Codul din Nomenclatorul Combinat al mărfurilor.
data.niveluri.sectiune[].denumire string Denumirea, aşa cum o publică sursa.
data.niveluri.sectiune[].fluxuri array Sensurile de flux pentru care există valori.
data.niveluri.sectiune[].de_la integer Începutul intervalului acoperit.
data.niveluri.sectiune[].pana_la integer Sfârşitul intervalului acoperit, inclusiv.
data.niveluri.total[].nc string Codul din Nomenclatorul Combinat al mărfurilor.
data.niveluri.total[].denumire string Denumirea, aşa cum o publică sursa.
data.niveluri.total[].fluxuri array Sensurile de flux pentru care există valori.
data.niveluri.total[].de_la integer Începutul intervalului acoperit.
data.niveluri.total[].pana_la integer Sfârşitul intervalului acoperit, inclusiv.
data.nota string Precizare despre cum se citesc datele — o capcană, o convenţie sau o limită a sursei.
data.nota_completitudine string
data.nota_partener string
data.nota_asimetrie string
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.nota_judete string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
data.niveluri.capitol[].nota Prezentă unde codul nu acoperă toată seria — cazul capitolului 99.
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/nomenclator
{
    "data": {
        "coduri": 1480,
        "pe_nivel": {
            "capitol": 97,
            "pozitie": 1360,
            "sectiune": 22,
            "total": 1
        },
        "niveluri": {
            "capitol": [
                {
                    "nc": "01",
                    "denumire": "01. Animale vii",
                    "fluxuri": [
                        "export",
                        "import"
                    ],
                    "de_la": 1991,
                    "pana_la": 2025
                }
            ],
            "pozitie": [
                {
                    "nc": "0101",
                    "denumire": "0101 Cai, magari, catari si bardoti, vii",
                    "capitol": "01",
                    "fluxuri": [
                        "export",
                        "import"
                    ],
                    "de_la": 1991,
                    "pana_la": 2025
                }
            ],
            "sectiune": [
                {
                    "nc": "I",
                    "denumire": "I. Animale vii si produse animale",
                    "fluxuri": [
                        "export",
                        "import"
                    ],
                    "de_la": 1991,
                    "pana_la": 2025
                }
            ],
            "total": [
                {
                    "nc": "total",
                    "denumire": "Total",
                    "fluxuri": [
                        "export",
                        "import"
                    ],
                    "de_la": 1991,
                    "pana_la": 2025
                }
            ]
        },
        "nota": "⚠️ Cele patru niveluri acoperă aceleaşi mărfuri, nu bucăţi diferite: secţiune → capitol → poziţie de patru cifre. Nu se adună între ele; `nivel_nc` alege unul singur. Primele două cifre ale unei poziţii SUNT capitolul ei, dat şi în `capitol`.",
        "nota_completitudine": "⚠️ Defalcarea se completează în timp: 35/35 de ani pe trei din cele patru combinaţii flux × partener, 34/35 pe a patra (1996) la secţiuni; capitolele închid doar din 2024 — 2 ani din 35; abateri de până la 2,12% la export şi 2,89% la import în anii vechi; poziţiile din 2024 la export şi din 2025 la import; numărul poziţiilor creşte de la 742 în 1991 la 1.170 în 2024.",
        "nota_partener": "Defalcarea pe Uniunea Europeană se publică doar pe secţiuni şi capitole.",
        "nota_asimetrie": "Exportul şi importul n-au acelaşi număr de poziţii — importăm mărfuri pe linii de nomenclator pe care nu exportăm nimic. `fluxuri` spune pe care apare fiecare cod."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatorul matricilor EXP101E, EXP102D, EXP101F şi EXP102F (TEMPO).",
        "nota_judete": "La /financiar/v1/comert-exterior/judete, judeţele se cer pe codul auto (`CJ`, `B`), acelaşi cu `cod_auto` din /locations/v1."
    }
}

Coduri de eroare

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