Business v1 / Firme

Registre de autorizare

În ce registre (din cele 42: farmacii, școli, ONG, sancțiuni, emitenți BVB, energie etc.) apare firma,
cu detaliile intrării (atribute) și autoritatea sursei.

GET

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

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ă

Sumarul autorizărilor firmei pe registre (ANSVSA, ANAF, ANRSC etc.): fiecare registru cu numărul de intrări, nu fiecare intrare. O firmă poate avea sute de unităţi autorizate — detaliul e la ruta pe registru.
Intrările detaliate ale unui registru anume sunt la /firme/{cui}/registre/{registru}, paginate.

La ce folosește

O privire de ansamblu: în ce registre e autorizată firma şi cu câte intrări.
Verificarea faptului că un furnizor deţine autorizarea sectorială necesară.
Punctul de plecare pentru detaliu — cheia de registru se ia de aici.

Structura răspunsului

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

CâmpTipDescriere

nr_registre integer Numărul de registre în care apare.

registre[].registru string Cheia registrului (de folosit la /firme/{cui}/registre/{registru}).

registre[].denumire string | null Denumirea.

registre[].autoritate string | null Autoritatea care ţine registrul.

registre[].licenta string | null Licenţa sub care e publicat registrul.

registre[].nr_intrari integer Numărul de intrări.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/24890577/registre

{
    "data": {
        "nr_registre": 2,
        "registre": [
            {
                "registru": "ansvsa",
                "denumire": "Unități autorizate/înregistrate sanitar-veterinar (DSVSA județene)",
                "autoritate": "ANSVSA",
                "licenta": "ANSVSA – date publice",
                "nr_intrari": 3
            }
        ]
    }
}

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

{
    "data": {
        "nr_registre": 5,
        "registre": [
            {
                "registru": "anaf_datorii",
                "denumire": "Datorii către bugetul general consolidat",
                "autoritate": "ANAF",
                "licenta": "Guvernare Deschisă v1.0",
                "nr_intrari": 1
            }
        ]
    }
}

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

{
    "data": {
        "nr_registre": 8,
        "registre": [
            {
                "registru": "anpm_eee",
                "denumire": "Producători EEE (echipamente electrice/electronice) — registru ANMAP/ANPM",
                "autoritate": "ANMAP",
                "licenta": "Guvernare Deschisă v1.0",
                "nr_intrari": 1
            }
        ]
    }
}

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

{
    "data": {
        "nr_registre": 1,
        "registre": [
            {
                "registru": "mcpds_sponsorizari",
                "denumire": "Firme care au dedus sponsorizări către ONG-uri",
                "autoritate": "MCPDS",
                "licenta": "Guvernare Deschisă (data.gov.ro)",
                "nr_intrari": 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	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."
            ]
        }
    }
}