oneapi
Autentificare
Financiar v1 / Calendar

Ce e ziua asta

Fişa completă a unei zile: e lucrătoare? e sărbătoare legală? e punte stabilită prin HG? a
publicat BNR curs? e deschis TARGET2? Trei calendare distincte, într-un singur răspuns.

GET
https://oneapi.ro/api/financiar/v1/zi

Parametri de interogare

NumeTipDescriereValori acceptate
dataopțional string | null Opţional: ziua, AAAA-LL-ZZ (anii 1990–2100). Fără ea, azi (ora României). ex. 2026-04-06ex. 2026-12-25ex. 2024-06-15

Cum se comportă

  • Fişa completă a unei zile, într-o singură cerere: e lucrătoare, e sărbătoare legală, e punte stabilită prin hotărâre de Guvern, a publicat BNR curs, e deschis TARGET2.
  • Trei calendare distincte se întâlnesc aici şi nu trebuie confundate. Zilele lucrătoare urmează art. 139 din Codul Muncii, cu Paştele ORTODOX. Zilele bancare sunt un fapt empiric — a publicat sau nu BNR cotaţii. TARGET2 are calendar propriu, cu Paştele GREGORIAN.
  • Divergenţa dintre calendare e reală, nu teoretică: în 2026, TARGET2 e închis pe 6 aprilie, când România lucrează, şi deschis pe 13 aprilie, când România e în sărbătoare.
  • lucratoare urmează regula generală: zi de săptămână care nu e sărbătoare legală. O punte de HG NU o schimbă dacă se aplică doar bugetarilor — şi toate punţile înregistrate până acum sunt de acest fel. Pentru o firmă privată, 2 mai 2025 a fost zi lucrătoare normală. Puntea se raportează separat, cu aplicabil_la, ca fiecare să decidă dacă îl priveşte.
  • zi_bancara_bnr nu e sinonim cu lucratoare: există patru zile lucrătoare în care BNR nu a publicat, fără să fie sărbătoare — 30 iunie şi 1 iulie 2005 (denominarea ROL→RON), 31 decembrie 2007 şi 3 ianuarie 2012. Cine calculează o dată de valută are nevoie de faptul bancar, nu de cel legal.
  • Valoarea null la zi_bancara_bnr înseamnă „nu ştiu" — ziua e în afara acoperirii cotaţiilor (înainte de 2005-01-03 sau după ultima zi publicată). Nu se confundă cu false, care ar afirma că BNR a fost închis.
  • Sărbătorile se calculează, nu se citesc din tabel: Paştele ortodox prin algoritm, restul din reguli versionate pe an. Pentru anii viitori răspunsul e o PROIECŢIE a legislaţiei actuale — lista se poate schimba prin lege.

La ce folosește

  • Verificarea dacă o scadenţă cade într-o zi lucrătoare.
  • Stabilirea datei de valută a unei plăţi.
  • Verificarea disponibilităţii decontării în euro.

Structura răspunsului

CâmpTipDescriere
data.data string Ziua cerută, exact cum ai trimis-o.
data.zi_saptamana string Ziua săptămânii, cu 1 = luni.
data.zi_saptamana_iso integer
data.lucratoare boolean Zi de săptămână care nu e sărbătoare legală. Punţile pentru bugetari nu o schimbă.
data.sarbatori[] string[] Sărbătorile legale ale zilei, fiecare cu un cod stabil şi mobila: true la cele legate de Paşti. Tablou GOL dacă ziua nu e sărbătoare, şi cu DOUĂ intrări când două sărbători cad în aceeaşi zi (2026-06-01 = Ziua Copilului + a doua zi de Rusalii).
data.zi_libera_hg object | null Puntea stabilită prin hotărâre de Guvern: actul normativ, cui se aplică (bugetari sau toti) şi dacă se recuperează.
data.target2_deschis boolean | null Dacă sistemul european de decontare în euro funcţionează în ziua respectivă.
data.zi_bancara_bnr boolean | null true/false dacă BNR a publicat sau nu cotaţii; null în afara acoperirii.
data.urmatoarea_zi_lucratoare string Prima zi lucrătoare strict după ziua cerută.
meta.temei string Temeiul legal al valorilor sau al modului de calcul.
meta.nota string Precizare despre cum se citesc datele din răspuns — o capcană, o convenţie sau o limită a sursei.
meta.calendare.lucratoare string
meta.calendare.zi_bancara_bnr string
meta.calendare.target2_deschis string Dacă sistemul european de decontare în euro funcţionează în ziua respectivă.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/zi
{
    "data": {
        "data": "2026-10-07",
        "zi_saptamana": "miercuri",
        "zi_saptamana_iso": 3,
        "lucratoare": true,
        "sarbatori": [],
        "zi_libera_hg": null,
        "target2_deschis": true,
        "zi_bancara_bnr": null,
        "urmatoarea_zi_lucratoare": "2026-10-08"
    },
    "meta": {
        "temei": "art. 139 Codul Muncii (sărbători legale); Paştele ortodox calculat, nu tabelat.",
        "nota": "Pentru anii viitori răspunsul e o proiecţie a legislaţiei actuale: lista sărbătorilor se poate schimba prin lege.",
        "calendare": {
            "lucratoare": "Zi de săptămână care nu e sărbătoare legală. Punţile de HG pentru bugetari NU o schimbă.",
            "zi_bancara_bnr": "Fapt empiric: a publicat BNR cotaţii. `null` în afara acoperirii.",
            "target2_deschis": "Calendar propriu, cu Paştele GREGORIAN — diferit de cel românesc."
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareDată scrisă altfel decât AAAA-LL-ZZ ori în afara anilor 1990–2100.
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": "Dată scrisă altfel decât AAAA-LL-ZZ ori în afara anilor 1990–2100.",
        "detalii": {
            "data": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}