oneapi
Autentificare
Business v1 / Firme

Proiecte Kohesio

Proiectele de coeziune în care firma e beneficiar, aşa cum le publică Comisia Europeană: bugetul în euro, fondul, programul şi perioada. Legătura la firmă se face prin numele beneficiarului, iar meta.legatura spune cât de sigură e.

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

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ă

  • Proiectele în care firma e beneficiar, după platforma Kohesio a Comisiei Europene. Sumele sunt în EURO şi la nivel de PROIECT, nu de contract — altă unitate decât la /firme/{cui}/fonduri.
  • Ordinea e după data de început, descrescător; proiectele fără dată stau la SFÂRŞIT.
  • ⚠️ Legătura la firmă NU vine de la sursă: Kohesio nu publică niciun cod fiscal, deci beneficiarii se leagă la CUI prin NUME. meta.legatura spune, pentru fiecare beneficiar, cât de sigură e potrivirea — exact (nume identic şi unic în registrul de firme), probabil (apropiat, confirmat de locaţie) ori manual (verificată de om). Citiţi-o înainte de a trata lista ca pe un fapt.
  • ⚠️ Sursa ţine DUBLURI de entitate: aceeaşi instituţie poate apărea de două ori, cu scrieri diferite ale numelui (CNAIR e şi Q7387008, şi Q3117516). De aceea meta.legatura e o LISTĂ, iar proiectele sunt reunite de la toate dublurile legate la acelaşi CUI.
  • ⚠️ Se suprapune cu /firme/{cui}/fonduri: aceleaşi programe 2014–2023, surse diferite. Nu însumaţi cele două fără deduplicare — aceiaşi bani s-ar număra de două ori.
  • Firmele nelegate răspund cu 200 şi zero proiecte, nu cu 404: firma există, doar n-are (ori n-a putut fi legată la) niciun proiect Kohesio. Din 12.124 de beneficiari, 9.377 sunt legaţi la o firmă (77,3%).

La ce folosește

  • Verificarea a ce a primit firma din fonduri de coeziune, aşa cum o raportează Comisia.
  • Regula de cumul la ajutoare de stat, pe sursa europeană — nu doar pe cea naţională.
  • Compararea cifrelor europene cu cele naţionale de la /firme/{cui}/fonduri, pe aceeaşi firmă.

Structura răspunsului

CâmpTipDescriere
data[].kohesio_id string Identificatorul proiectului în Kohesio (Q…); detaliul e la /fonduri/kohesio/{id}.
data[].titlu string | null Titlul proiectului.
data[].beneficiari[].nume string Numele beneficiarului, cum îl publică Kohesio.
data[].beneficiari[].kohesio_id string | null Identificatorul beneficiarului în Kohesio (Q…).
data[].buget_eur number | null Bugetul total al proiectului, în euro.
data[].buget_ue_eur number | null Partea finanţată din fonduri UE, în euro.
data[].fond string | null Fondul (FEDR, FSE, Fondul de coeziune…).
data[].program string | null Programul operaţional.
data[].regiune string | null Regiunea, în vocabularul Kohesio (rar completată).
data[].data_inceput string | null Data de început.
data[].data_sfarsit string | null Data de sfârşit.
data[].lat number | null Latitudinea (WGS84).
data[].lng number | null Longitudinea (WGS84).
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.
meta.legatura[].kohesio_id Beneficiarul Kohesio prin care s-a ajuns la proiecte.
meta.legatura[].nume Numele beneficiarului la sursă — forma pe care s-a făcut potrivirea.
meta.legatura[].potrivire Cât de sigură e legătura la firmă: exact, probabil ori manual.
meta.legatura[].nr_proiecte Câte proiecte are beneficiarul, după Kohesio.
meta.legatura[].buget_eur Bugetul total al beneficiarului, în euro.
meta.legatura[].buget_ue_eur Partea UE a bugetului beneficiarului, în euro.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/%7Bcui%7D/kohesio
{
    "data": "string"
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitFirma cu CUI [{cui}] nu a fost găsită.
422validareRuta nu primeşte parametri, în afară de paginare şi lang: orice alt parametru dă 422, nu e ignorat.
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": "Ruta nu primeşte parametri, în afară de paginare şi lang: orice alt parametru dă 422, nu e ignorat.",
        "detalii": {
            "cui": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}