Business v1 / Firme

Financiar ajustat la inflaţie

Aceleaşi bilanţuri, dar deflaţionate la un an de bază: cifra de afaceri a lui 2015 exprimată în puterea de cumpărare a anului pe care îl alegi. Creşterea nominală şi cea reală nu sunt acelaşi lucru.

GET

https://oneapi.ro/api/business/v1/firme/{cui}/financiar/real

Parametri de cale

NumeTipDescriereExemplu

cuiobligatoriu string Codul de identificare fiscală al firmei, fără prefixul RO (ex. 6719278).

Parametri de interogare

NumeTipDescriereValori acceptate

baza_anopțional integer | null Anul de referinţă pentru preţuri. Implicit anul curent. 1990 – 2100

Cum se comportă

Ruta nu cere ca firma să fie în registrul comerţului. Ministerul Finanţelor primeşte raportări şi de la entităţi din afara ONRC — asociaţii, fundaţii, instituţii: 103.953 de entităţi, cu 905.993 de rânduri. Pentru ele, bilanţurile se servesc normal, dar /firme/{cui} răspunde 404, fiindcă profil în registru chiar nu există. data.in_registru_onrc spune de care caz e vorba, ca 404-ul de pe profil să nu pară o inconsecvenţă.
Când o firmă a depus de două ori pentru acelaşi an, se serveşte raportarea din setul specializat (cea completă), nu oglinda generică web. Dacă cele două chiar se contrazic pe cifre — 17 cazuri în toată baza, toate pe 2009 — anul poartă câmpul conflict, cu familia cealaltă şi indicatorii care diferă. Sursa nu dă nici dată de depunere, nici marcaj de rectificare, deci nu putem spune care cifră e cea corectă; o arătăm pe cea mai completă şi semnalăm că a existat un dezacord.
Situaţiile financiare deflaţionate la preţurile unui an de bază, folosind indicele preţurilor de consum (IPC) cumulat. Formula: valoare_reală = valoare_nominală × IPC(bază) / IPC(an).
Anul de bază se dă cu ?baza_an= (implicit anul curent). Aşa poţi vedea dacă o creştere de cifră de afaceri e reală sau doar efect de inflaţie — o firmă poate creşte „pe hârtie" şi totuşi să scadă în termeni reali.

La ce folosește

Analiza creşterii reale, curăţată de inflaţie.
Comparaţii corecte între ani îndepărtaţi.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

CâmpTipDescriere

cui integer Codul fiscal.

in_registru_onrc boolean Dacă entitatea are şi profil la /firme/{cui}. false pentru cele care raportează la Finanţe fără să fie în registrul comerţului.

ani[] object[] Bilanţurile pe ani, cu indicatorii fiecăruia.

ani[].conflict[].familie Cealaltă raportare depusă pentru acelaşi an. Apare doar când cifrele chiar diferă.

ani[].conflict[].indicatori[] Codurile indicatorilor pe care cele două raportări nu sunt de acord. Lipsa şi zero nu se numără ca dezacord.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/6719278/financiar/real

{
    "data": {
        "cui": 6719278,
        "in_registru_onrc": true,
        "ani": [
            {
                "an": 2008,
                "tip": "SOCIETATI COMERCIALE CARE DEPUN BILANT LUNG, BILANT SCURT SI RAPORTARI ANUALE",
                "familie": "web",
                "caen": 4711,
                "decodat": true,
                "indicatori": [
                    {
                        "cod": "I1",
                        "denumire": "ACTIVE IMOBILIZATE - TOTAL",
                        "valoare": 111431788,
                        "valoare_reala": 251987872
                    }
                ]
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/14399840/financiar/real

{
    "data": {
        "cui": 14399840,
        "in_registru_onrc": true,
        "ani": [
            {
                "an": 2008,
                "tip": "SOCIETATI COMERCIALE CARE DEPUN BILANT LUNG, BILANT SCURT SI RAPORTARI ANUALE",
                "familie": "web",
                "caen": 4754,
                "decodat": true,
                "indicatori": [
                    {
                        "cod": "I1",
                        "denumire": "ACTIVE IMOBILIZATE - TOTAL",
                        "valoare": 4533669,
                        "valoare_reala": 10252277
                    }
                ]
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/2054341/financiar/real

{
    "data": {
        "cui": 2054341,
        "in_registru_onrc": true,
        "ani": [
            {
                "an": 2008,
                "tip": "SOCIETATI COMERCIALE CARE DEPUN BILANT LUNG, BILANT SCURT SI RAPORTARI ANUALE",
                "familie": "web",
                "caen": 1439,
                "decodat": true,
                "indicatori": [
                    {
                        "cod": "I1",
                        "denumire": "ACTIVE IMOBILIZATE - TOTAL",
                        "valoare": 9438768,
                        "valoare_reala": 21344493
                    }
                ]
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/24890577/financiar/real

{
    "data": {
        "cui": 24890577,
        "in_registru_onrc": true,
        "ani": [
            {
                "an": 2009,
                "tip": "SOCIETATI COMERCIALE CARE DEPUN BILANT LUNG, BILANT SCURT SI RAPORTARI ANUALE",
                "familie": "webblbssl",
                "caen": 4619,
                "decodat": true,
                "indicatori": [
                    {
                        "cod": "I1",
                        "denumire": "ACTIVE IMOBILIZATE - TOTAL",
                        "valoare": 72827,
                        "valoare_reala": 157218
                    }
                ]
            }
        ]
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
404	negasit	Firma [{cui}] negăsită.
422	validare	Un parametru nedeclarat ori o valoare care nu trece validarea (`baza_an`). Câmpul vinovat e în `detalii`.
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 nedeclarat ori o valoare care nu trece validarea (baza_an). Câmpul vinovat e în detalii.",
        "detalii": {
            "cui": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}