Business v1 / Nomenclatoare

Indicatori financiari

Dicţionarul rândurilor de bilanţ: ce înseamnă fiecare cod din situaţiile financiare, pe familie şi pe an, fiindcă formularele s-au schimbat de-a lungul timpului.

GET

https://oneapi.ro/api/business/v1/indicatori-financiari

Parametri de interogare

NumeTipDescriereValori acceptate

anopțional integer | null Anul exerciţiului financiar, ca să vezi indicatorii publicaţi pentru el. ex. 2023ex. 2022

familieopțional string | null Familia de raportare (web, webbanci, webasig…). Familiile specializate publică toţi indicatorii; web îi omite pe cei nuli. ex. webasig

Cum se comportă

Dicţionarul indicatorilor financiari (codurile „I1…In" din bilanţuri şi denumirile lor prietenoase, pe familie şi an) — referinţa după care se decodează /firme/{cui}/financiar.

La ce folosește

Decodarea codurilor de bilanţ în denumiri, la afişarea situaţiilor financiare.
Construirea propriilor indicatori derivaţi, ştiind ce reprezintă fiecare cod.
Referinţa după care se citeşte răspunsul de la /firme/{cui}/financiar.

Structura răspunsului

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

CâmpTipDescriere

familie string Familia de indicatori financiari.

an integer Anul de referinţă.

cod string Codul.

denumire string Denumirea.

ordine integer Ordinea de afişare.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/indicatori-financiari?an=2023

{
    "data": [
        {
            "familie": "webasig",
            "an": 2023,
            "cod": "I1",
            "denumire": "Imobilizari necorporale",
            "ordine": 1
        }
    ]
}

GEThttps://oneapi.ro/api/business/v1/indicatori-financiari?an=2022

{
    "data": [
        {
            "familie": "webasig",
            "an": 2022,
            "cod": "I1",
            "denumire": "Imobilizari necorporale",
            "ordine": 1
        }
    ]
}

GEThttps://oneapi.ro/api/business/v1/indicatori-financiari?familie=webasig

{
    "data": [
        {
            "familie": "webasig",
            "an": 2008,
            "cod": "I1",
            "denumire": "Asigurari generale",
            "ordine": 1
        }
    ]
}

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 nedeclarat ori o valoare care nu trece validarea (`an`, `familie`). Câmpul vinovat e în `detalii`.
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": "Un parametru nedeclarat ori o valoare care nu trece validarea (an, familie). Câmpul vinovat e în detalii.",
        "detalii": {
            "an": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}