Edit an employee

Goal

Update an existing employee’s identity, organization, and related profile fields without inventing a second people record.

Who it is for

HR clerk with hr.manage.

Preconditions

• Employee exists and is not archived (archived → 404).
• Module hr_records; permission hr.manage.

Steps

1. Open the employee from the list (detail) and choose edit, or open the edit form route for that id.
2. Adjust the same tabs as create: Identity & contact, Organization, Payroll setup, Schedule, Starting compensation, Notes.
3. Keep employee number unique if you change it.
4. Change manager carefully — self-as-manager is rejected.
5. Save. Status changes to terminated use Terminate on detail (not a silent status toggle on the form).
6. Use detail tabs for documents, dependents, emergency contacts, statutory identifiers, assets, loans, payroll lines, and time when those APIs are available.

Result

The employee record reflects current org and pay setup for leave, attendance, and payroll consumers.

Hard stops

Same domain errors as create (duplicate_employee_number, invalid_manager, …). Terminated employees cannot log new billable time (hr.terminated_cannot_log_time).

Related

• Create an employee
• Find employees
• Employee troubleshooting