oneapi
Autentificare
Business v1 / Nomenclatoare

Calendar fiscal

Termenele și obligațiile fiscale (opțional ?an=, ?luna=).

GET
https://oneapi.ro/api/business/v1/calendar-fiscal

Parametri de interogare

NumeTipDescriereValori acceptate
anopțional integer | null Anul calendarului; implicit anul curent. ex. 2024
lunaopțional integer | null Luna ca NUMĂR ÎNTREG, 1–12 (nu AAAA-LL), ca să vezi doar termenele ei. 1 – 12
de_laopțional string | null Începutul intervalului, AAAA-LL-ZZ — se aplică pe data, deci termenele-condiţie (fără zi) rămân pe dinafară. ex. 2024-01-01
pana_laopțional string | null Sfârşitul intervalului, AAAA-LL-ZZ — ca să vezi doar termenele până la o dată. ex. 2024-12-31

Cum se comportă

  • Calendarul fiscal: termenele de depunere a declaraţiilor şi de plată a obligaţiilor, ca referinţă pentru interpretarea vectorului fiscal.
  • ⚠️ Nu presupuneţi că anii acoperiţi sunt întregi, nici că sunt la rând. meta.acoperire spune exact ce există, iar meta.goluri ce lipseşte între primul şi ultimul an — cu motivul, acolo unde se poate citi din date. Construiţi lista de ani din ele, nu dintr-un interval presupus.
  • ⚠️ Anul 2025 NU există, şi nu e un import nefăcut: ANAF a suprascris Calendar_obligatii_fiscale_2025.htm cu calendarul pe 2026, deci calendarul pe 2025 nu mai e publicat la adresa lui. Verificat pe 29 sep şi reconfirmat pe 14 oct 2026. Apare în meta.goluri cu motiv: suprascris_la_sursa.
  • ⚠️ Anul în curs e publicat LUNĂ CU LUNĂ de ANAF, nu întreg la început de an, iar lanţul nostru îl reîmprospătează lunar. Un an cu nouă luni în acoperire e starea sursei la ultima aducere, nu un import incomplet.
  • Circa 15% din termene sunt CONDIŢII, nu date („în 30 de zile de la data înfiinţării"): au data_limita în text şi data: null. Filtrele de_la/pana_la lucrează pe data, deci acele rânduri nu intră niciodată într-o fereastră de date.

La ce folosește

  • Construirea unui calendar de termene într-o aplicaţie de contabilitate.
  • Trimiterea de memento-uri clienţilor înainte de scadenţă.
  • Interpretarea vectorului fiscal: ce se depune şi până când.

Structura răspunsului

CâmpTipDescriere
data[].an integer Anul de referinţă.
data[].luna integer Luna de referinţă (număr întreg, 1–12).
data[].data string Termenul ca dată calendaristică (AAAA-LL-ZZ), când se poate stabili. null la termenele exprimate ca CONDIŢIE („30 de zile de la data înfiinţării"), care n-au o zi fixă — circa 15% din rânduri. Pe el se face ordonarea şi filtrarea cu de_la/pana_la.
data[].data_limita string Termenul-limită aşa cum îl scrie ANAF, text liber („luni 26 ianuarie", „în 30 de zile de la…").
data[].obligatie string Obligaţia declarativă sau de plată.
data[].categorii_contribuabili string Cui i se aplică obligaţia.
data[].baza_legala string Temeiul legal.
meta.acoperire[].an integer Un an pentru care avem termene.
meta.acoperire[].luni array Lunile publicate din acel an. ANAF publică anul în curs LUNĂ CU LUNĂ, deci un an parţial e normal, nu o lipsă la noi.
meta.goluri[].an Un an care LIPSEŞTE dintre primul şi ultimul an acoperit.
meta.goluri[].motiv suprascris_la_sursa dacă ANAF a înlocuit fişierul anului respectiv cu altul, ori null dacă motivul nu se poate citi din date.
meta.goluri[].fisier Fişierul sursă numit după anul lipsă.
meta.goluri[].livrat_anul Anul pe care îl conţine de fapt acel fişier.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/calendar-fiscal
{
    "data": [
        {
            "an": 2022,
            "luna": 1,
            "data": "2022-01-07",
            "data_limita": "vineri 7 ianuarie",
            "obligatie": "Depunerea Declarației de mențiuni privind schimbarea perioadei fiscale pentru persoanele impozabile înregistrate în scopuri de TVA care utilizează trimestrul calendaristic ca perioadă fiscală și care efectuează o achiziție intracomunitară taxabilă în România - Formularul 092",
            "categorii_contribuabili": "Contribuabilii înregistrați în scop de TVA care utilizează ca perioadă fiscală trimestrul și care au efectuat o achiziție intracomunitară taxabilă în România, fiind astfel obligați să își modifice perioada fiscală, devenind plătitori de TVA lunar.",
            "baza_legala": "Legea 227/2015 art. 322OPANAF 169/2019"
        }
    ],
    "meta": {
        "acoperire": [
            {
                "an": 2022,
                "luni": [
                    1,
                    2,
                    3,
                    4,
                    5,
                    6,
                    7,
                    8,
                    9,
                    10,
                    11,
                    12
                ]
            }
        ]
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareUn parametru nedeclarat ori o valoare care nu trece validarea (an, luna). Câmpul vinovat e în detalii.
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": "Un parametru nedeclarat ori o valoare care nu trece validarea (an, luna). Câmpul vinovat e în detalii.",
        "detalii": {
            "an": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}