Employee

An employee is a person engaged by a business under a contract of employment, carrying a payroll identity and a set of system permissions.

Also called Staff · Team member · Personnel · Worker

Why it exists

Because a business needs to know who works for it, what they are owed, and what they are permitted to do — three questions that are related but answered from different data.

What it means to the business

The employee record is where HR, payroll and access control meet, and separating it from the user account is what keeps that intersection manageable. The high-consequence part is authority: who can approve what, and what happens to that authority when the person is absent or gone. Get it wrong and either the business stops or its controls do.

01Lifecycle — walk the states

Onboarding. Contracted, not yet started. Records exist, access does not.

State 1 of 4

02Relationships — walk the chain

Employee approves Approval Workflow.

Open Approval Workflow
03What goes wrong — and why
  • Payroll history, approvals they gave and documents they created all lose their attribution. Deactivation is the only correct operation, and statutory retention usually requires it anyway.

Rules that must hold

  • An employee record and a system user are different objects. Not every employee needs a login, and some system users are not employees.
  • Employment has a start date and may have an end date. Records are never deleted — payroll, statutory and audit history outlive the employment.
  • Approval authority attaches to a role, not to a person. When someone leaves, the authority must transfer without the record being edited.

What commonly goes wrong

Offboarding is treated as an HR task rather than a systems one. Payroll stops promptly; access does not. Months later an audit finds live credentials for people who left, and the approvals those accounts could still give were never revoked.

Edge cases

  • Contractors and consultants who need system access but no payroll record.
  • Rehires, where a second employment period must not overwrite the first.
  • Employees moving between group companies, where payroll transfers but service continuity may not.
  • Someone who leaves while documents they raised are still mid-approval.

How ERPNext models it

DocTypeNote
Employee`status` drives payroll inclusion. Linked to User optionally — the link is deliberately not mandatory.
UserThe login. Separate object; permissions live here, not on Employee.
Employee Internal Work HistoryRole and department changes over time, which is what makes historical approvals explicable.

Last reviewed 2026-08-14

Machine-readable version

We implement this for a living — that’s where the mistakes above come from. See the service or request a discovery briefing