Utile v1 / Sarbatori

Scadență în zile lucrătoare

La ce dată cade un termen de atâtea zile lucrătoare de la o dată — sărind weekendurile şi sărbătorile ţării. Răspunsul spune şi care sărbători au fost sărite.

GET

https://oneapi.ro/api/utile/v1/sarbatori/adauga-zile-lucratoare

Parametri de interogare

NumeTipDescriereValori acceptate

taraobligatoriu string OBLIGATORIU. Codul țării sau al subdiviziunii. max 12 car.

de_laopțional string | null Data de la care se numără. Implicit azi (ora României). ex. 2026-12-20ex. 2026-03-31

zileobligatoriu integer OBLIGATORIU. Câte zile lucrătoare, între −2000 și 2000, fără zero. Negativ merge înapoi în timp. -2000 – 2000

Cum se comportă

Numărătoarea începe de la ZIUA URMĂTOARE. „5 zile lucrătoare de luni" dă luni-ul următor, nu vineri — e convenția uzuală a termenelor procedurale.
Valorile negative merg înapoi, ceea ce e la fel de util: „cu 15 zile lucrătoare înainte de termen" e o întrebare la fel de frecventă ca inversul ei.
Sărbătorile peste care s-a sărit sunt în răspuns, cu numele lor. Fără ele, o scadență care pare cu trei zile prea târziu n-ar putea fi explicată fără să refaci calculul de mână.
Anii se încarcă pe măsură ce numărătoarea trece prin ei. O scadență lungă pornită în decembrie iese în anul următor, iar un calcul care ar folosi doar sărbătorile anului de start ar rata exact zilele libere de la trecerea dintre ani.

La ce folosește

Calculezi termenul de răspuns la o cerere: „30 de zile lucrătoare de la înregistrare".
Afli până când trebuie trimis un document, mergând ÎNAPOI de la termenul limită.
Stabilești data de livrare promisă, sărind peste sărbătorile țării destinatarului.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

CâmpTipDescriere

tara string Ţara la care se referă valoarea.

de_la string Începutul intervalului acoperit de răspuns.

zile_lucratoare integer Câte zile lucrătoare are perioada.

scadenta string Data rezultată, AAAA-LL-ZZ.

zi_saptamana integer Ziua săptămânii a scadenței, ISO 8601.

sarbatori_sarite[] array Sărbătorile peste care s-a trecut, cu dată și nume.

sarbatori_sarite[].data string

sarbatori_sarite[].nume string Numele, aşa cum îl publică sursa.

zile_weekend array Zilele de weekend folosite.

sursa string De unde vin zilele, scris explicit.

verificat boolean true doar dacă sursa e textul legii.

Exemple de răspuns

GEThttps://oneapi.ro/api/utile/v1/sarbatori/adauga-zile-lucratoare?tara=RO&de_la=2026-12-20&zile=10

{
    "data": {
        "tara": "RO",
        "de_la": "2026-12-20",
        "zile_lucratoare": 10,
        "scadenta": "2027-01-05",
        "zi_saptamana": 2,
        "sarbatori_sarite": [
            {
                "data": "2026-12-25",
                "nume": "Crăciunul"
            }
        ],
        "zile_weekend": [
            6,
            7
        ],
        "sursa": "art. 139 din Codul Muncii (Legea 53/2003), prin modulul Financiar",
        "verificat": true
    }
}

GEThttps://oneapi.ro/api/utile/v1/sarbatori/adauga-zile-lucratoare?tara=RO&zile=30

{
    "data": {
        "tara": "RO",
        "de_la": "2026-10-06",
        "zile_lucratoare": 30,
        "scadenta": "2026-11-17",
        "zi_saptamana": 2,
        "sarbatori_sarite": [],
        "zile_weekend": [
            6,
            7
        ],
        "sursa": "art. 139 din Codul Muncii (Legea 53/2003), prin modulul Financiar",
        "verificat": true
    }
}

GEThttps://oneapi.ro/api/utile/v1/sarbatori/adauga-zile-lucratoare?tara=RO&de_la=2026-03-31&zile=-15

{
    "data": {
        "tara": "RO",
        "de_la": "2026-03-31",
        "zile_lucratoare": -15,
        "scadenta": "2026-03-10",
        "zi_saptamana": 2,
        "sarbatori_sarite": [],
        "zile_weekend": [
            6,
            7
        ],
        "sursa": "art. 139 din Codul Muncii (Legea 53/2003), prin modulul Financiar",
        "verificat": true
    }
}

GEThttps://oneapi.ro/api/utile/v1/sarbatori/adauga-zile-lucratoare?tara=DE&zile=30

{
    "data": {
        "tara": "DE",
        "de_la": "2026-10-06",
        "zile_lucratoare": 30,
        "scadenta": "2026-11-17",
        "zi_saptamana": 2,
        "sarbatori_sarite": [],
        "zile_weekend": [
            6,
            7
        ],
        "sursa": "Yasumi (MIT) — calculat algoritmic",
        "verificat": false
    }
}

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.
404	negasit	Țara nu e acoperită.
422	validare	`zile` e 0 sau în afara intervalului −2000…2000.
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": "zile e 0 sau în afara intervalului −2000…2000.",
        "detalii": {
            "tara": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}