Financiar v1 / Inflatie

Catalogul activităţilor pentru populaţia ocupată

Codurile pe care se publică populaţia ocupată, separat pe cele două clasificări CAEN, cu denumirea
exactă de la sursă şi nivelul fiecăruia.

GET

https://oneapi.ro/api/financiar/v1/populatie-ocupata/activitati

Parametri de interogare

NumeTipDescriereValori acceptate

versiuneopțional string | null Opţional: rev2 (implicit) sau rev1. rev1rev2

Cum se comportă

Codurile pe care se publică populaţia ocupată, separat pe cele două clasificări CAEN, cu denumirea exactă de la sursă şi nivelul fiecăruia.
Rev.2 are 21 de coduri: 19 secţiuni, total şi industrie. Rev.1 are tot 21, dar altfel împărţite: 14 secţiuni, total, industrie şi patru agregate scrise în clar.
⚠️ Codurile nu se transferă între clasificări: J înseamnă „Intermedieri financiare" în Rev.1 şi „Informaţii şi comunicaţii" în Rev.2.

La ce folosește

Găsirea codului potrivit înainte de a cere seria.
Compararea structurii celor două clasificări.

Structura răspunsului

CâmpTipDescriere

data.versiune_caen string Revizia din care vine seria servită.

data.activitati integer Activităţile pentru care există valori.

data.pe_nivel object Câte coduri are fiecare nivel în clasificarea cerută.

data.pe_nivel.agregat integer Agregatul din care face parte valoarea.

data.pe_nivel.sectiune integer Secţiunea din clasificare — nivelul cel mai larg.

data.pe_nivel.total integer

data.niveluri.agregat[].caen string Codul CAEN al activităţii, în revizia seriei.

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

data.niveluri.agregat[].cerere.grupare string Valoarea de trimis în grupare: cheia e un agregat al sursei, nu un cod CAEN.

data.niveluri.sectiune[].caen string Codul CAEN al activităţii, în revizia seriei.

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

data.niveluri.sectiune[].cerere.caen string Codul CAEN de trimis în caen pentru cheia asta.

data.niveluri.total[].caen string Codul CAEN al activităţii, în revizia seriei.

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

data.niveluri.total[].cerere.grupare string Valoarea de trimis în grupare: cheia e un agregat al sursei, nu un cod CAEN.

data.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.nota_versiune string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.

data.niveluri[].denumire Denumirea exactă publicată de INS.

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/populatie-ocupata/activitati

{
    "data": {
        "versiune_caen": "rev2",
        "activitati": 21,
        "pe_nivel": {
            "agregat": 1,
            "sectiune": 19,
            "total": 1
        },
        "niveluri": {
            "agregat": [
                {
                    "caen": "industrie",
                    "denumire": "INDUSTRIE",
                    "cerere": {
                        "grupare": "industrie"
                    }
                }
            ],
            "sectiune": [
                {
                    "caen": "A",
                    "denumire": "A  AGRICULTURA, SILVICULTURA SI PESCUIT",
                    "cerere": {
                        "caen": "A"
                    }
                }
            ],
            "total": [
                {
                    "caen": "total",
                    "denumire": "TOTAL",
                    "cerere": {
                        "grupare": "total"
                    }
                }
            ]
        },
        "nota": "Codul `industrie` e un agregat peste secţiunile B, C, D, E, nu o secţiune."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — clasificările CAEN aşa cum apar în matricile FOM103A şi FOM103D (TEMPO).",
        "nota_versiune": "`rev1` şi `rev2` au coduri şi denumiri diferite; codul cerut trebuie să fie din clasificarea potrivită."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/populatie-ocupata/activitati?versiune=rev1

{
    "data": {
        "versiune_caen": "rev1",
        "activitati": 21,
        "pe_nivel": {
            "agregat": 1,
            "grupa": 5,
            "sectiune": 14,
            "total": 1
        },
        "niveluri": {
            "agregat": [
                {
                    "caen": "industrie",
                    "denumire": "Industrie",
                    "cerere": {
                        "grupare": "industrie"
                    }
                }
            ],
            "grupa": [
                {
                    "caen": "agricultura_vanatoare",
                    "denumire": "Agricultura, vanatoare",
                    "cerere": {
                        "caen": "01"
                    }
                }
            ],
            "sectiune": [
                {
                    "caen": "A",
                    "denumire": "A Agricultura, vanatoare si silvicultura",
                    "cerere": {
                        "caen": "A"
                    }
                }
            ],
            "total": [
                {
                    "caen": "total",
                    "denumire": "Total",
                    "cerere": {
                        "grupare": "total"
                    }
                }
            ]
        },
        "nota": "Rev.1 amestecă secţiunile CAEN cu câteva agregate scrise în clar („Industrie\", „Transport si depozitare\"), care apar la nivelul `grupa` şi nu intră în partiţia secţiunilor."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — clasificările CAEN aşa cum apar în matricile FOM103A şi FOM103D (TEMPO).",
        "nota_versiune": "`rev1` şi `rev2` au coduri şi denumiri diferite; codul cerut trebuie să fie din clasificarea potrivită."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/populatie-ocupata/activitati?versiune=rev2

{
    "data": {
        "versiune_caen": "rev2",
        "activitati": 21,
        "pe_nivel": {
            "agregat": 1,
            "sectiune": 19,
            "total": 1
        },
        "niveluri": {
            "agregat": [
                {
                    "caen": "industrie",
                    "denumire": "INDUSTRIE",
                    "cerere": {
                        "grupare": "industrie"
                    }
                }
            ],
            "sectiune": [
                {
                    "caen": "A",
                    "denumire": "A  AGRICULTURA, SILVICULTURA SI PESCUIT",
                    "cerere": {
                        "caen": "A"
                    }
                }
            ],
            "total": [
                {
                    "caen": "total",
                    "denumire": "TOTAL",
                    "cerere": {
                        "grupare": "total"
                    }
                }
            ]
        },
        "nota": "Codul `industrie` e un agregat peste secţiunile B, C, D, E, nu o secţiune."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — clasificările CAEN aşa cum apar în matricile FOM103A şi FOM103D (TEMPO).",
        "nota_versiune": "`rev1` şi `rev2` au coduri şi denumiri diferite; codul cerut trebuie să fie din clasificarea potrivită."
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă sau invalid.
403	feature_indisponibil	`financiar.indici` nu e în planul curent.
422	validare	Un parametru nu a trecut validarea (`versiune`); `detalii` spune care şi de ce.
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 nu a trecut validarea (versiune); detalii spune care şi de ce.",
        "detalii": {
            "versiune": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}