Financiar v1 / Calendar

Punţile stabilite prin HG

Zilele libere stabilite prin hotărâre de Guvern pentru un an — de regulă punţi lipite de o
sărbătoare legală. Se aplică, în general, doar personalului din sectorul public: aplicabil_la
spune cui, iar se_recupereaza dacă ziua trebuie recuperată prin program prelungit.

Sărbătorile legale, care se aplică tuturor, sunt pe /sarbatori?an=.

GET

https://oneapi.ro/api/financiar/v1/punti

Parametri de interogare

NumeTipDescriereValori acceptate

anopțional integer | null Opţional: anul, AAAA (1990–2100). Fără el, anul curent. 1990 – 2100

Cum se comportă

Zilele libere stabilite prin hotărâre de Guvern pentru un an — de regulă punţi lipite de o sărbătoare legală, ca vinerea de după 1 Mai.
Rută separată de /sarbatori?an= fiindcă e alt instrument legal, cu altă sferă de aplicare: sărbătorile vin din art. 139 Codul Muncii şi se aplică tuturor, punţile vin din hotărâri de Guvern şi, în general, doar personalului din sectorul public.
aplicabil_la spune cui se aplică. O punte cu aplicabil_la: "bugetari" NU e zi liberă într-o firmă privată — toate punţile înregistrate până acum sunt de acest fel.
se_recupereaza arată dacă ziua trebuie recuperată prin program prelungit, ceea ce hotărârile prevăd de obicei.
O listă goală pentru un an viitor e de aşteptat; pentru anul curent înseamnă doar că n-am înregistrat încă nicio hotărâre — o HG poate stabili punţi şi pe parcursul anului. Unde actul normativ nu e identificat, act_normativ e null şi nota o spune.

La ce folosește

Planificarea programului de lucru într-o instituţie publică.
Verificarea dacă o zi liberă anunţată public are temei normativ.

Structura răspunsului

CâmpTipDescriere

data.an integer Anul la care se referă datele.

data.punti[] object[]

meta.punti integer

meta.temei string Temeiul legal al valorilor sau al modului de calcul.

meta.nota string Până pe 15 sep nota spunea „pentru anii viitori lista e normal să fie goală" şi la anul
CURENT, unde nu explică nimic. Acum formularea urmează poziţia anului faţă de azi.

data.punti[].act_normativ string Hotărârea de Guvern care a stabilit ziua. null unde actul nu e încă identificat.

data.punti[].aplicabil_la string bugetari sau toti.

data.punti[].se_recupereaza boolean Dacă ziua se recuperează prin program prelungit.

data.punti[].nota null Observaţii, inclusiv marcaje de verificare încă deschise.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/punti

{
    "data": {
        "an": 2026,
        "punti": []
    },
    "meta": {
        "punti": 0,
        "temei": "hotărâri de Guvern; instrument distinct de sărbătorile legale din art. 139 Codul Muncii.",
        "nota": "Niciun act normativ înregistrat pentru anul 2026 până acum. O hotărâre de Guvern poate stabili punţi şi pe parcursul anului; lista goală nu garantează că nu vor apărea."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/punti?an=2024

{
    "data": {
        "an": 2024,
        "punti": [
            {
                "data": "2024-05-02",
                "denumire": "Punte după Ziua Muncii",
                "act_normativ": "HG 1307/2023",
                "aplicabil_la": "bugetari",
                "se_recupereaza": true,
                "nota": null
            }
        ]
    },
    "meta": {
        "punti": 3,
        "temei": "hotărâri de Guvern; instrument distinct de sărbătorile legale din art. 139 Codul Muncii.",
        "nota": "O punte cu `aplicabil_la: \"bugetari\"` NU e zi liberă într-o firmă privată."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/punti?an=2023

{
    "data": {
        "an": 2023,
        "punti": [
            {
                "data": "2023-06-02",
                "denumire": "Punte după Ziua Copilului",
                "act_normativ": null,
                "aplicabil_la": "bugetari",
                "se_recupereaza": true,
                "nota": "Actul normativ nu e încă identificat în baza noastră; ziua e dedusă din calendar: 1 iunie 2023 a fost joi, deci vineri 2 iunie a fost puntea."
            }
        ]
    },
    "meta": {
        "punti": 2,
        "temei": "hotărâri de Guvern; instrument distinct de sărbătorile legale din art. 139 Codul Muncii.",
        "nota": "O punte cu `aplicabil_la: \"bugetari\"` NU e zi liberă într-o firmă privată."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/punti?an=2020

{
    "data": {
        "an": 2020,
        "punti": []
    },
    "meta": {
        "punti": 0,
        "temei": "hotărâri de Guvern; instrument distinct de sărbătorile legale din art. 139 Codul Muncii.",
        "nota": "Niciun act normativ înregistrat în baza noastră pentru anul 2020."
    }
}

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	An în afara intervalului 1990–2100.
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": "An în afara intervalului 1990–2100.",
        "detalii": {
            "an": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}