Financiar v1 / Calcul

Conversia peste denominarea din 2005

Transformă o sumă între lei vechi (ROL) şi lei noi (RON), la raportul fix de 10.000:1 stabilit prin
Legea 348/2004.

Dacă se dă şi o dată, răspunsul spune ce monedă era de referinţă atunci şi semnalează nepotrivirea:
o sumă declarată în RON pentru o dată din 1998 e aproape sigur o eroare de interpretare.

GET

https://oneapi.ro/api/financiar/v1/calcul/denominare

Parametri de interogare

NumeTipDescriereValori acceptate

sumaobligatoriu string Obligatoriu. Poate fi negativă şi poate avea până la 4 zecimale. ex. 1000ex. 2500.75

dinobligatoriu string Obligatoriu: ROL sau RON. Minusculele se acceptă. ROLRONrolron

dataopțional string | null Opţional. Activează verificarea coerenţei între moneda declarată şi data indicată. ex. 2024-06-15

Cum se comportă

Transformă o sumă între lei vechi (ROL) şi lei noi (RON), la raportul fix de 10.000:1 stabilit prin Legea 348/2004, în vigoare de la 1 iulie 2005.
Dacă se dă şi o dată, răspunsul spune ce monedă era de referinţă atunci şi semnalează nepotrivirea: o sumă declarată în RON pentru o dată din 1998 e aproape sigur o eroare de interpretare, iar rezultatul ar greşi cu patru ordine de mărime.
Fereastra 1 ianuarie – 1 iulie 2005 e ambiguă şi nu o presupunem. BNR îşi exprimă arhiva de curs în lei noi încă de la 1 ianuarie 2005, deşi denominarea legală a fost la 1 iulie. Pentru date din acea fereastră, moneda_de_referinta_la_data e null, cu explicaţia: unitatea depinde de sursa cifrei, nu de calendar.
Leii vechi au rămas mijloc legal de plată până la 31 decembrie 2006, în circulaţie paralelă cu cei noi.
Ruta e utilă în special împreună cu indexarea: o sumă din anii 1990 indexată la valoarea de azi rămâne exprimată în lei vechi, iar aici se aduce în lei noi.

La ce folosește

Aducerea unei sume din acte vechi în lei noi.
Verificarea în ce monedă e exprimată o cifră dintr-un document.

Structura răspunsului

CâmpTipDescriere

data[] object[]

meta[] string[] Plicul răspunsului: sursa, prospeţimea şi precizările care însoţesc datele.

data.suma_convertita string Rezultatul. La conversia în lei noi e rotunjit la bani; la conversia în lei vechi rămâne exact.

data.suma_convertita_exacta string Rezultatul nerotunjit.

data.moneda_de_referinta_la_data string ROL, RON, sau absent pentru fereastra ambiguă din prima jumătate a lui 2005.

data.declaratie_coerenta boolean false când moneda declarată nu se potriveşte cu data. Absent când nu se poate stabili.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/calcul/denominare?suma=1000&din=ROL

{
    "data": {
        "suma": "1000",
        "din": "ROL",
        "in": "RON",
        "raport": "1 RON = 10,000 ROL",
        "suma_convertita": "0.10",
        "suma_convertita_exacta": "0.1"
    },
    "meta": {
        "temei": "Legea 348/2004 privind denominarea monedei naţionale: 1 leu nou (RON) = 10.000 lei vechi (ROL), de la 1 iulie 2005.",
        "circulatie_paralela": "Leii vechi au rămas mijloc legal de plată până la 31 decembrie 2006."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/calcul/denominare?suma=2500.75&din=ROL

{
    "data": {
        "suma": "2500.75",
        "din": "ROL",
        "in": "RON",
        "raport": "1 RON = 10,000 ROL",
        "suma_convertita": "0.25",
        "suma_convertita_exacta": "0.250075"
    },
    "meta": {
        "temei": "Legea 348/2004 privind denominarea monedei naţionale: 1 leu nou (RON) = 10.000 lei vechi (ROL), de la 1 iulie 2005.",
        "circulatie_paralela": "Leii vechi au rămas mijloc legal de plată până la 31 decembrie 2006."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/calcul/denominare?suma=1000&din=ROL&data=2024-06-15

{
    "data": {
        "suma": "1000",
        "din": "ROL",
        "in": "RON",
        "raport": "1 RON = 10,000 ROL",
        "suma_convertita": "0.10",
        "suma_convertita_exacta": "0.1",
        "data": "2024-06-15",
        "moneda_de_referinta_la_data": "RON",
        "declaratie_coerenta": false
    },
    "meta": {
        "temei": "Legea 348/2004 privind denominarea monedei naţionale: 1 leu nou (RON) = 10.000 lei vechi (ROL), de la 1 iulie 2005.",
        "circulatie_paralela": "Leii vechi au rămas mijloc legal de plată până la 31 decembrie 2006.",
        "atentie_declaratie": "La data 2024-06-15, moneda de referinţă era RON, nu ROL. Verifică în ce unitate e scrisă suma înainte s-o converteşti — altfel rezultatul greşeşte cu patru ordine de mărime."
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
422	validare	Sumă malformată, `din` lipsă sau altul decât ROL/RON, dată malformată ori în viitor.
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": "Sumă malformată, din lipsă sau altul decât ROL/RON, dată malformată ori în viitor.",
        "detalii": {
            "suma": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}