API pentru Dezvoltatori
Schema — Employee
Structura completă a obiectului Employee utilizat în endpoint-urile de contacte ale API-ului ssm.ro.
Obiectul Employee reprezintă un angajat (contact) în platforma ssm.ro. Este folosit ca request body la creare și modificare, și ca răspuns la preluare.
Câmpuri
| Câmp | Tip | Valori acceptate | Descriere |
|---|---|---|---|
nume | string | — | Numele de familie |
prenume | string | — | Prenumele |
email | string | — | Adresa de email (folosită pentru autentificare în platformă) |
departament | string | — | Denumirea departamentului |
codDepartament | string | — | Codul extern al departamentului |
cor | string | — | Funcția conform Clasificării Ocupațiilor din România (COR) |
post | string | — | Postul angajatului |
marca | string | — | Cheia unică de identificare a angajatului (ID intern HR) |
marcaSuperior | string | — | Marca superiorului direct (N+1) |
marcaSuperior2 | string | — | Marca superiorului N+2 (acolo unde se aplică) |
marcaInlocuitor | string | — | Marca înlocuitorului |
adresa | string | — | Adresa angajatului |
localitate | string | — | Localitatea |
judet | string | — | Județul |
dataNasterii | string | YYYY-MM-DD | Data nașterii (format ISO 8601) |
locatieFizica | string | — | Locația fizică / biroul (ex: Office 101) |
status | string | activ rez suspendat | Starea contractului angajatului |
organizatie | string | — | Numele organizației din platformă |
echipaPSI | string | Da Nu | Face parte din echipa PSI (Prevenire și Stingere Incendii) |
Exemplu complet
{
"nume": "Ion",
"prenume": "Popescu",
"email": "ion.popescu@exemplu.ro",
"departament": "Finanțe",
"codDepartament": "D163",
"cor": "Referent bancar",
"post": "Tesa",
"marca": "M00212",
"marcaSuperior": "M00132",
"marcaSuperior2": "M0081",
"marcaInlocuitor": "M00301",
"adresa": "Str. Soarelui nr. 2",
"localitate": "Brașov",
"judet": "Brașov",
"dataNasterii": "1981-08-24",
"locatieFizica": "Office 101",
"status": "activ",
"organizatie": "demo-organization",
"echipaPSI": "Nu"
}Note
- Câmpul
marcaeste identificatorul unic al angajatului și este folosit ca cheie de căutare înGET /v1/contacts/{id}și ca referință în ierarhia de superiori. - La
PATCH /v1/contacts/update, se trimite schema completă Employee. Câmpurilemarcașiorganizatiesunt obligatorii pentru identificarea contactului. - Valorile
status:activ= angajat activ,rez= rezervat / inactiv temporar,suspendat= suspendat.