Financiar v1 / Inflatie

Nomenclatorul ţărilor partenere

Cele 249 de ţări pe care se publică comerţul exterior, cu grupul, fluxurile pe care apar şi anii
fiecăreia. Grupul ue marchează cele 27 de ţări ale Uniunii — singurele cu defalcare pe produse.

GET

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

Parametri de interogare

NumeTipDescriereValori acceptate

grup_tariopțional string | null toate (implicit) sau ue — lista se restrânge la statele membre. Defalcarea pe secţiuni există doar pentru ţările UE. toateue

Cum se comportă

Cele 249 de ţări pe care se publică comerţul exterior, cu grupul, fluxurile pe care apar şi anii fiecăreia.
Grupul ue marchează cele 27 de ţări ale Uniunii — singurele cu defalcare pe secţiuni de nomenclator. Restul apar doar cu totalul pe ţară.
⚠️ De aici se vede şi acoperirea inegală: importul pe ţara de origine se opreşte în 2006, cel pe ţara de expediere începe atunci.

La ce folosește

Găsirea slugului corect înainte de a cere seria.
Verificarea anilor în care o ţară chiar apare în date.

Structura răspunsului

CâmpTipDescriere

data.tari integer Ţările acoperite de răspuns.

data.pe_grup object Câte ţări are fiecare grup.

data.pe_grup.toate integer

data.pe_grup.ue integer

data.grupuri.toate[].tara string Ţara la care se referă valoarea.

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

data.grupuri.toate[].fluxuri array Sensurile de flux pentru care există valori.

data.grupuri.toate[].de_la integer Începutul intervalului acoperit.

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

data.grupuri.ue[] array Cele 27 de ţări cu defalcare pe produse.

data.grupuri.ue[].tara string Ţara la care se referă valoarea.

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

data.grupuri.ue[].fluxuri array Sensurile de flux pentru care există valori.

data.grupuri.ue[].de_la integer Începutul intervalului acoperit.

data.grupuri.ue[].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_concept string

data.nota_coduri string

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/tari/nomenclator

{
    "data": {
        "tari": 277,
        "pe_grup": {
            "toate": 250,
            "ue": 27
        },
        "grupuri": {
            "toate": [
                {
                    "tara": "afganistan",
                    "denumire": "Afganistan",
                    "fluxuri": [
                        "export",
                        "import"
                    ],
                    "de_la": 1991,
                    "pana_la": 2025
                }
            ],
            "ue": [
                {
                    "tara": "austria",
                    "denumire": "Austria",
                    "fluxuri": [
                        "export",
                        "import"
                    ],
                    "de_la": 1991,
                    "pana_la": 2025
                }
            ]
        },
        "nota": "Grupul `toate` are totalul pe ţară parteneră; `ue` are cele 27 de ţări ale Uniunii, singurele cu defalcare pe secţiuni de nomenclator.",
        "nota_concept": "⚠️ La import, ţara parteneră înseamnă **ţara de origine** până în 2006 şi **ţara de expediere** după — pentru schimburile intra-UE. Cele două nu se lipesc.",
        "nota_coduri": "Codul e slugul denumirii de la sursă; nu există un nomenclator ISO în platformă cu care să se poată lega, deci denumirea originală rămâne în `denumire`."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatorul de ţări al matricilor EXP101B, EXP102G, EXP102E, EXP101D şi EXP102C (TEMPO)."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/comert-exterior/tari/nomenclator?grup_tari=toate

{
    "data": {
        "tari": 250,
        "pe_grup": {
            "toate": 250
        },
        "grupuri": {
            "toate": [
                {
                    "tara": "afganistan",
                    "denumire": "Afganistan",
                    "fluxuri": [
                        "export",
                        "import"
                    ],
                    "de_la": 1991,
                    "pana_la": 2025
                }
            ]
        },
        "nota": "Grupul `toate` are totalul pe ţară parteneră; `ue` are cele 27 de ţări ale Uniunii, singurele cu defalcare pe secţiuni de nomenclator.",
        "nota_concept": "⚠️ La import, ţara parteneră înseamnă **ţara de origine** până în 2006 şi **ţara de expediere** după — pentru schimburile intra-UE. Cele două nu se lipesc.",
        "nota_coduri": "Codul e slugul denumirii de la sursă; nu există un nomenclator ISO în platformă cu care să se poată lega, deci denumirea originală rămâne în `denumire`."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatorul de ţări al matricilor EXP101B, EXP102G, EXP102E, EXP101D şi EXP102C (TEMPO)."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/comert-exterior/tari/nomenclator?grup_tari=ue

{
    "data": {
        "tari": 27,
        "pe_grup": {
            "ue": 27
        },
        "grupuri": {
            "ue": [
                {
                    "tara": "austria",
                    "denumire": "Austria",
                    "fluxuri": [
                        "export",
                        "import"
                    ],
                    "de_la": 1991,
                    "pana_la": 2025
                }
            ]
        },
        "nota": "Grupul `toate` are totalul pe ţară parteneră; `ue` are cele 27 de ţări ale Uniunii, singurele cu defalcare pe secţiuni de nomenclator.",
        "nota_concept": "⚠️ La import, ţara parteneră înseamnă **ţara de origine** până în 2006 şi **ţara de expediere** după — pentru schimburile intra-UE. Cele două nu se lipesc.",
        "nota_coduri": "Codul e slugul denumirii de la sursă; nu există un nomenclator ISO în platformă cu care să se poată lega, deci denumirea originală rămâne în `denumire`."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatorul de ţări al matricilor EXP101B, EXP102G, EXP102E, EXP101D şi EXP102C (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 (`grup_tari`); `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 (grup_tari); detalii spune care şi de ce.",
        "detalii": {
            "grup_tari": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}