Financiar v1 / Calendar

Calendarul de decontare TARGET2

Zilele în care sistemul european de decontare în euro e închis, pentru un an, plus numărul de
zile de decontare. Calendar propriu, cu Paştele GREGORIAN — nu se suprapune cu cel românesc.

Pentru zilele în care cele două calendare se contrazic, vezi /target2/divergente?an=.

GET

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

Parametri de interogare

NumeTipDescriereValori acceptate

anopțional integer | null Opţional: anul, AAAA (1999–2100 — TARGET a pornit în 1999). Fără el, anul curent. 1990 – 2100

Cum se comportă

Zilele în care TARGET2, sistemul de decontare în euro al Eurosistemului, e închis — plus numărul de zile de decontare din an.
Din 2000 încoace (cu excepţia lui 2001) zilele de închidere sunt şase: Anul Nou, Vinerea Mare, a doua zi de Paşti, 1 Mai, Crăciunul şi a doua zi de Crăciun. Paştele e GREGORIAN, nu ortodox, deci calendarul NU se suprapune cu cel românesc.
Numărul de zile de decontare variază totuşi de la an la an, chiar la acelaşi număr de închideri: o închidere care cade sâmbătă sau duminică nu scade nimic, fiind deja weekend. În 2026 doar una din şase cade în weekend (256 de zile de decontare), în 2027 trei (258).
meta.verificare scrie identitatea aritmetică, ca rezultatul să poată fi confirmat dintr-o privire.
Pentru zilele în care cele două calendare se contrazic — cazul care produce plăţi nedecontate — vezi /target2/divergente?an=.

La ce folosește

Verificarea dacă o plată în euro se poate deconta la o dată anume.
Stabilirea datei de valută a unui transfer în euro.
Numărarea zilelor de decontare dintr-un an.

Structura răspunsului

CâmpTipDescriere

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

data.zile_inchise[].data string

data.zile_inchise[].zi_saptamana string Ziua săptămânii, cu 1 = luni.

data.zile_inchise[].denumire string Sărbătoarea care produce închiderea, în calendarul gregorian.

data.zile_inchise[].in_weekend boolean true dacă închiderea cade sâmbătă sau duminică — caz în care nu scade nicio zi de decontare.

meta.zile_inchise integer

meta.inchise_in_zile_de_lucru integer Câte închideri cad luni–vineri, adică reduc efectiv numărul.

meta.zile_de_decontare integer Câte zile din an se poate deconta efectiv în euro.

meta.verificare string Ce verificare s-a rulat pe valorile din răspuns.

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.

Exemple de răspuns

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

{
    "data": {
        "an": 2026,
        "zile_inchise": [
            {
                "data": "2026-01-01",
                "zi_saptamana": "joi",
                "denumire": "Anul Nou",
                "in_weekend": false
            }
        ]
    },
    "meta": {
        "zile_inchise": 6,
        "inchise_in_zile_de_lucru": 5,
        "zile_de_decontare": 256,
        "verificare": "365 − 104 − 5 = 256",
        "temei": "calendarul TARGET2 al Eurosistemului; Paştele GREGORIAN, nu ortodox.",
        "nota": "O închidere care cade în weekend nu scade nicio zi de decontare — de aceea numărul de zile de decontare variază de la an la an chiar la acelaşi număr de închideri. În 2026 sunt 6 zile de închidere, ca în calendarul obişnuit (din 2000, cu excepţia lui 2001)."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/target2?an=2027

{
    "data": {
        "an": 2027,
        "zile_inchise": [
            {
                "data": "2027-01-01",
                "zi_saptamana": "vineri",
                "denumire": "Anul Nou",
                "in_weekend": false
            }
        ]
    },
    "meta": {
        "zile_inchise": 6,
        "inchise_in_zile_de_lucru": 3,
        "zile_de_decontare": 258,
        "verificare": "365 − 104 − 3 = 258",
        "temei": "calendarul TARGET2 al Eurosistemului; Paştele GREGORIAN, nu ortodox.",
        "nota": "O închidere care cade în weekend nu scade nicio zi de decontare — de aceea numărul de zile de decontare variază de la an la an chiar la acelaşi număr de închideri. În 2027 sunt 6 zile de închidere, ca în calendarul obişnuit (din 2000, cu excepţia lui 2001)."
    }
}

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

{
    "data": {
        "an": 2024,
        "zile_inchise": [
            {
                "data": "2024-01-01",
                "zi_saptamana": "luni",
                "denumire": "Anul Nou",
                "in_weekend": false
            }
        ]
    },
    "meta": {
        "zile_inchise": 6,
        "inchise_in_zile_de_lucru": 6,
        "zile_de_decontare": 256,
        "verificare": "366 − 104 − 6 = 256",
        "temei": "calendarul TARGET2 al Eurosistemului; Paştele GREGORIAN, nu ortodox.",
        "nota": "O închidere care cade în weekend nu scade nicio zi de decontare — de aceea numărul de zile de decontare variază de la an la an chiar la acelaşi număr de închideri. În 2024 sunt 6 zile de închidere, ca în calendarul obişnuit (din 2000, cu excepţia lui 2001)."
    }
}

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, ori `an_inainte_de_target2` pentru un an dinainte de 1999, când TARGET nu exista.
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, ori an_inainte_de_target2 pentru un an dinainte de 1999, când TARGET nu exista.",
        "detalii": {
            "an": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}