Business v1 / Persoane

Firmele unei persoane

Toate firmele în care persoana apare (administrator/asociat/lichidator etc.), cu rolul ei. Paginat.

GET

https://oneapi.ro/api/business/v1/persoane/{id}/firme

Parametri de cale

NumeTipDescriereExemplu

idobligatoriu string Identificatorul intern al persoanei — se obţine din răspunsurile de căutare, nu e un CNP.

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

„Nu are” e un răspuns, nu o eroare. Când entitatea există, dar lista e goală, răspunsul e 200 cu listă goală. 404 înseamnă doar că entitatea din cale nu există.
Firmele în care persoana apare, cu rolul în fiecare (administrator, asociat), paginate.

La ce folosește

Trasarea portofoliului unui administrator, cu rolul în fiecare firmă.
Verificarea unui potenţial conflict de interese, la achiziţii publice.
Construirea profilului de risc al unei persoane din firmele pe care le conduce.

Structura răspunsului

CâmpTipDescriere

data[].cui integer Codul fiscal.

data[].denumire string | null Denumirea.

data[].forma_juridica string | null Forma juridică (SRL, SA, PFA…).

data[].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[].judet string | null Judeţul.

data[].localitate string | null Localitatea.

data[].rol string | null Rolul deţinut (administrator, asociat…).

meta.paginare.pagina integer Pagina curentă.

meta.paginare.per_pagina integer Rezultate pe pagină.

meta.paginare.total integer Total rezultate.

meta.paginare.pagini integer Număr de pagini.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/persoane/1a316a50-157a-5cc5-a545-86f333631344/firme

{
    "data": [
        {
            "cui": 15733964,
            "denumire": "1WAY AUTO RENT SRL",
            "forma_juridica": "SRL",
            "stare": {
                "cod": "1084",
                "denumire": "radiată",
                "categorie": "radiata"
            },
            "judet": "Ilfov",
            "localitate": "Dragomirești-Vale",
            "rol": "reprezentant al persoanei juridice"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1878,
            "pagini": 94
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/persoane/85109718-b109-561c-b334-b1171d20ac7a/firme

{
    "data": [
        {
            "cui": 5866831,
            "denumire": "20 TH OU YA INTERNATIONAL TRADE SRL",
            "forma_juridica": "SRL",
            "stare": {
                "cod": "1084",
                "denumire": "radiată",
                "categorie": "radiata"
            },
            "judet": "București",
            "localitate": "București Sectorul 3",
            "rol": "reprezentant al persoanei juridice"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1868,
            "pagini": 94
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/persoane/431fd7d3-9df9-5072-9ab2-6360dcd437fe/firme

{
    "data": [
        {
            "cui": 17994729,
            "denumire": "NOC 2005 SRL",
            "forma_juridica": "SRL",
            "stare": {
                "cod": "1084",
                "denumire": "radiată",
                "categorie": "radiata"
            },
            "judet": "Hunedoara",
            "localitate": "Petroșani",
            "rol": "lichidator judiciar"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1,
            "pagini": 1
        }
    }
}

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	Persoana [{id}] 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": {
            "id": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}