Business v1 / Statistici ONRC

Chei disponibile

Valorile pe care le poate lua o dimensiune pentru un indicator: judeţele (cu cod SIRUTA),
activităţile CAEN, ţările sau formele juridice.

GET

https://oneapi.ro/api/business/v1/statistici/onrc/chei

Parametri de interogare

NumeTipDescriereValori acceptate

dimensiuneopțional string | null judet, caen, tara sau forma. Implicit prima defalcare publicată pentru indicator. ex. judet

indicatoropțional string | null Codul indicatorului (vezi /statistici/onrc/indicatori). ex. radieriex. inmatriculari

Cum se comportă

Vocabularul pentru ?cheie= din /statistici/onrc/serie. Numele sunt canonizate la import: judeţele poartă numele din nomenclatorul Locations, iar activităţile şi ţările o singură ortografie — sursa le scrie cu diacritice inconsecvente de la o lună la alta.
La filtrare nu trebuie reprodus numele exact: cheie=cluj, cheie=Cluj şi cheie=CLUJ duc la acelaşi judeţ. Pentru judeţe e oricum mai sigur cod= (SIRUTA).

La ce folosește

Popularea filtrului de defalcare — judeţ, activitate, formă juridică.
Verificarea numelui canonic al unei chei, înainte de a cere seria.
Legarea judeţelor de nomenclatorul Locations, care foloseşte aceleaşi nume.

Structura răspunsului

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

CâmpTipDescriere

indicator string Indicatorul cerut.

dimensiune string Defalcarea cerută.

chei[].cheie string Valoarea dimensiunii: numele judeţului, al activităţii CAEN, al ţării sau codul formei juridice.

chei[].cod string|null Codul SIRUTA al judeţului, acelaşi cu cel din modulul Locations. null la CAEN, ţări şi forme juridice, care n-au nomenclator comun.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/statistici/onrc/chei?indicator=radieri&dimensiune=judet

{
    "data": {
        "indicator": "radieri",
        "dimensiune": "judet",
        "chei": [
            {
                "cheie": "Alba",
                "cod": "10"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/statistici/onrc/chei?indicator=inmatriculari&dimensiune=judet

{
    "data": {
        "indicator": "inmatriculari",
        "dimensiune": "judet",
        "chei": [
            {
                "cheie": "Alba",
                "cod": "10"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/statistici/onrc/chei?indicator=radieri

{
    "data": {
        "indicator": "radieri",
        "dimensiune": "judet",
        "chei": [
            {
                "cheie": "Alba",
                "cod": "10"
            }
        ]
    }
}

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	Un parametru nu a trecut validarea (`dimensiune`, `indicator`); `detalii` spune care şi de ce.
429	cota_depasita	Cota lunară a planului a fost depăşită (vezi `Retry-After`).
dimensiune_invalida	eroare	Indicatorul nu e publicat pe defalcarea cerută — SRL-D există doar pe judeţe, capitalul străin doar pe ţări şi judeţe.
indicator_invalid	eroare	Indicatorul cerut nu există. Lista completă e în `/statistici/onrc/indicatori`.

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": "Un parametru nu a trecut validarea (dimensiune, indicator); detalii spune care şi de ce.",
        "detalii": {
            "dimensiune": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}