Schema — Employee

Complete structure of the Employee object used in the ssm.ro API's contact endpoints.

The Employee object represents an employee (contact) in the ssm.ro platform. It is used as the request body for creation and updates, and as the response when retrieving data.

Fields

Field	Type	Accepted values	Description
`nume`	string	—	Last name
`prenume`	string	—	First name
`email`	string	—	Email address (used for authentication in the platform)
`departament`	string	—	Department name
`codDepartament`	string	—	External department code
`cor`	string	—	Job title according to the Romanian Classification of Occupations (COR)
`post`	string	—	Employee's position
`marca`	string	—	Unique employee identifier key (internal HR ID)
`marcaSuperior`	string	—	Employee ID of the direct supervisor (N+1)
`marcaSuperior2`	string	—	Employee ID of the N+2 supervisor (where applicable)
`marcaInlocuitor`	string	—	Employee ID of the replacement
`adresa`	string	—	Employee's address
`localitate`	string	—	City/town
`judet`	string	—	County
`dataNasterii`	string	`YYYY-MM-DD`	Date of birth (ISO 8601 format)
`locatieFizica`	string	—	Physical location / office (e.g. `Office 101`)
`status`	string	`activ` `rez` `suspendat`	Employee's contract status
`organizatie`	string	—	Organization name in the platform
`echipaPSI`	string	`Da` `Nu`	Member of the PSI team (Fire Prevention and Firefighting)
`telefon`	string	—	Employee's phone number
`cnp`	string	13 digits	Personal Identification Number (CNP). Validated if provided: exactly 13 digits and unique within the organization
`limba`	string	`ro` `en`	Employee's interface language in the platform
`calificare`	string	—	Employee's qualification
`cetatenie`	string	—	Employee's citizenship
`nationalitate`	string	—	Employee's nationality / country
`dataIncepereActivitate`	string	`YYYY-MM-DD`	Start date of employment (contract date), ISO 8601 format

Full example

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

Notes

The marca field is the employee's unique identifier and is used as the lookup key in GET /v1/contacts?marca= and as a reference in the supervisor hierarchy.
For PATCH /v1/contacts/update, the complete Employee schema must be sent. The marca and organizatie fields are required to identify the contact.
status values: activ = active employee, rez = reserved / temporarily inactive, suspendat = suspended.
Department identified via codDepartament. The department is identified by codDepartament (the unique external code from HR). If you send the same codDepartament with a departament value different from the existing one, the department name is updated (renamed), without creating a new department. This way, a rename in HR propagates to the platform as long as the code stays the same.
cnp is validated only if provided: it must have exactly 13 digits and be unique within the organization.
telefon is normalized automatically; values that are too short (under 9 digits) are ignored, without an error.
dataIncepereActivitate: an unparsable date is treated as empty (the field is ignored, without an error).

Schema — Employee

Fields

Full example

Notes

On this page