Business v1 / Firme

Grup (LEI)

Ierarhia de proprietate aşa cum o declară GLEIF prin codul LEI: societatea-mamă directă, cea finală şi filialele cunoscute. Există doar pentru firmele cu LEI.

GET

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

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ă

Grupul din care face parte firma, după ierarhia de proprietate declarată în sistemul LEI (societate-mamă directă şi ultimă). Disponibil doar pentru firmele cu cod LEI.

La ce folosește

Consolidarea expunerii pe grup, nu pe firmă, într-un portofoliu de credit.
Identificarea societăţii-mamă ultime pentru raportări de conformitate.
Trasarea proprietăţii transfrontaliere a unui partener.

Structura răspunsului

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

CâmpTipDescriere

lei string Codul LEI (Legal Entity Identifier).

copii[] object[] Firmele-copil din grup.

Exemple de răspuns

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

{
    "data": {
        "lei": "097900BFJD0000032849",
        "copii": []
    }
}

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

{
    "data": {
        "lei": null,
        "copii": []
    }
}

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

{
    "data": {
        "lei": "315700V12MDD9PTKU295",
        "copii": [
            {
                "lei": "315700JBDSJKQFG9Z785",
                "denumire": "Delivery Solutions SA",
                "cui": 23743772,
                "tara": "RO"
            }
        ]
    }
}

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 [{cui}] negă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."
            ]
        }
    }
}