oneapi
Autentificare
Business v1 / Nomenclatoare

Categorii de servicii

Categorii de servicii pe înţelesul oricui (instalatori, stomatologi, service auto), fiecare cu codurile CAEN Rev.3 care o acoperă.

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

Parametri de interogare

NumeTipDescriereValori acceptate
qopțional string | null Un cuvânt din denumire ori sinonime (fără diacritice). max 100 car.
domeniuopțional string | null constructii, casa, auto, transport, horeca, sanatate, personal, profesionale, imobiliare, it, educatie, comert, agricultura, energie. constructiicasaautotransporthorecasanatatepersonalprofesionaleimobiliareiteducatiecomertagriculturaenergie

Cum se comportă

  • 97 de categorii în 14 domenii, fiecare cu codurile CAEN Rev.3 care o acoperă, scrise şi verificate de noi pe nomenclator. Firmele unei categorii: /firme/cauta?categorie=instalatori&judet=CJ — codurile se desfac acolo şi în Rev.2, după regula de mai jos.
  • Pentru un text liber („vreau să repar biciclete"), potrivirea semantică e la /caen/potriveste. Pe un singur cuvânt, însă, ea greşeşte exact la meseriile cele mai căutate („instalator" dădea instalarea maşinilor industriale), de aceea lista de aici e scrisă de mână.
  • q caută în denumire, sinonime şi cheie, fără diacritice şi fără majuscule: q=stomatolog, q=centrala.
  • Firmele încă pe Rev.2 intră într-o categorie doar când codul lor vechi duce clar acolo: fie toate corespondentele lui Rev.3 sunt în categorie, fie a fost doar renumerotat în cel mult 3 coduri (5610 restaurante → 5611 + 5612; 4120 → 4100; 4532 piese auto → 4782), fie îşi păstrează numărul (6820 → 6820). Codurile-sac nu intră: 4399 „alte lucrări speciale de construcţii" se împarte în zece coduri Rev.3, deci „instalatori" nu mai prinde firme de schele ori fundaţii. Preţul: activităţile care în Rev.2 stăteau doar în codurile-sac (zidăria, în 4399) apar abia pe măsură ce firmele trec, obligatoriu, pe Rev.3.

La ce folosește

  • Un meniu „Caută un serviciu" (instalatori, stomatologi, service auto), fără ca utilizatorul să ştie ce e un cod CAEN.
  • Un câmp de căutare care transformă „dentist" în codul corect înainte de a lista firmele.
  • Gruparea firmelor unui oraş pe tipuri de servicii, într-un director local.

Structura răspunsului

CâmpTipDescriere
data[].cheie string Identificatorul categoriei — se trimite la /firme/cauta?categorie=.
data[].denumire string Denumirea, în română.
data[].denumire_en string Denumirea, în engleză.
data[].domeniu.cheie string Domeniul (constructii, auto, sanatate…).
data[].domeniu.denumire string Denumirea domeniului.
data[].coduri[].cod string Un cod CAEN Rev.3 al categoriei.
data[].coduri[].denumire string Denumirea oficială a codului.
data[].sinonime array Cuvintele cu care se găseşte categoria („instalator", „centrala termica"…).
data[].nr_firme integer Numărul de firme.
data[].nr_firme_functiune integer
meta.q string Cuvântul căutat, dacă e cazul.
meta.domeniu string Domeniul cerut, dacă e cazul.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/caen/categorii?q=instalator
{
    "data": [
        {
            "cheie": "instalatori",
            "denumire": "Instalatori (sanitare, termice, aer condiţionat)",
            "denumire_en": "Plumbers and HVAC",
            "domeniu": {
                "cheie": "constructii",
                "denumire": "Construcţii"
            },
            "coduri": [
                {
                    "cod": "4322",
                    "denumire": "Lucrări de instalații sanitare, de încălzire și de aer condiționat"
                }
            ],
            "sinonime": [
                "instalator",
                "instalatii sanitare",
                "centrala termica",
                "incalzire",
                "aer conditionat",
                "climatizare",
                "gaze"
            ],
            "nr_firme": 31268,
            "nr_firme_functiune": 15688
        }
    ],
    "meta": {
        "q": "instalator"
    }
}

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