Business v1 / Firme

Financiar în EUR

Bilanţurile firmei convertite în euro la cursul BNR al zilei de închidere a fiecărui exerciţiu — ca anii să fie comparabili între ei şi cu date din afară.

GET

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

Parametri de cale

NumeTipDescriereExemplu

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

Parametri de interogare

Ruta nu acceptă parametri de interogare.

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.
Aceleaşi situaţii financiare, cu fiecare valoare convertită în EUR la cursul de sfârşit de an (BNR) al anului respectiv. Fiecare an poartă şi cursul folosit (curs_eur), ca să fie trasabilă conversia.
Conversia la cursul anului evită distorsiunea unei rate unice aplicate retroactiv — un leu din 2015 nu valorează cât un leu din 2024. Pentru comparaţii reale între ani, vezi şi /financiar/real.

La ce folosește

Raportare către parteneri sau investitori străini.
Comparaţii între firme din ţări diferite.

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/eur

{
    "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_eur": 27961404
                    }
                ],
                "curs_eur": 3.9852
            }
        ]
    }
}

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

{
    "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_eur": 1137626
                    }
                ],
                "curs_eur": 3.9852
            }
        ]
    }
}

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

{
    "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_eur": 2368455
                    }
                ],
                "curs_eur": 3.9852
            }
        ]
    }
}

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

{
    "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_eur": 17224
                    }
                ],
                "curs_eur": 4.2282
            }
        ]
    }
}

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	Ruta nu primeşte parametri, în afară de `lang`: orice alt parametru dă 422, nu e ignorat.
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": "Ruta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat.",
        "detalii": {
            "cui": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}