Business v1 / Firme

Istoric modificări

Istoricul modificărilor firmei (denumiri, stări etc.) — câmpul schimbat cu valoarea veche și nouă,
cel mai recent întâi. Paginat.

GET

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

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ă

Istoricul modificărilor firmei din registru (câmp, valoare veche, valoare nouă, dată), paginat. Util pentru a urmări schimbări de denumire, sediu, formă juridică.

La ce folosește

Aflarea denumirii pe care o avea firma la data unui document vechi.
Detectarea schimbărilor de sediu sau de formă juridică într-un portofoliu.
Alimentarea unui jurnal de audit cu modificările oficiale ale partenerului.

Structura răspunsului

CâmpTipDescriere

data[].camp string Câmpul care s-a schimbat.

data[].valoare_veche string | null Valoarea dinaintea modificării.

data[].valoare_noua string | null Valoarea după modificare.

data[].snapshot_vechi string | null Data instantaneului dinaintea modificării.

data[].snapshot_nou string | null Data instantaneului de după modificare.

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/istoric

{
    "data": [
        {
            "camp": "sediu",
            "valoare_veche": "Bucureşti Sectorul 6, B-dul Timişoara, Nr. 26, Etaj 2",
            "valoare_noua": "Bucureşti Sectorul 6, B-dul Timişoara, Nr. 26, Etaj 2, Cod poștal 61331",
            "snapshot_vechi": "2020-08-01",
            "snapshot_nou": "2020-12-08"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1,
            "pagini": 1
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/14399840/istoric

{
    "data": [
        {
            "camp": "sediu",
            "valoare_veche": "Bucureşti Sectorul 6, Şos. VIRTUŢII, Nr. 148, spatiul E47",
            "valoare_noua": "Bucureşti Sectorul 6, Şos. VIRTUŢII, Nr. 148, spatiul E47, Cod poștal 60787",
            "snapshot_vechi": "2020-08-01",
            "snapshot_nou": "2020-12-08"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1,
            "pagini": 1
        }
    }
}

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

{
    "data": [
        {
            "camp": "sediu",
            "valoare_veche": "Iaşi|Municipiul Iaşi|TĂTĂRAŞI|65",
            "valoare_noua": "Neamţ|Municipiul Roman|B-dul REPUBLICII|123-125",
            "snapshot_vechi": "2025-10-06",
            "snapshot_nou": "2025-11-13"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 5,
            "pagini": 1
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/24890577/istoric

{
    "data": [
        {
            "camp": "sediu",
            "valoare_veche": "Municipiul Gheorgheni, Str. MARGARETEI, Nr. 4, Județ Harghita",
            "valoare_noua": "Municipiul Gheorgheni, Str. POMPIERILOR, Nr. 118, Județ Harghita, Cod poștal 535500",
            "snapshot_vechi": "2020-08-01",
            "snapshot_nou": "2020-12-08"
        }
    ],
    "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."
            ]
        }
    }
}