oneapi
Autentificare
Business v1 / Nomenclatoare

Nomenclator CAEN

Codurile CAEN, filtrabile: ?q= (cod sau denumire), ?versiune=0|1|2|3 (implicit 3=Rev.3; 0/1 =
ediții istorice de referință), ?nivel=sectiune|diviziune|grupa|clasa, ?sectiune=A. Paginat.

GET
https://oneapi.ro/api/business/v1/caen

Parametri de interogare

NumeTipDescriereValori acceptate
nivelopțional string | null sectiune, diviziune, grupa sau clasa. sectiunediviziunegrupaclasa
qopțional string | null Cod sau text din denumire. ex. softwareex. Cluj
sectiuneopțional string | null Litera secţiunii CAEN (A–U), ca să vezi numai codurile din ea. ex. Jex. A
versiuneopțional string | null 0|1|2|3 (0 = ediția inițială, apoi Rev.1–3). Implicit 3. 0123

Cum se comportă

  • Nomenclatorul CAEN, filtrabil după q (cod sau denumire), versiune, nivel (secţiune/diviziune/grupă/clasă) şi sectiune. Implicit versiunea 3 (Rev.3, cea curentă).
  • Toate ediţiile sunt disponibile ca referinţă: versiune=0|1|2|3 (ediția inițială + Rev.1–3). Lista versiunilor, cu numărul de coduri pe nivel, e la /caen/versiuni; arborele ierarhic la /caen/arbore; echivalările Rev.2↔Rev.3 la /caen/{cod}/echivalent.

La ce folosește

  • Popularea unui selector de coduri CAEN.
  • Traducerea unui cod în denumire şi ierarhie.
  • Migrarea codurilor între revizii.

Structura răspunsului

CâmpTipDescriere
data[].cod string Codul.
data[].denumire string | null Denumirea.
data[].versiune string Revizia nomenclatorului.
data[].nivel string Nivelul din ierarhie (secţiune, diviziune, grupă, clasă).
data[].sectiune string | null Secţiunea din ierarhia CAEN.
data[].diviziune string | null Diviziunea din ierarhie.
data[].grupa string | null Grupa din ierarhie.
data[].nr_firme integer Numărul de firme.
data[].nr_firme_functiune integer
meta.paginare.pagina integer Pagina curentă.
meta.paginare.per_pagina integer Rezultate pe pagină.
meta.paginare.total integer Total rezultate.
meta.paginare.pagini integer Număr de pagini.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/caen?q=software
{
    "data": [
        {
            "cod": "582",
            "denumire": "Activităţi de editare a produselor software",
            "versiune": "CAEN Rev.3",
            "nivel": "grupa",
            "sectiune": "J",
            "diviziune": "58",
            "grupa": "582",
            "nr_firme": 5471,
            "nr_firme_functiune": 2179
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 3,
            "pagini": 1
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareUn parametru nedeclarat ori o valoare care nu trece validarea (nivel, q, sectiune, versiune). Câmpul vinovat e în detalii.
429cota_depasitaCota 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 nedeclarat ori o valoare care nu trece validarea (nivel, q, sectiune, versiune). Câmpul vinovat e în detalii.",
        "detalii": {
            "nivel": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}