# Deduction Categories

<p class="doc-lead">Deduction Categories define how amounts are subtracted from an employee's pay — cash advances, deductions on expenses, and loss-of-pay (LOP). Each category maps to ledger accounts used when a pay run or deduction transaction is approved.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<div class="doc-toc-links">
<a href="#/payroll/deduction-categories?id=overview">Overview</a>
<a href="#/payroll/deduction-categories?id=quick-start">Quick Start</a>
<a href="#/payroll/deduction-categories?id=fields">Fields</a>
<a href="#/payroll/deduction-categories?id=seed-data">Default Categories</a>
<a href="#/payroll/deduction-categories?id=custom-categories">Custom Deduction Categories</a>
<a href="#/payroll/deduction-categories?id=how-it-works">How It Works</a>
<a href="#/payroll/deduction-categories?id=actions">Actions</a>
<a href="#/payroll/deduction-categories?id=faq">FAQ</a>
<a href="#/payroll/deduction-categories?id=related">Related</a>
</div>
</div>
</div>

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

<h2 id="overview">Overview</h2>

Go to <b>Payroll → Settings → Deduction Categories</b>.

Deduction Categories appear on <a href="#/payroll/pay-run">Pay Run</a> deduction lines, <a href="#/payroll/cash-advance-voucher">Cash Advance Voucher</a>, and <a href="#/payroll/deduction-on-expense">Deduction on Expense</a>. Use the quick filter tabs and Advanced Filters to find categories by name, credit account, or LOP flag.

<img src="payroll/images/deductioncategory.webp" alt="Deduction Categories list" loading="lazy">

<b>List columns</b>

| **Column** | **Shows** |
|------------|-----------|
| Id | Category reference number. |
| Name | Deduction category name. |
| Description | Optional note. |
| Credit account | Account credited when the deduction is posted. |

<b>Quick filter tabs</b>

| **Tab** | **Shows** |
|---------|-----------|
| Active | Active categories (default). |
| Suspended | Suspended categories. |

<b>Advanced Filters</b>

Id, Name, Description, Credit Account, Is Amount affected on lop days, Status, and Created Date.

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

<h2 id="quick-start">Quick Start</h2>

<h3>1. Navigate</h3>
Go to <b>Payroll → Settings → Deduction Categories</b> and click <b>New</b>.

<h3>2. Fill the form</h3>
Enter <b>Name</b>, select a <b>Credit Account</b>, and optionally enable <b>Is Amount affected on lop days</b>. The debit account defaults to Wages Payable.

<h3>3. Save</h3>
Click <b>Save</b>. The category is available on pay runs and deduction transactions.

<img src="payroll/images/new-dedctn-catgry.webp" alt="New Deduction Category form" loading="lazy">

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

<h2 id="fields">Fields</h2>

| **Field** | **Description** |
|-----------|-----------------|
| Name * | Display name on pay runs and reports. |
| Description | Optional note. |
| Credit Account * | Account credited when the deduction is posted (e.g. employee advance receivable). |
| Is Amount affected on lop days | When enabled, LOP-related salary reductions can affect this deduction category. Default: off. |

<p>On save, the system records the credit account origin (<b>creditOrigin</b>). Debit posts to Wages Payable by default.</p>

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

<h2 id="seed-data">Default Categories</h2>

| **Name** | **Debit Account** | **Credit Account** | **LOP Affected** | **Used for** |
|----------|-------------------|--------------------|------------------|--------------|
| Cash advance | Wages Payable | Employee advance receivable | No | Cash advance recovery on pay runs |
| Deduction on expense | Wages Payable | Employee advance receivable | No | Linking to <a href="#/payroll/deduction-on-expense">Deduction on Expense</a> vouchers |
| Loss of Pay | Wages Payable | Salary expense | No | LOP salary deduction lines on pay runs |

<p><b>Loss of Pay</b> is used when salary is reduced for unpaid leave under deduction-mode calculation. Any custom categories you create (see <a href="#/payroll/deduction-categories?id=custom-categories">Custom Deduction Categories</a>) are treated as "other deductions" in balance and statement reports — they reduce net payable but are kept separate from the Cash advance and Deduction on expense workflows.</p>

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

<h2 id="custom-categories">Custom Deduction Categories</h2>

Beyond the seeded categories, you can create your own deduction categories for statutory, contractual, or voluntary deductions that apply in your region. Each custom category maps to a <b>Credit Account</b> — the liability or payable account where the withheld amount accrues — while the debit always posts to Wages Payable, reducing the employee's net pay. When a pay run is approved, the deduction lines credit the payable account so the accrued amount is ready for remittance.

<h3>India</h3>

Indian payroll typically includes several mandatory statutory deductions alongside voluntary ones:

| **Category** | **Type** | **Notes** |
|--------------|----------|-----------|
| Provident Fund (PF) | Mandatory | Employees' Provident Fund — a mandatory retirement social security scheme. The employee contribution (typically 12% of Basic + DA) is withheld and credited to a PF payable account for remittance to EPFO. |
| Employees' State Insurance (ESIC) | Mandatory | Health and social security cover for employees earning below the wage threshold. The employee share is withheld and credited to an ESI payable account. |
| Professional Tax (PT) | Mandatory (state) | State-levied tax deducted monthly and remitted to the state government. |
| TDS on Salary | Mandatory | Income tax deducted at source, credited to a TDS payable account. |
| Labour Welfare Fund (LWF) | Mandatory (state) | Small periodic contribution in states where it applies. |
| Salary Advance / Loan Recovery | Voluntary / contractual | Repayment of company loans or salary advances. |

<p><b>Example scenario — India.</b> A manufacturing company must withhold PF and ESIC from every eligible employee each month. Create a <b>Provident Fund (PF)</b> category with a "PF Payable" credit account and an <b>Employees' State Insurance (ESIC)</b> category with an "ESI Payable" credit account. On pay run approval, both appear as deduction lines: Wages Payable is debited and the respective payable accounts are credited, so the accrued statutory liability is ready for monthly remittance to EPFO and ESIC.</p>

<h3>Middle East</h3>

In most GCC countries there is no personal income tax, so deductions are usually limited to social security for nationals plus voluntary or contractual items:

| **Category** | **Type** | **Notes** |
|--------------|----------|-----------|
| Social Security (GOSI / GPSSA / PIFSS) | Mandatory for GCC nationals | Withheld only for GCC national employees; expatriate staff are generally exempt. Examples: GOSI (Saudi Arabia), GPSSA (UAE), PIFSS (Kuwait). Credited to a social security payable account. |
| Salary Advance / Loan Recovery | Voluntary / contractual | Recovery of staff loans or advances. |
| Fines / Penalties | Contractual | Disciplinary deductions within the limits set by local labour law. |
| Unpaid Leave / Absence | Contractual | Deduction for days not covered by paid leave (often handled through Loss of Pay). |

<p><b>Example scenario — Middle East.</b> A company in Saudi Arabia employs both Saudi nationals and expatriates. Social security (GOSI) applies only to the Saudi nationals, so create a <b>GOSI (Social Security)</b> category linked to a "GOSI Payable" account and apply it on the pay runs of national employees only. Expatriate employees have no statutory salary deduction, so their pay runs carry only voluntary deductions such as loan recovery. Because there is no personal income tax, no TDS-equivalent category is needed.</p>

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

<h2 id="how-it-works">How It Works</h2>

<ul>
<li><b>Pay Run</b> — Deduction lines on a pay run debit Wages Payable and credit the category's account. Cash advance deductions recover outstanding advances.</li>
<li><b>Cash Advance Voucher</b> — When an advance is issued, it posts against the Cash advance category. Receipt vouchers reduce the balance.</li>
<li><b>Deduction on Expense</b> — Standalone deductions use the Deduction on expense category and appear on the <a href="#/payroll/reports/employee-statement-report">Employee Statement</a>.</li>
<li><b>LOP</b> — Under deduction-style salary calculation, LOP amounts post through the Loss of Pay category, reversing the salary expense.</li>
</ul>

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

<h2 id="actions">Actions</h2>

<b>List header:</b> <b>New</b>

| **Action** | **Description** |
|------------|-----------------|
| View | Opens the category in read-only view |
| Edit | Opens the edit form |
| Delete | Removes the category when not referenced |
| Suspend / Activate | Disables or re-enables the category |

<b>Form buttons:</b> <b>Save</b> / <b>Update</b>, <b>Reset</b>, <b>Cancel</b>

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

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

<p><b>Why can't I change the debit account on the form?</b><br>Debit account is fixed to Wages Payable. Deductions reduce the net amount owed to the employee.</p>

<p><b>What is the difference between Cash advance and Deduction on expense?</b><br>Cash advance is for advances issued and recovered through pay runs. Deduction on expense is for ad-hoc deductions recorded on <a href="#/payroll/deduction-on-expense">Deduction on Expense</a> vouchers.</p>

<p><b>Which deductions count as "Other Deductions" on the Employee Wise Salary report?</b><br>Loss of Pay and any custom deduction categories you create — everything other than the Cash advance and Deduction on expense categories.</p>

<p><b>What is Loss of Pay category?</b><br>A seeded deduction category for LOP amounts when salary calculation uses deduction mode — it appears as separate pay-run deduction lines.</p>

<p><b>Can I create custom deduction categories?</b><br>Yes. Create categories for statutory or voluntary deductions such as Provident Fund (PF), ESIC, Professional Tax, or GOSI (see <a href="#/payroll/deduction-categories?id=custom-categories">Custom Deduction Categories</a>). The Cash advance and Deduction on expense categories are reserved for their built-in workflows.</p>

<p><b>Why does cash advance recovery use the Cash advance category?</b><br>It links pay-run deduction lines to <a href="#/payroll/cash-advance-voucher">Cash Advance Voucher</a> references for balance tracking.</p>

<p><b>Do deduction categories post on pay-run approve?</b><br>Yes together with payment lines — net effect reduces Wages Payable by total deductions.</p>

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

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

<ul>
<li><a href="#/payroll/payment-categories">Payment Categories</a></li>
<li><a href="#/payroll/cash-advance-voucher">Cash Advance Voucher</a></li>
<li><a href="#/payroll/deduction-on-expense">Deduction on Expense</a></li>
<li><a href="#/payroll/pay-run">Pay Run</a></li>
</ul>
