Business v1 / Firme

Istoric stare fiscală

Cum s-a schimbat starea fiscală în timp — intrări şi ieşiri din TVA, din inactivitate, din split — fiecare schimbare cu data ei, nu doar starea de azi.

GET

https://oneapi.ro/api/business/v1/firme/{cui}/fiscal/istoric

Parametri de cale

NumeTipDescriereExemplu

cuiobligatoriu string Codul de identificare fiscală al firmei, fără prefixul RO (ex. 6719278).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Istoricul schimbărilor de stare fiscală (TVA, inactivitate etc.), cu data fiecărei modificări — util pentru a vedea când a intrat sau a ieşit o firmă din TVA.

La ce folosește

Stabilirea regimului de TVA aplicabil la data unei facturi vechi, nu la ziua de azi.
Reconstituirea momentului în care un partener a intrat sau a ieşit din inactivitate.
Documentarea unei corecţii fiscale cu data exactă a schimbării de statut.

Structura răspunsului

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

CâmpTipDescriere

istoric[].atribut string Atributul fiscal care s-a schimbat.

istoric[].data_start string De când e valabilă valoarea.

istoric[].data_end string | null Până când a fost valabilă; null = încă în vigoare.

istoric[].sursa string Sursa datelor.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/6719278/fiscal/istoric

{
    "data": {
        "istoric": [
            {
                "atribut": "tva",
                "data_start": "1995-01-04",
                "data_end": null,
                "sursa": "anaf:v9"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/14399840/fiscal/istoric

{
    "data": {
        "istoric": [
            {
                "atribut": "tva",
                "data_start": "2002-02-01",
                "data_end": null,
                "sursa": "anaf:v9"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/2054341/fiscal/istoric

{
    "data": {
        "istoric": [
            {
                "atribut": "tva",
                "data_start": "2025-06-30",
                "data_end": null,
                "sursa": "anaf:v9"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/24890577/fiscal/istoric

{
    "data": {
        "istoric": [
            {
                "atribut": "tva",
                "data_start": "2009-01-06",
                "data_end": null,
                "sursa": "anaf:v9"
            }
        ]
    }
}

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	Firma [{cui}] negăsită.
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.",
        "detalii": {
            "cui": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}