1. Overview
The Payslip screen provides a clear summary of an employee’s payroll amounts for a selected period. It organizes payroll totals into two sides: Earnings (amounts paid to the employee) and Deductions (amounts withheld or recovered).
2. Before You Start
2.1 Required data
- The employee must exist and be selectable in the Employee list.
- Payroll items must be configured correctly (especially whether each item is an earning or a deduction).
- Payroll entries/transactions must already be recorded for the selected date range.
2.2 Security access
2.3 Recommended preparation
- Confirm the employee’s pay setup is correct (rates, hours, pay period).
- Confirm payroll items are configured correctly (Income vs Deduction).
- Confirm payroll was processed/entered for the target period (so the payslip has data to summarize).
3. Generate a Payslip (Process)
The Payslip screen typically has an Employee selector, a Date / Period selector (often including quick options such as “This Month”), and a Process button.
- Open Employees → Payslip (menu name may vary depending on your QBM build).
- Select the Employee.
- Select the Date/Period (for example: “This Month”, or a From/To range if available).
- Click Process.
- Review the results in Earnings and Deductions.
- Confirm Net Salary at the bottom.
4. Understanding the Payslip Screen
4.1 Header controls
| Control | What it does |
|---|---|
| Employee | Selects which employee the payslip is generated for. |
| Date / Period | Defines the reporting period used when summarizing payroll records (commonly “This Month” or a date range). |
| Process | Loads and summarizes payroll data into Earnings and Deductions. |
4.2 Earnings and Deductions grids
The screen shows two grids:
- Earnings grid (left): totals that increase pay.
- Deductions grid (right): totals that reduce pay.
- Item (payroll item name)
- Amount (sum total for that item in the selected period)
4.3 Net Salary
At the bottom of the form, QBM shows Net Salary. Net Salary is typically computed as: Net = Total Earnings − Total Deductions
5. Earnings vs Deductions
The Payslip screen separates values based on how each payroll item is configured:
Earnings
Payroll items intended to pay the employee (salary, hourly, overtime, allowances, reimbursements).
Deductions
Payroll items intended to reduce the final pay (loan repayments, advances, penalties, any recovery items).
6. Print & Preview
Payslips are normally printed using QBM’s payslip print template. You can usually access printing from the File menu (or toolbar), such as:
- Print — sends the payslip to the printer.
- Preview — shows a preview of the payslip template before printing.
- Use a default payslip template automatically when you select Preview, or
- Ask you to choose a template (and possibly allow copying/creating notes) when you print.
7. Common Scenarios
7.1 Reprinting an old payslip
- Select the employee.
- Select the historical date/period.
- Click Process.
- Use Preview or Print.
7.2 Payslip shows totals but you need details
Payslip is a summary. If you need line-level detail (per day/job/hours), use payroll reports or payroll transaction screens, then compare totals to the payslip summary.
7.3 Employee receives multiple allowances/deductions
Ensure each allowance/deduction is a distinct payroll item. This makes payslip output readable and makes audits easier.
8. Troubleshooting
No data appears in Earnings or Deductions
- Confirm you selected the correct employee.
- Confirm you selected the correct date/period.
- Confirm payroll was entered/processed for that employee during that period.
- Confirm you clicked Process after changing filters.
Totals are wrong
- Confirm the period selection matches your intended payroll cycle (monthly/weekly/custom range).
- Verify payroll transactions were not duplicated for the same period.
- Verify payroll items are correctly configured as income vs deduction.
Earnings appears under Deductions (or the opposite)
- Open the payroll item definition.
- Verify the item is flagged correctly as a deduction or income.
- Re-run Process on the payslip screen.
Print/Preview is blocked
- Confirm the current user has payslip print permission.
- Confirm a payslip template exists and is accessible.
- Try Preview first to validate template selection.
share the final payroll posting layer (where payroll entry/transactions are saved and posted) and the payslip query logic used in production. Then the guide can be updated to describe the exact “source of truth” and posting lifecycle.
9. Best Practices
- Keep payroll item naming consistent (clear payslip output, clean reporting).
- Separate recurring deductions (loan repayment, advance repayment, penalties) into distinct payroll items.
- Validate employee setup (rates/hours/pay period) before running payroll, then use payslip as your final review.
- Preview before printing to ensure the correct template is used.
- Audit totals using payroll reports when issues are suspected (payslip is summary, reports provide deeper traceability).