Contacte

Endpoint-uri pentru gestionarea contactelor (angajaților) în platforma ssm.ro: preluare, creare și modificare.

Endpoint-urile de contacte permit sincronizarea angajaților din sistemul tău HR cu platforma ssm.ro. Un contact reprezintă un angajat înrolat în organizația ta.

Preluare contact

GET /v1/contacts/{id}

Returnează datele unui contact pe baza mărcii (ID-ului unic) și a numelui organizației.

Exemplu request:

GET /v1/contacts/M00212?organizatie=demo-organization

Parametri

Parametru	În	Tip	Obligatoriu	Descriere
`id`	path	string	Da	Marca — cheia unică de identificare a angajatului
`organizatie`	query	string	Da	Numele organizației

Răspunsuri

Cod	Descriere
`200 OK`	Obiect Employee
`404 Not Found`	Contactul nu există — răspuns JSON cu mesaj de eroare
`500 Server Error`	Eroare internă server

Creare contact nou

POST /v1/contacts

Creează un contact nou în organizație. Dacă marca există deja, operațiunea va eșua.

Request body

Content-Type: application/json — obiect Employee.

Exemplu:

{
  "nume": "Ion",
  "prenume": "Popescu",
  "email": "ion.popescu@exemplu.ro",
  "departament": "Finanțe",
  "codDepartament": "D163",
  "cor": "Referent bancar",
  "post": "Tesa",
  "marca": "M00212",
  "marcaSuperior": "M00132",
  "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"
}

Răspunsuri

Cod	Descriere
`200 OK`	Contactul a fost creat — returnează obiectul Employee
`404 Not Found`	Organizația nu a fost găsită
`422 Unprocessable Entity`	Date invalide — răspuns JSON cu detalii eroare
`500 Server Error`	Eroare internă server

Modificare contact existent

PATCH /v1/contacts/update

Actualizează datele unui contact existent, identificat prin câmpul marca. Doar câmpurile trimise în body vor fi actualizate.

Request body

Content-Type: application/json — obiect Employee complet. Câmpurile marca și organizatie sunt obligatorii pentru identificare.

Exemplu:

{
  "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"
}

Răspunsuri

Cod	Descriere
`200 OK`	Contactul a fost actualizat — returnează obiectul Employee
`204 No Content`	Nicio modificare efectuată — datele trimise sunt identice cu cele existente
`404 Not Found`	Contactul nu a fost găsit
`422 Unprocessable Entity`	Date invalide — răspuns JSON cu detalii eroare
`500 Server Error`	Eroare internă server

On this page