Business v1 / Nomenclatoare

Detaliu cod CAEN

Un cod CAEN cu ierarhia părinților (denumiri), notele explicative (include/exclude) și numărul de
firme care îl au ca CAEN principal. ?versiune=2|3 (implicit 3).

GET

https://oneapi.ro/api/business/v1/caen/{cod}

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul CAEN Rev. 2, patru cifre (ex. 6201).

Parametri de interogare

NumeTipDescriereValori acceptate

versiuneopțional string | null 0|1|2|3. Implicit 3. 0123

Cum se comportă

Un cod CAEN cu denumirile părinţilor (secţiune, diviziune, grupă), notele explicative (include/exclude) şi numărul de firme care îl au ca CAEN principal. ?versiune= alege ediţia.

La ce folosește

Afişarea denumirii şi a ierarhiei unui cod, lângă profilul unei firme.
Verificarea, prin notele include/exclude, dacă un cod acoperă activitatea ta.
Estimarea mărimii unui sector din numărul de firme care îl declară.

Structura răspunsului

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

CâmpTipDescriere

cod string Codul.

denumire string | null Denumirea.

versiune string Revizia nomenclatorului.

nivel string Nivelul din ierarhie (secţiune, diviziune, grupă, clasă).

ierarhie.sectiune.cod string Codul.

ierarhie.sectiune.denumire string | null Denumirea.

ierarhie.diviziune.cod string Codul.

ierarhie.diviziune.denumire string | null Denumirea.

ierarhie.grupa.cod string Codul.

ierarhie.grupa.denumire string | null Denumirea.

note.include string Ce include activitatea, din notele explicative CAEN.opțional

note.include_de_asemenea string Ce mai include, din notele explicative CAEN.opțional

note.exclude string Ce NU include, din notele explicative CAEN.opțional

nr_firme integer | null Firmele a căror activitate principală cade sub cod, pe toate reviziile purtate de firme (62 le numără şi pe cele din 6201, 6202…).

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/caen/6201

{
    "data": {
        "cod": "6201",
        "denumire": "Activități de realizare a soft-ului la comandă (software orientat client)",
        "versiune": "CAEN Rev.2",
        "nivel": "clasa",
        "ierarhie": {
            "sectiune": {
                "cod": "J",
                "denumire": "INFORMAŢII ŞI COMUNICAŢII"
            },
            "diviziune": {
                "cod": "62",
                "denumire": "Activități de servicii în tehnologia informației"
            },
            "grupa": {
                "cod": "620",
                "denumire": "Activități de servicii în tehnologia informației"
            }
        },
        "note": [],
        "nr_firme": 65600
    }
}

GEThttps://oneapi.ro/api/business/v1/caen/582

{
    "data": {
        "cod": "582",
        "denumire": "Activităţi de editare a produselor software",
        "versiune": "CAEN Rev.3",
        "nivel": "grupa",
        "ierarhie": {
            "sectiune": {
                "cod": "J",
                "denumire": "ACTIVITĂȚI DE EDITARE; DIFUZAREA DE PROGRAME DE RADIO ȘI TELEVIZIUNE; ACTIVITĂȚI DE PRODUCȚIE ȘI DISTRIBUȚIE DE CONȚINUTURI"
            },
            "diviziune": {
                "cod": "58",
                "denumire": "Activităţi de editare"
            },
            "grupa": {
                "cod": "582",
                "denumire": "Activităţi de editare a produselor software"
            }
        },
        "note": {
            "include": "Această grupă include editarea de software (de exemplu, sisteme de operare, software și aplicații pentru tehnologii de afaceri și financiare, jocuri video). Dezvoltarea și actualizarea continuă a jocurilor video și software-ului editate în mod independent sunt incluse aici.",
            "include_de_asemenea": "Această grupă include, de asemenea:\n-activități de servicii de intermediere pentru editarea de software și operarea piețelor pentru descărcări de software"
        },
        "nr_firme": 5471
    }
}

GEThttps://oneapi.ro/api/business/v1/caen/B

{
    "data": {
        "cod": "B",
        "denumire": "INDUSTRIA EXTRACTIVĂ",
        "versiune": "CAEN Rev.3",
        "nivel": "sectiune",
        "ierarhie": {
            "sectiune": {
                "cod": "B",
                "denumire": "INDUSTRIA EXTRACTIVĂ"
            }
        },
        "note": {
            "include": "Exploatarea în carieră include extracția mineralelor care apar în mod natural sub formă de solide (cărbune și minereuri), lichide (petrol) sau gaze (gaz natural). Extracția poate fi realizată prin diferite metode (de exemplu, minerit subteran sau de suprafață, exploatarea puțurilor, exploatarea fundului mării).\nAceastă secțiune include activități suplimentare care vizează pregătirea materiilor prime pentru comercializare (de exemplu, zdrobirea, măcinarea, curățarea, uscarea, sortarea, concentrarea minereurilor și lichefierea gazelor naturale).\nActivitățile miniere sunt clasificate în diviziuni, grupuri și clase pe baza principalului mineral produs. Diviziunile 05 și 06 se ocupă de exploatarea și extragerea combustibililor fosili (cărbune, lignit, petrol, gaz); diviziunile 07 și 08 se referă la minereuri metalice, diverse minerale și produse din carieră.\nUnele dintre operațiunile tehnice ale acestei secțiuni, în special legate de extracția hidrocarburilor, pot fi efectuate și pentru terți de către unități specializate ca activitate de servicii industriale care se reflectă în diviziunea 09.",
            "exclude": "Această secțiune exclude:\n- prelucrarea ulterioară a materialelor extrase, a se vedea secțiunea C\n- utilizarea materialelor extrase fără alte transformări în scopuri de construcție, vezi secțiunea F\n- îmbuteliere de izvoare naturale și ape minerale la izvoare și fântâni, vezi 1107\n- remedierea siturilor miniere, vezi 3900"
        },
        "nr_firme": 5604
    }
}

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	Codul nu există în versiunea cerută.
422	validare	Un parametru nu a trecut validarea (`versiune`); `detalii` spune care şi de ce.
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": "Un parametru nu a trecut validarea (versiune); detalii spune care şi de ce.",
        "detalii": {
            "cod": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}