Financiar v1 / Inflatie
Salariaţii pe secţiuni CAEN Rev.1
Numărul mediu şi efectivul, pe 19 rânduri CAEN Rev.1 × 56 de teritorii, anual 1990-2008 —
singura serie de salariaţi pe activitate care coboară la judeţ înainte de 2008.
⚠️ Nomenclatorul amestecă niveluri: 12 secţiuni cu literă, patru subsecţiuni fără literă
(jumătăţile secţiunilor A şi I), agregatul parţial industrie şi restul celelalte. Numai cele 16
plus restul compun totalul; industrie NU intră.
⚠️ Masculinul nu e publicat — sursa dă doar total şi feminin. Îl derivăm prin scădere, cu
derivat: true, iar dacă scăderea iese negativă întoarcem null, nu zero.
GET
https://oneapi.ro/api/financiar/v1/salariati/istoric
Parametri de interogare
NumeTipDescriereValori acceptate
nivel_teritoriuopțional
string | null
Opţional:
tara, macroregiune, regiune, judet.
taramacroregiuneregiunejudet
de_laopțional
integer | null
Opţional, an, din 1990.
1990 – 2008
pana_laopțional
integer | null
Opţional, an, până în 2008.
1990 – 2008
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. Doar efectivul are dimensiunea sexului.
numar_mediuefectiv
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 CAEN Rev.1 (sursa o scrie cu literă mică, c) ori diviziunea pe care sursa o numeşte (01 = agricultura, 02 = silvicultura, 64 = posta; 60–63 intră în transport); ce s-a folosit e în meta.caen.
ex. 01,D
gruparelistăopțional
text
Opţional, separate prin virgulă: agregatele sursei care nu sunt coduri CAEN —
total, industrie (C+D+E, agregat parţial), celelalte, transport (diviziunile 60–63). Nu se trimite împreună cu caen.
ex. total
categorielistăopțional
text
Opţional:
total, muncitori.
totalmuncitori
teritoriulistăopțional
text
Opţional, coduri scurte separate prin virgulă.
ex. cluj
Cum se comportă
- Numărul mediu şi efectivul salariaţilor, pe secţiuni CAEN Rev.1 şi teritorii — 102.739 de valori, anual din 1990 până în 2008, din matricile TEMPO
FOM104AşiFOM105B. Singura serie de salariaţi pe activitate care coboară la judeţ înainte de 2008. - ⚠️ Nomenclatorul amestecă niveluri în clar. Cele 19 rânduri sunt: 12 secţiuni cu literă (
b…n), patru subsecţiuni fără literă —agriculturaşisilvicultura(cele două jumătăţi ale secţiunii A),transportşiposta(jumătăţile secţiunii I) — plus agregatul parţialindustrie, restulcelelalteşi totalul. Câmpulnivel_sectiunele desparte. - ✅
total= cele 12 secţiuni cu literă + cele 4 subsecţiuni +celelalte: 1.471 din 1.471. ⚠️industrieNU intră în sumă — e agregat parţial:industrie=c+d+e, verificat 1.891 din 1.891. - ✅ Teritoriul
total= suma celor 42 de judeţe: 667/667 la numărul mediu şi 1.236/1.236 la efectiv. - ⚠️ Masculinul nu e publicat. La efectiv, sursa dă doar
totalşifeminin. Îl derivăm prin scădere şi îl marcăm cuderivat: true; acolo unde scăderea iese negativă — ceea ce nu poate fi real — întoarcemnull, nu zero, şi raportăm câte celule au ieşit aşa. E aceeaşi regulă ca la/financiar/v1/populatie-ocupata. - ⚠️ Numărul mediu (
FOM104A) n-are deloc dimensiunea sexului; doar efectivul o are. - ⚠️ Bucureştiul are două coduri, fiindcă teritoriul s-a schimbat în 1996.
mun_bucuresti_incl_sai(1990-1995) cuprinde şi Sectorul Agricol Ilfov; din 1996 apar separatmunicipiul_bucurestişi judeţulilfov. Nu le lipim — nu e acelaşi teritoriu; pentru o serie continuă pe toată perioada foloseşte regiuneabucuresti_ilfov. - Pentru seria CAEN Rev.2, din 2000 încoace:
/financiar/v1/salariatişi/financiar/v1/salariati/proprietate. Nomenclatoarele nu se lipesc. - Activitatea se cere ca pe toată platforma.
caenprimeş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.caenspune codul cerut, cel folosit şi dacă a fost urcat ori convertit.gruparee pentru agregatele sursei care nu sunt coduri CAEN.
La ce folosește
- Dezindustrializarea anilor '90, pe judeţe şi pe secţiuni.
- Ponderea femeilor într-o secţiune, înainte de 2008.
- Structura ocupării unui judeţ în perioada tranziţiei.
Structura răspunsului
CâmpTipDescriere
data.unitate
string
Unitatea de măsură a valorilor. Citeşte-o înainte de a le pune pe un grafic sau de a le aduna.
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.filtre.sectiune
array
Secţiunea din clasificare — nivelul cel mai larg.
data.filtre.categorie
array
Categoria din clasificarea sursei.
data.filtre.nivel_teritoriu
string
Nivelul teritorial al valorii (ţară, regiune, judeţ, localitate).
data.ani
array
Anii pentru care există valori.
data.serii[].indicator
string
Indicatorul statistic la care se referă valoarea.
data.serii[].unitate
string
Unitatea de măsură a valorilor. Citeşte-o înainte de a le pune pe un grafic sau de a le aduna.
data.serii[].categorie
string
Categoria din clasificarea sursei.
data.serii[].sectiune
string
Secţiunea din clasificare — nivelul cel mai larg.
data.serii[].denumire_sectiune
string
data.serii[].nivel_sectiune
string
total, sectiune, subsectiune, agregat_partial ori rest. Numai primele trei şi restul compun totalul.
data.serii[].teritoriu
string
Teritoriul la care se referă valoarea.
data.serii[].denumire_teritoriu
string
Denumirea exactă de la sursă, aşa cum e scrisă în matricea ei.
data.serii[].nivel_teritoriu
string
Nivelul teritorial al valorii (ţară, regiune, judeţ, localitate).
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.teritorii.verificari
integer
Câte combinaţii au fost verificate.
data.identitati.teritorii.inchise
integer
Câte verificări s-au închis în toleranţă.
data.identitati.teritorii.identitate
string
Identitatea verificată — ce sumă trebuie să dea ce total.
data.identitati.teritorii.nota
string
Precizare despre cum se citesc datele — o capcană, o convenţie sau o limită a sursei.
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_niveluri
string
Ce înseamnă fiecare nivel şi care dintre ele se pot compara.
meta.nota_rev2
string
Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
data.serii[].derivat
Prezent pe seriile masculine, calculate prin scădere.
data.identitati.masculin_derivat
object
Câte serii au fost derivate şi câte celule au ieşit negative.
meta.fara_date
data e null, iar aici stă motivul. Proiecţia peste datele INS e goală. Codul nu apare în nomenclator. 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[].cod
string
Codul CAEN pe care îl reprezintă cheia folosită, când seria îşi numeşte activităţile altfel (
agricultura = 01) ori când cheia e un agregat (62-63).
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/istoric?nivel_teritoriu=tara&indicator=numar_mediu&categorie=total&grupare=total&de_la=2000&pana_la=2008
{
"data": {
"unitate": "numar persoane",
"de_la": 2000,
"pana_la": 2008,
"filtre": {
"indicator": [
"numar_mediu"
],
"sectiune": [
"total"
],
"categorie": [
"total"
],
"nivel_teritoriu": "tara"
},
"ani": [
2000,
2001,
2002,
2003,
2004,
2005,
2006,
2007,
2008
],
"serii": [
{
"indicator": "numar_mediu",
"unitate": "numar persoane",
"categorie": "total",
"sectiune": "total",
"denumire_sectiune": "Total",
"nivel_sectiune": "total",
"teritoriu": "total",
"denumire_teritoriu": "TOTAL",
"nivel_teritoriu": "tara",
"valori": {
"2000": "4623026",
"2001": "4618988",
"2002": "4567820",
"2003": "4590876",
"2004": "4468837",
"2005": "4558910",
"2006": "4667254",
"2007": "4885319",
"2008": "5046317"
}
}
],
"identitati": {
"toleranta": "1",
"teritorii": {
"verificari": 9,
"inchise": 9,
"identitate": "teritoriul `total` = suma celor 42 de judeţe",
"nota": "Verificat pe toată proiecţia: 667/667 la numărul mediu şi 1.236/1.236 la efectiv."
}
}
},
"meta": {
"sursa": "Institutul Naţional de Statistică — salariaţii pe categorii, activităţi CAEN Rev.1 şi judeţe (TEMPO, matricile FOM104A şi FOM105B).",
"acoperire": {
"de_la": 1990,
"pana_la": 2008
},
"serii_returnate": 1,
"nota_niveluri": "`industrie` e agregat parţial peste `c`, `d` şi `e`; nu intră în total. `celelalte` e restul, nu o secţiune.",
"nota_rev2": "Pentru seria CAEN Rev.2, din 2000: /financiar/v1/salariati şi /financiar/v1/salariati/proprietate."
}
}
GEThttps://oneapi.ro/api/financiar/v1/salariati/istoric?caen=01,D&nivel_teritoriu=tara&de_la=2005
{
"data": {
"unitate": "numar persoane",
"de_la": 2005,
"pana_la": 2008,
"filtre": {
"sectiune": [
"agricultura",
"d"
],
"nivel_teritoriu": "tara"
},
"ani": [
2005,
2006,
2007,
2008
],
"serii": [
{
"indicator": "efectiv",
"unitate": "numar persoane",
"sex": "feminin",
"categorie": "muncitori",
"sectiune": "agricultura",
"denumire_sectiune": "Agricultura, vanatoare",
"nivel_sectiune": "subsectiune",
"teritoriu": "total",
"denumire_teritoriu": "TOTAL",
"nivel_teritoriu": "tara",
"valori": {
"2005": "18432",
"2006": "17251",
"2007": "17155",
"2008": null
}
}
],
"identitati": {
"toleranta": "1",
"teritorii": {
"verificari": 42,
"inchise": 42,
"identitate": "teritoriul `total` = suma celor 42 de judeţe",
"nota": "Verificat pe toată proiecţia: 667/667 la numărul mediu şi 1.236/1.236 la efectiv."
},
"masculin_derivat": {
"explicatie": "Sursa publică doar `total` şi `feminin`; `masculin` e derivat prin scădere şi poartă `derivat: true`.",
"serii_derivate": 4
}
}
},
"meta": {
"sursa": "Institutul Naţional de Statistică — salariaţii pe categorii, activităţi CAEN Rev.1 şi judeţe (TEMPO, matricile FOM104A şi FOM105B).",
"acoperire": {
"de_la": 1990,
"pana_la": 2008
},
"serii_returnate": 16,
"nota_niveluri": "`industrie` e agregat parţial peste `c`, `d` şi `e`; nu intră în total. `celelalte` e restul, nu o secţiune.",
"nota_masculin": "Sursa publică doar `total` şi `feminin`; `masculin` e derivat prin scădere şi poartă `derivat: true`.",
"nota_rev2": "Pentru seria CAEN Rev.2, din 2000: /financiar/v1/salariati şi /financiar/v1/salariati/proprietate.",
"caen": [
{
"cerut": "01",
"versiune_cerut": "Rev.1",
"folosit": "agricultura",
"cod": "01",
"nivel": "diviziune",
"denumire": "Agricultură, vânătoare și servicii anexe",
"versiune_serie": "Rev.1",
"conversie": false,
"urcat": false
}
]
}
}
GEThttps://oneapi.ro/api/financiar/v1/salariati/istoric?nivel_teritoriu=judet&teritoriu=cluj&de_la=1995&pana_la=2005
{
"data": {
"unitate": "numar persoane",
"de_la": 1995,
"pana_la": 2005,
"filtre": {
"teritoriu": [
"cluj"
],
"nivel_teritoriu": "judet"
},
"ani": [
1995,
1996,
1997,
1998,
1999,
2000,
2001,
2002,
2003,
2004,
2005
],
"serii": [
{
"indicator": "efectiv",
"unitate": "numar persoane",
"sex": "feminin",
"categorie": "muncitori",
"sectiune": "agricultura",
"denumire_sectiune": "Agricultura, vanatoare",
"nivel_sectiune": "subsectiune",
"teritoriu": "cluj",
"denumire_teritoriu": "Cluj",
"nivel_teritoriu": "judet",
"valori": {
"1995": "1286",
"1996": "1109",
"1997": "1000",
"1998": "876",
"1999": "769",
"2000": "399",
"2001": "555",
"2002": "424",
"2003": null,
"2004": "451",
"2005": "343"
}
}
],
"identitati": {
"toleranta": "1",
"total": {
"identitate": "`total` = cele douăsprezece secţiuni cu literă + cele patru subsecţiuni + `celelalte`",
"nota": "Verificat pe toată proiecţia: 1.471 din 1.471. ⚠️ `industrie` NU intră: e agregat parţial peste `c`, `d` şi `e`.",
"verificari": 51,
"inchise": 51
},
"industrie": {
"identitate": "`industrie` = `c` + `d` + `e`",
"nota": "Agregat parţial peste industria extractivă, cea prelucrătoare şi energia. Verificat: 1.891 din 1.891.",
"verificari": 65,
"inchise": 65
},
"masculin_derivat": {
"explicatie": "Sursa publică doar `total` şi `feminin`; `masculin` e derivat prin scădere şi poartă `derivat: true`.",
"serii_derivate": 38
}
}
},
"meta": {
"sursa": "Institutul Naţional de Statistică — salariaţii pe categorii, activităţi CAEN Rev.1 şi judeţe (TEMPO, matricile FOM104A şi FOM105B).",
"acoperire": {
"de_la": 1990,
"pana_la": 2008
},
"serii_returnate": 152,
"nota_niveluri": "`industrie` e agregat parţial peste `c`, `d` şi `e`; nu intră în total. `celelalte` e restul, nu o secţiune.",
"nota_masculin": "Sursa publică doar `total` şi `feminin`; `masculin` e derivat prin scădere şi poartă `derivat: true`.",
"nota_identitate": "Verificat pe acest răspuns: totalul e suma celor şaptesprezece rânduri în 51 din 51 celule.",
"nota_rev2": "Pentru seria CAEN Rev.2, din 2000: /financiar/v1/salariati şi /financiar/v1/salariati/proprietate."
}
}
Coduri de eroare
| Cod | Slug | Când apare |
|---|---|---|
| 401 | neautentificat | Token lipsă sau invalid. |
| 403 | feature_indisponibil | financiar.indici nu e în planul curent. |
| 404 | caen_nepublicat | Nici 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. |
| 422 | caen_inexistent | 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, secţiune, categorie, teritoriu ori an în afara formei aşteptate; seria se opreşte în 2008. caen şi grupare trimise împreună, caen_versiune fără caen, ori un cod fără forma CAEN. |
| 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": "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, secţiune, categorie, teritoriu ori an în afara formei aşteptate; seria se opreşte în 2008. caen şi grupare trimise împreună, caen_versiune fără caen, ori un cod fără forma CAEN.",
"detalii": {
"nivel_teritoriu": [
"Valoarea trimisă nu respectă regula parametrului."
]
}
}
}