Payroll Processing
Payroll processing in JobNext follows a structured sequence: define Welfare heads (salary structure), set Welfare Allowances for employees, finalize attendance for the period, then run payroll. The system calculates net pay based on configured earnings, deductions, attendance records, leave adjustments, and statutory requirements. After payroll is generated and approved, salary is remitted through the Finance module.
Payroll Workflow Overview
Payroll Dashboard
The main Payroll page is accessed via HR > Payroll. It provides the central hub for all payroll operations.
Main Page Layout
| Element | Purpose |
|---|---|
| Generate Payroll button | Opens the payroll generation dialog to create a new salary run |
| Month / Year dropdowns | Filter the Salary Runs grid to show runs for a specific period. Click the blue search icon to apply the filter. |
| Salary Runs grid | Lists all payroll runs for the selected period, showing run details, status, and actions |
| Right Sidebar | Quick links to Welfare, Welfare Allowances, Chapter 6 Exemptions, Loan Request, Welfare Allowances History, and Payroll Log sub-pages |
Prerequisites for Payroll
Before generating payroll, three components must be properly configured:
| # | Requirement | Details | Frequency |
|---|---|---|---|
| 1 | Welfare Heads | Salary structure components (earnings and deductions) must be defined. Each head maps to an accounting ledger. | One-time / Rare |
| 2 | Welfare Allowances | Specific monetary amounts must be assigned to each welfare head for employees (by cadre, department, designation, or individually). | As needed |
| 3 | Finalized Attendance | Attendance for the payroll month must be uploaded, validated, and finalized. See Attendance for details. | Every month |
Payroll cannot be generated if attendance for the period has not been finalized. The system uses finalized attendance data to calculate days present, absent, overtime, leave, and LOP for each employee.
Step 1: Welfare (Payroll Heads)
Welfare refers to the compensation framework — the Payroll Heads that define the salary structure. Each welfare head represents either an Earning (adds to pay) or a Deduction (reduces pay). Welfare heads are the building blocks of every payslip.
Navigation: HR > Payroll > Welfare (from the right sidebar)
Welfare Grid Columns
| Column | Description |
|---|---|
| Order On Payslip | Numeric sort order determining the sequence in which this head appears on the payslip (e.g., Basic Salary = 1, HRA = 2, etc.) |
| Type | Shows a badge: Earning or Deduction |
| Code | Short code identifier (e.g., BS = Basic Salary, HR = HRA, PF = Provident Fund, SE = Seniority Allowance) |
| Description | Full name of the welfare head |
| Active? | Whether this head is currently in use for payroll calculations |
| Prorated | Whether the amount adjusts based on days present in the payroll period |
| Ledger | The accounting ledger to which the expense is debited (format: Company/Account Code - Account Name) |
| Show? | Whether the head is displayed on the payslip and included in net pay calculation |
Common Welfare Heads (Examples)
| Code | Description | Type | Prorated? |
|---|---|---|---|
| BS | Basic Salary | Earning | Yes |
| HR | House Rent Allowance (HRA) | Earning | Yes |
| SE | Seniority Allowance | Earning | Yes |
| F3 | Fixed OT Allowance | Earning | Yes |
| S2 | Special Site Allowance | Earning | No |
| A0 | Airfare Accrual | Earning | Yes (hidden) |
| V | Visa Expenses Accrual | Earning | Yes (hidden) |
| PE | PASI Employee Contribution | Deduction | No |
| PR | PASI Employer Contribution | Earning | No |
| I1 | Insurance Recovery | Deduction | Yes |
| O2 | Other Recoveries | Deduction | Yes |
Adding / Editing a Welfare Head
Click Add + to create a new welfare head, or click the edit (pencil) icon on an existing row. The Edit Welfare form appears:
Welfare Form Fields
| Field | Required | Description |
|---|---|---|
| Code | Yes | Short alphanumeric code identifying this welfare head (e.g., BS, HR, PF). Must be unique. |
| Description | Yes | Full descriptive name (e.g., "Basic Salary", "Seniority Allowance", "PASI Employee Contribution") |
| Ledger | Yes | The accounting ledger to which this expense is debited. Select from the chart of accounts (format: Company/AccountCode - AccountName) |
| Welfare Category | No | Classification of the welfare head. Options: Fixed (regular recurring component), Temporary (one-time or limited period), Provisional (pending confirmation) |
| Print Order | Yes | Numeric value determining the position of this head on the payslip. Lower numbers appear first. |
| Calculation Procedure | Yes | Name of the stored procedure that computes this welfare amount during payroll. Do not modify unless you are a system administrator — incorrect values will cause payroll calculation errors. |
| Active | — | Checkbox. When checked, this welfare head is included in payroll calculations. Uncheck to deactivate without deleting. |
| Display In Payslip | — | Checkbox. When checked, the amount appears on the employee payslip. Items like Airfare Accrual or Visa Accrual are typically hidden (used for internal costing only). |
| Prorated | — | Checkbox. When checked, the amount is proportionally adjusted based on days present in the payroll period. For example, if an employee worked 20 out of 30 days, a prorated amount = (Allowance / 30) × 20. |
| Prorate Type | — | How proration is calculated. Options: DAY (based on days present) or HOUR (based on hours worked). Only applicable when Prorated is checked. |
| Earning | — | Checkbox. When checked, this is an Earning (adds to gross pay). When unchecked, it is a Deduction (subtracted from gross pay). |
| Employer Contribution | — | Checkbox. When checked, this welfare head represents an employer-side statutory contribution (e.g., Employer PF, PASI Employer). These create a liability on the employer rather than being paid directly to the employee. |
The form also includes an Employee Group Details section at the bottom, which allows restricting this welfare head to specific employee groups.
Defining or modifying welfare heads is usually done during initial system implementation or infrequently on an as-needed basis. Changes to welfare heads affect all employees and payroll calculations. Always consult your payroll administrator before making changes.
Step 2: Welfare Allowances
Welfare Allowances define the actual monetary amounts to be paid or deducted for each welfare head per employee. While Welfare defines the salary structure, Allowances define the salary values. Allowances must be configured before generating payroll.
Navigation: HR > Payroll > Welfare Allowances (from the right sidebar)
Six Assignment Methods
JobNext provides six ways to assign welfare allowances, giving flexibility to match your organization’s salary structure:
| Method | Scope | Example |
|---|---|---|
| By Cadre | All employees sharing a cadre (grade/level) | All “Officer” cadre staff get Basic Salary = 8,000 |
| By Department | All employees in a department | Projects department gets Site Allowance = 2,000 |
| By Designation | All employees with a specific job title | All “Senior Engineer” staff get HRA = 5,000 |
| By Employee | Individual employee only | John Smith specifically gets Basic Salary = 12,500 |
| By Site | All employees at a specific job/site | All staff at “Dubai Mall Project” get Site Allowance = 3,000 |
| By Site By Cadre | Employees at a specific site AND cadre combination | “Technician” cadre at “Abu Dhabi Metro” get Site Allowance = 4,000 |
Precedence Rules (Highest to Lowest)
When multiple assignment methods apply to the same employee for the same welfare head, the system uses the following priority:
- By Employee — highest priority, overrides all other assignments
- By Cadre — overrides department and designation
- By Department — overrides designation
- By Designation — lowest priority (default fallback)
For each assignment method, you can:
- Add: Click the Add By [Method] button to manually enter individual allowance records
- Upload: Click Upload [Method] to bulk-import allowance data from a spreadsheet
The allowances grid shows existing records with columns for the welfare head, cadre/department/designation/employee, and the configured amount.
Activating / Deactivating Allowances
Newly created welfare allowances are automatically active. To temporarily or permanently stop an allowance from being included in future payroll runs, use the De-Activate action on the allowance record. Deactivated allowances remain in the system for audit purposes but are excluded from payroll calculations.
Step 4: Generate Payroll
Once welfare heads, allowances, and attendance are all configured and finalized, you can generate the payroll run.
How to Generate Payroll
- Navigate to HR > Payroll
- Click the Generate Payroll button (blue button at top-left)
- The Generate Payroll dialog opens:
Generate Payroll Dialog Fields
| Field | Description |
|---|---|
| Notes | Optional free-text notes for this payroll run (e.g., “October 2024 regular payroll”, “Includes overtime adjustments”) |
| Current Date Voucher | Checkbox. When checked, the finance voucher created upon approval will use today’s date instead of the payroll period end date. |
| Month | The payroll month (January through December). Must have finalized attendance for this month. |
| Year | The payroll year (available range: 2016–2031) |
| Select Staff | Opens a staff selection popup to choose which employees to include in this payroll run. You can select all or specific staff members. |
- Select the Month and Year for the payroll period
- Click Select Staff to choose which employees to include in this run
- Add any Notes for reference
- Click Generate to start the payroll calculation
What Happens During Payroll Generation
The system executes the payroll calculation engine, which:
- Retrieves each employee’s welfare allowance amounts based on the precedence rules
- Applies proration for prorated welfare heads based on days present from finalized attendance
- Computes overtime amounts using configured OT multipliers and normal working hours
- Calculates leave deductions for unpaid leave (LOP) days
- Applies statutory deductions (PASI, insurance, etc.) based on welfare head calculation procedures
- Computes income tax (India-specific: tax slabs, Chapter 6 exemptions, etc.) where applicable
- Generates individual payslips for each employee showing all earnings, deductions, and net pay
If payroll generation fails for any employee, check the Payroll Log (right sidebar) for error details. Common issues include: missing welfare allowances, unfinalized attendance, or misconfigured calculation procedures.
Step 5: Review Salary Runs
After payroll is generated, a new entry appears in the Salary Runs grid on the main Payroll page. Use the Month/Year filters to find runs for a specific period.
Each salary run shows:
- Run date and period (month/year)
- Number of employees included
- Total gross pay, total deductions, and total net pay
- Run status (Draft, Approved, etc.)
- Action buttons to view details, approve, or delete (if still in draft)
Click on a salary run row to drill down into individual employee payslips and review the detailed breakdown of earnings and deductions for each staff member.
Step 5: Approve Payroll
After reviewing the salary run and verifying all payslips are correct, the payroll must be approved to finalize it. Approval locks the run and triggers several automated processes.
What Happens on Approval
When a payroll run is approved, the system automatically:
- Resolves the default job to book payroll expenses (from system configuration)
- Creates a Finance voucher with module code “PAYROLL”, debiting salary expense ledgers and crediting the Salaries Payable liability ledger
- Computes staff actual cost for each employee for the period
- Runs leave accrual/management — posts monthly leave entitlement transactions to employee leave balances based on eligibility by designation and leave type rules
- Updates staff demographics where applicable (e.g., tenure-based calculations)
Once a payroll run is approved, it cannot be unapproved or deleted. Always thoroughly review all payslips before approving. If errors are found after approval, corrective adjustments must be made in the next payroll cycle.
Step 6: Salary Remittance
Once payroll is approved, the Net Pay is credited to the Salaries Payable Ledger (a current liability in Finance). To actually pay employees and discharge this liability, you process a Salary Remittance.
Navigation: Finance > Salary Remittance
Salary Remittance Process
- Navigate to Finance > Salary Remittance
- Select the approved payroll run to remit
- Review the salary disbursement summary showing each employee’s net pay
- Select the payment method (Bank Transfer or Cash)
- Select the Bank/Cash account to pay from
- Process the remittance — a single Bank or Cash payment covers multiple employees
- The system creates a payment voucher that discharges the Salaries Payable liability
Salary Remittance is located in the Finance module (not HR > Payroll) because it involves actual fund disbursement. The payroll approval creates the liability; remittance discharges it through the accounting system.
Chapter 6 Exemptions (India-Specific)
For organizations operating in India, JobNext supports Chapter 6 income tax exemptions that reduce taxable income during payroll processing. This feature allows recording employee-declared exemption amounts for a financial year.
Navigation: HR > Payroll > Chapter 6 Exemptions (from the right sidebar)
Grid Columns
| Column | Description |
|---|---|
| Staff Name | Employee name and ID (e.g., “Harini Haran : OMNISVC4”) |
| Fin Yr | The financial year the exemption applies to (e.g., 2023-2024) |
| Exemption Amount | The total exemption amount declared by the employee under Chapter 6 provisions |
| Notes | Any additional notes or reference |
| Income From Other Sources | Any additional income the employee has declared from outside employment, which affects tax computation |
Click Add Exemption to create a new exemption entry. Each row can be edited (pencil icon) or viewed (magnifying glass icon).
Loan Request
The Loan Request feature allows employees to request company loans, which are then deducted from their salary through EMI (Equated Monthly Installments) during payroll processing.
Navigation: HR > Payroll > Loan Request (from the right sidebar)
Page Elements
| Element | Description |
|---|---|
| From / To date fields | Filter loan requests by date range. Default shows last 30 days. |
| Search icon | Apply the date filter to refresh the grid |
| Add Loan + button | Opens the loan creation form to register a new loan for an employee |
| Add Loan Request button | Alternative button to add a loan request |
Once a loan is approved, the system automatically creates a Loan Recovery deduction welfare head entry that deducts the EMI amount from the employee’s salary each month until the loan is fully repaid. Loan amortization vouchers are managed through Finance > Loan Amortisation Vouchers.
Welfare Allowances History
This page provides a complete audit trail of all changes made to welfare allowances, helping you track who changed what and when.
Navigation: HR > Payroll > Welfare Allowances History (from the right sidebar)
Filter Options
| Filter | Description |
|---|---|
| From / To | Date range for the audit log entries |
| Changed By | Filter by the user who made the change |
| Welfare | Filter by specific welfare head (e.g., Basic Salary, HRA) |
| By | Filter by assignment method (By Cadre, By Department, By Designation, By Employee, etc.) |
Each history record shows the old value, new value, date of change, and the user who made the modification. This is useful for auditing salary revisions, verifying allowance updates before payroll runs, and resolving disputes.
Payroll Log
The Payroll Log records the execution history of all payroll runs, including errors and warnings encountered during generation.
Navigation: HR > Payroll > Payroll Log (from the right sidebar)
When payroll runs have been executed, the log shows:
- Run date and time
- Month/Year of the payroll period
- Number of staff processed
- Success/failure status for each employee
- Error messages for failed calculations (e.g., missing allowances, attendance not finalized)
If payroll generation completes but some employees show errors, check the Payroll Log first. Common issues include: employee not having finalized attendance, missing welfare allowance configuration, or inactive welfare heads referenced in calculation procedures.
Common Payroll Workflows
Workflow 1: Monthly Payroll Processing (End-to-End)
- Upload & Finalize Attendance — Go to HR > Attendance, upload the month’s attendance data, validate, and finalize. See Attendance.
- Review Welfare Allowances — Check HR > Payroll > Welfare Allowances to ensure all employee allowances are current. Update any salary revisions, new joiners’ allowances, or site-specific allowances.
- Generate Payroll — Go to HR > Payroll, click Generate Payroll, select the month/year, choose staff, and generate.
- Review Payslips — Click on the salary run in the grid to review individual payslips. Verify gross pay, deductions, and net pay for each employee.
- Approve Payroll — Once verified, approve the salary run. This creates the Finance voucher and runs leave accrual.
- Process Salary Remittance — Go to Finance > Salary Remittance, select the approved run, and process payment to discharge the salary liability.
Workflow 2: Adding a New Employee to Payroll
- Create Staff Record — Add the employee in HR > Staff Directory with correct designation, department, and cadre.
- Check Welfare Applicability — Verify the employee’s cadre/designation/department has the required welfare allowances configured. If the new employee needs special amounts, add “By Employee” allowances.
- Upload Attendance — Include the new employee in the attendance upload for their joining month (pro-rated from join date).
- Generate Payroll — Include the new employee when generating payroll. The system will prorate earnings based on days present.
Workflow 3: Processing a Salary Revision
- Update Welfare Allowances — Go to HR > Payroll > Welfare Allowances and modify the relevant allowance amounts for the affected employees (by employee, cadre, designation, etc.).
- Verify in History — Check Welfare Allowances History to confirm the changes were recorded correctly.
- Generate Next Payroll — The updated allowances will automatically be used in the next payroll run.
Best Practices
- Always finalize attendance first — Payroll depends on finalized attendance. Never attempt to generate payroll before attendance is locked for the period.
- Review before approving — Always review payslip summaries after generating payroll and before approval. Look for unusual amounts that might indicate configuration errors.
- Update allowances before payroll — Any salary revisions, new joiner allowances, or site changes should be updated in Welfare Allowances before generating payroll for that month.
- Use the Payroll Log — If any employee shows unexpected results, check the Payroll Log for calculation errors or warnings.
- Maintain audit trail — Use Welfare Allowances History to verify salary changes and maintain compliance documentation.
- Don’t modify Calculation Procedures — The Calculation Procedure field in welfare heads references system stored procedures. Incorrect values will break payroll calculations.
- Chapter 6 Exemptions deadline — Ensure employee tax declarations are entered before the relevant payroll run to correctly compute income tax deductions.
Frequently Asked Questions
Q: Why is an employee’s salary showing as zero?
A: Most likely the employee does not have Welfare Allowances configured. Check HR > Payroll > Welfare Allowances to verify that the employee’s cadre, department, designation, or individual record has allowance amounts set for each relevant welfare head.
Q: Can I regenerate payroll after it has been generated but not approved?
A: Yes. If a salary run is still in draft (not yet approved), you can delete it and regenerate. Once approved, however, the run is locked and cannot be changed.
Q: Why are some welfare heads not appearing on the payslip?
A: Check the “Display In Payslip” checkbox on the welfare head. Items like Airfare Accrual or Visa Expenses Accrual are intentionally hidden — they are used for internal costing but not shown to employees.
Q: How does proration work for partial months?
A: For welfare heads marked as “Prorated”, the system calculates: (Allowance Amount / Total Days in Month) × Days Present. The Prorate Type determines whether this is based on calendar days (DAY) or working hours (HOUR).
Q: Which employee gets which welfare allowance amount when multiple methods overlap?
A: The precedence rule applies: Employee-level overrides Cadre, which overrides Department, which overrides Designation. The highest-priority match is used. For example, if an employee has both a “By Designation” HRA of 5,000 and a “By Employee” HRA of 8,000, they will receive 8,000.
Q: Where do I find salary remittance?
A: Salary Remittance is in the Finance module (Finance > Salary Remittance), not in HR > Payroll. This is because remittance involves actual fund disbursement through the accounting system.
Q: What is the “Current Date Voucher” option in Generate Payroll?
A: When checked, the Finance voucher created upon payroll approval will use today’s date as the voucher date instead of the payroll period end date. This is useful when payroll is processed after the month has ended and you want the voucher dated to the actual processing date.