oneapi
Autentificare
Financiar v1 / Inflatie

Comerţul exterior — total şi balanţă comercială

Exportul FOB, importul CIF, cele două solduri ale balanţei comerciale şi cei doi indici, anual
din 1991 până în 2025. 630 de valori din matricile TEMPO EXP101A, EXP102A, EXP103A,
EXP103B, EXP104A şi EXP105A.

⚠️ Moneda e o dimensiune, nu o etichetă. Aceeaşi mărime se publică deodată în lei, dolari şi
euro; fără moneda, răspunsul ar purta aceeaşi serie de trei ori. Implicit e euro. Indicii sunt
în procente şi n-au monedă — filtrul nu-i şterge din răspuns.

⚠️ Seria în lei ascunde denominarea din 2005, cu alt factor decât în restul modulului. E în
milioane lei vechi, nu în miliarde: exportul total sare de la 767.940.109 în 2004 la 80.663 în
2005, adică se împarte la 10.000. Blocul publicat păstrează valoarea brută.

✅ export FOB − import CIF = sold fob_cif se închide 35 din 35 de ani, cu toleranţa derivată
de 1 milion — sursa publică milioane întregi, iar doi termeni rotunjiţi pot devia cu atât.

⚠️ sold fob_fob NU e o variantă de prezentare a celuilalt şi nu se poate verifica din datele
publicate: ar cere importul evaluat FOB, care nu se publică separat. Diferenţa dintre cele două
solduri e marja CIF−FOB, adică transportul şi asigurarea importurilor — 446 de milioane de
dolari în 1991, 5.503 în 2024. Răspunsul o dă calculată, în identitati.marja_cif_fob.

⚠️ Defalcarea pe proprietate privată se opreşte în 2006, 16 ani din 35.

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

Parametri de interogare

NumeTipDescriereValori acceptate
variantaopțional string | null Opţional, doar pentru sold: fob_cif ori fob_fob. fob_fobfob_cif
proprietateopțional string | null Opţional: total (implicit) ori privata, aceasta din urmă doar până în 2006. totalprivata
de_laopțional integer | null Opţional, an, din 1991. 1991 – 2100
pana_laopțional integer | null Opţional, an. 1991 – 2100
indicatorlistăopțional text Opţional, separate prin virgulă: valoare, sold, indice_valoric, indice_valoare_unitara. Implicit toate. valoaresoldindice_valoricindice_valoare_unitara
fluxlistăopțional text Opţional: export, import. Soldul n-are flux — e diferenţa dintre ele. exportimport
monedalistăopțional text Opţional: lei, usd, eur. Implicit eur. Indicii n-au monedă. leiusdeur

Cum se comportă

  • Exportul FOB, importul CIF, cele două solduri ale balanţei comerciale şi cei doi indici — anual din 1991 până în 2025. 630 de valori din matricile TEMPO EXP101A, EXP102A, EXP103A, EXP103B, EXP104A şi EXP105A.
  • ⚠️ Moneda e o dimensiune, nu o etichetă. Aceeaşi mărime se publică deodată în lei, dolari şi euro; fără moneda, răspunsul ar purta aceeaşi serie de trei ori. Implicit e euro. Cei doi indici sunt în procente şi n-au monedă — filtrul de monedă nu-i şterge din răspuns.
  • ⚠️ Seria în lei ascunde denominarea din 2005, cu ALT factor decât în restul modulului. Aici sursa publică în milioane lei vechi, nu în miliarde: exportul total sare de la 767.940.109 în 2004 la 80.663 în 2005. Deci milioane ROL → milioane RON înseamnă împărţit la 10.000, nu înmulţit cu 0,1 ca la /financiar/v1/intreprinderi/rezultate. Verificat: 767.940.109 / 10.000 = 76.794, iar 2005 dă 80.663 — o creştere de 5%, serie continuă. Blocul publicat păstrează valoarea brută şi factorul.
  • ✅ export FOB − import CIF = sold fob_cif se închide 35 din 35 de ani, cu toleranţa derivată de 1 milion: sursa publică milioane întregi, iar doi termeni rotunjiţi pot devia cu atât. Identitatea se cere din bază, nu din răspunsul filtrat — cine cere doar exportul n-are cum s-o închidă.
  • ⚠️ sold fob_fob NU e o variantă de prezentare a celuilalt şi nu se poate verifica din datele publicate: ar cere importul evaluat FOB, care nu se publică separat. Diferenţa dintre cele două solduri E marja CIF−FOB — transportul şi asigurarea importurilor: 446 de milioane de dolari în 1991, 5.503 în 2024. Răspunsul o dă calculată, în identitati.marja_cif_fob, ca să nu fie nevoie de o scădere pe care cineva ar putea-o face invers.
  • ⚠️ Defalcarea pe proprietate privată se opreşte în 2006 — 16 ani din 35. Totalul merge până la zi.
  • ⚠️ Sursa scrie „totalul" în două feluri pe aceeaşi dimensiune: - la export, Total la import. Proiecţia le normalizează pe amândouă la total; o potrivire pe literal ar fi ratat jumătate din pereche.

La ce folosește

  • Deficitul comercial al României, pe treizeci şi cinci de ani, în moneda dorită.
  • Costul de transport şi asigurare al importurilor, ca serie de sine stătătoare.
  • Separarea creşterii de preţ de creşterea de volum, prin cei doi indici.
  • Aceeaşi serie în lei, dolari şi euro, fără conversie proprie.

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.filtre.moneda array Moneda în care sunt exprimate valorile.
data.filtre.proprietate string Forma de proprietate.
data.ani array Anii pentru care există valori.
data.serii[].indicator string Indicatorul statistic la care se referă valoarea.
data.serii[].denumire string Denumirea, aşa cum o publică sursa.
data.serii[].flux string Sensul fluxului (de regulă import ori export).
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.sold object Verificarea export − import = sold fob_cif, cerută din bază, cu toleranţa derivată din precizia publicată.
data.identitati.sold.identitate string Identitatea verificată — ce sumă trebuie să dea ce total.
data.identitati.sold.toleranta string Cât se acceptă ca abatere înainte ca identitatea să fie considerată neînchisă — rotunjirea sursei, nu o eroare.
data.identitati.sold.nota string Precizare despre cum se citesc datele — o capcană, o convenţie sau o limită a sursei.
data.identitati.sold.verificari integer Câte combinaţii au fost verificate.
data.identitati.sold.inchise integer Câte verificări s-au închis în toleranţă.
data.identitati.sold.abatere_maxima string Cea mai mare abatere întâlnită între suma componentelor şi total.
data.identitati.sold.unde null Categoria şi perioada cu abaterea cea mai mare. Absent când totul se închide.
data.identitati.marja_cif_fob object Diferenţa dintre cele două solduri: costul de transport şi asigurare al importurilor, calculat pe fiecare an.
data.identitati.marja_cif_fob.ce_e string
data.identitati.marja_cif_fob.nota string Precizare despre cum se citesc datele — o capcană, o convenţie sau o limită a sursei.
data.identitati.marja_cif_fob.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.identitati.marja_cif_fob.valori object Valorile seriei, pe perioade.
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.nota_implicit string Ce valoare s-a folosit când parametrul n-a fost trimis.
meta.nota_identitate string Cum se verifică identitatea de mai sus şi ce înseamnă când nu se închide.
meta.nota_sold string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_proprietate string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
data.serii[].publicat Prezent doar pe anii în lei de până în 2004: valoarea brută în milioane lei vechi şi factorul 0,0001.
data.serii[].varianta Doar pe sold: fob_cif sau fob_fob. Cele două nu se compară ca variante ale aceleiaşi cifre.
meta.fara_date data e null, iar aici stă motivul. Proiecţia peste datele INS e goală. Combinaţia n-are serii; atenţie, varianta există doar pe sold, iar privata se opreşte în 2006. 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
{
    "data": {
        "de_la": 1991,
        "pana_la": 2025,
        "filtre": {
            "moneda": [
                "eur"
            ],
            "proprietate": "total"
        },
        "ani": [
            1991,
            1992,
            1993,
            1994,
            1995,
            1996,
            1997,
            1998,
            1999,
            2000,
            2001,
            2002,
            2003,
            2004,
            2005,
            2006,
            2007,
            2008,
            2009,
            2010,
            2011,
            2012,
            2013,
            2014,
            2015,
            2016,
            2017,
            2018,
            2019,
            2020,
            2021,
            2022,
            2023,
            2024,
            2025
        ],
        "serii": [
            {
                "indicator": "indice_valoare_unitara",
                "denumire": "Indicele valorii unitare",
                "flux": "export",
                "unitate": "procente",
                "ani_publicati": 25,
                "valori": {
                    "1991": null,
                    "1992": null,
                    "1993": null,
                    "1994": null,
                    "1995": null,
                    "1996": null,
                    "1997": null,
                    "1998": null,
                    "1999": null,
                    "2000": "108.9",
                    "2001": "100.6",
                    "2002": "98.5",
                    "2003": "98.2",
                    "2004": "105.1",
                    "2005": "109.5",
                    "2006": "108.2",
                    "2007": "106",
                    "2008": "103.8",
                    "2009": "89.3",
                    "2010": "107",
                    "2011": "107.9",
                    "2012": "103.9",
                    "2013": "97",
                    "2014": "98.5",
                    "2015": "100.2",
                    "2016": "98.2",
                    "2017": "101.6",
                    "2018": "103.8",
                    "2019": "101.4",
                    "2020": "98.8",
                    "2021": "109.4",
                    "2022": "116.8",
                    "2023": "100.8",
                    "2024": "99.9",
                    "2025": null
                }
            }
        ],
        "identitati": {
            "sold": {
                "identitate": "export FOB − import CIF = sold `fob_cif`",
                "toleranta": "1",
                "nota": "Cerută din bază, pe moneda şi proprietatea răspunsului — un răspuns filtrat pe un singur flux n-ar avea cum s-o închidă. Toleranţa e derivată: sursa publică milioane întregi, iar doi termeni rotunjiţi pot devia cu 1. Măsurat pe toată seria: 35 din 35 de ani.",
                "verificari": 35,
                "inchise": 35,
                "abatere_maxima": "0",
                "unde": null
            },
            "marja_cif_fob": {
                "ce_e": "Diferenţa dintre cele două solduri publicate: costul de transport şi asigurare al importurilor, adică exact ce separă evaluarea CIF de cea FOB.",
                "nota": "⚠️ `sold fob_fob` NU se poate verifica din datele publicate — ar cere importul evaluat FOB, care nu se publică separat. Nu e o variantă de prezentare a celuilalt sold.",
                "unitate": "milioane EUR",
                "valori": {
                    "1991": "365",
                    "1992": "371",
                    "1993": "429",
                    "1994": "461",
                    "1995": "612",
                    "1996": "702",
                    "1997": "769",
                    "1998": "811",
                    "1999": "764",
                    "2000": "1095",
                    "2001": "1338",
                    "2002": "1454",
                    "2003": "1632",
                    "2004": "2023",
                    "2005": "2507",
                    "2006": "3137",
                    "2007": "3951",
                    "2008": "4406",
                    "2009": "2999",
                    "2010": "3608",
                    "2011": "4230",
                    "2012": "2255",
                    "2013": "2280",
                    "2014": "2412",
                    "2015": "2596",
                    "2016": "2777",
                    "2017": "3117",
                    "2018": "3340",
                    "2019": "3478",
                    "2020": "3247",
                    "2021": "3965",
                    "2022": "5080",
                    "2023": "4920",
                    "2024": "5082",
                    "2025": "5213"
                }
            }
        }
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — comerţul internaţional cu bunuri (TEMPO, matricile EXP101A, EXP102A, EXP103A, EXP103B, EXP104A şi EXP105A).",
        "acoperire": {
            "de_la": 1991,
            "pana_la": 2025
        },
        "serii_returnate": 8,
        "nota_implicit": "Fără `moneda` şi `proprietate`, răspunsul ar purta aceeaşi mărime de mai multe ori. Implicit: euro, total.",
        "nota_identitate": "Verificat pe acest răspuns: 35 din 35 ani se închid la toleranţa de 1 milion.",
        "nota_sold": "Cele două solduri nu sunt variante de prezentare: `fob_cif` se verifică din export şi import, `fob_fob` nu. Diferenţa dintre ele e marja de transport şi asigurare a importurilor.",
        "nota_proprietate": "Defalcarea `privata` se opreşte în 2006; totalul merge până la zi."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă sau invalid.
403feature_indisponibilfinanciar.indici nu e în planul curent.
422validareIndicator, flux, monedă, variantă ori formă în afara listei; an în afara intervalului.
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": "Indicator, flux, monedă, variantă ori formă în afara listei; an în afara intervalului.",
        "detalii": {
            "varianta": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}