oneapi
Autentificare
Business v1 / Firme

Locaţia firmei

Sediul firmei — RAW (ONRC) + REZOLVAT (Locations: SIRUTA, UAT, județ, regiune, NUTS, populație, stradă).

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

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ă

  • Sediul social rezolvat la nivel de judeţ, localitate şi, unde se poate, stradă, prin legarea de modulul Locations (99,9% la localitate, ~79% la stradă).
  • Faţă de sediu din profil, ruta asta e dedicată feliei de locaţie: identificatorii Locations (cod SIRUTA, id localitate) plus textul brut.

La ce folosește

  • Aşezarea firmei pe hartă fără să geocodezi tu textul brut al adresei.
  • Rutarea unui lead către agentul de vânzări din judeţul sau localitatea sediului.
  • Legarea firmei de restul platformei prin cod SIRUTA — de aici mergi în /locations/v1.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

CâmpTipDescriere
cui integer Codul fiscal.
raw[] string | integer Adresa aşa cum e la sursă, câmp cu câmp; cheile goale lipsesc.
rezolvat.localitate_id integer Id-ul intern al localităţii în Locations.
rezolvat.localitate string Localitatea.
rezolvat.cod_siruta integer | null Codul SIRUTA al localităţii — chainable spre /locations/v1.
rezolvat.uat string | null Unitatea administrativ-teritorială.
rezolvat.judet string | null Judeţul.
rezolvat.regiune string | null Regiunea de dezvoltare.
rezolvat.cod_nuts string | null Codul NUTS al unităţii teritoriale.
rezolvat.populatie integer | null Populaţia localităţii (recensământ).
rezolvat.strada_id integer | null Id-ul străzii în Locations — chainable spre /locations/v1/strazi/{id}.
rezolvat.strada string | null Strada.
rezolvat.potrivire[] string Cât de sigură e legarea la nomenclator, pe localitate şi pe stradă.
rezolvat.coordonate.lat number Latitudinea punctului (WGS84, 6 zecimale ≈ 11 cm).
rezolvat.coordonate.lng number Longitudinea punctului (WGS84).
rezolvat.coordonate.precizie string ⚠️ Cât de fin e punctul, în patru trepte care NU sunt interschimbabile: numar (punctul de adresă din OSM, potrivit exact pe numărul din registru — 1.308.114 firme), numar_aproximativ (acelaşi fel de punct, dar potrivit doar pe partea întreagă: „4A" aşezat la „4", „27-33" la începutul intervalului — 115.040 firme), strada (centrul arterei) şi localitate (restul). Desenează ac doar pe primele două, cerc pe stradă, pastilă pe localitate: un ac pe strada afirmă o exactitate pe care n-o avem.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/6719278/locatie
{
    "data": {
        "cui": 6719278,
        "raw": {
            "judet": "Bucureşti",
            "localitate": "Bucureşti Sectorul 6",
            "strada": "Timişoara",
            "numar": "26",
            "cod_postal": "61331",
            "sector": 6
        },
        "rezolvat": {
            "localitate_id": 13755,
            "localitate": "București Sectorul 6",
            "cod_siruta": 179196,
            "uat": "București",
            "judet": "București",
            "regiune": "București-Ilfov",
            "cod_nuts": "RO321",
            "populatie": 324994,
            "strada_id": 221585,
            "strada": "Timișoara",
            "potrivire": {
                "loc": "exact",
                "str": "exact"
            },
            "coordonate": {
                "lat": 44.428876,
                "lng": 26.036041,
                "precizie": "numar"
            }
        }
    }
}

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."
            ]
        }
    }
}