oneapi
Autentificare
Financiar v1 / Fiscal

Cotele fiscale în vigoare

Cotele de contribuţii şi impozite valabile la o dată — CAS, CASS, impozit pe venit, impozit pe
profit, CAM şi TVA — fiecare cu articolul din Codul Fiscal şi cu perioada ei.

⚠️ de_verificat nu e decor. Marchează valorile care n-au fost confirmate pe textul actului
normativ; azi sunt cele din pachetul fiscal 2025 şi cel din 2026. Un răspuns care le conţine o
spune explicit, ca nimeni să nu ia drept confirmat legal ceva ce nu e.

⚠️ Fără extrapolare. O dată în afara perioadei acoperite primeşte eroare cu acoperirea în
mesaj, nu ultima valoare cunoscută — care ar fi plauzibilă şi greşită.

GET
https://oneapi.ro/api/financiar/v1/fiscal/cote

Parametri de interogare

NumeTipDescriereValori acceptate
la_dataopțional string | null Opţional, AAAA-LL-ZZ; implicit ziua curentă. ex. 2024-06-15ex. 2024-06-14
tipopțional string | null Opţional: cota_cas, cota_cass, cota_impozit_venit, cota_impozit_profit, cota_cam, cota_tva_standard. cota_cascota_casscota_impozit_venitcota_impozit_profitcota_camcota_tva_standard

Cum se comportă

  • Cotele de contribuţii şi impozite valabile la o dată — CAS, CASS, impozitul pe venit, impozitul pe profit, CAM şi TVA — fiecare cu articolul din Codul Fiscal care o stabileşte şi cu perioada ei de aplicare.
  • ⚠️ de_verificat nu e decor. Marchează valorile care nu au fost confirmate pe textul actului normativ. Azi sunt patru în tot registrul, toate din pachetele fiscale 2025 şi 2026. Un răspuns care conţine măcar una o spune explicit în meta, ca nimeni să nu ia drept confirmat legal ceva ce nu e.
  • ⚠️ Fără extrapolare. O dată în afara perioadei acoperite primeşte eroare, cu acoperirea în mesaj — niciodată „ultima valoare cunoscută". Aici o valoare plauzibilă şi greşită înseamnă salariu calculat greşit.
  • Cotele vin din registrul comun business_indicatori_fiscali, citit cross-modul. Nu există o a doua copie în Financiar: două tabele cu cota CAS ar diverge tăcut, iar răspunsul ar depinde de ruta nimerită.

La ce folosește

  • Cota exactă aplicabilă la data unui document, cu temeiul ei, pentru un calcul de salarii.
  • Verificarea a ce cotă era în vigoare la o dată din trecut, într-un litigiu sau o reconciliere.
  • Alimentarea unui calculator propriu, fără să ţii tu evidenţa modificărilor legislative.

Structura răspunsului

CâmpTipDescriere
data.la_data string Data la care sunt valabile valorile întoarse.
data.valori[].indicator string Indicatorul statistic la care se referă valoarea.
data.valori[].valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.
data.valori[].unitate string Unitatea de măsură a valorilor. Citeşte-o înainte de a le pune pe un grafic sau de a le aduna.
data.valori[].de_la string Începutul intervalului acoperit.
data.valori[].pana_la null null înseamnă în vigoare, fără termen.
data.valori[].act_normativ string Temeiul legal al valorii — articolul din Codul Fiscal ori actul care a modificat-o.
data.valori[].de_verificat boolean true când valoarea nu a fost confirmată pe textul actului. Nu o trata ca fiind confirmată legal.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.de_verificat array Ce valori folosite nu sunt confirmate legal. Gol înseamnă că toate sunt.
meta.nota_acoperire string De ce totalul e o limită de jos, în proză. meta.total_e_limita_de_jos e cuvântul pe care comuţi în cod.
meta.fara_date data e null, iar aici stă motivul. Cotaţia există la sursă, dar importul nostru e în urmă; răspunsul spune până când avem date. Data cerută e în afara perioadei acoperite; răspunsul dă acoperirea.
meta.fara_date_cod Cuvântul scurt şi STABIL al motivului, pentru clienţii care comută pe el în cod: fara_date e proză şi se poate reformula, ăsta nu.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/fiscal/cote
{
    "data": {
        "la_data": "2026-10-07",
        "valori": [
            {
                "indicator": "cota_cam",
                "valoare": "2.25",
                "unitate": "%",
                "de_la": "2018-01-01",
                "pana_la": null,
                "act_normativ": "Codul Fiscal art.220^3",
                "de_verificat": false
            }
        ]
    },
    "meta": {
        "sursa": "Legislaţia fiscală, curatată manual, cu act normativ pe fiecare valoare. Cotele, pragurile şi salariul minim se citesc din registrul comun `business_indicatori_fiscali`.",
        "de_verificat": [],
        "nota_acoperire": "Ce perioade acoperă fiecare set şi ce e neconfirmat: /financiar/v1/fiscal/acoperire."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă sau invalid.
403feature_indisponibilfinanciar.fiscal_referinta nu e în planul curent.
422validaretip nu e o cotă (pragurile sunt la /fiscal/praguri) ori la_data nu e în forma AAAA-LL-ZZ; detalii spune care.
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": "tip nu e o cotă (pragurile sunt la /fiscal/praguri) ori la_data nu e în forma AAAA-LL-ZZ; detalii spune care.",
        "detalii": {
            "la_data": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}