> ## Documentation Index
> Fetch the complete documentation index at: https://human-resource-docs.ha-consultancy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payroll Setup

> Configure salary components, employee salary packages, end-of-service rules, social insurance, overtime multipliers, air-ticket policy, and G/L account mapping.

The system captures all the inputs a payroll run needs: each employee's salary breakdown, the company's end-of-service rules, social-insurance contributions, overtime multipliers, allowances, and air-ticket entitlement. Each month you generate the salary journal (see [Journals](/features/journals)) using these settings.

## What you can configure

* **Salary components** — Basic Salary, Transportation, Travel, Communication, Accommodation, plus any you add (bonus, deduction, custom allowance).
* **Salary packages per employee** — which components apply to whom, at what amounts, and from when.
* **Compensation allowance rules** — fixed amounts or percentage-of-basic.
* **End-of-Service (EOS) rules** — the indemnity formula on termination (e.g. 21 days/year for the first 5 years, 30 days/year thereafter).
* **Social insurance** — employer and employee contribution percentages, with brackets if applicable.
* **Overtime multipliers** — different rates per day, e.g. 1.5× weekday, 2× weekend.
* **Air-ticket policy** — frequency and class, varying by position and nationality.
* **G/L account mapping** — which accounts each HR amount posts to.

## Before you start

* Configure your chart of accounts so the HR-specific accounts (salary, leave, EOS, loans…) exist.
* Set up [master data](/features/master-data) — positions, nationalities, work types — these drive air-ticket and EOS eligibility.

## Walkthroughs

### Walkthrough 1 — Add a salary component

Add a new salary component, e.g. *Performance Bonus*.

1. Search for **Salary Type List**.
2. Click **New**.
3. Type the component label in the **Type** column.
4. Press **Esc** to save.

<Note>The basics (Basic Salary, Transportation, Travel, Communication, Accommodation Allowances) are already there from initial setup and can't be deleted.</Note>

***

### Walkthrough 2 — Set up end-of-service rules

Define the indemnity formula payable on termination. Typical GCC pattern: 21 days of basic salary per year of service for the first 5 years, 30 days per year thereafter.

1. Search for **EOS Config List**.
2. Click **New**. A blank rule card opens.
3. Give it a **Name** (e.g. `Standard EOS`).
4. In the **Lines** section, add tiers:
   * First row: From Year `0`, To Year `5`, Days Per Year `21`.
   * Second row: From Year `5`, To Year `999`, Days Per Year `30`.
5. Press **Esc** to save.

Once saved, assign this rule code on each eligible employee's card under End-of-Service. Termination calculations use it.

***

### Walkthrough 3 — Set up social insurance

Set employer and employee contribution percentages for the local social-insurance scheme.

1. Search for **Soc. Insur. Setting List**.
2. Click **New**. A blank settings card opens.
3. Fill the name, employer percentage, employee percentage. Add salary brackets if your scheme has them.
4. Press **Esc** to save.

Once saved, assign this code on eligible employees' cards. Monthly salary calculation adds the employer and employee contribution lines automatically.

***

### Walkthrough 4 — Set up overtime multipliers

Define overtime rates — e.g. 1.5× for weekday overtime, 2× for weekend or holiday work.

1. Search for **Overtime Config List**.
2. Click **New**.
3. Fill the multiplier bands per day-of-week or hour-of-day.
4. Press **Esc** to save.

Assign on each eligible employee's card under Overtime. The overtime engine applies the multipliers using the employee's attendance punches.

***

### Walkthrough 5 — Set up air-ticket policy

Common in GCC: eligible employees get an annual return ticket to their home country, with class varying by position.

1. Search for **Air Ticket Policy**.
2. Click **New**. A blank policy card opens.
3. Fill the name, how often (annual / biennial), and the class (Economy / Business).
4. In the Position sublist, list the positions eligible for the higher class.
5. In the Nationality sublist, list the nationalities whose home country governs the route.
6. Press **Esc** to save.

The Employee Air Ticket flow now uses this policy to schedule and record per-employee tickets.

***

### Walkthrough 6 — Set up an employee's salary package

Capture an employee's compensation structure.

1. Open the employee's card → click **Salary Package** on the ribbon.
2. Click **New**. A blank package card opens with a reference number filled in for you.
3. Set the **Status** to `Draft` while editing.
4. Set **Effective From** and **Effective To**. The system blocks you from having two active packages overlap for the same employee — that's protection against accidental double-pay.
5. In the **Items** section, add one row per component — pick the salary type and enter the amount.
6. Change the **Status** to `Active` once the figures are right.
7. Press **Esc** to save.

<Tip>**Giving a raise:** close the current package (set its Effective To date), then create a new one starting the next day with the new figures.</Tip>

***

### Walkthrough 7 — Wire HR to your chart of accounts

Before you can post salary journals to the ledger, point each HR-specific account at the right G/L account.

1. Search for **Employee Posting Groups**.
2. Open the row matching your default posting group (or create one).
3. Fill the HR-specific account fields: Employees Leave Account, Employees Overtime Account, Employees EOS Account, Employees Salary Account, Employees Warnings Account, Employees Deduc. Account, Employees Loans Account, Employees Bonus Account, Employees Advance Account, Loan Installment Account.
4. Press **Esc** to save.

If you don't use a particular module yet, you can leave its field blank and fill it later.

## Related features

* [Journals](/features/journals) — the monthly salary journal that uses everything you configure here.
* [Leave management](/features/leave-management) — leave consumption can change which salary components accrue.
* [Loans & advances](/features/loans-and-advances) — loan installments and advances net off the monthly salary.
* [Master data](/features/master-data) — work type, nationality, and position drive EOS and air-ticket entitlement.