oneapi
Autentificare
Financiar v1 / RiscCredit

Investiţii străine directe

18 poziţii pe cinci niveluri, pe principiul direcţional — ca tranzacţii (lunar din 2013 sau
trimestrial) ori ca stocuri (trimestrial). Cele trei clase ale sursei au exact aceleaşi coduri.

Totalul înseamnă altceva la stocuri decât la tranzacţii, iar denumirea nu avertizează: ambele
serii-total se numesc „Investiţii directe". Măsurat, la stocuri se închide total = străinătate − România pe toate trimestrele, iar la tranzacţii total = străinătate + România pe toate perioadele
— fiecare ipoteză pică pe cealaltă clasă, cu abateri de sute de miliarde. La stocuri totalul e poziţia
netă, la tranzacţii intrarea netă. Răspunsul spune care identitate a verificat-o.

Atenţie la semn: la tranzacţii IDT6*_R (investiţiile rezidenţilor în străinătate) vine cu semn
INVERSAT faţă de stocuri şi faţă de balanţa de plăţi — o ieşire de capital e negativă (2026-T2:
−68,90). De aceea T = R + N dă intrarea netă de investiţii directe. Cine compară cu activele din
balanţa de plăţi schimbă semnul lui R.

Cifrele nu se potrivesc cu poziţia investiţională, şi e corect aşa. Diferenţa e aceeaşi sumă pe
ambele laturi — 16.442,50 şi 16.442,54 milioane în 2026-T1 — în toate trimestrele: e
principiul direcţional, cu investiţia inversă compensată, faţă de principiul activ/pasiv al PII.

Tranzacţiile trimestriale sunt exact suma celor lunare (toate trimestrele, abatere maximă 0,01),
deci o agregare verificată, nu date independente. Cele două serii se opresc aliniat (2026-06 lunar,
2026-T2 trimestrial).

Stocurile poartă data_referinta, tranzacţiile nu — un stoc trimestrial e măsurat la sfârşitul
trimestrului, un flux acoperă perioada.

GET
https://oneapi.ro/api/financiar/v1/investitii-directe

Parametri de interogare

NumeTipDescriereValori acceptate
tipopțional string | null Opţional, implicit tranzactii. Sau stocuri — atenţie, totalul îşi schimbă înţelesul. tranzactiistocuri
frecventaopțional string | null Opţional; implicit cea mai fină pe care sursa o publică pentru tipul cerut — lunar la tranzacţii, trimestrial la stocuri. Combinaţia stocuri + lunar nu există. lunartrimestrial
de_laopțional string | null Opţional, YYYY-MM sau YYYY-Tn. La frecvenţă trimestrială, o lună se rotunjeşte la trimestrul care o conţine. ex. 2024-06-15
pana_laopțional string | null Opţional, YYYY-MM sau YYYY-Tn. ex. 2024-06-15
nivel_maxopțional integer | null Opţional, 1–5. Limitează adâncimea arborelui. 1 – 5

Cum se comportă

  • Investiţiile străine directe pe principiul direcţional — 18 poziţii pe cinci niveluri, ca tranzacţii (lunar din ianuarie 2013, sau trimestrial) ori ca stocuri (trimestrial). Cele trei clase ale sursei au exact aceleaşi 18 coduri, deci o rută cu tip şi frecventa.
  • Totalul înseamnă altceva la stocuri decât la tranzacţii, iar denumirea nu avertizează: ambele serii-total se numesc „Investiţii directe". Măsurat, la stocuri se închide total = străinătate − România pe toate trimestrele — e poziţia netă, −126.547 milioane euro în 2026-T1. La tranzacţii se închide total = străinătate + România, pe toate perioadele, fiindcă R — investiţiile rezidenţilor în străinătate — vine cu semn INVERSAT faţă de stocuri şi faţă de balanţa de plăţi: o ieşire de capital e negativă, iar T = R + N e intrarea netă. Cine compară R cu activele din balanţa de plăţi îi schimbă semnul; răspunsul o spune şi în meta.avertisment_semn. Fiecare ipoteză pică pe cealaltă clasă, cu abateri de sute de miliarde; cine aplică aceeaşi regulă la amândouă greşeşte cu 270 de miliarde. Răspunsul spune în identitati[].operatie care a fost verificată.
  • Cifrele nu se potrivesc cu cele din poziţia investiţională, şi e corect aşa. Investiţiile directe din PII sunt 24.718 / 151.265, aici 8.275 / 134.822. Diferenţa e aceeaşi sumă pe ambele laturi — 16.442,50 şi 16.442,54 milioane — în toate trimestrele: principiul direcţional compensează investiţia inversă, faţă de principiul activ/pasiv al poziţiei investiţionale. Nu e o deducţie: denumirea clasei la BNR spune literal „principiul direcţional".
  • Tranzacţiile trimestriale sunt exact suma celor lunare — toate trimestrele, abatere maximă 0,01. Sunt expuse ca frecvenţă pentru comoditate, dar sunt o agregare verificată, nu date independente; cele două serii se opresc aliniat (2026-06 lunar, 2026-T2 trimestrial).
  • Stocurile poartă data_referinta, tranzacţiile nu. Un stoc trimestrial e măsurat la sfârşitul trimestrului, deşi sursa îl etichetează cu luna de început; un flux chiar acoperă perioada.
  • Toleranţa e măsurată direct, nu derivată. La poziţia investiţională toate valorile sunt milioane întregi, deci eroarea de rotunjire se calculează din numărul de componente. Aici 4.301 din 4.730 de valori au zecimale (măsurat 15 sep), până la şase, deci regula nu se aplică — dar abaterea maximă observată pe cele opt identităţi × trei clase e 0,01, la o toleranţă de 0,05.
  • Arborele e asimetric: ramura investiţiilor în România se desface în împrumuturi, credite comerciale şi alte creanţe; cea din străinătate nu. Verificarea cale-vs-cod dă zero dezacorduri la toate trei clasele.
  • Fără filtru pe direcţie: toată clasa e 18 poziţii şi încape într-un răspuns.

La ce folosește

  • Fluxul lunar de investiţii străine în România, cu patru luni mai proaspăt decât cel trimestrial.
  • Stocul de ISD pe sectoare — societăţi care acceptă depozite faţă de restul economiei.
  • Participaţii la capital faţă de instrumente de datorie, adică ce parte din ISD e credit intragrup.

Structura răspunsului

CâmpTipDescriere
data.tip string intreprinderi sau unitati_locale — două concepte diferite, niciodată însumate.
data.frecventa string Frecvenţa la care sursa publică seria (zilnic, lunar, trimestrial, anual).
data.principiu string Mereu direcţional. E motivul pentru care cifrele diferă de poziţia investiţională.
data.de_la string Începutul intervalului acoperit de răspuns.
data.pana_la string 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 array Filtrele aplicate efectiv, aşa cum le-a înţeles ruta — util când o valoare a fost normalizată.
data.perioade[].perioada string Perioada la care se referă valoarea.
data.perioade[].luna_sursa string Luna cu care sursa etichetează perioada, pentru join înapoi în seria brută.
data.pozitii[].cod string Codul din nomenclatorul sursei — cheia pe care se filtrează.
data.pozitii[].sufix string Partea de cod comună celor trei clase — NXDI e aceeaşi poziţie la stocuri şi la tranzacţii.
data.pozitii[].eticheta string Eticheta afişabilă a valorii — versiunea citibilă a codului de alături.
data.pozitii[].cale array Calea în ierarhie, de la rădăcină până la elementul curent.
data.pozitii[].nivel integer Nivelul din ierarhia clasificării — cu cât e mai adânc, cu atât e mai detaliat.
data.pozitii[].parinte null Codul poziţiei-părinte. null la total.
data.pozitii[].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.pozitii[].perioade_publicate integer Câte perioade a publicat efectiv sursa.
data.pozitii[].valori object Valorile seriei, pe perioade.
data.identitati[].identitate string Identitatea verificată — ce sumă trebuie să dea ce total.
data.identitati[].total string
data.identitati[].componente array Componentele care se adună în total.
data.identitati[].operatie string diferenţă la totalul stocurilor, sumă în rest. E semnul distinctiv dintre cele două înţelesuri ale totalului.
data.identitati[].toleranta string Măsurată pe clasă, nu derivată din rotunjire — valorile au zecimale.
data.identitati[].perioade_verificate integer
data.identitati[].perioade_inchise integer
data.identitati[].abatere_maxima string Cea mai mare abatere întâlnită între suma componentelor şi total.
data.identitati_neverificate array Câte identităţi n-au putut fi verificate, din lipsă de date pe una din laturi.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.acoperire.de_la string Prima perioadă pentru care avem date.
meta.acoperire.pana_la string Ultima perioadă pentru care avem date.
meta.perioade integer Perioadele pentru care există valori.
meta.pozitii_totale integer Câte poziţii se potrivesc filtrelor, dincolo de pagina curentă.
meta.pozitii_returnate integer Câte poziţii s-au întors efectiv în răspunsul ăsta.
meta.identitati_verificate integer
meta.identitati_inchise integer Câte identităţi s-au închis în toleranţă.
meta.nota_total string Ce cuprinde totalul şi ce rămâne în afara lui.
meta.avertisment_semn string
meta.nota_principiu string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_frecvente string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_toleranta string De unde vine toleranţa şi de ce nu e zero.
meta.nota_null string De ce lipsesc unele valori: sursa nu le-a publicat, nu le-a calculat ori le-a suprimat.
data.perioade[].data_referinta Doar la tip=stocuri: sfârşitul trimestrului, momentul la care e măsurat stocul.
data.identitati[].unde Perioada care depăşeşte toleranţa. Absent când identitatea se închide peste tot.
data.identitati.neverificate Identităţile declarate pe care fereastra cerută nu le-a putut verifica, fiecare cu motivul: serie_inexistenta (sursa nu publică deloc componenta), nepublicata_in_fereastra (există, dar nu în intervalul ăsta) sau fara_perioada_completa (componentele există, dar nu simultan în nicio perioadă). Numărul verificat se schimbă cu fereastra, iar aici scrie de ce.
meta.fara_date data e null, iar aici stă motivul. Nu există valori în bază pentru combinaţia cerută. Intervalul e în întregime în afara acoperirii. Se suprapune peste ea, dar n-are nicio valoare în el.
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/investitii-directe
{
    "data": {
        "tip": "tranzactii",
        "frecventa": "lunar",
        "principiu": "direcţional",
        "de_la": "2013-01",
        "pana_la": "2026-07",
        "unitate": "milioane EUR",
        "filtre": [],
        "perioade": [
            {
                "perioada": "2013-01",
                "luna_sursa": "2013-01"
            }
        ],
        "pozitii": [
            {
                "cod": "IDT6L_T",
                "sufix": "T",
                "eticheta": "Investiţii directe",
                "cale": [
                    "Investiţii directe"
                ],
                "nivel": 1,
                "parinte": null,
                "unitate": "milioane EUR",
                "perioade_publicate": 163,
                "valori": {
                    "2013-01": "300.39",
                    "2013-02": "97.60",
                    "2013-03": "659.58",
                    "2013-04": "-344.28",
                    "2013-05": "258.93",
                    "2013-06": "-151.23",
                    "2013-07": "57.99",
                    "2013-08": "322.00",
                    "2013-09": "351.49",
                    "2013-10": "110.43",
                    "2013-11": "215.10",
                    "2013-12": "1045.94",
                    "2014-01": "318.33",
                    "2014-02": "312.73",
                    "2014-03": "58.32",
                    "2014-04": "110.24",
                    "2014-05": "345.12",
                    "2014-06": "161.94",
                    "2014-07": "637.45",
                    "2014-08": "22.08",
                    "2014-09": "201.54",
                    "2014-10": "293.25",
                    "2014-11": "281.13",
                    "2014-12": "-40.08",
                    "2015-01": "383.87",
                    "2015-02": "-152.42",
                    "2015-03": "757.40",
                    "2015-04": "-79.46",
                    "2015-05": "56.82",
                    "2015-06": "647.95",
                    "2015-07": "222.99",
                    "2015-08": "55.39",
                    "2015-09": "546.79",
                    "2015-10": "617.26",
                    "2015-11": "-315.37",
                    "2015-12": "213.28",
                    "2016-01": "60.01",
                    "2016-02": "722.53",
                    "2016-03": "68.29",
                    "2016-04": "343.23",
                    "2016-05": "323.45",
                    "2016-06": "560.29",
                    "2016-07": "712.29",
                    "2016-08": "248.02",
                    "2016-09": "243.47",
                    "2016-10": "177.76",
                    "2016-11": "172.12",
                    "2016-12": "881.81",
                    "2017-01": "285.80",
                    "2017-02": "569.06",
                    "2017-03": "244.47",
                    "2017-04": "134.29",
                    "2017-05": "332.41",
                    "2017-06": "110.80",
                    "2017-07": "647.34",
                    "2017-08": "683.06",
                    "2017-09": "782.94",
                    "2017-10": "434.10",
                    "2017-11": "312.49",
                    "2017-12": "346.13",
                    "2018-01": "305.15",
                    "2018-02": "477.92",
                    "2018-03": "661.52",
                    "2018-04": "108.45",
                    "2018-05": "25.75",
                    "2018-06": "15.03",
                    "2018-07": "646.34",
                    "2018-08": "1021.55",
                    "2018-09": "1022.36",
                    "2018-10": "220.28",
                    "2018-11": "220.25",
                    "2018-12": "220.38",
                    "2019-01": "648.06",
                    "2019-02": "814.41",
                    "2019-03": "-258.65",
                    "2019-04": "784.55",
                    "2019-05": "-130.58",
                    "2019-06": "832.17",
                    "2019-07": "659.56",
                    "2019-08": "931.99",
                    "2019-09": "95.09",
                    "2019-10": "24.88",
                    "2019-11": "40.89",
                    "2019-12": "406.67",
                    "2020-01": "916.22",
                    "2020-02": "-242.13",
                    "2020-03": "-1074.74",
                    "2020-04": "355.99",
                    "2020-05": "800.07",
                    "2020-06": "236.68",
                    "2020-07": "223.53",
                    "2020-08": "256.51",
                    "2020-09": "196.29",
                    "2020-10": "439.74",
                    "2020-11": "254.66",
                    "2020-12": "595.47",
                    "2021-01": "625.81",
                    "2021-02": "432.13",
                    "2021-03": "975.05",
                    "2021-04": "243.23",
                    "2021-05": "92.44",
                    "2021-06": "1166.30",
                    "2021-07": "210.91",
                    "2021-08": "595.21",
                    "2021-09": "1919.88",
                    "2021-10": "1459.36",
                    "2021-11": "200.34",
                    "2021-12": "927.62",
                    "2022-01": "849.42",
                    "2022-02": "1014.65",
                    "2022-03": "970.64",
                    "2022-04": "436.76",
                    "2022-05": "434.73",
                    "2022-06": "659.20",
                    "2022-07": "1528.39",
                    "2022-08": "239.03",
                    "2022-09": "1248.34",
                    "2022-10": "1054.76",
                    "2022-11": "217.94",
                    "2022-12": "701.18",
                    "2023-01": "512.45",
                    "2023-02": "686.55",
                    "2023-03": "750.60",
                    "2023-04": "163.30",
                    "2023-05": "27.42",
                    "2023-06": "314.29",
                    "2023-07": "1109.51",
                    "2023-08": "643.93",
                    "2023-09": "639.04",
                    "2023-10": "718.51",
                    "2023-11": "693.78",
                    "2023-12": "105.95",
                    "2024-01": "961.25",
                    "2024-02": "324.71",
                    "2024-03": "632.08",
                    "2024-04": "-249.92",
                    "2024-05": "-221.70",
                    "2024-06": "290.14",
                    "2024-07": "800.78",
                    "2024-08": "951.35",
                    "2024-09": "711.86",
                    "2024-10": "627.85",
                    "2024-11": "-298.37",
                    "2024-12": "211.39",
                    "2025-01": "365.30",
                    "2025-02": "393.30",
                    "2025-03": "736.16",
                    "2025-04": "547.08",
                    "2025-05": "631.07",
                    "2025-06": "737.39",
                    "2025-07": "1181.85",
                    "2025-08": "633.70",
                    "2025-09": "1142.53",
                    "2025-10": "124.96",
                    "2025-11": "511.87",
                    "2025-12": "541.62",
                    "2026-01": "343.82",
                    "2026-02": "641.44",
                    "2026-03": "203.74",
                    "2026-04": "-284.92",
                    "2026-05": "-213.77",
                    "2026-06": "-180.71",
                    "2026-07": "446.70"
                }
            }
        ],
        "identitati": [
            {
                "identitate": "total = investiţii în străinătate + investiţii în România (fluxul net)",
                "total": "IDT6L_T",
                "componente": [
                    "IDT6L_R",
                    "IDT6L_N"
                ],
                "operatie": "sumă",
                "toleranta": "0.05",
                "perioade_verificate": 163,
                "perioade_inchise": 163,
                "abatere_maxima": "0.01"
            }
        ],
        "identitati_neverificate": []
    },
    "meta": {
        "sursa": "BNR — investiţii directe, principiul direcţional (clasa 1367).",
        "acoperire": {
            "de_la": "2013-01",
            "pana_la": "2026-07"
        },
        "perioade": 163,
        "pozitii_totale": 18,
        "pozitii_returnate": 18,
        "identitati_verificate": 8,
        "identitati_inchise": 8,
        "nota_total": "La tranzacţii totalul e intrarea netă: `total = străinătate + România`, verificat pe toate perioadele, fiindcă `R` (investiţiile rezidenţilor în străinătate) vine cu semn INVERSAT faţă de stocuri şi de balanţa de plăţi — o ieşire de capital e negativă. Ipoteza diferenţei pică în toate.",
        "avertisment_semn": "`R` are aici semn inversat faţă de `tip=stocuri` şi faţă de activele de investiţii directe din /financiar/v1/balanta-plati: o investiţie a rezidenţilor în străinătate apare NEGATIVĂ. `T = R + N` e intrarea netă. Schimbă semnul lui `R` înainte să-l compari cu balanţa de plăţi.",
        "nota_principiu": "Principiul direcţional compensează investiţia inversă, deci cifrele sunt mai mici decât investiţiile directe din poziţia investiţională, care e pe principiul activ/pasiv. Diferenţa e aceeaşi sumă pe ambele laturi în toate trimestrele — 16.442,50 şi 16.442,54 milioane în 2026-T1.",
        "nota_frecvente": "Tranzacţiile trimestriale sunt exact suma celor lunare (toate trimestrele, abatere maximă 0,01) — o agregare verificată, nu date independente. Cele două serii se opresc aliniat: ultima lună e ultima lună a ultimului trimestru.",
        "nota_toleranta": "Toleranţa de ±0.05 e măsurată direct, nu derivată: aici circa nouă valori din zece au zecimale, deci regula de rotunjire folosită la poziţia investiţională nu se aplică. Abaterea maximă observată pe cele opt identităţi × trei clase e 0,01.",
        "nota_null": "`null` într-o perioadă înseamnă că poziţia n-a fost publicată atunci, nu zero."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareinterval_prea_lung peste 180 de perioade, tip sau frecvenţă în afara listei, nivel_max în afara intervalului 1–5. combinatie_inexistenta — stocuri la frecvenţă lunară; răspunsul listează combinaţiile publicate.
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": "interval_prea_lung peste 180 de perioade, tip sau frecvenţă în afara listei, nivel_max în afara intervalului 1–5. combinatie_inexistenta — stocuri la frecvenţă lunară; răspunsul listează combinaţiile publicate.",
        "detalii": {
            "tip": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}