Business v1 / Firme

Fonduri europene

Finanțările din fonduri europene ale firmei (după legarea beneficiar→CUI), paginat. Include programul,
titlul, suma totală și partea UE, anul și data semnării.

GET

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

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ă

Finanţările europene în care firma apare ca beneficiar, după legarea beneficiarilor la CUI. Legarea acoperă ~29% din înregistrări — restul sunt ONG-uri, instituţii publice sau beneficiari fără CUI potrivit.

La ce folosește

Verificarea dacă un partener a beneficiat de finanţare europeană.
Regula de cumul la ajutoare de stat: ce a primit deja firma.
Documentarea unui dosar de finanţare cu istoricul de beneficiar.

Structura răspunsului

CâmpTipDescriere

data[].id integer

data[].program string | null Programul de finanţare.

data[].titlu string | null Titlul proiectului.

data[].an integer | null Anul de referinţă.

data[].data_semnare string | null Data semnării.

data[].suma number | null Suma totală.

data[].suma_ue number | null Partea finanţată din fonduri europene.

data[].moneda string | null Moneda sumei.

data[].judet string | null Judeţul.

data[].sursa string | null Sursa datelor.

meta.paginare.pagina integer Pagina curentă.

meta.paginare.per_pagina integer Rezultate pe pagină.

meta.paginare.total integer Total rezultate.

meta.paginare.pagini integer Număr de pagini.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/6719278/fonduri

{
    "data": [],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 0,
            "pagini": 0
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/2054341/fonduri

{
    "data": [
        {
            "id": 1669553,
            "program": null,
            "titlu": "SC DAS SRL",
            "an": 2012,
            "data_semnare": "2012-07-19",
            "suma": 1570998.97,
            "suma_ue": null,
            "moneda": "RON",
            "judet": "NEAMT",
            "sursa": "data.gov.ro"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 5,
            "pagini": 1
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/35333601/fonduri

{
    "data": [
        {
            "id": 1751799,
            "program": null,
            "titlu": "Construire clinică medicală și amenajări aferente, mijloace de publicitate și împrejmuire teren",
            "an": 2021,
            "data_semnare": "2021-12-02",
            "suma": 2291918.33,
            "suma_ue": null,
            "moneda": "RON",
            "judet": "Arad",
            "sursa": "data.gov.ro"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1,
            "pagini": 1
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/16712013/fonduri

{
    "data": [
        {
            "id": 1752434,
            "program": null,
            "titlu": "Secție nouă de producție dispozitive de conexiune pentru fire și cabluri electrice",
            "an": 2021,
            "data_semnare": "2021-12-02",
            "suma": 3979942.27,
            "suma_ue": null,
            "moneda": "RON",
            "judet": "Timiș",
            "sursa": "data.gov.ro"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1,
            "pagini": 1
        }
    }
}

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 cu CUI [{cui}] nu a fost gă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."
            ]
        }
    }
}