ERPNext HRMS and Payroll for Indian Businesses: A Complete Guide

ERPNext & Frappe Development

18 November, 2026

erpnext-hrms-payroll-india
Deven Jayantilal Ramani

Deven Jayantilal Ramani

CTO, Softices

Managing payroll in India involves more than simply calculating monthly salaries. Businesses must account for Provident Fund (PF), Employee State Insurance (ESI), Professional Tax, Labour Welfare Fund (LWF), income tax deductions and other statutory requirements.

With the introduction of India's Labour Codes and the revision of the EPF wage ceiling in September 2026, businesses need to review their existing salary structures and payroll configurations.

ERPNext, powered by Frappe HR and the India Payroll extension, can help businesses streamline payroll processing, manage employee records and handle several Indian statutory deductions from one system.

This guide explains how Indian payroll works in ERPNext, what the India Payroll extension covers, and what businesses should review before implementation.

Why Indian Payroll is More Complex Than It Looks

Indian payroll involves several compliance requirements, each with its own calculation method and applicability.

Some of the key components include:

  • Provident Fund (PF): Retirement savings contributions from eligible employees and employers.
  • Employee State Insurance (ESI): Social security and medical benefits for eligible employees.
  • Professional Tax (PT): A state-level tax with different slabs and exemptions.
  • Labour Welfare Fund (LWF): Contributions based on state-specific rules and payment schedules.
  • Tax Deducted at Source (TDS): Income tax deducted from salaries based on applicable tax provisions and the employee's selected tax regime.
  • Gratuity and statutory bonus: Employee benefits calculated according to applicable labour laws.

The challenge is not just calculating these amounts. It is maintaining accurate employee information, applying the correct rules and updating payroll whenever regulations change.

A spreadsheet may work for a small team, but managing multiple states, salary structures and statutory deductions manually becomes increasingly difficult as a business grows.

What Frappe HR Offers Beyond Payroll

Payroll is only one part of employee management. Frappe HR, which integrates with ERPNext, provides tools to manage the wider employee lifecycle.

Its key capabilities include:

  • Employee records, onboarding and exit management
  • Attendance, shifts and leave management
  • Salary structures and payroll processing
  • Expense claims and employee advances
  • Recruitment and applicant tracking
  • Performance appraisals
  • Employee self-service

The biggest advantage is that HR and accounting information remain connected.

For example, approved attendance and leave information can feed into salary calculations. Once payroll is submitted, the corresponding accounting entries are recorded in ERPNext.

This reduces duplicate data entry, improves financial visibility and makes payroll reconciliation easier.

How Payroll Processing Works in ERPNext

Frappe HR follows a structured payroll workflow. Each step needs to be configured correctly before generating salary slips.

The typical process involves:

  • Create salary components: Define earnings such as Basic, HRA and allowances, along with deductions such as PF, ESI and TDS.
  • Create a salary structure: Combine the relevant components and configure their conditions, formulas and amounts.
  • Assign salary structures: Link the appropriate structure to each employee and configure the applicable income tax slab.
  • Create a payroll entry: Select the payroll period and employees to generate draft salary slips.
  • Review and submit salary slips: Verify attendance, earnings and deductions before submission. This records the salary expense and payable liability.
  • Create a bank entry: Record the salary payment against the company's bank account.

An important distinction is that submitting salary slips does not transfer money to employees. It records the payroll accrual. The bank entry records the payment in the accounts.

Example: Monthly Salary Structure for a ₹50,000 Gross Salary

Consider a simplified salary structure for an employee earning ₹50,000 per month.

Salary Component

Type

Monthly Amount

Note

Basic salary Earning ₹25,000 Counts as wages
House Rent Allowance (HRA) Earning ₹10,000 Excluded from wages
Special allowance Earning ₹15,000 Excluded from wages
Gross salary Total ₹50,000 Total
Employee PF (12%) Deduction ₹3,000 12% of wages, up to the ₹25,000 ceiling
Professional Tax Deduction State-specific Set by the employee's work state
TDS Deduction As calculated Projected annual income and chosen regime


The employer also contributes towards PF. Assuming the full ₹25,000 is the applicable PF wage base and the standard 12% contribution applies, the employer contribution is ₹3,000, split into:

  • EPS: ₹2,083 (8.33%)
  • EPF: ₹917 (3.67%)

ESI does not apply in this example because the gross salary exceeds the ₹21,000 monthly eligibility threshold.

These figures are illustrative. Actual PF applicability and contribution calculations depend on employee membership, applicable wage definitions, scheme provisions and employer arrangements.

Why is Salary Structure Important?

Under the Labour Codes' revised definition of wages, certain excluded allowances are subject to a 50% limit. If the excluded components exceed that limit, the excess is added back to wages.

For example, if basic salary is ₹20,000 and excluded allowances total ₹20,000 on remuneration of ₹50,000, the excluded portion exceeds 50% by ₹5,000. That excess may need to be included in the wage calculation.

This can affect statutory contributions and employee benefits. Salary structures should therefore be reviewed rather than relying on basic salary percentages alone.

Indian Statutory Compliance in ERPNext

The standard Frappe HR payroll module provides the foundation for salary processing. The India Payroll extension adds India-specific statutory deductions and reporting capabilities.

It is an open-source extension designed for Indian payroll requirements and can be enabled through payroll settings.

Compliance

Applicable Requirement

India Payroll Support

EPF 12% employee, 12% employer, mandatory on wages up to ₹25,000 (₹15,000 before 17 Sep 2026) PF deductions and ECR reporting
ESI 0.75% employee and 3.25% employer contributions for eligible employees Automated deductions and ESI reporting
Professional Tax State-specific tax slabs State-wise configuration
Labour Welfare Fund State-specific contribution amounts and schedules LWF deductions
TDS Income tax based on applicable slabs, declarations and tax regime (₹75,000 standard deduction) Tax calculations and exemption handling


A few important points to consider:

  • Professional Tax and LWF depend on the employee's applicable work state.
  • Not every state has identical compliance requirements or contribution schedules.
  • Verify the extension's supported states, reports and version compatibility before implementation.
  • Statutory rates and thresholds should be maintained according to the latest applicable notifications.

Labour Codes and the PF Changes that Businesses Need to Know

The four Labour Codes came into effect on 21 November 2025. They consolidate several existing labour laws and introduce a revised definition of wages. 

One important change is how wages are calculated for statutory purposes.

1. The 50% Wage Rule

The definition of wages includes basic pay, dearness allowance and retaining allowance. Certain components, including HRA and other specified allowances, can be excluded, subject to the statutory 50% limit.

If excluded components exceed 50% of total remuneration, the excess is added back to wages.

This can affect PF, gratuity, statutory bonus and other employee benefits.

Importantly, the rule does not simply require every employee's basic salary to equal 50% of CTC. The actual calculation must follow the statutory definition and applicable exclusions.

2. PF Wage Ceiling Revised to ₹25,000

A significant change took effect on 17 September 2026.

The statutory wage ceiling for mandatory EPF coverage increased from ₹15,000 to ₹25,000 per month. This expands coverage to additional eligible employees.

The maximum EPS contribution at 8.33% consequently increased from ₹1,250 to approximately ₹2,083 per month, where applicable.

Businesses should review:

  • Existing PF eligibility and employee membership.
  • Salary structures and PF wage calculations.
  • Employer and employee contribution settings.
  • Employees newly eligible under the revised ceiling.
  • Payroll calculations for September 2026, including the transition date.

Do not simply replace every occurrence of ₹15,000 in existing formulas. Review the applicable statutory provisions and employee-specific eligibility first.

Where ERPNext Payroll May Need Customization

Although Frappe HR and India Payroll cover several standard requirements, businesses may need additional development for their specific workflows.

Common customization areas include:

  • Incentives and commissions: Variable compensation with business-specific calculation formulas.
  • Multi-state payroll: Employees transferring between states or working across multiple locations.
  • Attendance integration: Connecting biometric devices or custom mobile attendance applications.
  • Payslip formats: Creating salary slips and reports that match existing company documents.
  • Year-end tax reporting: Reviewing Form 16 generation, TDS returns and supporting documentation.
  • Full and final settlements: Handling notice periods, leave encashment, gratuity and other exit-related calculations.

Start with standard configuration wherever possible. Salary components, formulas and payroll settings can handle many business requirements without additional development.

A custom Frappe app is worth considering when standard configuration cannot support the required logic.

Read our guide on ERPNext Customization vs Custom Frappe App Development to understand the difference.

ERPNext Payroll Implementation Checklist 

Before going live, businesses should review the following:

Pre-Implementation Checklist

  • Confirm Frappe HR and India Payroll version compatibility.
  • Install and configure the India Payroll extension.
  • Create and verify all salary components.
  • Assign the correct work state to each employee.
  • Configure PF, ESI, Professional Tax and LWF rules.
  • Review salary structures against the revised definition of wages.
  • Update applicable PF wage ceilings and contribution calculations.
  • Configure income tax slabs and employee tax declarations.
  • Set appropriate payroll access permissions. Our post on Frappe role-based permissions shows how.
  • Run at least one parallel payroll cycle and compare salary slips with the existing system.

Common Payroll Implementation Mistakes

Some mistakes can create compliance issues even when the software is configured correctly.

Common Mistake

How to Avoid It

Assigning salary structures before finalizing components Finalize components and formulas first
Hard-coding statutory rates Maintain rates in configurable settings
Ignoring employee work locations Verify state-wise compliance
Migrating without previous salary and tax records Import year-to-date payroll information
Assuming submitted salary slips mean employees are paid Complete the bank entry separately
Ignoring changes in labour regulations Schedule periodic compliance reviews


Is ERPNext Suitable for Indian Payroll?

ERPNext, together with Frappe HR and the India Payroll extension, provides a strong foundation for managing Indian payroll.

It brings employee management, attendance, salary calculations, statutory deductions and accounting into one connected system.

However, successful implementation depends on more than installing the software. Businesses must configure salary structures correctly, verify statutory requirements, migrate historical payroll data and test calculations before going live.

For businesses moving from Tally or spreadsheets, ERPNext can offer better integration between HR and finance while reducing repetitive manual work.

At Softices, we help businesses implement, customize and integrate ERPNext according to their operational requirements. Whether you need a complete HRMS implementation or improvements to an existing payroll workflow, our team can help you plan the right approach.

Disclaimer: This article provides general information about ERPNext and Indian payroll practices. Statutory provisions, thresholds and implementation requirements can change. Consult a qualified payroll professional or chartered accountant before making compliance decisions.


Django

Previous

Django

Next

Are iPhone Cleaner Apps Worth It? What They Can (and Can't) Do

are-iphone-cleaner-app-worth-it

Frequently Asked Questions (FAQs)

Yes. ERPNext, together with Frappe HR and the India Payroll extension, can manage Indian payroll processing, including salary structures, salary slips, PF, ESI, Professional Tax, Labour Welfare Fund and TDS calculations. It also integrates payroll with ERPNext accounting.

India Payroll is an extension for Frappe HR that adds India-specific payroll functionality. It provides preconfigured salary components, statutory deduction configurations and reports for requirements such as PF and ESI. It helps businesses manage Indian payroll without building every statutory calculation from scratch.

Yes. ERPNext with the India Payroll extension supports Provident Fund (PF) and Employee State Insurance (ESI) calculations. The standard contribution rates are 12% for employee and employer PF contributions, and 0.75% for employee and 3.25% for employer ESI contributions, subject to applicable eligibility and statutory rules.

Yes. ERPNext India Payroll supports state-specific Professional Tax configurations. Businesses can configure applicable tax slabs according to employees' work locations. However, they should verify the extension's state coverage and update the rates whenever state regulations change.

ERPNext uses employee salary information, applicable income tax slabs, declared investments, exemptions and the selected tax regime to calculate TDS. Payroll administrators can configure tax rules and employee declarations to determine monthly tax deductions.

Under the revised definition of wages, certain salary components, such as HRA and other specified allowances, can be excluded from wages only up to the prescribed 50% limit of total remuneration. Any excess is added back to wages for applicable statutory calculations. This can affect PF, gratuity and other employee benefits.

The PF wage ceiling increased from ₹15,000 to ₹25,000 per month with effect from 17 September 2026. This changes mandatory EPF coverage for eligible employees and increases the maximum EPS contribution to approximately ₹2,083 per month, where applicable.

Yes. Frappe HR connects employee attendance, shift schedules and leave records with payroll processing. Approved attendance and leave information can be considered while calculating salary slips, reducing manual calculations and data entry.

Yes. ERPNext can generate employee salary slips, payroll entries and accounting records. The India Payroll extension also provides India-specific statutory reports. Businesses can customize salary slip formats and reports to match their internal requirements.

ERPNext can be a suitable alternative for businesses looking to integrate payroll, employee management and accounting. Unlike using separate tools for HR and finance, ERPNext connects employee records, attendance, salary processing and accounting within one platform.