Business v1 / Statistici

Statistici TVA

Câte firme sunt plătitoare de TVA, câte la încasare, câte în split şi câte inactive fiscal — numere pe toată baza, nu pe un eşantion.

GET

https://oneapi.ro/api/business/v1/statistici/tva

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Agregate pe statutul de TVA: câţi plătitori, la încasare, în split, inactivi, cu e-Factura — imaginea de ansamblu a bazei de TVA.

La ce folosește

Dimensionarea bazei de plătitori de TVA, pentru un studiu de piaţă.
Estimarea audienţei unui produs care se adresează firmelor înrolate în e-Factura.
Contextul în care interpretezi statutul de TVA al unei firme.

Structura răspunsului

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

CâmpTipDescriere

platitori integer Câte firme sunt plătitoare de TVA.

la_incasare integer Câte aplică TVA la încasare.

split integer Câte aplică split TVA.

inactivi integer Câte sunt declarate inactive fiscal.

e_factura integer Înrolată în e-Factura.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/statistici/tva

{
    "data": {
        "platitori": 497537,
        "la_incasare": 125201,
        "split": 0,
        "inactivi": 559303,
        "e_factura": 286027
    }
}

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