oneapi
Autentificare
Business v1 / Firme

Profilul unei firme

Profilul sintetic al unei firme după CUI: identitate ONRC, formă juridică, stare, CAEN principal,
stare fiscală (TVA/inactiv/e-factura), sediu în ambele variante — RAW (ONRC) și REZOLVAT (Locations:
SIRUTA, UAT, județ, regiune, NUTS, populație) — plus un rezumat al sub-resurselor disponibile.

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

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ă

  • Profilul unificat al unei firme, cheiat pe codul fiscal (CUI). Adună la un loc identitatea de la ONRC (denumire, formă juridică, sediu, stare, dată de înmatriculare), starea fiscală de la ANAF (plătitor de TVA, inactivitate) şi CAEN-ul principal.
  • CAEN-ul principal vine din starea fiscală (ANAF), nu din lista de activităţi autorizate. În registru, câmpul „activitate principală" de la ONRC e gol pe toate firmele, aşa că sursa de adevăr pentru CAEN-ul curent e vectorul fiscal. Acoperirea e ~97%.
  • Sediul e servit în două forme: sediu.raw (textul brut de la ONRC) şi sediu.rezolvat (legat de modulul Locations la nivel de judeţ, localitate şi, unde se poate, stradă). Rezolvarea acoperă 99,9% din firme la localitate.
  • Pentru felii individuale există rute dedicate: /firme/{cui}/fiscal, /financiar, /activitati, /persoane, /achizitii, /contact, /locatie. Profilul complet (toate feliile într-un apel) e la /firme/{cui}/profil-complet.

La ce folosește

  • Autocompletarea datelor de firmă la facturare sau la înscrierea unui client business.
  • Verificarea rapidă a stării şi a statutului de TVA înainte de o tranzacţie.
  • Îmbogăţirea unei baze de clienţi cu date oficiale, pornind de la CUI.

Structura răspunsului

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

CâmpTipDescriere
cui integer Codul fiscal.
denumire string | null Denumirea.
cod_inmatriculare string | null Numărul de ordine în registrul comerţului (J…).
euid string | null Identificatorul european unic al firmei.
forma_juridica string | null Forma juridică (SRL, SA, PFA…).
stare string | null 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.
data_inmatriculare string | null Data înmatriculării la registrul comerţului.
sediu object Obiect cu sediul brut (raw) şi cel rezolvat prin Locations (rezolvat).
sediu.raw[] string | integer Adresa sediului aşa cum e la sursă, câmp cu câmp; cheile goale lipsesc.
sediu.rezolvat.localitate_id integer Id-ul intern al localităţii în Locations.
sediu.rezolvat.localitate string Localitatea.
sediu.rezolvat.cod_siruta integer | null Codul SIRUTA al localităţii — chainable spre /locations/v1.
sediu.rezolvat.uat string | null Unitatea administrativ-teritorială.
sediu.rezolvat.judet string | null Judeţul.
sediu.rezolvat.regiune string | null Regiunea de dezvoltare.
sediu.rezolvat.cod_nuts string | null Codul NUTS al unităţii teritoriale.
sediu.rezolvat.populatie integer | null Populaţia localităţii (recensământ).
sediu.rezolvat.strada_id integer | null Id-ul străzii în Locations — chainable spre /locations/v1/strazi/{id}.
sediu.rezolvat.strada string | null Strada.
sediu.rezolvat.potrivire[] string Cât de sigură e legarea la nomenclator, pe localitate şi pe stradă.
sediu.rezolvat.coordonate.lat number Latitudinea punctului (WGS84, 6 zecimale ≈ 11 cm).
sediu.rezolvat.coordonate.lng number Longitudinea punctului (WGS84).
sediu.rezolvat.coordonate.precizie string Vezi precizie de la /firme/{cui}/locatie: numar, numar_aproximativ, strada ori localitate. ⚠️ Nu desena ac decât pe primele două.
caen_principal object Codul CAEN principal, din starea fiscală. null unde ANAF nu îl publică.
caen_principal.cod string Codul CAEN principal.
caen_principal.denumire string | null Denumirea activităţii principale.
caen_principal.versiune string Revizia CAEN în care e exprimat codul.
fiscal.platitor_tva boolean Plătitoare de TVA la ultima sincronizare.
fiscal.tva_la_incasare boolean Aplică TVA la încasare.
fiscal.split_tva boolean Aplică split TVA.
fiscal.inactiv_fiscal boolean Declarată inactivă fiscal.
fiscal.e_factura boolean Înrolată în e-Factura.
fiscal.radiata boolean Firma e radiată.
prezente[] mixed În ce seturi de date mai apare firma (financiar, achiziţii, registre…).
tva Plătitor de TVA la data ultimei sincronizări ANAF.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/6719278
{
    "data": {
        "cui": 6719278,
        "denumire": "MEGA IMAGE SRL",
        "cod_inmatriculare": "J1994027872407",
        "euid": "ROONRC.J1994027872407",
        "forma_juridica": "SRL",
        "stare": {
            "cod": "1048",
            "denumire": "funcțiune",
            "categorie": "activa"
        },
        "data_inmatriculare": "1994-12-27",
        "sediu": {
            "raw": {
                "judet": "Bucureşti",
                "localitate": "Bucureşti Sectorul 6",
                "strada": "Timişoara",
                "numar": "26",
                "etaj": "2",
                "sector": 6,
                "cod_postal": "61331"
            },
            "rezolvat": {
                "localitate_id": 13755,
                "localitate": "București Sectorul 6",
                "cod_siruta": 179196,
                "uat": "București",
                "judet": "București",
                "regiune": "București-Ilfov",
                "cod_nuts": "RO321",
                "populatie": 324994,
                "strada_id": 221585,
                "strada": "Timișoara",
                "potrivire": {
                    "loc": "exact",
                    "str": "exact"
                },
                "coordonate": {
                    "lat": 44.428876,
                    "lng": 26.036041,
                    "precizie": "numar"
                }
            }
        },
        "caen_principal": {
            "cod": "4711",
            "denumire": "Comerț cu amănuntul în magazine nespecializate, cu vânzare predominantă de produse alimentare, băuturi și tutun",
            "versiune": "CAEN Rev.2"
        },
        "fiscal": {
            "platitor_tva": true,
            "tva_la_incasare": false,
            "split_tva": false,
            "inactiv_fiscal": false,
            "e_factura": false,
            "radiata": false
        },
        "prezente": {
            "nr_persoane": 5,
            "ani_financiar": [
                2008,
                2009,
                2010,
                2011,
                2012,
                2013,
                2014,
                2015,
                2016,
                2017,
                2018,
                2019,
                2020,
                2021,
                2022,
                2023,
                2024,
                2025
            ],
            "nr_achizitii": 776,
            "registre": [
                "anaf_datorii",
                "anpm_eee",
                "ansvsa",
                "contribuabili",
                "mcpds_sponsorizari"
            ]
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitCUI inexistent în registru. Codul de eroare este negasit.
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": "negasit",
        "mesaj": "CUI inexistent în registru. Codul de eroare este negasit."
    }
}