Business v1 / Statistici ONRC

Serie temporală

Evoluţia lunară a unui indicator, opţional pentru o singură cheie (cheie=Cluj sau cod=54984).
Fără cheie, întoarce totalul pe ţară.

La indicatorii flux_cumulat, fiecare punct are şi valoare_luna — diferenţa faţă de luna
precedentă a aceluiaşi an. E null acolo unde nu se poate calcula onest: în prima lună a seriei
sau peste o lună lipsă.

GET

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

Parametri de interogare

NumeTipDescriereValori acceptate

cheieopțional string | null Numele cheii, potrivit fără diacritice şi fără majuscule (cluj, Cluj, CLUJ merg la fel). Fără ea, seria e totalul pe ţară. ex. Clujex. iasi

codopțional string | null Codul SIRUTA al judeţului — alternativă mai sigură la cheie pentru dimensiunea judet. ex. inmatriculariex. insolventaex. srl_d_functiune

de_laopțional string | null Prima lună inclusă, ca AAAA-LL. ex. 2024-01ex. 2025-01

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

formaopțional string | null Restrânge la o formă juridică (SRL, PFA, II…), pe o dimensiune care nu e deja forma. ex. SRL

indicatoropțional string | null Codul indicatorului (vezi /statistici/onrc/indicatori). ex. inmatriculariex. insolventaex. srl_d_functiune

pana_laopțional string | null Ultima lună inclusă, ca AAAA-LL. ex. 2024-12

Cum se comportă

Seria lunară a unui indicator, pentru o cheie (cheie=Cluj sau cod=127) sau, fără cheie, pentru toată ţara. Intervalul se taie cu de_la şi pana_la, scrise ca AAAA-LL.
La indicatorii cumulaţi, valoare_luna e cifra pe care o vrei de obicei într-un grafic: diferenţa faţă de luna precedentă. Nu e inventată acolo unde nu se poate deduce — dacă o lună lipseşte din serie, punctul următor are valoare_luna: null în loc de o diferenţă care ar acoperi două luni.
Cu dimensiune=forma, seria e a unei forme juridice (cheie=SRL, PFA, II…), însumată peste judeţe. Sursa desface înmatriculările pe formă doar în foaia de judeţe, deci defalcarea asta există numai la înmatriculări.

La ce folosește

Un grafic de evoluţie lunară a insolvenţelor dintr-un judeţ.
Compararea a două judeţe sau a două activităţi pe acelaşi indicator.
Alimentarea unui tablou de bord economic cu serii oficiale.

Structura răspunsului

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

CâmpTipDescriere

indicator.cod string Codul indicatorului.

indicator.denumire string Numele lui.

indicator.natura string flux_cumulat, flux_lunar sau stoc — determină cum se citesc valorile.

indicator.unitate string Unitatea de măsură.

indicator.dimensiuni[] string Defalcările publicate pentru indicator.

indicator.sursa string Buletinul de provenienţă.

dimensiune string Defalcarea pe care s-a filtrat.

cheie string|null Cheia pentru care e seria, sau null dacă e totalul pe ţară.

puncte[].an integer Anul punctului.

puncte[].luna integer Luna punctului (1-12).

puncte[].perioada string Anul şi luna ca AAAA-LL — de folosit direct ca etichetă pe grafic.

puncte[].valoare number Valoarea publicată. La indicatorii flux_cumulat e cumulatul de la 1 ianuarie, nu al lunii.

puncte[].valoare_an_anterior number|null Aceeaşi perioadă din anul precedent, aşa cum o publică sursa. null unde buletinul n-o dă.

puncte[].valoare_luna number|null Valoarea lunii, calculată ca diferenţă faţă de luna precedentă a aceluiaşi an. Apare doar la flux_cumulat. E null acolo unde nu se poate calcula onest: în prima lună a seriei sau peste o lună lipsă.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/statistici/onrc/serie?indicator=inmatriculari&dimensiune=judet&cheie=Cluj&de_la=2024-01&pana_la=2024-12

{
    "data": {
        "indicator": {
            "cod": "inmatriculari",
            "denumire": "Înmatriculări",
            "natura": "flux_cumulat",
            "unitate": "firme",
            "dimensiuni": [
                "judet",
                "caen",
                "forma"
            ],
            "sursa": "Buletinul statistic lunar ONRC — înmatriculări"
        },
        "dimensiune": "judet",
        "cheie": "Cluj",
        "puncte": [
            {
                "an": 2024,
                "luna": 1,
                "perioada": "2024-01",
                "valoare": 715,
                "valoare_an_anterior": 607,
                "valoare_luna": 715
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/statistici/onrc/serie?indicator=insolventa&de_la=2024-01

{
    "data": {
        "indicator": {
            "cod": "insolventa",
            "denumire": "Intrări în insolvenţă",
            "natura": "flux_cumulat",
            "unitate": "firme",
            "dimensiuni": [
                "judet",
                "caen"
            ],
            "sursa": "Buletinul statistic lunar ONRC — insolvenţe"
        },
        "dimensiune": "judet",
        "cheie": null,
        "puncte": [
            {
                "an": 2024,
                "luna": 1,
                "perioada": "2024-01",
                "valoare": 509,
                "valoare_an_anterior": 436,
                "valoare_luna": 509
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/statistici/onrc/serie?indicator=srl_d_functiune&cheie=iasi&de_la=2025-01

{
    "data": {
        "indicator": {
            "cod": "srl_d_functiune",
            "denumire": "SRL-D în funcţiune",
            "natura": "stoc",
            "unitate": "firme",
            "dimensiuni": [
                "judet"
            ],
            "sursa": "Raportul SRL-D"
        },
        "dimensiune": "judet",
        "cheie": "Iași",
        "puncte": [
            {
                "an": 2025,
                "luna": 1,
                "perioada": "2025-01",
                "valoare": 1045,
                "valoare_an_anterior": null
            }
        ]
    }
}

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 (`cheie`, `cod`, `de_la` ş.a.); `detalii` spune care şi de ce.
429	cota_depasita	Cota lunară a planului a fost depăşită (vezi `Retry-After`).
cheie_negasita	eroare	Cheia nu există pe defalcarea aleasă — vezi `/statistici/onrc/chei`.
dimensiune_invalida	eroare	Indicatorul nu e publicat pe defalcarea cerută.
indicator_invalid	eroare	Indicatorul cerut nu există.
perioada_invalida	eroare	Perioadele se scriu ca `AAAA-LL` (ex. `2024-03`).

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 (cheie, cod, de_la ş.a.); detalii spune care şi de ce.",
        "detalii": {
            "cheie": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}