Financiar v1 / Inflatie

Elementele costului forţei de muncă

Cele treisprezece elemente, cu nivelul şi cu intervalul de valabilitate al fiecăruia — cifra
care spune peste ce ani se poate compara şi peste care nu.

GET

https://oneapi.ro/api/financiar/v1/cost-forta-munca/elemente

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Elementele publicate în structura costului forţei de muncă, cu nivelul şi cu intervalul de valabilitate al fiecăruia — cifra care spune peste ce ani se poate compara şi peste care nu.
⚠️ Doar trei elemente acoperă tot intervalul 2000-2024: totalul şi cele două grupe. Detaliile încep în 2008, iar două dintre ele îşi schimbă definiţia pe parcurs — sursa o scrie chiar în numele rândului.
total e exact 100 peste tot: e o structură procentuală.

La ce folosește

Găsirea slugului de element înainte de a cere seria.
Verificarea anilor în care un element e comparabil cu el însuşi.

Structura răspunsului

CâmpTipDescriere

data.elemente integer

data.lista[].element string Elementul din nomenclator la care se referă valoarea.

data.lista[].denumire string Denumirea, aşa cum o publică sursa.

data.lista[].nivel string Nivelul din ierarhia clasificării — cu cât e mai adânc, cu atât e mai detaliat.

data.lista[].valabil_de_la integer Primul an publicat, măsurat din date.

data.lista[].valabil_pana_la integer

data.grupe array Cele două grupe care compun totalul de 100%.

data.nota_total string Ce cuprinde totalul şi ce rămâne în afara lui.

data.nota_valabilitate string

meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.

meta.nota_unitate string Ce trebuie ştiut despre unitatea de măsură înainte de a compara sau aduna valorile.

meta.fara_date data e null, iar aici stă motivul. Proiecţia peste datele INS e goală.

meta.fara_date_cod Cuvântul scurt şi STABIL al motivului, pentru clienţii care comută pe el în cod: fara_date e proză şi se poate reformula, ăsta nu.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/cost-forta-munca/elemente

{
    "data": {
        "elemente": 13,
        "lista": [
            {
                "element": "alte_cheltuieli",
                "denumire": "Alte cheltuieli",
                "nivel": "detaliu",
                "valabil_de_la": 2008,
                "valabil_pana_la": 2024
            }
        ],
        "grupe": [
            "cheltuieli_directe",
            "cheltuieli_indirecte"
        ],
        "nota_total": "`total` e exact 100 în toate cele 1.700 de celule: e o structură procentuală, nu o sumă de bani.",
        "nota_valabilitate": "⚠️ Componenţa se schimbă de două ori pe parcursul seriei, iar sursa o scrie chiar în numele rândurilor. Doar `total`, `cheltuieli_directe` şi `cheltuieli_indirecte` acoperă tot intervalul 2000-2024; detaliile încep în 2008. `contributie_somaj` ţine până în 2017 şi e înlocuită din 2018 de `contributie_asiguratorie_munca`; `fond_salarii` ţine până în 2019 şi devine `fond_salarii_si_alte_fonduri` din 2020. Nu se compară peste ruptură."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatorul matricei FOM112C (TEMPO).",
        "nota_unitate": "Toate valorile seriei sunt în procente din costul total."
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă sau invalid.
403	feature_indisponibil	`financiar.indici` nu e în planul curent.
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": "neautentificat",
        "mesaj": "Token lipsă sau invalid."
    }
}