Business v1 / Firme

Cod LEI

Codul LEI (Legal Entity Identifier) al firmei + status și ierarhia părinților (companie-mamă directă
și ultimă). 404 dacă firma nu are LEI înregistrat.

GET

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

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ă

„Nu are” e un răspuns, nu o eroare. Când firma există, dar n-are ce cere ruta, răspunsul e 200 cu data: null şi motivul în meta.fara_date. 404 înseamnă doar că firma (CUI-ul) nu există — aşa poţi deosebi cele două cazuri şi poţi păstra în cache răspunsul negativ.
Codul LEI al firmei (Legal Entity Identifier), starea lui şi ierarhia de părinţi (societate-mamă directă şi ultimă). Dacă firma n-are LEI, răspunsul e 200 cu data: null şi motivul în meta.fara_date.

La ce folosește

Obţinerea codului LEI cerut la raportările tranzacţiilor financiare.
Verificarea faptului că LEI-ul unui partener e încă valid.
Legarea firmei de seturile de date internaţionale, care folosesc LEI ca cheie.

Structura răspunsului

CâmpTipDescriere

data.lei string Codul LEI (Legal Entity Identifier).

data.status string | null Statusul.

data.status_inregistrare string | null Statusul înregistrării LEI la autoritatea emitentă.

data.inregistrat_la string | null Când a fost înregistrat codul LEI.

data.jurisdictie string | null Jurisdicţia sub care e emis codul LEI.

data.categorie string | null Categoria.

data.parinte_direct.lei string | null Codul LEI (Legal Entity Identifier).

data.parinte_direct.nume string | null Numele.

data.parinte_direct.tara string | null Ţara.

data.parinte_ultim.lei string | null Codul LEI (Legal Entity Identifier).

data.parinte_ultim.nume string | null Numele.

data.parinte_ultim.tara string | null Ţara.

meta.fara_date string Doar când răspunsul e gol: de ce nu există date (de pildă „Firma nu are cod LEI înregistrat la GLEIF.”). Lipseşte când data e completat.

meta.fara_date_cod string Cuvântul scurt şi STABIL al motivului, pentru clienţii care comută pe el în cod: fara_date e proză şi se poate reformula, ăsta nu.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/2054341/lei

{
    "data": {
        "lei": "097900BFJD0000032849",
        "status": "ACTIVE",
        "status_inregistrare": "LAPSED",
        "inregistrat_la": "RA000497",
        "jurisdictie": "RO",
        "categorie": "GENERAL",
        "parinte_direct": null,
        "parinte_ultim": null
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/6719278/lei

{
    "data": null,
    "meta": {
        "fara_date": "Firma nu are cod LEI înregistrat la GLEIF.",
        "fara_date_cod": "fara_lei"
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/14399840/lei

{
    "data": {
        "lei": "315700V12MDD9PTKU295",
        "status": "ACTIVE",
        "status_inregistrare": "ISSUED",
        "inregistrat_la": "RA000497",
        "jurisdictie": "RO",
        "categorie": "GENERAL",
        "parinte_direct": {
            "lei": "254900R8IVV4VMYUSZ81",
            "nume": "MIH B2C Holdings B.V.",
            "tara": "NL"
        },
        "parinte_ultim": {
            "lei": "21380044BQ8812EEKT59",
            "nume": "NASPERS",
            "tara": "ZA"
        }
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
404	negasit	Firma cu CUI [{cui}] nu a fost găsită.
422	validare	Ruta nu primeşte parametri, în afară de `lang`: orice alt parametru dă 422, nu e ignorat.
429	cota_depasita	Cota 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."
            ]
        }
    }
}