oneapi
Autentificare
Financiar v1 / Calcul

Reevaluarea unui sold în valută

Reevaluează un sold în valută la cursul de închidere al unei perioade de raportare.

Altceva decât /calcul/diferente-curs, deşi aritmetica pare aceeaşi. Acolo dai două date şi
rezultă o diferenţă de DECONTARE — factura emisă în ianuarie, încasată în august. Aici dai o
PERIOADĂ, iar cursul nu-l alegi tu: îl alege regula, cel de la închiderea perioadei. Un sold
reevaluat la cursul unei zile oarecare e o reevaluare la cursul greşit, iar cifra arată la fel de
bine.

Perioada, într-un singur parametru cu trei forme: 2026-07 (lună), 2026-T2 (trimestru),
2026 (an). Sunt neambigue după înfăţişare, iar a doua e chiar eticheta publicată de BNR.

Punctul de plecare se dă fie ca valoare_lei — cifra din evidenţă — fie ca de_la_perioada,
perioada la a cărei închidere soldul a fost reevaluat ultima dată. A doua e ciclul lunar real şi
ia cursul din datele noastre.

Răspunsul spune şi din ce zi bancară vine cursul de închidere: e ce se trece în nota la bilanţ.

Se reevaluează doar elementele MONETARE — creanţe, datorii, disponibil. Un avans nereturnabil
sau un stoc plătit în valută nu se reevaluează. Din parametri nu se poate şti ce e soldul, deci
ruta nu verifică nimic: limita e declarată, nu presupusă.

GET
https://oneapi.ro/api/financiar/v1/calcul/reevaluare

Parametri de interogare

NumeTipDescriereValori acceptate
sumaobligatoriu string Obligatoriu. Soldul în valută. ex. 10000ex. 5000ex. 20000
valutaobligatoriu string Obligatoriu. Cod de 3 litere. max 3 car.
pozitieobligatoriu string Obligatoriu: creanta sau datorie. Nu are implicit. creantadatorie
perioadaobligatoriu string Obligatoriu: 2026-07, 2026-T2 sau 2026. ex. 2024-06ex. 2024-03ex. 2024-09
valoare_leiopțional string | null Valoarea la care soldul e înregistrat. Exclude de_la_perioada. ex. 49500ex. 23000ex. 118000
de_la_perioadaopțional string | null Perioada la a cărei închidere a fost reevaluat ultima dată. Exclude valoare_lei. ex. 2023-T4

Cum se comportă

  • Reevaluează un sold în valută la cursul de ÎNCHIDERE al unei perioade de raportare.
  • Altceva decât /calcul/diferente-curs, deşi aritmetica pare aceeaşi. Acolo dai două date şi rezultă o diferenţă de DECONTARE — factura emisă în ianuarie, încasată în august. Aici dai o PERIOADĂ, iar cursul nu-l alegi tu: îl alege regula, cel de la închiderea perioadei. Un sold reevaluat la cursul unei zile oarecare e o reevaluare la cursul greşit, iar cifra arată la fel de bine.
  • Perioada, într-un singur parametru cu trei forme: 2026-07 (lună), 2026-T2 (trimestru), 2026 (an). Sunt neambigue după înfăţişare, iar a doua e chiar eticheta publicată de BNR.
  • Punctul de plecare, în două moduri care se exclud. valoare_lei e cifra din evidenţă. de_la_perioada ia cursul de la închiderea perioadei în care soldul a fost reevaluat ultima dată — ciclul lunar real, cu cifra luată din datele noastre. Când dai valoare_lei, răspunsul întoarce şi curs_implicit, ca să vezi la ce curs e înregistrat soldul.
  • Semnul vine din pozitie, obligatorie şi fără implicit: la o datorie, creşterea valorii în lei e cheltuială, nu venit. Aceeaşi mişcare de curs e câştig la creanţă şi pierdere la datorie.
  • Răspunsul spune din ce ZI bancară vine cursul de închidere — informaţie pe care seria oficială BNR nu o conţine, dar care se trece în nota la bilanţ şi se verifică la audit.
  • Perioada în curs nu are curs de închidere şi întoarce 404: „închiderea" unei perioade neîncheiate e pur şi simplu cursul cel mai recent. Pentru un sold la zi se foloseşte /calcul/diferente-curs cu data de azi.
  • Se reevaluează doar elementele MONETARE — creanţe, datorii, disponibil. Un avans nereturnabil sau un stoc plătit în valută nu se reevaluează. Din parametri nu se poate şti ce e soldul, deci ruta nu verifică nimic: limita e declarată, nu presupusă.
  • cont_orientativ (765 favorabile, 665 nefavorabile) e ORIENTATIV: încadrarea ţine de politica contabilă, nu de datele noastre.

La ce folosește

  • Reevaluarea creanţelor şi datoriilor în valută la închiderea lunii.
  • Reevaluarea disponibilului în valută la sfârşit de an.
  • Verificarea unei reevaluări făcute la cursul greşit.

Structura răspunsului

CâmpTipDescriere
data.suma string Suma valorilor, în unitatea indicată alături.
data.valuta string Codul ISO 4217 al valutei.
data.denumire string Denumirea, aşa cum o publică sursa.
data.pozitie string Poziţia elementului în ordinea răspunsului.
data.perioada.eticheta string Eticheta afişabilă a valorii — versiunea citibilă a codului de alături.
data.perioada.de_la string Începutul intervalului acoperit.
data.perioada.pana_la string Sfârşitul intervalului acoperit, inclusiv.
data.inregistrat.fel string valoare_data sau din_inchiderea_anterioara.
data.inregistrat.valoare_lei string
data.inregistrat.curs_implicit string Cursul la care e înregistrat soldul, dedus din valoarea dată. Doar în primul mod.
data.reevaluat.curs_inchidere string Cursul de închidere al perioadei, RON pentru o unitate.
data.reevaluat.provine_din_ziua string Ziua bancară din care vine cursul. Se trece în nota la bilanţ.
data.reevaluat.valoare_lei string
data.diferenta.valoare string Diferenţa contabilă, cu semnul dat de poziţie.
data.diferenta.valoare_exacta string
data.diferenta.fel string favorabila, nefavorabila sau neutra.
data.diferenta.variatie_valoare_lei string Variaţia brută a valorii în lei, fără semnul poziţiei.
data.diferenta.cont_orientativ string 765 sau 665. Orientativ — vezi nota.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.nota_curs string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_pozitie string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_cont string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_monetare string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_provenienta string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.fara_date data e null, iar aici stă motivul. Perioada încă se scrie, valuta n-are închidere în perioada cerută, ori perioada e înainte de 2005. Câmpul la spune care perioadă a produs golul.
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/calcul/reevaluare?suma=10000&valuta=EUR&pozitie=creanta&perioada=2024-06&valoare_lei=49500
{
    "data": {
        "suma": "10000",
        "valuta": "EUR",
        "denumire": "Euro",
        "pozitie": "creanta",
        "perioada": {
            "eticheta": "2024-06",
            "de_la": "2024-06-01",
            "pana_la": "2024-06-30"
        },
        "inregistrat": {
            "fel": "valoare_data",
            "valoare_lei": "49500.00",
            "curs_implicit": "4.95"
        },
        "reevaluat": {
            "curs_inchidere": "4.9771",
            "provine_din_ziua": "2024-06-28",
            "valoare_lei": "49771.00"
        },
        "diferenta": {
            "valoare": "271.00",
            "valoare_exacta": "271",
            "fel": "favorabila",
            "variatie_valoare_lei": "271.00",
            "cont_orientativ": "765"
        }
    },
    "meta": {
        "sursa": "BNR — cursul de schimb al pieţei valutare, serii de sfârşit de perioadă.",
        "nota_curs": "Cursul e cel de la ÎNCHIDEREA perioadei, ales de regulă, nu de client. Pentru o diferenţă între două date alese de tine: /financiar/v1/calcul/diferente-curs.",
        "nota_pozitie": "Semnul vine din `pozitie`: la datorie, creşterea valorii în lei e cheltuială, nu venit.",
        "nota_cont": "Contul 765 e ORIENTATIV (plan general OMFP 1802/2014). Încadrarea ţine de politica contabilă, nu de datele noastre.",
        "nota_monetare": "Se reevaluează doar elementele monetare — creanţe, datorii, disponibil. Ruta nu poate şti ce e soldul, deci nu verifică: limita e declarată.",
        "nota_provenienta": "Ziua bancară din `reevaluat.provine_din_ziua` e informaţia care se trece în nota la bilanţ; seria oficială nu o conţine."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422perioade_inversatePerioada de plecare nu e anterioară celei de raportare; pozitie lipsă; punct de plecare lipsă sau dublu; parametri malformaţi.
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": "perioade_inversate",
        "mesaj": "Perioada de plecare nu e anterioară celei de raportare; pozitie lipsă; punct de plecare lipsă sau dublu; parametri malformaţi.",
        "detalii": {
            "suma": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}