oneapi
Autentificare
Financiar v1 / Inflatie

Salariaţii pe forme de proprietate

Număr mediu, efectiv la sfârşitul anului, câştig net şi câştig brut — pe forme de proprietate,
categorii de salariaţi şi sexe, pe 68 de activităţi CAEN Rev.2, anual din 2000.

E dimensiunea „în ce fel de firmă" pe care /financiar/v1/salariati n-o are.

⚠️ Câştigurile sunt medii şi nu se adună — nici pe forme de proprietate, nici pe sexe. Măsurat,
identităţile ar ieşi 0 din 2.967, respectiv 0 din 3.629. Seriile lor poartă este_medie, iar
identităţile se rulează doar pe măsurile-număr.

⚠️ categorie nu e o partiţie: are doar total şi muncitori, iar muncitorii sunt un subset.

GET
https://oneapi.ro/api/financiar/v1/salariati/proprietate

Parametri de interogare

NumeTipDescriereValori acceptate
de_laopțional integer | null Opţional, an, din 2000. 2000 – 2100
pana_laopțional integer | null Opţional, an. 2000 – 2100
caen_versiuneopțional string | null Opţional: revizia codului din caen — 1, 2 sau 3 — când forma lui e ambiguă (4932 înseamnă altceva în Rev.2 şi în Rev.3). Fără ea, codul se caută întâi în revizia seriei. 123
indicatorlistăopțional text Opţional: numar_mediu, efectiv, castig_net, castig_brut. numar_mediuefectivcastig_netcastig_brut
forma_proprietatelistăopțional text Opţional: total, privata, publica. totalprivatapublica
categorielistăopțional text Opţional: total, muncitori. Nu e o partiţie. totalmuncitori
sexlistăopțional text Opţional: total, masculin, feminin. totalmasculinfeminin
caenlistăopțional text Opţional, coduri separate prin virgulă: orice cod CAEN — secţiune (C), diviziune (62), grupă, clasă (6201) — din orice revizie. Se aduce la secţiunea, diviziunea ori intervalul publicat (CAEN Rev.2); ce s-a folosit e în meta.caen. ex. K
gruparelistăopțional text Opţional, separate prin virgulă: agregatele sursei care nu sunt coduri CAEN — total ori intervalele de diviziuni comasate (02-03, 38-39, 59-60, 62-63). Nu se trimite împreună cu caen. ex. 02-03ex. 38-39ex. 59-60

Cum se comportă

  • Numărul mediu al salariaţilor, efectivul de la sfârşitul anului, câştigul net şi câştigul brut — 47.084 de valori, anual din 2000 până în 2024, din matricile TEMPO FOM104G, FOM105G, FOM106F şi FOM107F. Patru indicatori × 3 forme de proprietate × 2 categorii × 3 sexe × 68 de activităţi CAEN Rev.2.
  • E dimensiunea „în ce fel de firmă" pe care /financiar/v1/salariati n-o are — acolo defalcarea e pe activitate, judeţ şi sex.
  • ⚠️ castig_net şi castig_brut sunt MEDII şi nu se adună — nici pe forme de proprietate, nici pe sexe. Măsurat: identităţile ies 0 din 2.967 şi 0 din 3.629 pe câştiguri, pe când pe măsurile-număr se închid integral. Seriile de câştig poartă este_medie, iar ruta nu rulează identităţile pe ele. E aceeaşi regulă ca la /financiar/v1/salariati.
  • ✅ Pe măsurile-număr: total = privata + publica — 2.967/2.967 la numărul mediu şi 2.959/2.959 la efectiv; total = masculin + feminin — 3.629/3.629 şi 3.829/3.829.
  • ⚠️ categorie NU e o partiţie. Are doar total şi muncitori, iar muncitorii sunt un subset, nu jumătatea totalului. Nu există identitate acolo şi ruta nu inventează una.
  • Pentru efectivul lunar, fără forme de proprietate: /financiar/v1/salariati/lunar.
  • Activitatea se cere ca pe toată platforma. caen primeşte orice cod CAEN, de orice nivel şi din orice revizie, iar ruta îl aduce la ce publică seria — urcând la părinte ori traducându-l prin corespondenţa oficială INS; meta.caen spune codul cerut, cel folosit şi dacă a fost urcat ori convertit. grupare e pentru agregatele sursei care nu sunt coduri CAEN.

La ce folosește

  • Ponderea sectorului privat în ocuparea unei ramuri, în serie lungă.
  • Diferenţa de câştig între privat şi public, pe aceeaşi activitate.
  • Diferenţa de câştig între femei şi bărbaţi, pe formă de proprietate.
  • Ponderea muncitorilor în efectivul unei ramuri.

Structura răspunsului

CâmpTipDescriere
data.de_la integer Începutul intervalului acoperit de răspuns.
data.pana_la integer Sfârşitul intervalului acoperit de răspuns, inclusiv.
data.filtre.indicator array Indicatorul statistic la care se referă valoarea.
data.ani array Anii pentru care există valori.
data.serii[].indicator string Indicatorul statistic la care se referă valoarea.
data.serii[].unitate string numar persoane la efective, lei la câştiguri.
data.serii[].este_medie boolean Prezent pe cele două măsuri de câştig: sunt medii şi nu se adună pe nicio dimensiune.
data.serii[].forma_proprietate string
data.serii[].categorie string Categoria din clasificarea sursei.
data.serii[].sex string Sexul persoanelor la care se referă valoarea.
data.serii[].caen string Codul CAEN al activităţii, în revizia seriei.
data.serii[].forma_cod string
data.serii[].activitate string Activitatea economică la care se referă valoarea.
data.serii[].valori object Valorile seriei, pe perioade.
data.identitati.toleranta string Cât se acceptă ca abatere înainte ca identitatea să fie considerată neînchisă — rotunjirea sursei, nu o eroare.
data.identitati.nota_medii string Cum se citesc mediile din răspuns şi când mediana spune altceva.
data.identitati.nota_categorii string De ce nu există identitate pe categorii de salariaţi.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.acoperire.de_la integer Prima perioadă pentru care avem date.
meta.acoperire.pana_la integer Ultima perioadă pentru care avem date.
meta.serii_returnate integer Câte serii s-au întors efectiv, după filtre şi după plafonul de celule.
meta.nota_medii string Cum se citesc mediile din răspuns şi când mediana spune altceva.
meta.nota_categorii string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_judete string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.fara_date data e null, iar aici stă motivul. Proiecţia peste datele INS e goală. Ca la celelalte serii.
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.
meta.caen[] object[] Cum s-a înţeles parametrul caen: codul cerut, revizia în care s-a citit şi codul pe care l-a folosit ruta. La o listă de coduri, câte un obiect pe cod.
meta.caen[].cerut string Codul CAEN trimis, normalizat (litere mari, fără puncte).
meta.caen[].versiune_cerut string Revizia în care s-a citit codul trimis: cea din caen_versiune, altfel prima în care există.
meta.caen[].folosit string Codul pe care l-a folosit seria: cel cerut, primul lui părinte publicat ori agregatul sursei care îl cuprinde (02-03).
meta.caen[].nivel string Nivelul codului folosit — la rutele de firme, al codului cerut: sectiune, subsectiune, diviziune, grupa, clasa sau agregat.
meta.caen[].denumire string Denumirea codului, din nomenclatorul CAEN.
meta.caen[].versiune_serie string Revizia CAEN în care publică seria.
meta.caen[].conversie boolean true când codul a fost tradus dintr-o revizie în alta prin corespondenţa oficială INS.
meta.caen[].urcat boolean true când seria nu publică codul cerut şi s-a folosit un nivel superior.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/salariati/proprietate?indicator=castig_net&de_la=2020&pana_la=2023
{
    "data": {
        "de_la": 2020,
        "pana_la": 2023,
        "filtre": {
            "indicator": [
                "castig_net"
            ]
        },
        "ani": [
            2020,
            2021,
            2022,
            2023
        ],
        "serii": [
            {
                "indicator": "castig_net",
                "unitate": "lei",
                "este_medie": true,
                "forma_proprietate": "privata",
                "categorie": "total",
                "sex": "feminin",
                "caen": "01",
                "forma_cod": "diviziune",
                "activitate": "01 Agricultura, vanatoare si servicii anexe",
                "valori": {
                    "2020": "2170",
                    "2021": "2305",
                    "2022": "3020",
                    "2023": "3480"
                }
            }
        ],
        "identitati": {
            "toleranta": "0.5",
            "nota_medii": "⚠️ `castig_net` şi `castig_brut` sunt MEDII şi nu se adună: nici pe forme de proprietate, nici pe sexe. Măsurat, identităţile ar ieşi 0 din 2.967, respectiv 0 din 3.629. Seriile lor poartă `este_medie`.",
            "nota_categorii": "⚠️ `categorie` nu e o partiţie: are doar `total` şi `muncitori`, iar muncitorii sunt un subset. Nu există identitate acolo."
        }
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — salariaţii şi câştigurile pe categorii, forme de proprietate şi activităţi (TEMPO, matricile FOM104G, FOM105G, FOM106F şi FOM107F).",
        "acoperire": {
            "de_la": 2000,
            "pana_la": 2024
        },
        "serii_returnate": 583,
        "nota_medii": "⚠️ `castig_net` şi `castig_brut` sunt MEDII şi nu se adună: nici pe forme de proprietate, nici pe sexe. Măsurat, identităţile ar ieşi 0 din 2.967, respectiv 0 din 3.629. Seriile lor poartă `este_medie`.",
        "nota_categorii": "⚠️ `categorie` nu e o partiţie: are doar `total` şi `muncitori`, iar muncitorii sunt un subset. Nu există identitate acolo.",
        "nota_judete": "Aceiaşi salariaţi pe judeţe şi sexe, fără forme de proprietate: /financiar/v1/salariati."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă sau invalid.
403feature_indisponibilfinanciar.indici nu e în planul curent.
404caen_nepublicatNici codul, nici părinţii lui nu sunt publicaţi în serie; detalii.disponibile dă cheile. grupare_nepublicata — gruparea nu e în serie; răspunsul dă lista.
422caen_inexistentCodul din caen nu există în nicio revizie CAEN; e o valoare de FILTRU greşită, deci 422, nu 404. raspuns_prea_mare — peste 20.000 de celule. Plus indicator, formă, categorie, sex, cod ori an în afara formei aşteptate. caen şi grupare trimise împreună, caen_versiune fără caen, ori un cod fără forma CAEN.
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": "caen_inexistent",
        "mesaj": "Codul din caen nu există în nicio revizie CAEN; e o valoare de FILTRU greşită, deci 422, nu 404. raspuns_prea_mare — peste 20.000 de celule. Plus indicator, formă, categorie, sex, cod ori an în afara formei aşteptate. caen şi grupare trimise împreună, caen_versiune fără caen, ori un cod fără forma CAEN.",
        "detalii": {
            "de_la": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}