Business v1 / Firme

Firme modificate

Fluxul schimbărilor: ce s-a modificat la firme într-un interval, câmp cu câmp şi cu sursa care a adus schimbarea (ONRC ori ANAF). Pentru a-ţi ţine propria copie la zi fără să reîncarci totul.

GET

https://oneapi.ro/api/business/v1/firme/modificate

Parametri de interogare

NumeTipDescriereValori acceptate

de_laopțional string | null Data de la care s-au înregistrat modificări, AAAA-LL-ZZ. ex. 2026-09-01

sursaopțional string | null Opţional: toate (implicit), onrc ori anaf. toateonrcanaf

Cum se comportă

Schimbările de la o dată, câte un rând pe schimbare — util pentru sincronizări incrementale (iei doar ce s-a schimbat de la ultima rulare). Implicit vin ambele surse: registrul ONRC (sediu, denumire, firme noi) şi starea fiscală ANAF (înregistrare ori anulare TVA, inactivare, reactivare) — schimbările fiscale sunt cele urmărite zilnic.
Datele nu înseamnă acelaşi lucru. La ONRC, la e ziua în care am observat schimbarea; la ANAF, e data efectivă a tranziţiei, pe care ANAF o publică uneori cu întârziere. O sincronizare pe ANAF trebuie să ceară de_la cu o marjă (de pildă ultima rulare minus 30 de zile), altfel pierde tranziţiile publicate retroactiv.
total numără schimbările, adică exact rândurile paginate; o firmă cu trei schimbări apare de trei ori.

La ce folosește

Sincronizare incrementală: iei doar ce s-a schimbat de la ultima rulare.
Alerte pe portofoliu, când un client îşi schimbă sediul sau denumirea.
Reducerea costului de actualizare, fără să reciteşti toată baza.

Structura răspunsului

CâmpTipDescriere

data[] array Conţinutul răspunsului.

data[].cui integer Codul fiscal.

data[].denumire string Denumirea.

data[].camp string Ce s-a schimbat. ONRC: aparitie (firmă nouă în registru), sediu, denumire. ANAF: tva_inregistrare, tva_anulare, inactivare, reactivare.

data[].la string La ONRC, data la care s-a observat schimbarea în registru; la ANAF, data efectivă a tranziţiei.

data[].sursa string onrc ori anaf.

meta.paginare.pagina integer Pagina curentă, numărată de la 1.

meta.paginare.per_pagina integer Câte înregistrări are o pagină.

meta.paginare.total integer Totalul înregistrărilor care se potrivesc, dincolo de pagina curentă.

meta.paginare.pagini integer Câte pagini are lista.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/modificate?de_la=2026-09-01

{
    "data": [
        {
            "cui": 6736899,
            "denumire": "CMC CANTERO SRL",
            "camp": "inactivare",
            "la": "2026-10-06",
            "sursa": "anaf"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 61234,
            "pagini": 3062
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/modificate?de_la=2026-09-01&sursa=onrc

{
    "data": [
        {
            "cui": 159,
            "denumire": "FRIGOTEHNICA S.A.",
            "camp": "stare:alta",
            "la": "2026-09-02",
            "sursa": "onrc"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 58203,
            "pagini": 2911
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/modificate?de_la=2026-09-01&sursa=anaf

{
    "data": [
        {
            "cui": 6736899,
            "denumire": "CMC CANTERO SRL",
            "camp": "inactivare",
            "la": "2026-10-06",
            "sursa": "anaf"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 3031,
            "pagini": 152
        }
    }
}

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.
422	validare	Un parametru nedeclarat ori o valoare care nu trece validarea (`de_la`, `sursa`). Câmpul vinovat e în `detalii`.
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": "Un parametru nedeclarat ori o valoare care nu trece validarea (de_la, sursa). Câmpul vinovat e în detalii.",
        "detalii": {
            "de_la": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}