Financiar v1 / CursVamal

Seria lunară a cursului vamal

Cursul vamal al uneia până la cinci valute, pe un interval de luni, grupat pe valută.

GET

https://oneapi.ro/api/financiar/v1/curs-vamal/interval

Parametri de interogare

NumeTipDescriereValori acceptate

de_laobligatoriu string Obligatoriu, YYYY-MM. ex. 2024-01ex. 2024-06-15

pana_laopțional string | null Opţional, implicit ultima lună publicată. ex. 2024-12ex. 2024-06-30

valutalistăopțional text Obligatoriu, 1–5: ?valuta=EUR,USD. ex. EUR,USDex. EUR

Cum se comportă

Cursul vamal al uneia până la cinci valute, pe un interval de luni, grupat pe valută.
Intervalul se dă în LUNI (YYYY-MM), nu în zile: cursul vamal e lunar, iar a cere zile ar sugera o precizie pe care datele nu o au.
Plafonul e de 120 de luni — zece ani, adică toată acoperirea disponibilă.
meta.fara_valori listează valutele cerute fără nicio lună în interval, ca un răspuns parţial să nu treacă neobservat.

La ce folosește

Recalcularea unui an de importuri, lună cu lună, într-un singur apel.
Un grafic al cursului vamal pentru valutele cu care lucrezi.
Reconcilierea evidenţei contabile cu cursurile oficiale ale perioadei.

Structura răspunsului

CâmpTipDescriere

data.de_la string Începutul intervalului acoperit de răspuns.

data.pana_la string Sfârşitul intervalului acoperit de răspuns, inclusiv.

data.moneda_baza string Moneda faţă de care sunt exprimate cotaţiile.

data.serii[].valuta string Codul ISO 4217 al valutei.

data.serii[].multiplicator integer Cu cât se înmulţeşte valoarea ca să ajungă în unitatea de bază.

data.serii[].valori[].luna string Luna la care se referă valoarea.

data.serii[].valori[].valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.

data.serii[].valori[].valoare_unitara string Valoarea raportată la o singură unitate.

data.serii[].valori[].cotatie_din string

meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.

meta.valute integer Valutele acoperite de răspuns.

meta.valori integer Valorile seriei, pe perioade.

meta.luni_interval integer

meta.baza_legala string

meta.fara_date data e null, iar aici stă motivul. Cotaţia există la sursă, dar importul nostru e în urmă; răspunsul spune până când avem date.

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/curs-vamal/interval?de_la=2024-01&pana_la=2024-12&valuta=EUR,USD

{
    "data": {
        "de_la": "2024-01",
        "pana_la": "2024-12",
        "moneda_baza": "RON",
        "serii": [
            {
                "valuta": "EUR",
                "multiplicator": 1,
                "valori": [
                    {
                        "luna": "2024-01",
                        "valoare": "4.9702",
                        "valoare_unitara": "4.9702",
                        "cotatie_din": "2023-12-20"
                    }
                ]
            }
        ]
    },
    "meta": {
        "sursa": "derivat din cursul de referinţă BNR.",
        "valute": 2,
        "valori": 24,
        "luni_interval": 12,
        "baza_legala": "art. 146 din Regulamentul de punere în aplicare (UE) 2015/2447."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/curs-vamal/interval?de_la=2024-06-15&valuta=EUR

{
    "data": {
        "de_la": "2024-06",
        "pana_la": "2026-09",
        "moneda_baza": "RON",
        "serii": [
            {
                "valuta": "EUR",
                "multiplicator": 1,
                "valori": [
                    {
                        "luna": "2024-06",
                        "valoare": "4.9745",
                        "valoare_unitara": "4.9745",
                        "cotatie_din": "2024-05-22"
                    }
                ]
            }
        ]
    },
    "meta": {
        "sursa": "derivat din cursul de referinţă BNR.",
        "valute": 1,
        "valori": 28,
        "luni_interval": 28,
        "baza_legala": "art. 146 din Regulamentul de punere în aplicare (UE) 2015/2447."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/curs-vamal/interval?de_la=2024-06-15&valuta=EUR&pana_la=2024-06-30

{
    "data": {
        "de_la": "2024-06",
        "pana_la": "2024-06",
        "moneda_baza": "RON",
        "serii": [
            {
                "valuta": "EUR",
                "multiplicator": 1,
                "valori": [
                    {
                        "luna": "2024-06",
                        "valoare": "4.9745",
                        "valoare_unitara": "4.9745",
                        "cotatie_din": "2024-05-22"
                    }
                ]
            }
        ]
    },
    "meta": {
        "sursa": "derivat din cursul de referinţă BNR.",
        "valute": 1,
        "valori": 1,
        "luni_interval": 1,
        "baza_legala": "art. 146 din Regulamentul de punere în aplicare (UE) 2015/2447."
    }
}

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	`interval_prea_lung` (peste 120 de luni), `interval_gol`, valută sau lună malformată.
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": "interval_prea_lung (peste 120 de luni), interval_gol, valută sau lună malformată.",
        "detalii": {
            "de_la": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}