oneapi
Autentificare
Business v1 / Nomenclatoare

Echivalări CAEN

Traduce un cod CAEN dintr-o ediţie în alta — 1998, 2003 (Rev.1), 2008 (Rev.2), 2025 (Rev.3) — spunând de fiecare dată de unde vine echivalarea.

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

Parametri de cale

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

Parametri de interogare

NumeTipDescriereValori acceptate
versiuneopțional string | null Ediţia în care e codul dat: 0, 1, 2 ori 3. Implicit 3. 0123
catreopțional string | null Ediţia în care vrei echivalările: 0, 1, 2 ori 3. Implicit, cealaltă ediţie dintre Rev.2 şi Rev.3. 0123

Cum se comportă

  • Ediţiile sunt 0 (1998), 1 (2003, Rev.1), 2 (2008, Rev.2) şi 3 (2025, Rev.3). versiune spune în ce ediţie e codul dat, catre în ce ediţie îl vrei; fără catre, răspunsul merge între Rev.2 şi Rev.3, ca până acum.
  • INS publică tabele doar între ediţii vecine (2003 → 2008 şi 2008 → 2025). Un salt mai mare se obţine înlănţuindu-le, iar rezultatul e marcat sursa: compus — util, dar nu garantat de sursă. Pe un singur pas, sursa e oficial şi tip_relatie spune dacă e 1:1, 1:n, n:1 ori n:m.
  • ⚠️ Tabelele conţin doar codurile care s-au schimbat. 362 de coduri Rev.2 nu apar în corespondenţa cu Rev.3 fiindcă au rămas identice — citite ca „fără echivalent", ar tăia o treime din nomenclator. Când tabelul tace, ruta caută acelaşi cod în ediţia ţintă şi îl marchează sursa: cod_identic, tip_relatie: neschimbat.
  • ⚠️ Ediţia 1998 n-are niciun tabel de corespondenţă la INS. Pentru ea răspunsul se poate baza doar pe codul identic (747 din 849 de coduri se regăsesc în 2003), niciodată pe o corespondenţă oficială.

La ce folosește

  • Migrarea unui set de date de la CAEN Rev.2 la Rev.3.
  • Compararea unor serii istorice care folosesc ediţii diferite.
  • Traducerea codului dintr-un contract vechi în nomenclatorul curent.

Structura răspunsului

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

CâmpTipDescriere
din string Ediţia CAEN din care pleci.
catre string Ediţia CAEN în care s-a tradus codul.
echivalente[] array Codurile echivalente din ediţia ţintă.
echivalente[].cod string Codul echivalent.
echivalente[].denumire string Denumirea lui în ediţia ţintă.
echivalente[].tip_relatie string | null Cum se leagă cele două coduri: 1:1, 1:n, n:1, n:m ori neschimbat. Vine din tabelul INS, deci e completat doar când traducerea s-a făcut într-un singur pas.
echivalente[].sursa string oficial — din tabelul de corespondenţă INS; compus — obţinut din două tabele înlănţuite (2003 → 2008 → 2025), pe care INS nu le garantează împreună; cod_identic — tabelele tac, dar acelaşi cod există în ediţia ţintă.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/caen/4711/echivalent?versiune=2
{
    "data": {
        "din": "CAEN Rev.2",
        "catre": "CAEN Rev.3",
        "echivalente": [
            {
                "cod": "4711",
                "denumire": "Comerț cu amănuntul nespecializat, cu vânzare predominantă de produse alimentare, băuturi și tutun",
                "tip_relatie": "n:m",
                "sursa": "oficial"
            }
        ]
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitCodul CAEN [{cod}] nu există în ediţia [{versiune}]. Ediţia se alege cu versiune (0, 1, 2 ori 3).
422validareUn parametru nedeclarat ori o valoare care nu trece validarea (versiune, catre). 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, catre). Câmpul vinovat e în detalii.",
        "detalii": {
            "cod": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}