oneapi
Autentificare
Business v1 / Căutare universală

Căutare universală

Caută un termen simultan în firme (după nume) și persoane (după nume) și întoarce o previzualizare
(top 5 din fiecare) plus totalurile. Pentru liste complete paginate: /firme/cauta și /persoane/cauta.

GET
https://oneapi.ro/api/business/v1/cauta

Parametri de interogare

NumeTipDescriereValori acceptate
qopțional string | null Textul căutat. ex. digitalex. farmacieex. Mega Image

Cum se comportă

  • O căutare peste firme şi persoane deodată: top câteva din fiecare plus totalurile. Convenabilă pentru o bară de căutare unică, unde userul nu ştie dinainte dacă tastează un nume de firmă sau de persoană.

La ce folosește

  • O singură bară de căutare, când userul nu ştie dacă tastează firmă sau persoană.
  • Un endpoint de autocomplete pentru interfeţe, cu rezultate din ambele domenii.
  • Trierea rapidă a unui termen ambiguu, înainte de a merge la ruta specializată.

Structura răspunsului

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

CâmpTipDescriere
firme.total integer Totalul.
firme.rezultate[].cui integer Codul fiscal.
firme.rezultate[].denumire string Denumirea.
firme.rezultate[].cod_inmatriculare string Numărul de ordine în registrul comerţului (J…).
firme.rezultate[].forma_juridica string Forma juridică (SRL, SA, PFA…).
firme.rezultate[].stare string Starea firmei, ca obiect: denumire e textul brut din ONRC (107 valori distincte folosite), categorie e clasificarea noastră în 7 cutii — activa, suspendata, dizolvata, lichidare, radiata, insolventa, alta — pe care o foloseşti ca să filtrezi sau să grupezi. cod e codul ONRC al stării.
firme.rezultate[].data_inmatriculare string Data înmatriculării la registrul comerţului.
firme.rezultate[].sediu.judet string Judeţul sediului social.
firme.rezultate[].sediu.localitate string Localitatea sediului social.
firme.rezultate[].sediu.cod_siruta integer Codul SIRUTA al localităţii — chainable spre /locations/v1.
firme.rezultate[].caen_principal.cod string Codul CAEN principal.
firme.rezultate[].caen_principal.denumire string Denumirea activităţii principale.
firme.rezultate[].fiscal.tva boolean Plătitoare de TVA.
firme.rezultate[].fiscal.inactiv boolean Declarată inactivă fiscal.
firme.rezultate[].fiscal.e_factura boolean Înrolată în e-Factura.
firme.rezultate[].financiar object | null Ultimul bilanţ depus (an, cifră de afaceri, profit net, salariaţi); null la firmele fără bilanţ — PFA-uri, firme noi —, nu zero.
firme.rezultate[].financiar.an integer Anul bilanţului.
firme.rezultate[].financiar.cifra_afaceri number | null Cifra de afaceri netă, în lei.
firme.rezultate[].financiar.profit_net number | null Profitul net, în lei; negativ = pierdere.
firme.rezultate[].financiar.salariati integer | null Numărul mediu de salariaţi.
persoane.total integer Totalul.
persoane.rezultate[].id integer Identificatorul intern.
persoane.rezultate[].nume string Numele.
persoane.rezultate[].localitate string Localitatea.
persoane.rezultate[].judet string Judeţul.
persoane.rezultate[].nr_firme integer Numărul de firme.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/cauta?q=digital
{
    "data": {
        "firme": {
            "total": 6105,
            "rezultate": [
                {
                    "cui": 32917762,
                    "denumire": "DIGITAL 1 VENTURES DEVELOPMENT SRL",
                    "cod_inmatriculare": "J12/957/2014",
                    "forma_juridica": "SRL",
                    "stare": {
                        "cod": "1084",
                        "denumire": "radiată",
                        "categorie": "radiata"
                    },
                    "data_inmatriculare": "2014-03-13",
                    "sediu": {
                        "judet": "Cluj",
                        "localitate": "Cluj-Napoca",
                        "cod_siruta": 54984
                    },
                    "caen_principal": {
                        "cod": "6201",
                        "denumire": "Activități de realizare a soft-ului la comandă (software orientat client)"
                    },
                    "fiscal": {
                        "tva": true,
                        "inactiv": false,
                        "e_factura": false
                    },
                    "financiar": {
                        "an": 2025,
                        "cifra_afaceri": 83990,
                        "profit_net": 3947,
                        "salariati": 1
                    }
                }
            ]
        },
        "persoane": {
            "total": 12,
            "rezultate": [
                {
                    "id": 15029226,
                    "identificator": "5a53ec65-c6ba-50bf-b9da-9413dd3d7d42",
                    "nume": "DIGITAL CODECRAFT S.R.L.",
                    "localitate": "Constanţa",
                    "judet": "Constanţa",
                    "nr_firme": 0
                }
            ]
        }
    }
}

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 (q). Câmpul vinovat e în detalii.
422q_scurtTermenul de căutare trebuie să aibă cel puțin 3 caractere.
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 (q). Câmpul vinovat e în detalii.",
        "detalii": {
            "q": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}