Add component lines
Where: a DRAFT pay run → Employee entries → select the employee → Add component line.
Who: payroll.run.manage, payroll.setup.view (to choose the component), payroll.detail.view (to
open the entry).
Component lines add earnings, deductions and employer contributions on top of base pay. Each line is quantity × rate, entered by you.
Add a line
- Open the employee's entry and select Add component line.
- Fill in Add explicit component amount:
| Field | Rule | Example (Amira's overtime) |
|---|---|---|
| Component version | Its dates must cover the employee's whole service period | OVERTIME · V1 |
| Quantity | More than zero; up to 6 decimals | 10.5 |
| Rate (positive deduction amounts) | Zero or more, in the run currency; deductions are positive | 21.6346 |
| Unique source reference | Unique within this employee entry | OT-2026-10-001 |
| Reason | Required | 10.5 overtime hours approved 30 Oct |
- Save. The line appears under Component lines with its component and version, kind and tax treatment, quantity × rate, and amount (Uncalculated until the run is calculated).
Examples
Amira, October:
| Component | Kind | Quantity | Rate | Amount | Source reference |
|---|---|---|---|---|---|
Overtime V1 | Earning | 10.5 | 21.6346 | 227.16 | OT-2026-10-001 |
Employee pension 2026-1 | Deduction | 1 | 150.00 | 150.00 | PEN-2026-10-001 |
Employer pension V1 | Employer contribution | 1 | 90.00 | 90.00 | ERPEN-2026-10-001 |
The pension amounts were worked out outside Trade Manager (Payroll has no pension rules) and entered as quantity 1 × the amount.
The source reference prevents double counting
Use the identifier of the source: a timesheet line, an overtime approval, a pension schedule row. If the same line is entered twice, the second is refused: "The resource was changed or conflicts with existing data". This protects against importing or clicking twice.
Rules
- Every amount is positive. The component's kind decides whether it adds or subtracts.
- Negative adjustments, percentages, loans and arrears are not supported: enter the worked-out amount.
- Tax treatment is a label. A Pre tax deduction subtracts its amount like any other; nothing recalculates tax.
- Each line is rounded on its own before totals are added. Two lines of 0.005 become 0.01 + 0.01 = 0.02.
| Message | Meaning |
|---|---|
| Component must cover the entire entry service period | The version's dates don't cover the whole service period. Choose the right version. |
| Payroll run must be DRAFT | The run has been calculated. Reopen it first. |
Remove a line
On the employee's statement, select the line's remove action, enter a Reason and select Confirm removal. Draft runs only. The removal is recorded in the workflow history.