# Chapter 1: Getting start with Payroll module

## 1.1 Payroll Quick Start

## Overview

The Quick Start Guide provides the minimum setup required before using the Payroll Module.

## Prerequisites

Before starting, ensure:

- Core Module has been installed.
- User has Payroll access permission.
- Company profile has been configured.

## Navigation

```
Payroll
```

<div class="relative w-full mt-4 mb-1" id="bkmrk-"><div class=""><div class="contents"><div class="relative"><div class="h-full min-h-0 min-w-0"><div class="h-full min-h-0 min-w-0"><div class="border border-token-border-light border-radius-3xl corner-superellipse/1.1 rounded-3xl"><div class="h-full w-full border-radius-3xl bg-token-bg-elevated-secondary corner-superellipse/1.1 overflow-clip rounded-3xl lxnfua_clipPathFallback"><div class="relative"><div class="pe-11 pt-3"><div class="relative z-0 flex max-w-full"><div class="q9tKkq_viewer cm-editor z-10 light:cm-light dark:cm-light flex h-full w-full flex-col items-stretch ͼs ͼ16" dir="ltr" id="bkmrk--1"><div class="cm-scroller"></div></div></div></div></div></div></div></div></div><div class=""><div class="">  
</div></div></div></div></div></div>## Setup Workflow

```
Setup HR Profile
        │
        ▼
Setup Payroll Components
        │
        ▼
Configure Statutory Data
        │
        ▼
Register Employee
        │
        ▼
Setup Account Posting
        │
        ▼
Assign Leave & Claim Approver
        │
        ▼
Ready to Process Payroll
```

## Quick Start Checklist

<div class="TyagGW_tableContainer" id="bkmrk-step-description-1-s"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="1549" data-start="1282"><thead data-end="1313" data-start="1282"><tr data-end="1313" data-start="1282"><th class="last:pe-10" data-col-size="sm" data-end="1289" data-start="1282">Step</th><th class="last:pe-10" data-col-size="sm" data-end="1303" data-start="1289">Description</th></tr></thead><tbody data-end="1549" data-start="1346"><tr data-end="1374" data-start="1346"><td data-col-size="sm" data-end="1350" data-start="1346">1</td><td data-col-size="sm" data-end="1369" data-start="1350">Setup HR Profile</td></tr><tr data-end="1411" data-start="1375"><td data-col-size="sm" data-end="1379" data-start="1375">2</td><td data-col-size="sm" data-end="1406" data-start="1379">Setup Payroll Components</td></tr><tr data-end="1444" data-start="1412"><td data-col-size="sm" data-end="1416" data-start="1412">3</td><td data-col-size="sm" data-end="1439" data-start="1416">Setup Statutory Data</td></tr><tr data-end="1474" data-start="1445"><td data-col-size="sm" data-end="1449" data-start="1445">4</td><td data-col-size="sm" data-end="1469" data-start="1449">Register Employee</td></tr><tr data-end="1508" data-start="1475"><td data-col-size="sm" data-end="1479" data-start="1475">5</td><td data-col-size="sm" data-end="1503" data-start="1479">Setup Account Posting</td></tr><tr data-end="1549" data-start="1509"><td data-col-size="sm" data-end="1513" data-start="1509">6</td><td data-col-size="sm" data-end="1544" data-start="1513">Setup Leave &amp; Claim Approver</td></tr></tbody></table>

</div></div>## Expected Result

After completing all setup steps, the Payroll Module is ready for payroll processing.

<div class="TyagGW_tableContainer" id="bkmrk-task-result-configur"></div><div class="relative w-full mt-4 mb-1" id="bkmrk--2"><div class=""><div class="contents"><div class="relative"><div class=""></div></div></div></div></div>---

## 1.2 Setup Compensation Data

### Purpose

Configure government-required payroll deductions.

Example: Compensation Management

[![image.png](https://documentation.xccel.my/uploads/images/gallery/2026-07/scaled-1680-/NGoimage.png)](https://documentation.xccel.my/uploads/images/gallery/2026-07/NGoimage.png)

This is default record.

[![image.png](https://documentation.xccel.my/uploads/images/gallery/2026-07/scaled-1680-/8sjimage.png)](https://documentation.xccel.my/uploads/images/gallery/2026-07/8sjimage.png)

---

### Workflow

```
Payroll Module
    ↓
Payroll Component
    ↓
Compensation
    ↓
+ Create
    ↓
Save
```

<div class="relative w-full mt-4 mb-1" id="bkmrk--8"><div class=""><div class="contents"><div class="relative"><div class="h-full min-h-0 min-w-0"><div class="h-full min-h-0 min-w-0"><div class="border border-token-border-light border-radius-3xl corner-superellipse/1.1 rounded-3xl"><div class="h-full w-full border-radius-3xl bg-token-bg-elevated-secondary corner-superellipse/1.1 overflow-clip rounded-3xl lxnfua_clipPathFallback"><div class="relative"><div class="pe-11 pt-3"><div class="relative z-0 flex max-w-full"><div class="q9tKkq_viewer cm-editor z-10 light:cm-light dark:cm-light flex h-full w-full flex-col items-stretch ͼs ͼ16" dir="ltr" id="bkmrk--9"><div class="cm-scroller">  
</div></div></div></div></div></div></div></div></div><div class=""><div class="">  
</div></div></div></div></div></div>---

## 1.3 Setup Payroll Components

### Purpose

Payroll Components define how employee salaries are calculated.

##### 1. Position

Purpose

The Position module manages the list of employee job positions within the organization.

Functions

- Create new job positions
- Edit existing positions
- Assign positions to employees
- Organize payroll by job role

Examples

- Manager
- Supervisor
- Executive
- Technician
- Clerk

---

##### 2. Department

Purpose

The Department module manages the organizational departments used throughout the payroll system.

Functions

- Create departments
- Update department information
- Assign employees to departments
- Generate department-based payroll reports

Examples

- Human Resources
- Finance
- Sales
- Marketing
- Production
- IT

---

##### 3. Compensation

Purpose

The Compensation module defines employee salary structures and recurring earnings.

Functions

- Configure basic salary
- Set salary frequency
- Manage fixed compensation
- Support payroll calculation

Examples

- Basic Salary
- Fixed Monthly Salary
- Daily Wage
- Hourly Rate

---

##### 4. Allowance

Purpose

The Allowance module manages additional payments provided to employees beyond their basic salary.

Functions

- Create allowance types
- Configure allowance amount
- Assign allowances to employees
- Include allowances in payroll processing

Common Allowances

- Transport Allowance
- Meal Allowance
- Housing Allowance
- Phone Allowance
- Travel Allowance

---

##### 5. Deduction

Purpose

The Deduction module manages salary deductions applied during payroll calculation.

Functions

- Create deduction types
- Configure deduction rules
- Apply recurring deductions
- Include statutory deductions

Common Deductions

- Income Tax (PCB)
- EPF (KWSP)
- SOCSO (PERKESO)
- EIS
- Loan Repayment
- Salary Advance

---

##### 6. Overtime

Purpose

The Overtime module manages overtime payment settings for employees.

Functions

- Configure overtime rates
- Define overtime categories
- Calculate overtime earnings
- Include overtime in payroll

Examples

- Normal Working Day
- Rest Day
- Public Holiday
- Weekend Overtime

---

##### 7. Commission

Purpose

The Commission module manages commission-based earnings for eligible employees.

Functions

- Configure commission schemes
- Assign commission to employees
- Calculate commission payments
- Include commissions in payroll

Examples

- Sales Commission
- Performance Commission
- Incentive Bonus

---

##### 8. Claim

Purpose

The Claim module manages employee reimbursement categories used in the Claim Approval process.

Functions

- Create claim categories
- Configure claim limits
- Define reimbursement rules
- Support employee claim submissions

Examples

- Travel
- Medical
- Accommodation
- Meal
- Transportation
- Miscellaneous

---

##### 9. Leave Setup

Purpose

The Leave Setup module configures company leave policies and entitlement rules.

Functions

- Configure leave entitlement
- Define leave eligibility
- Set leave accrual rules
- Configure carry-forward policies

Examples

- Annual Leave Entitlement
- Sick Leave Entitlement
- Carry Forward Limit
- Leave Expiry Rules

---

##### 10. Leave Type

Purpose

The Leave Type module defines the different categories of leave available to employees.

Functions

- Create leave types
- Configure leave settings
- Assign leave eligibility
- Link leave types to Leave Approval

Common Leave Types

- Annual Leave
- Sick Leave
- Emergency Leave
- Maternity Leave
- Paternity Leave
- Unpaid Leave
- Compassionate Leave

---

##### 11. Account Posting

Purpose

The Account Posting module maps payroll components to the company's accounting ledger. It ensures payroll transactions are posted to the correct General Ledger (GL) accounts during payroll processing.

Functions

- Configure GL account mapping
- Assign debit and credit accounts
- Link payroll components with accounting codes
- Support automatic accounting postings

Common Posting Accounts

<div class="TyagGW_tableContainer" id="bkmrk-payroll-component-ex"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)"><thead><tr><th class="last:pe-10">Payroll Component

</th><th class="last:pe-10">Example GL Account

</th></tr></thead><tbody><tr><td>Basic Salary

</td><td>Salary Expense

</td></tr><tr><td>Allowance

</td><td>Allowance Expense

</td></tr><tr><td>Overtime

</td><td>Overtime Expense

</td></tr><tr><td>Commission

</td><td>Commission Expense

</td></tr><tr><td>EPF

</td><td>EPF Payable

</td></tr><tr><td>SOCSO

</td><td>SOCSO Payable

</td></tr><tr><td>PCB

</td><td>Tax Payable

</td></tr><tr><td>Bonus

</td><td>Bonus Expense

</td></tr></tbody></table>

</div></div>---

<div class="TyagGW_tableContainer" id="bkmrk--22"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1">  
</div></div>---

## 1.4 Setup HR Profile (Core Module)

### Purpose

Before payroll can be used, every employee must have an HR Profile.

<table class="w-fit min-w-(--thread-content-width)" data-end="944" data-start="414" id="bkmrk-field-required-emp-c" style="width: 35%; height: 296px;"><thead data-end="437" data-start="414"><tr data-end="437" data-start="414" style="height: 29.6px;"><th class="last:pe-10" data-col-size="sm" data-end="422" data-start="414" style="width: 56.9336%; height: 29.6px;">Field</th><th style="width: 43.3393%; height: 29.6px;">Required</th></tr></thead><tbody data-end="944" data-start="464"><tr data-end="550" data-start="464" style="height: 29.6px;"><td data-col-size="sm" data-end="494" data-start="464" style="width: 56.9336%; height: 29.6px;">**Emp Code Index / Prefix**</td><td class="align-center" style="width: 43.3393%; height: 29.6px;">**Yes**</td></tr><tr data-end="593" data-start="551" style="height: 29.6px;"><td data-col-size="sm" data-end="566" data-start="551" style="width: 56.9336%; height: 29.6px;">**HR Email**</td><td class="align-center" style="width: 43.3393%; height: 29.6px;">**Yes**</td></tr><tr data-end="652" data-start="594" style="height: 29.6px;"><td data-col-size="sm" data-end="617" data-start="594" style="width: 56.9336%; height: 29.6px;">**Employer No. (E)**</td><td class="align-center" style="width: 43.3393%; height: 29.6px;">**Yes**</td></tr><tr data-end="706" data-start="653" style="height: 29.6px;"><td data-col-size="sm" data-end="671" data-start="653" style="width: 56.9336%; height: 29.6px;">**LHDN Branch**</td><td class="align-center" style="width: 43.3393%; height: 29.6px;">**Yes**</td></tr><tr data-end="763" data-start="707" style="height: 29.6px;"><td data-col-size="sm" data-end="722" data-start="707" style="width: 56.9336%; height: 29.6px;">**KWSP No.**</td><td class="align-center" style="width: 43.3393%; height: 29.6px;">**Yes**</td></tr><tr data-end="834" data-start="764" style="height: 29.6px;"><td data-col-size="sm" data-end="780" data-start="764" style="width: 56.9336%; height: 29.6px;">**SOCSO No.**</td><td class="align-center" style="width: 43.3393%; height: 29.6px;">**Yes**</td></tr><tr data-end="866" data-start="835" style="height: 29.6px;"><td data-col-size="sm" data-end="854" data-start="835" style="width: 56.9336%; height: 29.6px;">**Officer Name**</td><td class="align-center" style="width: 43.3393%; height: 29.6px;">**Yes**</td></tr><tr data-end="902" data-start="867" style="height: 29.6px;"><td data-col-size="sm" data-end="890" data-start="867" style="width: 56.9336%; height: 29.6px;">**Officer Position**</td><td class="align-center" style="width: 43.3393%; height: 29.6px;">**Yes**</td></tr><tr data-end="944" data-start="903" style="height: 29.6px;"><td data-col-size="sm" data-end="930" data-start="903" style="width: 56.9336%; height: 29.6px;">**Officer Phone Number**</td><td class="align-center" style="width: 43.3393%; height: 29.6px;">****Yes****</td></tr></tbody></table>

[![image.png](https://documentation.xccel.my/uploads/images/gallery/2026-07/scaled-1680-/3Quimage.png)](https://documentation.xccel.my/uploads/images/gallery/2026-07/3Quimage.png)

---

### Workflow

```
Core
   ↓
Branch / Company
   ↓
Edit record company
   ↓
Payroll
   ↓
Fill in HR information
```

<div class="relative w-full mt-4 mb-1" id="bkmrk--26"><div class=""><div class="contents"><div class="relative"><div class="h-full min-h-0 min-w-0"><div class="h-full min-h-0 min-w-0"><div class="border border-token-border-light border-radius-3xl corner-superellipse/1.1 rounded-3xl"><div class="h-full w-full border-radius-3xl bg-token-bg-elevated-secondary corner-superellipse/1.1 overflow-clip rounded-3xl lxnfua_clipPathFallback"><div class="relative"><div class="pe-11 pt-3"><div class="relative z-0 flex max-w-full"><div class="q9tKkq_viewer cm-editor z-10 light:cm-light dark:cm-light flex h-full w-full flex-col items-stretch ͼs ͼ16" dir="ltr" id="bkmrk--27"><div class="cm-scroller">  
</div></div></div></div></div></div></div></div></div><div class=""><div class="">  
</div></div></div></div></div></div>---

## 1.5 Register Employee

### Purpose

Register employees into the payroll system.

### Required Information

<table class="w-fit min-w-(--thread-content-width)" data-end="2747" data-start="2604" id="bkmrk-field-required-emplo-1" style="width: 29.0476%; height: 300px;"><thead data-end="2624" data-start="2604"><tr data-end="2624" data-start="2604" style="height: 46.4px;"><th class="last:pe-10" data-col-size="sm" data-end="2612" data-start="2604" style="width: 67.9266%; height: 46.4px;">Field</th><th class="last:pe-10" data-col-size="sm" data-end="2624" data-start="2612" style="width: 32.4295%; height: 46.4px;">Required</th></tr></thead><tbody data-end="2747" data-start="2649"><tr data-end="2687" data-start="2673" style="height: 29.6px;"><td data-col-size="sm" data-end="2680" data-start="2673" style="width: 67.9266%; height: 29.6px;">Employee Name</td><td data-col-size="sm" data-end="2687" data-start="2680" style="width: 32.4295%; height: 29.6px;">Yes</td></tr><tr><td style="width: 67.9266%;">Birthday</td><td style="width: 32.4295%;">Yes</td></tr><tr><td style="width: 67.9266%;">Retirement date</td><td style="width: 32.4295%;">Yes</td></tr></tbody></table>


<div class="TyagGW_tableContainer" id="bkmrk--30"></div>[![image.png](https://documentation.xccel.my/uploads/images/gallery/2026-07/scaled-1680-/mxIimage.png)](https://documentation.xccel.my/uploads/images/gallery/2026-07/mxIimage.png)

Users can configure the employee's payroll information

[![image.png](https://documentation.xccel.my/uploads/images/gallery/2026-07/scaled-1680-/bfMimage.png)](https://documentation.xccel.my/uploads/images/gallery/2026-07/bfMimage.png)

### Workflow

```
Payroll
   ↓
Employee
   ↓
Create
```

##### Expected Result

The payroll component is available for employee salary configuration.

<div class="relative w-full mt-4 mb-1" id="bkmrk--33"><div class=""><div class="contents"><div class="relative"><div class="h-full min-h-0 min-w-0"><div class="h-full min-h-0 min-w-0"><div class="border border-token-border-light border-radius-3xl corner-superellipse/1.1 rounded-3xl"><div class="h-full w-full border-radius-3xl bg-token-bg-elevated-secondary corner-superellipse/1.1 overflow-clip rounded-3xl lxnfua_clipPathFallback"><div class="relative"><div class="pe-11 pt-3"><div class="relative z-0 flex max-w-full"><div class="q9tKkq_viewer cm-editor z-10 light:cm-light dark:cm-light flex h-full w-full flex-col items-stretch ͼs ͼ16" dir="ltr" id="bkmrk--34"><div class="cm-scroller">  
</div></div></div></div></div></div></div></div></div></div></div></div></div>---

## 1.6 Setup Account Posting

### Purpose

The Account Posting module maps payroll components to the company's accounting ledger. It ensures payroll transactions are posted to the correct General Ledger (GL) accounts during payroll processing.

[![image.png](https://documentation.xccel.my/uploads/images/gallery/2026-07/scaled-1680-/0w8image.png)](https://documentation.xccel.my/uploads/images/gallery/2026-07/0w8image.png)

---

### Posting Workflow

```
Payroll
      ↓
Payroll Component
      ↓
Account Posting
```

<div class="relative w-full mt-4 mb-1" id="bkmrk--39"><div class=""><div class="contents"><div class="relative"><div class="h-full min-h-0 min-w-0"><div class="h-full min-h-0 min-w-0"><div class="border border-token-border-light border-radius-3xl corner-superellipse/1.1 rounded-3xl"><div class="h-full w-full border-radius-3xl bg-token-bg-elevated-secondary corner-superellipse/1.1 overflow-clip rounded-3xl lxnfua_clipPathFallback"><div class="relative"><div class="pe-11 pt-3"><div class="relative z-0 flex max-w-full"><div class="q9tKkq_viewer cm-editor z-10 light:cm-light dark:cm-light flex h-full w-full flex-col items-stretch ͼs ͼ16" dir="ltr" id="bkmrk--40"></div></div></div></div></div></div></div></div><div class=""><div class=""></div></div></div></div></div></div>---

## 1.7 Setup Superior for Approval Request

### Purpose

Assign approvers for leave.

Approval Flow

```
Core
      ↓
Approval Request
      
```

[![image.png](https://documentation.xccel.my/uploads/images/gallery/2026-07/scaled-1680-/Zaoimage.png)](https://documentation.xccel.my/uploads/images/gallery/2026-07/Zaoimage.png)

<div class="relative w-full mt-4 mb-1" id="bkmrk--44"><div class=""><div class="contents"><div class="relative"><div class="h-full min-h-0 min-w-0"><div class="h-full min-h-0 min-w-0"><div class="border border-token-border-light border-radius-3xl corner-superellipse/1.1 rounded-3xl"><div class="h-full w-full border-radius-3xl bg-token-bg-elevated-secondary corner-superellipse/1.1 overflow-clip rounded-3xl lxnfua_clipPathFallback"><div class="relative"><div class="pe-11 pt-3"><div class="relative z-0 flex max-w-full"><div class="q9tKkq_viewer cm-editor z-10 light:cm-light dark:cm-light flex h-full w-full flex-col items-stretch ͼs ͼ16" dir="ltr" id="bkmrk--45"><div class="cm-scroller">  
</div></div></div></div></div></div></div></div></div><div class=""><div class="">  
</div></div></div></div></div></div>