Dipendente (Employee)

Rappresenta l’anagrafica dipendente (master record del collaboratore): matricola (employeeNumber), stato rapporto (status), dati anagrafici e contatto, date di assunzione e cessazione, collegamento al ruolo (positionId / positionTitle), responsabile diretto (managerId), ubicazione lavorativa opzionale (locationId, allineabile alle entità Organizzazione), paese di riferimento e tag. È il record centrale da cui partono assenze, presenze, paghe e altre integrazioni HR verso HCM, payroll o directory aziendali.

Esempio JSON completo

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

Note

• positionTitle può essere denormalizzato per lettura rapida; la fonte di verità del ruolo resta di norma l’entità Position (positionId).
• locationId nel campione riusa lo stesso id della Location in organization/location.json; in produzione deve coincidere con il master sedi/magazzini del tenant.
• Dati sensibili (CF, IBAN, categorie protette) possono richiedere campi aggiuntivi o connettori dedicati non mostrati nel campione.