oneapi
Autentificare
Business v1 / Firme

Firme similare

Firme cu acelaşi profil de activitate şi din aceeaşi zonă, ordonate după cât de apropiate sunt. Pentru benchmark şi pentru a găsi concurenţa directă.

GET
https://oneapi.ro/api/business/v1/firme/{cui}/similare

Parametri de cale

NumeTipDescriereExemplu
cuiobligatoriu string Codul de identificare fiscală al firmei, fără prefixul RO (ex. 6719278).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • Firme asemănătoare celei date — apropiate ca sector (CAEN) şi arie geografică. Util pentru descoperirea concurenţei sau a unei liste de comparabile.

La ce folosește

  • Construirea unei liste de comparabile pentru o evaluare.
  • Descoperirea concurenţei locale a unui client, pe acelaşi CAEN şi aceeaşi zonă.
  • Extinderea unei campanii de vânzări de la un client câştigat la firme asemănătoare.

Structura răspunsului

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

CâmpTipDescriere
firme[].cui integer Codul fiscal.
firme[].denumire string Denumirea.
firme[].cod_inmatriculare string Numărul de ordine în registrul comerţului (J…).
firme[].forma_juridica string Forma juridică (SRL, SA, PFA…).
firme[].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[].data_inmatriculare string Data înmatriculării la registrul comerţului.
firme[].sediu.judet string Judeţul sediului social.
firme[].sediu.localitate string Localitatea sediului social.
firme[].sediu.cod_siruta integer Codul SIRUTA al localităţii — chainable spre /locations/v1.
firme[].caen_principal.cod string Codul CAEN principal.
firme[].caen_principal.denumire string Denumirea activităţii principale.
firme[].fiscal.tva boolean Plătitoare de TVA.
firme[].fiscal.inactiv boolean Declarată inactivă fiscal.
firme[].fiscal.e_factura boolean Înrolată în e-Factura.
firme[].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[].financiar.an integer Anul bilanţului.
firme[].financiar.cifra_afaceri number | null Cifra de afaceri netă, în lei.
firme[].financiar.profit_net number | null Profitul net, în lei; negativ = pierdere.
firme[].financiar.salariati integer | null Numărul mediu de salariaţi.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/6719278/similare
{
    "data": {
        "firme": [
            {
                "cui": 18430426,
                "denumire": "ADOLORATA IMPEX SRL",
                "cod_inmatriculare": "J40/3344/2006",
                "forma_juridica": "SRL",
                "stare": {
                    "cod": "1048",
                    "denumire": "funcțiune",
                    "categorie": "activa"
                },
                "data_inmatriculare": "2006-02-28",
                "sediu": {
                    "judet": "București",
                    "localitate": "București Sectorul 3",
                    "cod_siruta": 179169
                },
                "caen_principal": {
                    "cod": "4711",
                    "denumire": "Comerț cu amănuntul în magazine nespecializate, cu vânzare predominantă de produse alimentare, băuturi și tutun"
                },
                "fiscal": {
                    "tva": false,
                    "inactiv": true,
                    "e_factura": false
                },
                "financiar": null
            }
        ]
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitFirma [{cui}] negăsită.
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.",
        "detalii": {
            "cui": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}