Business v1 / Meta

Acoperire date

Volumul datelor per categorie (nr. rânduri estimat, din statisticile Postgres — instant).

GET

https://oneapi.ro/api/business/v1/meta/acoperire

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Sunt rânduri, nu entităţi distincte. La situatii_financiare cele două nu coincid: Finanţele publică acelaşi exerciţiu şi în setul general, şi în cel specializat pe tipul entităţii, deci un (CUI, an) poate avea două rânduri — iar API-ul serveşte o singură raportare pe an. Numărul de raportări distincte e deci mai mic decât cifra de aici.
Câte înregistrări are fiecare set de date din modul (firme, activităţi, achiziţii, bilanţuri, persoane etc.), citite instant din statisticile tabelelor — o măsură a acoperirii.

La ce folosește

Verificarea, înainte de a integra, cât de mari sunt seturile de date.
Un panou de stare care arată câte înregistrări are fiecare felie.
Detectarea unei căderi de import, când o cifră scade brusc.

Structura răspunsului

CâmpTipDescriere

data.firme integer Firmele găsite.

data.stare_fiscala integer Secţiunea de stare fiscală (aceeaşi formă ca /firme/{cui}/fiscal).

data.activitati integer Secţiunea de activităţi CAEN.

data.persoane integer Secţiunea de persoane.

data.situatii_financiare integer Secţiunea de situaţii financiare.

data.achizitii integer Secţiunea de achiziţii publice.

data.fonduri_europene integer Secţiunea de fonduri europene.

data.firme_conexe integer Secţiunea de firme conexe.

data.registre_intrari integer Secţiunea de intrări în registre.

meta.unitate string Ce numără cifrele: rânduri stocate.

meta.nota string De ce cifrele numără rânduri, nu raportări distincte.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/meta/acoperire

{
    "data": {
        "firme": 3909449,
        "stare_fiscala": 3908658,
        "activitati": 19163960,
        "persoane": 3031993,
        "situatii_financiare": 15671717,
        "achizitii": 17831182,
        "fonduri_europene": 175705,
        "firme_conexe": 2145456,
        "registre_intrari": 1546326
    },
    "meta": {
        "metoda": "estimare",
        "sursa": "statistici Postgres (pg_stat_user_tables)",
        "unitate": "rânduri stocate",
        "nota": "Cifrele sunt rânduri, nu entităţi distincte. La `situatii_financiare`, acelaşi exerciţiu al unei firme poate fi publicat de Finanţe în două seturi (cel general şi cel specializat pe tipul entităţii), deci raportările distincte sunt mai puţine decât rândurile. API-ul serveşte o singură raportare pe an."
    }
}

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