oneapi
Autentificare
Locations v1 / ServiciiSociale

Serviciile sociale ale unui UAT

Furnizorii de servicii sociale acreditaţi din UAT, pe tip de serviciu şi pe mediu: centre pentru vârstnici, pentru copii, cantine, servicii la domiciliu.

GET
https://oneapi.ro/api/locations/v1/uat/{cod}/servicii-sociale

Parametri de cale

NumeTipDescriereExemplu
codobligatoriu string Codul SIRUTA al unităţii administrativ-teritoriale (ex. 54975 pentru Cluj-Napoca).

Parametri de interogare

NumeTipDescriereValori acceptate
per_paginaopțional text Câți furnizori întoarce lista (implicit 50, maxim 200). Sumarul rămâne complet. ex. 50
paginaopțional text Pagina, numărată de la 1. ex. 1

Cum se comportă

  • Sursa e registrul furnizorilor acreditați în baza Legii nr. 197/2012 (MMPS), importat în Business.
  • Sunt FURNIZORI, după adresa lor de înregistrare — nu servicii disponibile în teritoriu. Un furnizor înregistrat aici poate presta în altă parte, iar unul din alt județ poate presta aici. Distincția contează: cine caută ajutor social nu trebuie să citească lista asta ca pe o hartă a serviciilor.
  • Registrul ține adresa preponderent la nivel de UAT (3.729 din 4.037 înregistrări), motiv pentru care ruta există DOAR pe UAT. O rută pe localitate ar întoarce liste aproape goale pentru majoritatea cazurilor — un răspuns parțial care pare complet. Interogarea acoperă totuși ambele forme: furnizorii ținuți pe codul UAT-ului și cei ținuți pe o localitate din el.
  • tip_furnizor_cod e codul BRUT din registru. MMPS nu publică legenda lui alături de listă, iar o etichetă pusă de noi ar fi o invenție — deci îl trecem mai departe ca atare. Rămâne util pentru grupare.
  • localitate apare doar când registrul a dat cod de localitate; altfel primești localitate_declarata, adică textul din registru, nerezolvat în nomenclator.

La ce folosește

  • Vezi ce furnizori de servicii sociale acreditați sunt înregistrați într-o comună sau oraș.
  • Verifici dacă un furnizor are acreditarea în regulă, cu seria certificatului și data.
  • Compari densitatea furnizorilor între UAT-uri, ca semnal de acoperire socială.

Structura răspunsului

CâmpTipDescriere
data.uat.cod_siruta integer Codul SIRUTA al unităţii teritoriale.
data.uat.nume string Numele, aşa cum îl publică sursa.
data.uat.tip string Tipul UAT-ului (municipiu/oraș/comună).
data.judet.cod_siruta integer Codul SIRUTA al unităţii teritoriale.
data.judet.nume string Numele, aşa cum îl publică sursa.
data.judet.cod_auto string Indicativul auto al judeţului.
data.sumar.total integer Numărul de furnizori înregistrați în UAT.
data.pe_tip[] array Defalcare pe codul de tip din registru [{cod, nr}] — cod brut, fără etichetă oficială.
data.pe_tip[].cod string Codul din nomenclatorul sursei — cheia pe care se filtrează.
data.pe_tip[].nr integer Numărul de elemente din grupa asta.
data.pe_mediu object Defalcare urban/rural, după mediul declarat.
data.pe_mediu.urban integer
data.furnizori[] array Lista paginată: {denumire, cui?, tip_furnizor_cod, certificat, nr_decizie, data_acreditare, adresa?, mediu, localitate? | localitate_declarata?}.
data.furnizori[].denumire string Denumirea, aşa cum o publică sursa.
data.furnizori[].cui integer Codul de identificare fiscală, fără prefixul RO.
data.furnizori[].tip_furnizor_cod string
data.furnizori[].certificat string
data.furnizori[].nr_decizie string
data.furnizori[].data_acreditare string
data.furnizori[].adresa string Adresa, în forma publicată de sursă.
data.furnizori[].mediu string Mediul de rezidenţă (urban ori rural).
data.furnizori[].localitate_declarata string
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/locations/v1/uat/54975/servicii-sociale
{
    "data": {
        "uat": {
            "cod_siruta": 54975,
            "nume": "Cluj-Napoca",
            "tip": "municipiu"
        },
        "judet": {
            "cod_siruta": 127,
            "nume": "Cluj",
            "cod_auto": "CJ"
        },
        "sumar": {
            "total": 78
        },
        "pe_tip": [
            {
                "cod": "4",
                "nr": 65
            }
        ],
        "pe_mediu": {
            "urban": 78
        },
        "furnizori": [
            {
                "denumire": "Arhiepiscopia Vadului, Feleacului şi Clujului",
                "cui": 4547095,
                "tip_furnizor_cod": "5",
                "certificat": "AF/000626",
                "nr_decizie": "243",
                "data_acreditare": "15.04.2014",
                "adresa": "Piaţa Avram Iancu nr. 18",
                "mediu": "urban",
                "localitate_declarata": "Cluj-Napoca"
            }
        ]
    },
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 50,
            "total": 78,
            "pagini": 2
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitUAT inexistent pentru codul SIRUTA dat.
422validareUn parametru nu a trecut validarea (per_pagina, pagina); detalii spune care şi de ce.
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 nu a trecut validarea (per_pagina, pagina); detalii spune care şi de ce.",
        "detalii": {
            "cod": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}