ESS (Employee Self-Service) is the portal where employees access their own payroll data directly - without going through HR for every small change or question.
What employees can do
- Report certain Employee Case Changes themselves - e.g. address or bank account changes
- Complete their own missing data when something required is outstanding
- View and download their own documents - payslips, salary certificates, contracts
What stays with HR
Case changes that need review or approval (e.g. salary changes, contract changes) are not exposed via ESS by default - they're reported by HR through the regular Employee Case Change flow. Which fields are ESS-editable is configured per regulation.
Access
Employees access ESS with their existing account if you've connected your Identity & Access Management (IAM) - see Embedded Into Your Platform or Standalone White-Label Solution for the two ways to set that up. No separate ESS login is needed.
FAQ
Can employees report a salary change themselves?
No - that needs review or approval and stays with HR. Only certain fields (e.g. address) are ESS-editable, configured per regulation.
Do employees need a separate ESS login?
No - ESS uses the same IAM-connected account as the rest of your platform.
What if an employee has missing data?
They can complete it directly via ESS - see Missing Employee Data.
Can an employee see all of their data?
Only their own record - not company data or other employees' data.
Do employees see reports in ESS? Which ones?
Only their own documents (payslips, salary certificates, contracts) via the Documents tab - there's no separate broader reports view in ESS.
Can employees see other employees' or company data through ESS?
No - access is strictly scoped to their own employee record.
Can employees report their own personal data via ESS? Which fields?
Yes, but only whatever fields are configured as ESS-editable per regulation (typically things like address or bank details) - fields needing review or approval, like salary, stay with HR.
Can HR see when an employee has entered/completed data via ESS?
HR can see what changed and when in the case-change history, but the underlying data doesn't carry a "changed by" field - so you can't reliably tell from that history alone whether a given change came from HR or from the employee via ESS.
API Endpoints
ESS reuses the regular case-change and missing-data endpoints, scoped to the logged-in employee's own record - there is no separate ESS-only API surface:
| What | Call |
|---|---|
| Report a case change | POST /tenants/{orgId}/payrolls/{payrollId}/cases/sets |
| List missing employee data | GET /tenants/{orgId}/payrolls/{payrollId}/missingdata/employees |
| Get an employee document | GET /tenants/{orgId}/employees/{employeeId}/cases/{caseValueId}/documents/{documentId} |