oneapi
Autentificare
Business v1 / Nomenclatoare

Arbore CAEN

Ierarhia completă a unei versiuni CAEN: secțiuni → diviziuni → grupe → clase. ?versiune=2|3 (implicit 3).

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

Parametri de interogare

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

Cum se comportă

  • Ierarhia completă a unei versiuni CAEN: secţiuni → diviziuni → grupe → clase. La ediţiile vechi (ediția inițială, Rev.1, Rev.2), care n-au rânduri de secţiune, rădăcinile arborelui sunt diviziunile. ?versiune= alege ediţia (implicit 3).

La ce folosește

  • Construirea unui selector ierarhic de activitate, secţiune → clasă.
  • Popularea unui nomenclator local, într-un singur apel.
  • Gruparea unui portofoliu de clienţi pe diviziuni sau secţiuni.

Structura răspunsului

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

CâmpTipDescriere
versiune string Revizia nomenclatorului.
arbore[].cod string Codul.
arbore[].denumire string Denumirea.
arbore[].copii[].cod string Codul.
arbore[].copii[].denumire string Denumirea.
arbore[].copii[].copii[].cod string Codul.
arbore[].copii[].copii[].denumire string Denumirea.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/caen/arbore
{
    "data": {
        "versiune": "CAEN Rev.3",
        "arbore": [
            {
                "cod": "A",
                "denumire": "AGRICULTURĂ, SILVICULTURĂ ŞI PESCUIT",
                "nr_firme": 261167,
                "nr_firme_functiune": 123874,
                "copii": [
                    {
                        "cod": "01",
                        "denumire": "Agricultură, vânătoare şi servicii anexe",
                        "nr_firme": 237244,
                        "nr_firme_functiune": 111489,
                        "copii": [
                            {
                                "cod": "011",
                                "denumire": "Cultivarea plantelor nepermanente",
                                "nr_firme": 88929,
                                "nr_firme_functiune": 50288,
                                "copii": [
                                    {
                                        "cod": "0111",
                                        "denumire": "Cultivarea cerealelor (excluzând orezul), plantelor leguminoase și a plantelor oleaginoase",
                                        "nr_firme": 41993,
                                        "nr_firme_functiune": 25585
                                    }
                                ]
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

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 (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 (versiune). Câmpul vinovat e în detalii.",
        "detalii": {
            "versiune": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}