Skip to main content

Employee

Represents the employee master record: employee number (employeeNumber), employment status (status), name and contact fields, hire and termination dates, link to the role (positionId / positionTitle), manager (managerId), optional work location (locationId, alignable with Organization entities), country code, and tags. Central record for absences, time, payroll, and HR integrations into HCM, payroll, or corporate directory systems.

Full JSON example​

{
  "id": "emp_4Hy7Jk0Lm3No6",
  "channel": "demoipaas",
  "createdAt": "2022-03-14T08:00:00+00:00",
  "updatedAt": "2026-02-28T16:20:00+00:00",
  "employeeNumber": "EMP-01482",
  "status": "active",
  "firstName": "Elena",
  "lastName": "Conti",
  "email": "e.conti@company.test",
  "phone": "+39 02 5550192",
  "hireDate": "2022-03-14",
  "terminationDate": null,
  "positionId": "pos_wh_manager",
  "positionTitle": "Warehouse Manager",
  "managerId": "emp_9Qr2St5Uv8Wx1",
  "locationId": "loc_wh_MIL01",
  "countryCode": "IT",
  "tags": ["shift-lead"]
}

Remarkable notes​

  • positionTitle may be denormalized for display; the canonical job definition is usually the Position entity (positionId).
  • Sample locationId matches the Location id in organization/location.json; in production it must match the tenant’s site/warehouse master.
  • Sensitive fields (tax IDs, bank details, protected categories) may need extra fields or dedicated connectors not shown in the sample.