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) şi3(2025, Rev.3).versiunespune î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,sursaeoficialşitip_relatiespune dacă e1:1,1:n,n:1orin: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"
}
]
}
}
GEThttps://oneapi.ro/api/business/v1/caen/5211/echivalent?versiune=1&catre=2
{
"data": {
"din": "CAEN Rev.1",
"catre": "CAEN Rev.2",
"echivalente": [
{
"cod": "4711",
"denumire": "Comerț cu amănuntul în magazine nespecializate, cu vânzare predominantă de produse alimentare, băuturi și tutun",
"tip_relatie": "1: 1",
"sursa": "oficial"
}
]
}
}
GEThttps://oneapi.ro/api/business/v1/caen/5211/echivalent?versiune=1&catre=3
{
"data": {
"din": "CAEN Rev.1",
"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": null,
"sursa": "compus"
}
]
}
}
GEThttps://oneapi.ro/api/business/v1/caen/582/echivalent
{
"data": {
"din": "CAEN Rev.3",
"catre": "CAEN Rev.2",
"echivalente": [
{
"cod": "582",
"denumire": "Activități de editare a produselor software",
"tip_relatie": "neschimbat",
"sursa": "cod_identic"
}
]
}
}
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 CAEN [{cod}] nu există în ediţia [{versiune}]. Ediţia se alege cu versiune (0, 1, 2 ori 3). |
| 422 | validare | Un parametru nedeclarat ori o valoare care nu trece validarea (versiune, catre). Câmpul vinovat e în detalii. |
| 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 nedeclarat ori o valoare care nu trece validarea (versiune, catre). Câmpul vinovat e în detalii.",
"detalii": {
"cod": [
"Valoarea trimisă nu respectă regula parametrului."
]
}
}
}