Skip to main content

Payroll

This module enables payroll management. Optionally integrates with LoanManagement for automatic loan repayment deductions.

Features​

  • Salary Structures - Define flexible salary structures with multiple components
  • Payslip Generation - Automated payslip generation with detailed breakdowns
  • Allowances & Deductions - Configure various allowances and deductions
  • Tax Calculations - Built-in tax calculation support
  • Payroll Reports - Comprehensive payroll reporting and analytics

Requirements​

  • Open Core Business Suite v5.0+
  • PHP 8.2+

Optional Dependencies​

ModulePurpose
LoanManagementAutomatic loan repayment deductions

Installation​

Enable via Admin Panel​

  1. Log in as administrator
  2. Navigate to Settings > Addons
  3. Find Payroll and click Enable
  4. Run migrations if prompted

Enable via Command Line​

php artisan module:enable Payroll
php artisan migrate

Usage​

Setting Up Salary Structures​

  1. Navigate to Payroll > Salary Structures
  2. Click Add New Structure
  3. Define the salary components:
    • Basic salary
    • Allowances (housing, transport, etc.)
    • Deductions (tax, insurance, etc.)
  4. Save the structure

Generating Payslips​

  1. Navigate to Payroll > Generate Payslips
  2. Select the pay period
  3. Choose employees or departments
  4. Review calculated amounts
  5. Click Generate to create payslips

Configuring Allowances​

  1. Navigate to Payroll > Allowances
  2. Add new allowance types with:
    • Name and description
    • Calculation method (fixed/percentage)
    • Applicable employee groups

Configuring Deductions​

  1. Navigate to Payroll > Deductions
  2. Add deduction types such as:
    • Tax deductions
    • Insurance premiums
    • Loan repayments (with LoanManagement module)

Viewing Reports​

Access payroll reports from Payroll > Reports:

  • Monthly payroll summary
  • Department-wise breakdown
  • Year-to-date reports
  • Tax reports

Configuration​

Configure payroll settings in Settings > Payroll Settings:

  • Pay period (weekly, bi-weekly, monthly)
  • Default currency
  • Tax calculation rules
  • Payslip templates
Last updated on