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)
`telefon`	string	—	Numărul de telefon al angajatului
`cnp`	string	13 cifre	Cod Numeric Personal. Validat dacă e trimis: exact 13 cifre și unic în organizație
`limba`	string	`ro` `en`	Limba interfeței angajatului în platformă
`calificare`	string	—	Calificarea angajatului
`cetatenie`	string	—	Cetățenia angajatului
`nationalitate`	string	—	Naționalitatea / țara angajatului
`dataIncepereActivitate`	string	`YYYY-MM-DD`	Data începerii activității (dată contract), format ISO 8601

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",
  "telefon": "+40722333444",
  "cnp": "1800101221144",
  "limba": "ro",
  "calificare": "Inginer",
  "cetatenie": "Romana",
  "nationalitate": "Romania",
  "dataIncepereActivitate": "2020-01-15"
}

Note

Câmpul marca este identificatorul unic al angajatului și este folosit ca cheie de căutare în GET /v1/contacts?marca= și ca referință în ierarhia de superiori.
La PATCH /v1/contacts/update, se trimite schema completă Employee. Câmpurile marca și organizatie sunt obligatorii pentru identificarea contactului.
Valorile status: activ = angajat activ, rez = rezervat / inactiv temporar, suspendat = suspendat.
Departament identificat prin codDepartament. Departamentul este identificat după codDepartament (codul extern unic din HR). Dacă trimiți același codDepartament cu o valoare departament diferită față de cea existentă, denumirea departamentului este actualizată (redenumire), fără a crea un departament nou. Astfel, o redenumire în HR se propagă în platformă câtă vreme codul rămâne același.
cnp este validat doar dacă e trimis: trebuie să aibă exact 13 cifre și să fie unic în organizație.
telefon este normalizat automat; valorile prea scurte (sub 9 cifre) sunt ignorate, fără eroare.
dataIncepereActivitate: o dată neparsabilă este tratată ca goală (câmpul este ignorat, fără eroare).

Schema — Employee

Câmpuri

Exemplu complet

Note

On this page