oneapi
Autentificare
Business v1 / Firme

Puncte de lucru

Hotelurile, restaurantele, magazinele alimentare, farmaciile şi unităţile aprobate ale unei firme, cu adresă, autorizaţie şi, unde există, coordonate.

GET
https://oneapi.ro/api/business/v1/firme/{cui}/puncte-lucru

Parametri de cale

NumeTipDescriereExemplu
cuiobligatoriu string Codul de identificare fiscală al firmei, fără prefixul RO (ex. 6719278).

Parametri de interogare

NumeTipDescriereValori acceptate
sursalistăopțional text Opţional. Unul sau mai multe registre, separate prin virgulă ori ca listă (sursa[]=): situr_cazare, situr_alimentatie, ansvsa, dgsante, farmacii. Implicit, toate. situr_cazaresitur_alimentatieansvsadgsantefarmacii

Cum se comportă

  • Nu e lista punctelor de lucru declarate la ONRC — aceea nu se publică nicăieri deschis. Ministerul Finanţelor are coloana cu firma-mamă a unei unităţi secundare, dar o lasă goală pe toate cele 2,65 milioane de rânduri (verificat pe 17 sep). Ruta reconstruieşte în schimb locaţiile autorizate din registrele în care un rând e o unitate fizică: structurile turistice clasificate (Ministerul Turismului), unităţile sanitar-veterinare (ANSVSA), unităţile aprobate pentru comerţul intra-UE (DG SANTE) şi farmaciile.
  • O firmă fără activitate autorizată în aceste domenii are listă goală, chiar dacă are puncte de lucru. meta.surse arată unde s-a căutat şi cât s-a găsit în fiecare registru.
  • SITUR dă CUI-ul operatorului, deci legătura e sigură. ANSVSA şi farmaciile dau doar denumirea: CUI-ul vine din motorul de potrivire, iar potrivire spune cât de sigur e. Denumirile trunchiate la sursă („SC DISTRIB") rămân nelegate.
  • Aceeaşi unitate poate apărea de mai multe ori în ANSVSA, o dată pentru fiecare activitate autorizată (magazin şi vânzare online, de pildă).

La ce folosește

  • Harta reţelei unui lanţ: toate restaurantele ori magazinele unui operator, pe judeţe.
  • Verificarea că un partener chiar are unitatea autorizată la adresa declarată.
  • Prospectare în HoReCa şi alimentaţie: operatorii cu cele mai multe locaţii dintr-un judeţ.

Structura răspunsului

CâmpTipDescriere
data[].sursa string Registrul din care vine locaţia: situr_cazare, situr_alimentatie, ansvsa, dgsante, farmacii.
data[].operator string Operatorul economic, aşa cum e scris în registru.
data[].unitate string | null Numele unităţii (hotelul, restaurantul), unde registrul îl dă.
data[].tip string | null Tipul unităţii: HOTEL, RESTAURANT CLASIC, MAGAZIN ALIMENTAR…
data[].categorie string | null Clasificarea turistică (3 - STELE), doar la SITUR.
data[].adresa string | null Adresa unităţii, din registru.
data[].localitate string | null Localitatea, unde registrul o dă separat.
data[].judet string | null Judeţul, cu numele din nomenclatorul Locations; null când registrul nu-l dă.
data[].coordonate object | null Coordonatele unităţii {lat, lng}, unde registrul le publică (SITUR aproape mereu, ANSVSA rar).
data[].coordonate.lat number Latitudinea, în grade zecimale (WGS 84).
data[].coordonate.lng number Longitudinea, în grade zecimale (WGS 84).
data[].autorizatie.numar string | null Numărul autorizaţiei, certificatului ori aprobării.
data[].autorizatie.data string | null Data emiterii, unde registrul o dă separat.
data[].autorizatie.valabila_pana_la string | null Termenul de valabilitate, unde se cunoaşte.
data[].potrivire string exact — CUI dat de registru ori denumire identică; probabil — legătură făcută de motorul de potrivire după denumire şi loc.
meta.surse object Câte locaţii are firma în fiecare registru consultat, inclusiv zero.
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/6205722/puncte-lucru
{
    "data": [
        {
            "sursa": "ansvsa",
            "operator": "Premier Restaurants Romania SRL",
            "unitate": null,
            "tip": "Restaurant-Vanzare internet",
            "categorie": null,
            "adresa": "Alba Iulia, Calea Motilor, Nr.120",
            "localitate": null,
            "judet": "Alba",
            "coordonate": null,
            "autorizatie": {
                "numar": "9087/12.12.2019",
                "data": null,
                "valabila_pana_la": null
            },
            "potrivire": "exact"
        }
    ],
    "meta": {
        "surse": {
            "situr_cazare": 0,
            "situr_alimentatie": 52,
            "ansvsa": 82,
            "dgsante": 0,
            "farmacii": 0
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 134,
            "pagini": 7
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitFirma [{cui}] negăsită.
422validareO valoare necunoscută în sursa ori un parametru nedeclarat. Câmpul vinovat e în detalii.
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": "O valoare necunoscută în sursa ori un parametru nedeclarat. Câmpul vinovat e în detalii.",
        "detalii": {
            "cui": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}