oneapi
Autentificare
Financiar v1 / Inflatie

Comerţul exterior pe ţări partenere

Exportul FOB şi importul CIF pe 249 de ţări partenere, anual din 1991, în dolari şi euro.
84.142 de valori din matricile TEMPO EXP101B, EXP102G, EXP102E (totalul pe ţară) şi
EXP101D, EXP102C (ţările Uniunii × secţiuni de nomenclator).

⚠️ La import, „ţara parteneră" înseamnă DOUĂ lucruri diferite, iar sursa le desparte în 2006.
Până atunci publică ţara de origine; după, ţara de expediere pentru schimburile intra-UE.
Pe totalul importului cele două coincid — e aceeaşi marfă, doar altfel atribuită — dar pe ţări mută
miliarde. În 2006, singurul an publicat pe amândouă: Ungaria trece de la 1,67 la 3,45 miliarde de
dolari, în timp ce China scade de la 2,19 la 1,31 şi Statele Unite de la 1,24 la 0,72.
Marfa chinezească intrată prin Ungaria sau Olanda apare la origine ca fiind din China şi la
expediere ca venind de acolo. Fiecare serie îşi poartă concept; cele două nu se lipesc.

Exportul n-are ambiguitatea asta — ţara parteneră e destinaţia.

⚠️ Defalcarea pe produse există numai pentru ţările Uniunii Europene — 27 de ţări × 22 de
secţiuni. Pentru restul lumii se publică doar totalul pe ţară. Şi acolo importul e pe origine
până în 2006 inclusiv şi pe expediere din 2007 — concept o spune pe fiecare an.

✅ Suma ţărilor dă rândul total în 34 din 35 de ani la export (abatere maximă 0,018%), 20/20 la
importul pe expediere şi 16/16 la cel pe origine.

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

Parametri de interogare

NumeTipDescriereValori acceptate
nivel_ncopțional string | null Opţional: total (implicit) ori sectiune. totalsectiune
grup_tariopțional string | null Opţional: toate (implicit) ori ue. toateue
monedaopțional string | null Opţional: eur (implicit) ori usd. usdeur
de_laopțional integer | null Opţional, an, din 1991. 1991 – 2100
pana_laopțional integer | null Opţional, an. 1991 – 2100
fluxlistăopțional text Opţional: export, import. Fără el, amândouă. exportimport
taralistăopțional text Opţional, sluguri separate prin virgulă, plus total. ex. afganistanex. austria
nclistăopțional text Opţional, secţiuni cu cifre romane — numai pentru ţările Uniunii Europene. ex. total

Cum se comportă

  • Exportul FOB şi importul CIF pe 249 de ţări partenere, anual din 1991 până în 2025, în dolari şi euro. 84.142 de valori din matricile TEMPO EXP101B, EXP102G, EXP102E (totalul pe ţară) şi EXP101D, EXP102C (ţările Uniunii × secţiuni de nomenclator).
  • ⚠️ La import, „ţara parteneră" înseamnă DOUĂ lucruri diferite, iar sursa le desparte în 2006. Până atunci publică ţara de origine — unde s-a produs marfa; din 2006, ţara de expediere pentru schimburile intra-UE. Pe totalul importului cele două coincid (în 2006: 51.106.041 faţă de 51.106.042 de mii de dolari, o diferenţă de o mie) — e aceeaşi marfă, doar altfel atribuită. Pe ţări, însă, mută miliarde: în 2006, singurul an publicat pe amândouă, Ungaria trece de la 1,67 la 3,45 miliarde de dolari, în timp ce China scade de la 2,19 la 1,31 şi Statele Unite de la 1,24 la 0,72. Marfa chinezească intrată prin Ungaria sau Olanda apare la origine ca fiind din China şi la expediere ca venind de acolo.
  • Fiecare serie îşi poartă concept, iar cele două nu se lipesc. Răspunsul dă şi cele mai mari diferenţe pe anul suprapus, în identitati.concept, ca schimbarea să se vadă cu ochii, nu doar să fie descrisă. Exportul n-are ambiguitatea asta — ţara parteneră e destinaţia.
  • ⚠️ Defalcarea pe produse există numai pentru ţările Uniunii Europene — 27 de ţări × 22 de secţiuni de nomenclator. Pentru restul lumii se publică doar totalul pe ţară. grup_tari desparte cele două seturi: toate şi ue.
  • ⚠️ Şi importul pe secţiuni îşi schimbă conceptul, dar un an mai târziu: ţările Uniunii × secţiuni sunt pe origine până în 2006 inclusiv şi pe expediere din 2007 (Ungaria, euro: 1.331.563 în 2006 = origine, 3.566.110 în 2007 = expediere). concept o spune pe fiecare an, deci seria pe secţiuni a unei ţări se rupe în două, exact ca totalul.
  • ✅ Suma ţărilor dă rândul total în 34 din 35 de ani la export (abatere maximă 0,018%), 20 din 20 la importul pe expediere şi 16 din 16 la cel pe origine, la un prag relativ de 0,01%.
  • Cei mai mari parteneri de export în 2024, în euro: Germania 19,04 miliarde, Italia 8,85, Franţa 5,87, Ungaria 4,92, Bulgaria 4,11.
  • Codul de ţară e slugul denumirii de la sursă (germania, africa_de_sud). Cehia apare la sursă sub două denumiri, după grup; slugul servit e republica_ceha, iar cehia rămâne acceptat ca sinonim, ca să nu pice cererile scrise înainte de unificare. Nu există un nomenclator ISO în platformă cu care să se poată lega, deci denumirea originală rămâne în denumire. Singura excepţie: sursa scrie „Cehia" la ţările Uniunii şi „Republica Ceha" la totalul pe ţări — amândouă poartă slugul republica_ceha.

La ce folosește

  • Structura pe destinaţii a exportului românesc, pe treizeci şi cinci de ani.
  • Dependenţa de un partener anume, cu seria completă în spate.
  • Ce cumpărăm de la fiecare ţară a Uniunii, pe secţiuni de mărfuri.
  • Efectul schimbării de concept din 2006, măsurat ţară cu ţară.

Structura răspunsului

CâmpTipDescriere
data.de_la integer Începutul intervalului acoperit de răspuns.
data.pana_la integer Sfârşitul intervalului acoperit de răspuns, inclusiv.
data.unitate string Unitatea de măsură a valorilor. Citeşte-o înainte de a le pune pe un grafic sau de a le aduna.
data.filtre.flux array Sensul fluxului (de regulă import ori export).
data.filtre.nivel_nc string
data.filtre.grup_tari string
data.filtre.moneda string Moneda în care sunt exprimate valorile.
data.ani array Anii pentru care există valori.
data.serii[].flux string Sensul fluxului (de regulă import ori export).
data.serii[].concept string partener la export, origine ori expediere la import — spune ce înseamnă ţara pe rândul acela.
data.serii[].tara string Ţara la care se referă valoarea.
data.serii[].denumire string Denumirea, aşa cum o publică sursa.
data.serii[].grup_tari string toate (totalul pe ţară) ori ue (cu defalcare pe secţiuni).
data.serii[].nc string Codul din Nomenclatorul Combinat al mărfurilor.
data.serii[].nivel_nc string
data.serii[].moneda string Moneda în care sunt exprimate valorile.
data.serii[].unitate string Unitatea de măsură a valorilor. Citeşte-o înainte de a le pune pe un grafic sau de a le aduna.
data.serii[].ani_publicati integer Anii pe care sursa i-a publicat efectiv pentru seria asta.
data.serii[].valori object Valorile seriei, pe perioade.
data.identitati.tari.identitate string Identitatea verificată — ce sumă trebuie să dea ce total.
data.identitati.tari.toleranta string Cât se acceptă ca abatere înainte ca identitatea să fie considerată neînchisă — rotunjirea sursei, nu o eroare.
data.identitati.tari.nota string Precizare despre cum se citesc datele — o capcană, o convenţie sau o limită a sursei.
data.identitati.tari.pe_serie[].flux string Sensul fluxului (de regulă import ori export).
data.identitati.tari.pe_serie[].concept string
data.identitati.tari.pe_serie[].verificari integer Câte combinaţii au fost verificate.
data.identitati.tari.pe_serie[].inchise integer Câte verificări s-au închis în toleranţă.
data.identitati.tari.pe_serie[].abatere_maxima_procente string
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.acoperire.de_la integer Prima perioadă pentru care avem date.
meta.acoperire.pana_la integer Ultima perioadă pentru care avem date.
meta.serii_returnate integer Câte serii s-au întors efectiv, după filtre şi după plafonul de celule.
meta.unitate string Unitatea de măsură a valorilor. Citeşte-o înainte de a le pune pe un grafic sau de a le aduna.
meta.nota_implicit string Ce valoare s-a folosit când parametrul n-a fost trimis.
meta.nota_concept string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_produse string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_identitate string Cum se verifică identitatea de mai sus şi ce înseamnă când nu se închide.
meta.nota_lista string Ce conţine lista şi ce nu — limitele ei.
data.identitati.concept Cele două concepte de import puse faţă în faţă pe 2006, cu cele mai mari diferenţe pe ţări.
meta.fara_date data e null, iar aici stă motivul. Proiecţia peste datele INS e goală. Listele sunt la /financiar/v1/comert-exterior/tari/nomenclator. Combinaţia n-are serii; atenţie, defalcarea pe secţiuni există numai pentru ţările Uniunii. Ca la celelalte serii.
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?flux=export&de_la=2020&pana_la=2024
{
    "data": {
        "de_la": 2020,
        "pana_la": 2024,
        "unitate": "mii EUR",
        "filtre": {
            "flux": [
                "export"
            ],
            "nivel_nc": "total",
            "grup_tari": "toate",
            "moneda": "eur"
        },
        "ani": [
            2020,
            2021,
            2022,
            2023,
            2024
        ],
        "serii": [
            {
                "flux": "export",
                "concept": "partener",
                "tara": "afganistan",
                "denumire": "Afganistan",
                "grup_tari": "toate",
                "nc": "total",
                "nivel_nc": "total",
                "moneda": "eur",
                "unitate": "mii EUR",
                "ani_publicati": 5,
                "valori": {
                    "2020": "5017",
                    "2021": "6964",
                    "2022": "500",
                    "2023": "528",
                    "2024": "2550"
                }
            }
        ],
        "identitati": {
            "tari": {
                "identitate": "suma ţărilor partenere = rândul `total`",
                "toleranta": "relativă, 0.0001 din total",
                "nota": "Cerută din bază — un răspuns pe o singură ţară n-ar avea cum s-o închidă. Măsurat pe toată seria: 34 din 35 de ani la export (abatere maximă 0,018%), 20/20 la importul pe expediere şi 16/16 la cel pe origine.",
                "pe_serie": [
                    {
                        "flux": "export",
                        "concept": "partener",
                        "verificari": 5,
                        "inchise": 5,
                        "abatere_maxima_procente": "0.000"
                    }
                ]
            }
        }
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — comerţul internaţional pe ţări partenere (TEMPO, matricile EXP101B, EXP102G, EXP102E, EXP101D şi EXP102C).",
        "acoperire": {
            "de_la": 1991,
            "pana_la": 2025
        },
        "serii_returnate": 220,
        "unitate": "mii EUR",
        "nota_implicit": "Fără `nivel_nc` şi `grup_tari`, răspunsul ar amesteca totalul pe ţară cu defalcarea pe secţiuni. Implicit: toate ţările, pe total.",
        "nota_concept": "La import, `concept` spune dacă ţara e cea de origine (până în 2006) ori cea de expediere (după).",
        "nota_produse": "Defalcarea pe secţiuni de nomenclator există numai pentru cele 27 de ţări ale Uniunii Europene.",
        "nota_identitate": "Cerută din bază — un răspuns pe o singură ţară n-ar avea cum s-o închidă. Măsurat pe toată seria: 34 din 35 de ani la export (abatere maximă 0,018%), 20/20 la importul pe expediere şi 16/16 la cel pe origine.",
        "nota_lista": "Lista ţărilor, cu grupul şi anii fiecăreia: /financiar/v1/comert-exterior/tari/nomenclator."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă sau invalid.
403feature_indisponibilfinanciar.indici nu e în planul curent.
422raspuns_prea_marePeste 20.000 de celule; cele 249 de ţări pe toată seria depăşesc plafonul. Plus flux, ţară, secţiune, grup ori monedă în afara listei.
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": "raspuns_prea_mare",
        "mesaj": "Peste 20.000 de celule; cele 249 de ţări pe toată seria depăşesc plafonul. Plus flux, ţară, secţiune, grup ori monedă în afara listei.",
        "detalii": {
            "nivel_nc": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}