Business v1 / Firme

Activităţi (CAEN)

Activitățile CAEN ale firmei: codul principal (din ANAF) + toate codurile autorizate/înregistrate
(din ONRC), fiecare cu cod, denumire, versiunea CAEN și marcaj autorizat/principal.

GET

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

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ă

CAEN-ul principal (din starea fiscală) plus activităţile autorizate de la ONRC. Codurile apar în ambele revizii în care sunt clasificate.
Reţine: „activitatea principală" din ONRC e goală pe tot registrul, deci principalul vine din vectorul fiscal ANAF.

La ce folosește

Verificarea faptului că firma e autorizată pentru activitatea pe care o contractezi.
Clasificarea unui portofoliu de clienţi pe sectoare, pe revizia CAEN care îţi trebuie.
Migrarea codurilor între revizii, fiindcă răspunsul le dă în ambele.

Structura răspunsului

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

CâmpTipDescriere

caen_principal.cod string Codul CAEN principal.

caen_principal.denumire string | null Denumirea activităţii principale.

caen_principal.versiune string Revizia CAEN în care e exprimat codul.

nr_activitati integer Numărul de activităţi.

activitati[].cod string Codul.

activitati[].denumire string | null Denumirea.

activitati[].versiune string Revizia nomenclatorului.

activitati[].autorizata boolean Activitatea e autorizată, nu doar declarată.

activitati[].principala boolean E activitatea principală.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/6719278/activitati

{
    "data": {
        "caen_principal": {
            "cod": "4711",
            "denumire": "Comerț cu amănuntul în magazine nespecializate, cu vânzare predominantă de produse alimentare, băuturi și tutun",
            "versiune": "CAEN Rev.2"
        },
        "nr_activitati": 82,
        "activitati": [
            {
                "cod": "1011",
                "denumire": "Prelucrarea și conservarea cărnii",
                "versiune": "CAEN Rev.3",
                "autorizata": true,
                "principala": false
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/14399840/activitati

{
    "data": {
        "caen_principal": {
            "cod": "4754",
            "denumire": "Comerț cu amănuntul al articolelor și aparatelor electrocasnice, în magazine specializate",
            "versiune": "CAEN Rev.2"
        },
        "nr_activitati": 80,
        "activitati": [
            {
                "cod": "4615",
                "denumire": "Intermedieri în comerțul cu mobilă, articole de menaj și de fierărie",
                "versiune": "CAEN Rev.3",
                "autorizata": true,
                "principala": false
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/2054341/activitati

{
    "data": {
        "caen_principal": {
            "cod": "1410",
            "denumire": "Fabricarea articolelor de îmbrăcăminte prin tricotare sau croșetare",
            "versiune": "CAEN Rev.3"
        },
        "nr_activitati": 97,
        "activitati": [
            {
                "cod": "0240",
                "denumire": "Activități de servicii anexe silviculturii",
                "versiune": "CAEN Rev.2",
                "autorizata": true,
                "principala": false
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/24890577/activitati

{
    "data": {
        "caen_principal": {
            "cod": "4619",
            "denumire": "Intermedieri în comerțul cu produse diverse",
            "versiune": "CAEN Rev.2"
        },
        "nr_activitati": 18,
        "activitati": [
            {
                "cod": "1071",
                "denumire": "Fabricarea pâinii; fabricarea prăjiturilor și a produselor proaspete de patiserie",
                "versiune": "CAEN Rev.2",
                "autorizata": true,
                "principala": false
            }
        ]
    }
}

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."
            ]
        }
    }
}