oneapi
Autentificare
Business v1 / Firme

Intrări dintr-un registru

Intrările detaliate ale firmei într-un anumit registru (ex. toate unitățile ANSVSA), cu atribute
complet. Paginat. registru = cheia din sumarul de la /registre.

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

Parametri de cale

NumeTipDescriereExemplu
cuiobligatoriu string Codul de identificare fiscală al firmei, fără prefixul RO (ex. 6719278).
registruobligatoriu string Cheia registrului sectorial din care se cer înregistrările firmei.

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • „Nu are” e un răspuns, nu o eroare. Când entitatea există, dar lista e goală, răspunsul e 200 cu listă goală. 404 înseamnă doar că entitatea din cale nu există.
  • Intrările detaliate ale firmei într-un registru anume, cu atributele fiecărei intrări (unitate, adresă, activitate autorizată), paginate. Cheia registrului o iei din sumarul de la /firme/{cui}/registre.

La ce folosește

  • Listarea unităţilor autorizate ale unui operator, cu adresa şi activitatea fiecăreia.
  • Verificarea autorizării exact pentru punctul de lucru care te interesează.
  • Export pentru audit: toate intrările firmei într-un registru, paginat.

Structura răspunsului

CâmpTipDescriere
data[].nume_in_registru string | null Numele sub care apare firma în registru — poate diferi de denumirea oficială.
data[].incredere_potrivire string | null Cât de sigură e potrivirea, şi pe CE s-a făcut. ⚠️ Spune cât de bună a fost potrivirea de DENUMIRE, nu că s-a potrivit un cod fiscal: când sursa nu publică CUI (are_cui: false în nomenclator), legătura se face exclusiv pe nume, iar exact înseamnă „numele s-a potrivit exact", nu „firma e confirmată". Măsurat: ted_ro are are_cui: false şi 122.002 rânduri exact. Valori: exact (denumire identică după normalizare), probabil (potrivire bună peste prag), ambiguu (mai mulţi candidaţi la fel de buni — cui rămâne null), none (nicio potrivire). Citeşte-l împreună cu are_cui al listei.
data[].valabil_de_la string | null De când e valabilă intrarea.
data[].valabil_pana_la string | null Până când e valabilă intrarea.
data[].atribute[] mixed Atributele brute publicate de registru, cu numele lor originale.
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/24890577/registre/mcpds_sponsorizari
{
    "data": [
        {
            "nume_in_registru": "UNIVERS-ALL DISTRIBUTION SRL",
            "incredere_potrivire": "exact",
            "valabil_de_la": null,
            "valabil_pana_la": null,
            "atribute": {
                "lista": "Firme care au dedus sponsorizări către ONG-uri",
                "adresa": "HARGHITA",
                "sume declarate": "3019"
            }
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1,
            "pagini": 1
        }
    }
}

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 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 lang: orice alt parametru dă 422, nu e ignorat.",
        "detalii": {
            "cui": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}