oneapi
Autentificare
Business v1 / Statistici

Trend înfiinţări

Numărul de firme înmatriculate pe an (implicit), pe lună (?pe=luna&luni=24) ori pe zi (?pe=zi&zile=90),
opţional într-un judeţ (?judet=CJ). Seriile lunare şi zilnice se termină la cea mai nouă înmatriculare din
registru şi au 0 în perioadele fără înmatriculări.

GET
https://oneapi.ro/api/business/v1/statistici/infiintari

Parametri de interogare

NumeTipDescriereValori acceptate
peopțional string | null an (implicit), luna ori zi. anlunazi
zileopțional integer | null Lungimea seriei zilnice (pe=zi): implicit 90, maxim 366. 1 – 366
luniopțional integer | null Lungimea seriei lunare (pe=luna): implicit 24, maxim 240. 1 – 240
judetopțional string | null Judeţul sediului: indicativul auto (CJ) ori numele. ex. CJ

Cum se comportă

  • Seria temporală a numărului de firme înmatriculate pe an — pulsul demografic al mediului de afaceri.
  • Cu pe=luna (ultimele luni luni, implicit 24) ori pe=zi (ultimele zile zile, implicit 90), seria e lunară ori zilnică. Fereastra se termină la cea mai nouă înmatriculare din registru, nu azi — registrul ONRC vine lunar, iar zilele de după ultima ediţie ar părea goale. Intervalul e în meta.interval.
  • Perioadele fără nicio înmatriculare apar cu nr_firme: 0, ca seria să se poată desena direct.
  • judet restrânge la firmele cu sediul (de azi) în judeţ. Firmele cu sediul nelegat de nomenclatorul de localităţi nu intră la filtrarea pe judeţ.

La ce folosește

  • Un grafic de evoluţie a înmatriculărilor, într-un raport sau pe un site.
  • Corelarea demografiei de afaceri cu indicatori macroeconomici.
  • Identificarea anilor de expansiune şi de contracţie.

Structura răspunsului

CâmpTipDescriere
data.pe_an[].an integer Anul de referinţă.
data.pe_an[].nr_firme integer Numărul de firme.
meta.pe string Pasul seriei: an, luna ori zi.
meta.judet string Judeţul cerut, dacă e cazul.
meta.interval object La seriile lunare şi zilnice, intervalul acoperit: {de, pana}; pana e cea mai nouă înmatriculare din registru.
data.pe_luna[].luna string Luna (AAAA-LL).
data.pe_luna[].nr_firme integer Firmele înmatriculate în lună.
data.pe_zi[].data string Ziua (AAAA-LL-ZZ).
data.pe_zi[].nr_firme integer Firmele înmatriculate în zi; 0 în zilele fără înmatriculări (weekend, sărbători).

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/statistici/infiintari
{
    "data": {
        "pe_an": [
            {
                "an": 1990,
                "nr_firme": 74
            }
        ]
    },
    "meta": {
        "pe": "an"
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitResursa cerută nu există.
422filtru_necunoscutJudeţul din judet nu există; detalii.camp spune care.
422validareUn parametru nedeclarat ori o valoare care nu trece validarea (pe, zile fără pe=zi, luni fără pe=luna, judet). Câmpul vinovat e în detalii.
429cota_depasitaCota 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": "filtru_necunoscut",
        "mesaj": "Judeţul din judet nu există; detalii.camp spune care.",
        "detalii": {
            "pe": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}