oneapi
Autentificare
Business v1 / Nomenclatoare

Versiuni CAEN

Versiunile de nomenclator disponibile ca referință: Rev.0/1/2/3 (istorice + curentă), cu eticheta,
versiunea implicită și numărul de coduri pe fiecare nivel. Rev.3 este cea curentă (implicită).

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

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • Cele patru ediţii de nomenclator CAEN disponibile ca referinţă (ediția inițială din 1998 + Rev.1/2/3), fiecare cu eticheta şi anul intrării în vigoare, dacă e cea implicită şi numărul de coduri pe nivel (secţiuni, diviziuni, grupe, clase). Rev.3 e cea curentă.

La ce folosește

  • Alegerea reviziei CAEN pe care o foloseşti într-o interfaţă sau într-un import.
  • Verificarea ediţiei în vigoare la data unui document mai vechi.
  • Popularea unui selector de versiune, înainte de a cere arborele.

Structura răspunsului

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

CâmpTipDescriere
versiune string Revizia nomenclatorului.
eticheta string Eticheta afişabilă.
an_vigoare integer Anul din care revizia e în vigoare.
implicita boolean Revizia folosită implicit când nu se cere alta.
total integer Totalul.
niveluri.sectiuni integer Câte secţiuni are revizia.
niveluri.diviziuni integer Câte diviziuni are revizia.
niveluri.grupe integer Câte grupe are revizia.
niveluri.clase integer Câte clase are revizia.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/caen/versiuni
{
    "data": [
        {
            "versiune": "0",
            "eticheta": "CAEN (ediția inițială)",
            "an_vigoare": 1998,
            "implicita": false,
            "total": 849,
            "niveluri": {
                "sectiuni": 0,
                "diviziuni": 60,
                "grupe": 226,
                "clase": 563
            }
        }
    ]
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareRuta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat.
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": "Ruta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat."
    }
}