Business v1 / Firme

Vector fiscal

Obligațiile declarative ale firmei (codurile de declarații: IMP100, CONT412 etc.).

GET

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

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ă

Vectorul fiscal: obligaţiile declarative ale firmei (IMP100, TVA, impozit pe profit/venit, contribuţii etc.), din datele ANAF. Arată ce declaraţii depune firma, deci indirect şi regimul ei fiscal.

La ce folosește

Deducerea regimului fiscal al firmei din declaraţiile la care e obligată.
Construirea unui calendar de termene pentru un client de contabilitate.
Verificarea faptului că un client îţi declară tot ce ar trebui să declare.

Structura răspunsului

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

CâmpTipDescriere

obligatii[] string Obligaţiile declarate în vectorul fiscal.

Exemple de răspuns

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

{
    "data": {
        "obligatii": [
            "IMP100",
            "IMP451",
            "IMP461",
            "IMP602",
            "IMP611",
            "IMP701",
            "CONT412",
            "CONT432",
            "CONT480",
            "ACCIZE200"
        ]
    }
}

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

{
    "data": {
        "obligatii": [
            "IMP100",
            "IMP602",
            "CONT412",
            "CONT432",
            "CONT480"
        ]
    }
}

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

{
    "data": {
        "obligatii": [
            "IMP100",
            "IMP602",
            "CONT412",
            "CONT432",
            "CONT480"
        ]
    }
}

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 cu CUI [{cui}] nu a fost gă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."
            ]
        }
    }
}