# Employee

<p class="doc-lead">Employee master records store personal, job, identity, and bank details for every person in the organization. Employees are used across HRMS, payroll, attendance, and other modules.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/hr/employees?id=overview">Overview &amp; List View</a>
<a href="#/hr/employees?id=quick-start">Quick Start</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Form reference</span>
<div class="doc-toc-links">
<a href="#/hr/employees?id=basic-details">Basic Details</a>
<a href="#/hr/employees?id=personal-contact">Personal &amp; Contact</a>
<a href="#/hr/employees?id=identity">Identity</a>
<a href="#/hr/employees?id=job-details">Job Details</a>
<a href="#/hr/employees?id=experience-education">Experience &amp; Education</a>
<a href="#/hr/employees?id=emergency-bank">Emergency &amp; Bank</a>
<a href="#/hr/employees?id=access-pass">Employee Access Pass</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/hr/employees?id=actions-status">Actions &amp; Status</a>
<a href="#/hr/employees?id=view-tabs">View Tabs</a>
<a href="#/hr/employees?id=login-access">Login Access</a>
<a href="#/hr/employees?id=best-practices">Best Practices</a>
<a href="#/hr/employees?id=faq">FAQ</a>
<a href="#/hr/employees?id=related">Related</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview &amp; List View</h2>

The Employees list shows all employees with code, contact details, pay classification, and status. Use quick filters or advanced filters to find specific employees.

<img src="hr/images/emploeelist.webp" alt="Employee list" loading="lazy">

<b>Quick filters</b>

| **Filter** | **Description** |
|------------|-----------------|
| Default | All employees. |
| Active | Active employees. |
| Active and no login access | Active but without system login. |
| Inactive | Inactive employees. |
| Resigned | Resigned employees. |
| Joined this month | Employees who joined in the current month. |

<b>Advanced filters</b>

Id, First Name, Last Name, Status, Employee Code, Employee Type, Department, Employee Group, Payroll Group, Branch, Brand, Timeslot, Shift, Employee Pass Status, Joined, Created Date.

<b>List columns</b>

| **Column** | **Description** |
|------------|-----------------|
| Id | Record ID. |
| Name | Employee full name. |
| Employee code | Unique employee code. |
| Phone | Primary phone number. |
| Email | Primary email. |
| Gender | Gender. |
| Pay classification | Salaried or Labour (Variable Shift). |
| Status | Current employment status. |

<b>List row actions</b>

| **Action** | **Available when** |
|------------|-------------------|
| Edit | All (if permitted) |
| Delete | All (if permitted) |
| Suspend | Active employees |
| Activate | Suspended employees |
| View | All |

<hr class="doc-section-divider">

<h2 id="quick-start">Quick Start — Create an Employee</h2>

<h3>1. Navigate</h3>
Go to <b>HRMS → Employee</b>.

<h3>2. Create new employee</h3>
Click <b>New</b>.

<img src="hr/images/employeenew.webp" alt="New Employee" loading="lazy">

<h3>3. Fill in mandatory fields</h3>
<ul>
<li><b>First Name</b>, <b>Employee code</b> (hidden when auto-numbering is enabled), <b>Joined Date</b>, <b>Pay classification</b>.</li>
<li>Add job details, contact information, and identity documents as needed.</li>
</ul>

<h3>4. Save</h3>
Click <b>Save</b>. Use <b>Save As Draft</b> on edit to save without finalizing.

<hr class="doc-section-divider">

<h2 id="basic-details">Basic Details</h2>

| **Field** | **Description** |
|-----------|-----------------|
| First Name * | Employee first name. |
| Last Name | Employee last name. |
| Primary Email | Primary email address. |
| Employee code * | Unique employee identifier. Hidden and auto-generated when auto-numbering is enabled for employees; otherwise entered manually. |
| Joined Date * | Date the employee officially joined. |
| Pay classification * | <b>Salaried</b> or <b>Labour (Variable Shift)</b>. |
| Shift | Default working shift. |
| Time slot | Default time slot for fixed-hour employees. |
| Payroll group | Payroll group for salary processing. |
| Employee Group | Employee group for filtering and reporting. |
| Branch | Branch assignment. Shown when multi-branch is enabled. |
| Brand | Brand assignment. Shown when brand tracking is enabled. |
| Show in modules | Controls which modules the employee appears in. |
| POS PIN | Point-of-sale PIN if applicable. |
| Consider in attendance | Whether the employee is included in attendance tracking. |

<hr class="doc-section-divider">

<h2 id="personal-contact">Personal &amp; Contact Details</h2>

<b>Personal Details</b>

| **Field** | **Description** |
|-----------|-----------------|
| Gender | Employee gender. |
| Blood | Blood group. |
| Marital Status | Marital status. |
| Nationality | Nationality. |
| Date of Birth | Date of birth. |

<b>Contact Details</b>

| **Field** | **Description** |
|-----------|-----------------|
| Primary Phone | Main phone number. |
| Secondary Phone | Alternate phone. |
| Primary Address | Primary residential address. |
| Secondary Address | Alternate address. |
| Secondary Email | Alternate email. |

<hr class="doc-section-divider">

<h2 id="identity">Identity</h2>

<img src="hr/images/identity-hrms.webp" alt="Identity section" loading="lazy">

Stores identification documents and expiry dates. The HRMS dashboard tracks documents expiring within 45 days.

| **Field** | **Description** |
|-----------|-----------------|
| Passport Number | Passport number. |
| Passport Expiry | Passport expiry date. |
| Civil ID | Civil identification number. |
| Civil ID Expiry | Civil ID expiry date. |
| Visa ID | Visa number. |
| Visa Expiry | Visa expiry date. |
| Labor Card ID | Labor card number. |
| Labor Card Expiry | Labor card expiry date. |
| Medical Insurance ID | Medical insurance number. |
| Medical Insurance Expiry | Medical insurance expiry date. |
| Emirates ID / Bahrain ID / Qatar ID / Iqama ID | Country-specific ID (shown based on company country). |
| Aadhaar Number | Aadhaar number (India). |
| PAN card Number | PAN number (India). |
| UAN Number | Universal Account Number (India). |
| ESI Number | ESI number (India). |
| Access Control Card Number | Access control card number. |

<hr class="doc-section-divider">

<h2 id="job-details">Job Details</h2>

<b>Job Basic Details</b>

| **Field** | **Description** |
|-----------|-----------------|
| Mode of recruitment | How the employee was recruited. |
| Hire Date | Official hire date. |

<b>Job Details</b> (multi-line table — click <b>new Job</b> to add)

| **Column** | **Description** |
|------------|-----------------|
| Department | Employee department. |
| Job Title | Job title or designation. |
| Center | Cost or work center. |
| Head of the Employee | Reporting manager. |
| Employee Type | Employment type. |
| Date | Effective date of this job record. |
| Notes | Notes for this job assignment. |

<hr class="doc-section-divider">

<h2 id="experience-education">Experience &amp; Education</h2>

<b>Experience</b> (click <b>new experience</b>)

| **Column** | **Description** |
|------------|-----------------|
| Previous Company | Previous employer name. |
| Job Title | Role at previous company. |
| Start Date | Employment start date. |
| End Date | Employment end date. |
| Description | Role description. |

<b>Education Qualification</b> (click <b>new qualification</b>)

| **Column** | **Description** |
|------------|-----------------|
| School Name | Institution name. |
| Degree/Diploma | Qualification obtained. |
| Field Of Study | Area of study. |
| Completion Date | Date of completion. |

<hr class="doc-section-divider">

<h2 id="emergency-bank">Emergency Contact &amp; Bank Accounts</h2>

<b>Emergency Contact</b> (click <b>new Contact</b>)

| **Column** | **Description** |
|------------|-----------------|
| Name | Contact person name. |
| Relation | Relationship to employee. |
| Phone | Contact phone number. |

<b>Bank accounts</b> (click <b>new account</b>)

| **Column** | **Description** |
|------------|-----------------|
| Account holder Name | Name on the bank account. |
| Account number | Bank account number. |
| Bank name | Bank name. |
| Branch | Bank branch. |
| IFSC Code | IFSC code (India). |
| IBAN Number | IBAN number. |

<hr class="doc-section-divider">

<h2 id="access-pass">Employee Access Pass</h2>

<img src="hr/images/access-pass-emp.webp" alt="Employee Access Pass" loading="lazy">

| **Field** | **Description** |
|-----------|-----------------|
| Employee Pass Status | Current pass status. |
| Pass Issued Date | Date the pass was issued. |
| Pass Expiry Date | Pass expiry date. |
| Pass Returned Date | Date the pass was returned. |

<hr class="doc-section-divider">

<h2 id="actions-status">Actions &amp; Status</h2>

<h3>View toolbar actions</h3>

| **Action** | **Description** |
|------------|-----------------|
| Edit | Opens employee for editing. |
| Delete | Permanently removes the employee. |
| Clone | Creates a copy. |
| Print | Prints employee details. |

<h3>More menu (⋮) actions</h3>

| **Action** | **Description** |
|------------|-----------------|
| Activate | Reactivates a suspended or inactive employee. |
| Remove login access | Removes system login without deactivating the employee. |
| Terminate | Marks the employee as resigned/terminated. |
| Set login access | Grants system login with a role. |

<h3>Statuses</h3>

| **Status** | **Description** |
|------------|-----------------|
| Active | Currently employed and active. |
| Active and no login access | Active but cannot log in to the system. |
| Inactive | Temporarily inactive. |
| Resigned | Employee has left the organization. |

<hr class="doc-section-divider">

<h2 id="view-tabs">View Tabs</h2>

<img src="hr/images/employee-profile.webp" alt="Employee profile view" loading="lazy">

| **Tab** | **What it shows** |
|---------|-------------------|
| Personal | Demographics, identity documents, visibility settings. |
| Contact | Phone, email, and address details. |
| Job Details | Current and historical job assignments. |
| Bank accounts | Salary bank account details. |
| Attachments | Uploaded documents (passport, visa, etc.). |

<img src="hr/images/attachment.webp" alt="Attachments tab" loading="lazy">

<hr class="doc-section-divider">

<h2 id="login-access">Login Access</h2>

Login access controls whether an employee can sign in to Freespace ERP.

<b>Set Login Access</b>

<img src="hr/images/login-access-page-emp.webp" alt="Set Login Access" loading="lazy">

<ol>
<li>Open the employee profile.</li>
<li>Click the more menu (⋮) → <b>Set Login Access</b>.</li>
<li>Select a <b>Role</b> and save.</li>
</ol>

<b>Remove Login Access</b>

<img src="hr/images/removelogin.webp" alt="Remove Login Access" loading="lazy">

<ol>
<li>Open the employee profile.</li>
<li>Click the more menu (⋮) → <b>Remove Login Access</b>.</li>
</ol>

<hr class="doc-section-divider">

<h2 id="best-practices">Best Practices</h2>

<ul>
<li>Fill in identity document expiry dates — the dashboard alerts you 45 days before expiry.</li>
<li>Assign Department, Job Title, and Head of the Employee for accurate reporting and approval routing.</li>
<li>Set <b>Consider in attendance</b> correctly — exclude employees who should not appear on attendance sheets.</li>
<li>Configure mandatory fields in <a href="#/hr/hrms-settings">HR Settings</a> before onboarding employees.</li>
</ul>

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>What is the difference between Salaried and Labour (Variable Shift)?</b><br>
<b>Salaried</b> employees have fixed schedules and monthly salary. <b>Labour (Variable Shift)</b> employees have variable shifts and are typically paid based on hours or piece rate.

<b>Can an employee log in without being Active?</b><br>
No. Use <b>Set Login Access</b> on an Active employee to grant login. Use <b>Active and no login access</b> status if the employee should not log in.

<b>How do I track document expiry?</b><br>
Enter expiry dates in the Identity section. The HRMS dashboard and <a href="#/hr/reports/employee-document-expiry-report">Employee Document Expiry Report</a> show documents expiring within 45 days.

<b>How do I link an employee to a system user?</b><br>
Use <b>Set Login Access</b> on the employee view — creates or links a user for Employee Profile and Field Sale App access.

<b>What is the difference between Employee Group and Department?</b><br>
Department is organizational structure. Employee Group is a flexible tag for filters and leave bulk credit — an employee can have both.

<b>Can I assign payroll group on the employee form?</b><br>
Yes on job/payroll details — links the employee to <a href="#/payroll/payroll-group">Payroll Group</a> for salary configuration and pay runs.

<b>Why can't a labour employee use time slot only?</b><br>
Labour (Variable Shift) employees should use shift maps. Time slot is intended for salaried fixed schedules.

<b>What happens when I suspend an employee?</b><br>
Suspended employees are hidden from new transactions but historical attendance and payroll records remain.

<b>How is Employee code assigned?</b><br>
If auto-generate is turned on for employees in Number Settings, the system generates the <b>Employee code</b> automatically from the numbering sequence (the field is hidden on the form). If it is off, enter the code manually.

<hr class="doc-section-divider">

<h2 id="related">Related Topics</h2>

<ul>
<li><a href="#/hr/department">Department</a> — organizational departments.</li>
<li><a href="#/hr/job-title">Job Title</a> — job titles and designations.</li>
<li><a href="#/hr/employee-profile">Employee Profile</a> — self-service portal for employees.</li>
<li><a href="#/hr/hrms-settings">HR Settings</a> — mandatory fields and attendance rules.</li>
<li><a href="#/hr/reports/employee-document-expiry-report">Employee Document Expiry Report</a> — track expiring documents.</li>
</ul>
