Business v1 / Statistici ONRC

Catalog indicatori ONRC

Ce serii există, pe ce dimensiuni, pe ce interval — şi, esenţial, ce fel de mărime e fiecare:
flux_cumulat (cumulat de la 1 ianuarie), flux_lunar sau stoc.

GET

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

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Punctul de plecare pentru restul familiei /statistici/onrc/*: ce indicatori există, pe ce defalcări sunt publicaţi şi pe ce interval — acoperirea e citită din date, nu declarată.
⚠️ Câmpul natura decide cum se citeşte o cifră. Cei cinci indicatori de flux (înmatriculări, radieri, suspendări, dizolvări, insolvenţe) sunt publicaţi de ONRC cumulat de la 1 ianuarie: valoarea lui iunie e totalul ianuarie–iunie, nu al lunii iunie. Adunarea a douăsprezece luni ar da un număr de câteva ori mai mare decât realitatea.
Seriile sunt agregate oficiale, aşa cum le-a publicat ONRC la data aceea. Nu se recalculează din registrul nostru: cifra pentru martie 2019 rămâne cifra buletinului din martie 2019, chiar dacă între timp firmele s-au schimbat. De aceea răspunsurile de aici pot să nu coincidă cu /statistici/firme, care numără registrul la zi.

La ce folosește

Aflarea ce serii lunare există, înainte de a construi un grafic.
Verificarea intervalului acoperit, ca să nu ceri ani fără date.
Popularea unui selector de indicator într-un tablou de bord.

Structura răspunsului

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

CâmpTipDescriere

indicatori[].cod string Codul indicatorului, de folosit în ?indicator=.

indicatori[].denumire string Numele indicatorului, aşa cum îl publică ONRC.

indicatori[].natura string Ce fel de mărime e: flux_cumulat (cumulat de la 1 ianuarie, se resetează în ianuarie), flux_lunar (valoarea lunii) sau stoc (situaţia la data buletinului). Citirea unei serii fără să ştii asta duce la cifre plauzibile şi greşite.

indicatori[].unitate string Unitatea de măsură: firme, societăţi, mii lei, mii EUR, USD etc.

indicatori[].dimensiuni[] string Defalcările pe care sursa le publică pentru indicatorul ăsta: judet, caen, forma, tara.

indicatori[].sursa string Buletinul ONRC din care vine seria.

indicatori[].acoperire[].dimensiune string Defalcarea la care se referă rândul de acoperire.

indicatori[].acoperire[].chei integer Câte valori distincte are dimensiunea (42 de judeţe, ~50 de activităţi, ~58 de ţări).

indicatori[].acoperire[].prima_luna string Prima lună acoperită, ca AAAA-LL.

indicatori[].acoperire[].ultima_luna string Ultima lună acoperită, ca AAAA-LL.

indicatori[].acoperire[].valori integer Câte valori măsurate există pe combinaţia asta.

dimensiuni[] string Toate defalcările din modul, ca vocabular pentru ?dimensiune=.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/statistici/onrc/indicatori

{
    "data": {
        "indicatori": [
            {
                "cod": "inmatriculari",
                "denumire": "Înmatriculări",
                "natura": "flux_cumulat",
                "unitate": "firme",
                "dimensiuni": [
                    "judet",
                    "caen",
                    "forma"
                ],
                "sursa": "Buletinul statistic lunar ONRC — înmatriculări",
                "acoperire": [
                    {
                        "dimensiune": "caen",
                        "chei": 27,
                        "prima_luna": "2013-08",
                        "ultima_luna": "2026-07",
                        "valori": 3407
                    }
                ]
            }
        ],
        "dimensiuni": [
            "judet",
            "caen",
            "tara",
            "forma"
        ]
    }
}

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