Business v1 / Nomenclatoare

Indicatori fiscali

Valori de referință fiscale (cote TVA/impozit etc.) cu perioada de valabilitate și actul normativ.

GET

https://oneapi.ro/api/business/v1/indicatori-fiscali

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Dicţionarul indicatorilor fiscali (codurile de declaraţii din vectorul fiscal, ex. IMP100), cu semnificaţia fiecăruia — referinţă pentru /firme/{cui}/vector-fiscal.

La ce folosește

Traducerea codurilor din vectorul fiscal în denumiri lizibile.
Popularea unei legende într-o interfaţă care afişează obligaţiile declarative.
Validarea unui cod de declaraţie primit dintr-o sursă externă.

Structura răspunsului

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

CâmpTipDescriere

indicator string Codul indicatorului.

valoare number | null Valoarea indicatorului.

unitate string Unitatea de măsură.

de_la string De când e valabil.

pana_la string | null Până când e valabil.

act_normativ string Actul normativ care o stabileşte.

observatii string | null Observaţii publicate odată cu intrarea.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/indicatori-fiscali

{
    "data": [
        {
            "indicator": "cota_cam",
            "valoare": 2.25,
            "unitate": "%",
            "de_la": "2018-01-01",
            "pana_la": null,
            "act_normativ": "Codul Fiscal art.220^3",
            "observatii": null
        }
    ]
}

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	Ruta nu primeşte parametri, în afară de `lang`: orice alt parametru dă 422, nu e ignorat.
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": "Ruta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat."
    }
}