# Payroll Group

<p class="doc-lead">Payroll Groups classify employees who share the same payroll cycle and salary structure. Groups are linked from <a href="#/payroll/salary-configuration">Salary Configuration</a>, where the hourly rate for production wages is defined per group or employee.</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/payroll-group?id=overview">Overview</a>
<a href="#/payroll/payroll-group?id=quick-start">Quick Start</a>
<a href="#/payroll/payroll-group?id=fields">Fields</a>
<a href="#/payroll/payroll-group?id=hourly-rate">Hourly Rate for Production</a>
<a href="#/payroll/payroll-group?id=how-it-works">How It Works</a>
<a href="#/payroll/payroll-group?id=actions">Actions</a>
<a href="#/payroll/payroll-group?id=faq">FAQ</a>
<a href="#/payroll/payroll-group?id=related">Related</a>
</div>
</div>
</div>

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

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

Go to <b>Payroll → Settings → Payroll Group</b>.

A Payroll Group is a named set of employees. Use groups to organize salary configurations — monthly components, overtime rates, and the <b>Hourly Rate</b> used when production vouchers calculate hourly production wages.

<img src="payroll/images/d-paygrp-list.webp" alt="Payroll Group list" loading="lazy">

<h3 id="list-columns">List columns</h3>

| **Column** | **Description** |
|------------|-----------------|
| Id | System ID. |
| Name | Group name. |
| Description | Optional note. |
| Employees | Employees assigned to this group. |

Quick filter tabs: <b>Active</b>, <b>Suspended</b>.

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

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

<h3>1. Create a group</h3>
Go to <b>Payroll → Settings → Payroll Group</b>, click <b>New</b>, enter <b>Name</b> and optionally assign <b>Employees</b>.

<img src="payroll/images/d-paygrp-new.webp" alt="New Payroll Group form" loading="lazy">

<h3>2. Configure salary and hourly rate</h3>
Open <a href="#/payroll/salary-configuration">Salary Configuration</a>, select the payroll group (or a specific employee), and enter payment lines plus <b>Hourly Rate (Used for employee production wage)</b>.

<h3>3. Enable production wages</h3>
Turn on <b>Enable Piece-Rate/Hourly-Rate Wages in Production</b> in <a href="#/payroll/payroll-settings">Payroll Settings</a>. See the production wage flow there.

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

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

| **Field** | **Description** |
|-----------|-----------------|
| Name * | Group display name. |
| Description | Optional note. |
| Employee | One or more employees to assign to this group. Employees can belong to one payroll group at a time via their profile. |

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

<h2 id="hourly-rate">Hourly Rate for Production</h2>

The hourly rate is <b>not</b> stored on the Payroll Group record itself. It is set on <a href="#/payroll/salary-configuration">Salary Configuration</a> (<b>Payroll → Salary Configuration</b>):

| **Salary Configuration field** | **Description** |
|----------------------------------|-----------------|
| Payroll group | Links the configuration to this group (or choose a specific employee instead). |
| Hourly Rate (Used for employee production wage) | Rate per hour for hourly production wages. |
| Overtime Rate Per Hour | OT rate for pay-run OT calculations. |
| Holiday OT Rate Per Hour | OT rate on holidays. |

<p><b>Hourly production wage formula:</b></p>

```
Wage amount = Hours worked × Hourly Rate (from Salary Configuration)
```

<p><b>Piece-rate production wage</b> uses the rate on the BOM, not the hourly rate:</p>

```
Wage amount = Quantity produced × Piece Rate (from BOM)
```

<p>Verify production wages before pay run using <a href="#/payroll/production-wage">Production Wage</a> and the <a href="#/payroll/reports/employee-piece-rate-report">Employee Piece Rate Report</a>.</p>

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

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

<ul>
<li><b>Employee assignment</b> — Assign employees on the group form or from the employee profile. Group membership drives which Salary Configuration applies.</li>
<li><b>Salary Configuration</b> — Each group (or employee override) has payment category lines, calculation basis (monthly/daily), effective date, and production wage rates.</li>
<li><b>Pay Run</b> — When a pay run is created for an employee, the active Salary Configuration for their payroll group supplies earning amounts and OT rates.</li>
<li><b>Production</b> — On production voucher approve, hourly wage lines multiply hours by the employee's configured hourly rate; piece-rate lines use the BOM rate.</li>
</ul>

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

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

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

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

<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>Where do I set the hourly rate?</b><br>On <a href="#/payroll/salary-configuration">Salary Configuration</a>, not on the Payroll Group form. Select the payroll group and enter <b>Hourly Rate (Used for employee production wage)</b>.</p>

<p><b>Can one employee have a different rate than their group?</b><br>Yes. Create a Salary Configuration targeted to the individual employee instead of the group.</p>

<p><b>Do I need a payroll group for every employee?</b><br>Recommended for structured payroll. Employees without a group can still have an employee-specific Salary Configuration.</p>

<p><b>How do I assign employees to a group?</b><br>Set Payroll Group on the <a href="#/hr/employees">Employee</a> profile — the group drives default salary configuration and group additional payments.</p>

<p><b>Can I use a payroll group for bulk additional payment?</b><br>Yes. Select the group on <a href="#/payroll/additional-payment">Additional Payment</a> type Group — one line is created per employee in the group.</p>

<p><b>What happens if I suspend a payroll group?</b><br>Suspended groups cannot be selected on new employee records or group payments. Existing salary configurations remain until edited.</p>

<p><b>Is payroll group the same as employee group in HR?</b><br>No. Payroll Group is for salary structure and pay-run components. HR Employee Group is for HR reporting and workflow — they are separate masters.</p>

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

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

<ul>
<li><a href="#/payroll/salary-configuration">Salary Configuration</a></li>
<li><a href="#/payroll/payroll-settings">Payroll Settings</a></li>
<li><a href="#/payroll/production-wage">Production Wage</a></li>
<li><a href="#/payroll/pay-run">Pay Run</a></li>
</ul>
