oneapi
Autentificare
Business v1 / Firme

Firme radiate

Firmele radiate (opțional dintr-un județ). Paginat.

GET
https://oneapi.ro/api/business/v1/firme/radiate

Parametri de interogare

NumeTipDescriereValori acceptate
judetopțional string | null Codul judeţului sediului (CJ), ca să vezi numai radierile de acolo. ex. CJ
zileopțional integer | null Fereastra radierii. zile e comoditatea („ce s-a închis în ultimele 90 de zile"), de_la/
pana_la sunt forma exactă. Ordonarea implicită a rutei rămâne alfabetică, ca până acum;
sortare=data_radiere e ce face din ea un flux de evenimente. 1 – 3650
de_laopțional string | null Începutul ferestrei de radiere, AAAA-LL-ZZ. Forma exactă a filtrului; zile e comoditatea pentru „ultimele N zile”. ex. 2024-06-15
pana_laopțional string | null Sfârşitul ferestrei de radiere, AAAA-LL-ZZ. ex. 2026-09-02
sortareopțional string | null Implicit alfabetic. Cu sortare=data_radiere, lista devine un flux de evenimente — cele mai recente radieri primele. ex. data_radiere

Cum se comportă

  • Firmele radiate (scoase din registru), cele mai recente întâi, paginate. Complementară cu /firme/noi.

La ce folosește

  • Curăţarea unei baze de clienţi de firmele care nu mai există.
  • Închiderea automată a conturilor legate de firme radiate.
  • Analiza demografiei de afaceri: câte firme dispar şi de unde.

Structura răspunsului

CâmpTipDescriere
data[].cui integer Codul fiscal.
data[].denumire string | null Denumirea.
data[].cod_inmatriculare string | null Numărul de ordine în registrul comerţului (J…).
data[].forma_juridica string | null Forma juridică (SRL, SA, PFA…).
data[].stare string | null Starea firmei, ca obiect: denumire e textul brut din ONRC (107 valori distincte folosite), categorie e clasificarea noastră în 7 cutii — activa, suspendata, dizolvata, lichidare, radiata, insolventa, alta — pe care o foloseşti ca să filtrezi sau să grupezi. cod e codul ONRC al stării.
data[].data_inmatriculare string | null Data înmatriculării la registrul comerţului.
data[].radiere.vazut_la string
data[].radiere.dupa string | null
data[].sediu.judet string Judeţul sediului social.opțional
data[].sediu.localitate string Localitatea sediului social.opțional
data[].sediu.cod_siruta integer Codul SIRUTA al localităţii — chainable spre /locations/v1.opțional
data[].caen_principal.cod string Codul CAEN principal.
data[].caen_principal.denumire string | null Denumirea activităţii principale.
data[].fiscal.tva boolean Plătitoare de TVA.
data[].fiscal.inactiv boolean Declarată inactivă fiscal.
data[].fiscal.e_factura boolean Înrolată în e-Factura.
data[].financiar object Ultimul bilanţ depus (an, cifră de afaceri, profit net, salariaţi); null la firmele fără bilanţ — PFA-uri, firme noi —, nu zero.
data[].financiar.an integer Anul bilanţului.
data[].financiar.cifra_afaceri number | null Cifra de afaceri netă, în lei.
data[].financiar.profit_net number | null Profitul net, în lei; negativ = pierdere.
data[].financiar.salariati integer | null Numărul mediu de salariaţi.
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/radiate
{
    "data": [
        {
            "cui": 411545,
            "denumire": "$AWA COMEXIM SRL",
            "cod_inmatriculare": "J40/13646/1992",
            "forma_juridica": "SRL",
            "stare": {
                "cod": "1084",
                "denumire": "radiată",
                "categorie": "radiata"
            },
            "data_inmatriculare": "1992-05-28",
            "radiere": null,
            "sediu": {
                "judet": "București",
                "localitate": "București Sectorul 5",
                "cod_siruta": 179187
            },
            "caen_principal": {
                "cod": "5541",
                "denumire": "Cafenele și baruri fără spectacol"
            },
            "fiscal": {
                "tva": false,
                "inactiv": false,
                "e_factura": false
            },
            "financiar": null
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1908588,
            "pagini": 95430
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareUn parametru nedeclarat ori o valoare care nu trece validarea (judet). Câmpul vinovat e în detalii.
422filtru_necunoscutUn filtru care nu corespunde niciunei entităţi (judeţ, localitate, UAT, formă juridică, stare scrise greşit) — nu o listă goală; detalii.camp spune care.
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": "Un parametru nedeclarat ori o valoare care nu trece validarea (judet). Câmpul vinovat e în detalii.",
        "detalii": {
            "judet": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}