oneapi
Autentificare
Financiar v1 / Inflatie

Nomenclatorul valorii serviciilor

Categoriile fiecărui beneficiar şi ale fiecărei revizii CAEN, cu nivelul, măsurile publicate şi
anii lor, plus anii de bază ai indicilor şi formele de proprietate. Nomenclatoarele celor două
revizii nu se traduc unul în altul, de aceea sunt date separat.

GET
https://oneapi.ro/api/financiar/v1/servicii/valoare/nomenclator

Parametri de interogare

NumeTipDescriereValori acceptate
beneficiaropțional string | null Beneficiarul serviciului: populatie, intreprinderi sau transport_posta_telecom. populatieintreprinderitransport_posta_telecom

Cum se comportă

  • Categoriile fiecărui beneficiar şi ale fiecărei revizii CAEN, cu nivelul, măsurile publicate şi anii lor, plus anii de bază ai indicilor şi formele de proprietate.
  • ⚠️ Nomenclatoarele celor două revizii nu se traduc unul în altul şi nici cele ale beneficiarilor între ele — de aceea sunt date separat, nu într-o listă comună.

La ce folosește

  • Găsirea slugului corect în revizia potrivită perioadei studiate.
  • Verificarea anilor în care o categorie chiar are date publicate.

Structura răspunsului

CâmpTipDescriere
data.baze[] array Cei doi ani de bază ai indicilor anuali, cu ce înseamnă fiecare.
data.baze[].baza string
data.baze[].descriere string Explicaţia în cuvinte a valorii.
data.proprietati array
data.beneficiari[].beneficiar string Beneficiarul la care se referă valoarea.
data.beneficiari[].descriere string Explicaţia în cuvinte a valorii.
data.beneficiari[].revizii[] array Reviziile în care apare acel beneficiar — transport_posta_telecom e doar în Rev.1.
data.beneficiari[].revizii[].revizie string Revizia sursei din care vin valorile; reviziile nu se compară între ele.
data.beneficiari[].revizii[].categorii[].categorie string Categoria din clasificarea sursei.
data.beneficiari[].revizii[].categorii[].denumire string Denumirea, aşa cum o publică sursa.
data.beneficiari[].revizii[].categorii[].cerere.grupare string Valoarea de trimis în grupare: cheia e un agregat al sursei, nu un cod CAEN.
data.beneficiari[].revizii[].categorii[].nivel string Nivelul din ierarhia clasificării — cu cât e mai adânc, cu atât e mai detaliat.
data.beneficiari[].revizii[].categorii[].masuri array Dacă acea categorie e publicată ca valoare, ca indice ori ca amândouă.
data.beneficiari[].revizii[].categorii[].de_la integer Începutul intervalului acoperit.
data.beneficiari[].revizii[].categorii[].pana_la integer Sfârşitul intervalului acoperit, inclusiv.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.nota_revizii 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ă.
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/servicii/valoare/nomenclator
{
    "data": {
        "baze": [
            {
                "baza": "1993",
                "descriere": "indice cu bază fixă: anul 1993 = 100"
            }
        ],
        "proprietati": [
            "total",
            "stat",
            "privata"
        ],
        "beneficiari": [
            {
                "beneficiar": "intreprinderi",
                "descriere": "servicii prestate întreprinderilor şi agenţilor economici",
                "revizii": [
                    {
                        "revizie": "caen_rev1",
                        "categorii": [
                            {
                                "categorie": "activitati_juridice_contabilitate_si_revizie_contabila",
                                "denumire": "Activitati juridice, contabilitate si revizie contabila",
                                "cerere": {
                                    "grupare": "activitati_juridice_contabilitate_si_revizie_contabila"
                                },
                                "nivel": "categorie",
                                "masuri": [
                                    "valoare"
                                ],
                                "de_la": 1998,
                                "pana_la": 2008
                            }
                        ]
                    }
                ]
            }
        ]
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatoarele matricilor PSC101-PSC104 (TEMPO).",
        "nota_revizii": "Nomenclatoarele celor două revizii CAEN nu se traduc unul în altul. Indicii anuali există doar la populaţie, iar cei doi au ani de bază diferiţi — nu se pun în aceeaşi serie."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă sau invalid.
403feature_indisponibilfinanciar.indici nu e în planul curent.
422validareUn parametru nu a trecut validarea (beneficiar); detalii spune care şi de ce.
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": "validare",
        "mesaj": "Un parametru nu a trecut validarea (beneficiar); detalii spune care şi de ce.",
        "detalii": {
            "beneficiar": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}