oneapi
Autentificare
Business v1 / Firme

Firmă după EUID

Caută firma după identificatorul european unic (EUID), forma ROONRC.J40/7734/1992 folosită în registrele interconectate ale UE.

GET
https://oneapi.ro/api/business/v1/firme/dupa-euid/{euid}

Parametri de cale

NumeTipDescriereExemplu
euidobligatoriu string Identificatorul european unic al firmei (ex. ROONRC.J39/600/2006).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • Găseşte firma după EUID (European Unique Identifier, identificatorul BRIS) şi întoarce profilul.

La ce folosește

  • Legarea unei firme româneşti de înregistrarea ei în sistemul european BRIS.
  • Reconcilierea datelor primite de la un partener din alt stat membru.
  • Verificarea identităţii unei firme într-un flux transfrontalier.

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.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, în grade zecimale (WGS 84).
sediu.rezolvat.coordonate.lng number Longitudinea, în grade zecimale (WGS 84).
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.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…).

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/dupa-euid/ROONRC.J40/7734/1992
{
    "data": {
        "cui": 3790028,
        "denumire": "TAI PAN 15 LTD IMPORT EXPORT SRL",
        "cod_inmatriculare": "J40/7734/1992",
        "euid": "ROONRC.J40/7734/1992",
        "forma_juridica": "SRL",
        "stare": {
            "cod": "1084",
            "denumire": "radiată",
            "categorie": "radiata"
        },
        "data_inmatriculare": "1992-03-31",
        "sediu": {
            "raw": {
                "judet": "Bucureşti",
                "localitate": "Bucureşti Sectorul 5",
                "strada": "Str. SEBASTIAN",
                "numar": "11",
                "bloc": "S30",
                "scara": "A",
                "etaj": "8",
                "apartament": "25",
                "sector": 5,
                "cod_postal": "63052"
            },
            "rezolvat": {
                "localitate_id": 13754,
                "localitate": "București Sectorul 5",
                "cod_siruta": 179187,
                "uat": "București",
                "judet": "București",
                "regiune": "București-Ilfov",
                "cod_nuts": "RO321",
                "populatie": 240288,
                "strada_id": null,
                "strada": null,
                "potrivire": {
                    "loc": "exact",
                    "str": "none"
                },
                "coordonate": {
                    "lat": 44.435278,
                    "lng": 26.102778,
                    "precizie": "localitate"
                }
            }
        },
        "caen_principal": null,
        "fiscal": {
            "platitor_tva": false,
            "tva_la_incasare": false,
            "split_tva": false,
            "inactiv_fiscal": false,
            "e_factura": false,
            "radiata": false
        },
        "prezente": {
            "nr_persoane": 0,
            "ani_financiar": [],
            "nr_achizitii": 0,
            "registre": []
        }
    }
}

Coduri de eroare

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