to select ↑↓ to navigate
Smooth HR

Smooth HR

Employee Records

The Employee record is the central person record in Smooth HR. It links a human being to your Company, Department, Designation, payroll, leave, expenses, performance, and — when configured — a User for self-service portal access.

Help URL: https://smoothhiring.com/help/hrms/people/employee-records


Table of contents

  1. Overview
  2. Who uses Employee records
  3. Desk paths
  4. Creating an Employee
  5. From recruitment and onboarding
  6. Key fields and tabs
  7. Linking a User for portal access
  8. Status and lifecycle
  9. Common mistakes
  10. Troubleshooting

Overview

Every HR transaction — leave, attendance, expense claim, salary slip, appraisal — references an Employee name. The record stores employment details, reporting structure, contact information, and links to job history when created from Job Offer.

Concept Detail
Naming Controlled by HR Settings Employee Naming By (Naming Series, Employee Number, or Full Name)
Company Required; drives payroll, tax, and permissions
Department / Designation Org placement; used in approvals and recruitment matching
Reports to Builds organizational chart and approval chains
User ID Links the login User for ESS and onboarding portal

Smooth HR runs in the cloud. Module sidebars (People, Recruitment, Expenses, Performance, Tenure, NextAI) appear after login. Use the left sidebar or search (Ctrl+K / Cmd+K) to open lists and workspaces.


Who uses Employee records

Role Typical use
HR Manager Full create/submit/cancel; setup masters; reports
HR User Day-to-day transactions; may need approval rules
Employee Self-service where enabled
System Manager Site-wide configuration, integrations, NextAI keys
Role Typical actions
HR Manager Create, edit, deactivate employees; bulk import
HR User Update contact info, department moves, manager changes
Employee Read own record; limited self-service updates if enabled
Payroll Verify bank, tax, salary structure assignment before pay run
System Manager Fix broken User links; permissions

Desk paths

Action Desk path
Employee list /app/employee
Open employee /app/employee/{employee-id}
People workspace /desk/people
HR Settings /app/hr-settings
Organizational chart /app/organizational-chart

Creating an Employee

Manual creation

  1. Open PeopleEmployeeAdd Employee.
  2. Set First Name, Company, Date of Joining, Department, Designation.
  3. Set Gender, Date of Birth if required by your policies.
  4. Set Reports to for org chart and leave/expense approvers.
  5. Save. Assign salary structure from Payroll when ready.

Naming series

If HR Settings uses Naming Series, the ID may look like HR-EMP-00042. If Full Name, the document name is the employee name — avoid duplicates.


From recruitment and onboarding

Typical hire flow:

flowchart LR
  JobOpening --> JobApplicant
  JobApplicant --> Interview
  Interview --> JobOffer
  JobOffer --> EmployeeOnboarding
  JobOffer --> Employee
  1. Job Applicant is named by email (document name = email_id).
  2. Interview rounds track feedback per Interview Round master.
  3. Job Offer accepted → use Create Employee (Create Employee maps offer fields to Employee).
  4. Employee Onboarding may run in parallel with e-sign via Signature Templates.

After Create Employee from Job Offer, personal email and name copy from the applicant record.


Key fields and tabs

Field / area Purpose
Company Legal employer
Department Team; drives approvers
Designation Job title; matches Job Opening
Branch Location if used
Grade Policy bands, onboarding templates
Employment Type Full-time, part-time, contract
Reports to Manager Employee link
User ID Portal login
Job Applicant Back-link when created from offer
Bank / Salary Payroll tabs

Linking a User for portal access

  1. Create User with employee's work email (or personal if that is login).
  2. Assign roles: Employee, plus module roles as needed.
  3. On Employee, set User ID to that user.
  4. Employee can access leave, expenses, goals per permissions.

Without User ID, the employee cannot use self-service or the onboarding portal tied to their email.


Status and lifecycle

Status Meaning
Active Currently employed
Inactive Left or on long leave without pay (per policy)
Suspended Disciplinary hold (if used)

Use Employee Separation for structured offboarding; it can create a separation project with tasks.


Common mistakes

Mistake Fix
No User linked Set User ID after User creation
Wrong company on Employee One primary company; use transfers properly
Duplicate email as Job Applicant name Applicant name IS email — use unique emails
Skipping Reports to Set manager for approvals and org chart
Creating Employee before masters Create Company, Department, Designation first

Troubleshooting

Issue What to do
Cannot save Employee Check mandatory Company, DOJ, gender if required
Employee not in payroll Assign Salary Structure Assignment
Portal login fails Verify User ID, role Employee, password reset
Create Employee greyed on Job Offer Offer must be submitted; applicant not already employee

Bulk import and integrations

Use Data Import on Employee for CSV uploads. Include Company, Department, and Designation values that already exist. Import in batches and validate org chart after each batch.

API integrations should use stable Employee IDs from naming series rather than display names. External systems mapping by email should use the User email or personal/work email fields consistently.

When rehiring, decide policy: new Employee record with new joining date vs reactivating old record — payroll and tenure reporting differ.


Frequently asked questions

Can employees edit their own record?

Only if permissions allow; typically HR owns master data.

On Employee when created from Job Offer; field Job Applicant.

How do I deactivate without separation doc?

Set status Inactive — but Tenure separation is recommended for audit trail.


Last updated: May 2026


Smooth LMS (training)

Guide Link
LMS help home smoothhiring.com/help/lms
HRMS + LMS overview lms/hrms-integration/overview
Auto-provision LMS access lms/hrms-integration/employee-auto-provisioning
Onboarding mandatory training lms/hrms-integration/onboarding-mandatory-training
Compliance vs certificates lms/hrms-integration/compliance-vs-lms-certificates
Mandatory courses lms/courses/mandatory-training-and-validity
Course categories (folders) lms/courses/categories-and-tags
Last updated 1 week ago
Was this helpful?
Thanks!