Business v1 / Nomenclatoare

Forme juridice

Nomenclatorul formelor juridice (SRL, SA, PFA etc.), cu numărul de firme din fiecare.

GET

https://oneapi.ro/api/business/v1/forme-juridice

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Formele juridice (SRL, SA, PFA etc.) cu numărul de firme din fiecare — util pentru un selector sau pentru statistici de structură.

La ce folosește

Popularea unui selector de formă juridică într-un formular.
Analiza structurii mediului de afaceri pe forme de organizare.
Validarea valorii primite într-un import.

Structura răspunsului

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

CâmpTipDescriere

cod string Codul.

denumire string | null Denumirea.

este_persoana_fizica boolean Forma juridică e de persoană fizică (PFA, II, IF).

nr_firme integer Numărul de firme.

nr_firme_functiune integer

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/forme-juridice

{
    "data": [
        {
            "cod": "SRL",
            "denumire": "SRL",
            "este_persoana_fizica": false,
            "nr_firme": 2666704,
            "nr_firme_functiune": 1190772
        }
    ]
}

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.
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."
    }
}