ERP & Manufacturing

Frappe HR for Indian Payroll: PF, ESI, PT and TDS in ERPNext

What Frappe HR (ERPNext HRMS) does for Indian payroll: PF on the new Rs 25,000 ceiling, ESI, professional tax, TDS under section 392, and what needs setup.

Illustration: Frappe HR for Indian Payroll: PF, ESI, PT and TDS in ERPNext
Frappe HR for Indian Payroll: PF, ESI, PT and TDS in ERPNext
On this page+

Picture an HR executive at a 30-person plant in Pune who runs payroll on a spreadsheet, uploads the PF ECR by hand, and found out in September that the EPF wage ceiling had moved from ₹15,000 to ₹25,000 and every formula needed changing. Frappe HR is free, open-source payroll software that runs inside the same database as ERPNext. This post covers what it does out of the box, what Indian statutory payroll needs on top, and where you will still configure or build.

TL;DR

  • Frappe HR is the HR and payroll app for ERPNext, split out as a separate GPL-3.0 app from version 14. It covers the employee lifecycle, attendance and shifts, leave, expense claims, salary structures, payroll entry and a mobile PWA.
  • Core Frappe HR has no built-in PF, ESI or professional tax rules. You define them as salary components with formulas, or install Frappe's free India Payroll app, which ships them preconfigured with ECR and register exports.
  • Rules that changed in the last year: the four Labour Codes took effect on 21 November 2025, the EPF wage ceiling became ₹25,000 from 17 September 2026, and TDS on salary moved to section 392 of the Income-tax Act, 2025 from April 2026.
  • Expect configuration work for each state's professional tax, the Labour Code 50% wage test, gratuity rules and your own allowance structure.

Free ERPNext fit check

Will ERPNext fit your factory?

Answer a few quick questions. On a short call we tell you whether ERPNext fits how you make, stock and sell, and what the rollout looks like.

Check my fit →

What Frappe HR is, and how it relates to ERPNext

HR and payroll used to be modules inside ERPNext. Frappe's hrms repository says that from version 14 "Frappe HR was created as a separate product". You install ERPNext and Frappe HR as two apps on the same site. Salary slips, payroll accruals and expense claims post into ERPNext's chart of accounts, so there is no export to a separate accounting package at month end.

Both are GPL-3.0, with no per-employee fee; you pay for hosting, setup, training and support. ERPNext implementation covers how we scope HR along with the rest of the ERP.

"ERPNext HRMS" and "ERPNext HR module" mean the same app. Older guides show HR screens inside ERPNext because they predate the split.

What Frappe HR covers out of the box

The Frappe HR documentation groups the product into these areas:

Employee lifecycle

Onboarding templates, promotions, transfers and separation with exit interviews.

Attendance and shifts

Shift Types mark attendance automatically from Employee Checkin records, with late entry and early exit flags.

Leave

Leave Policies, holiday lists, leave applications with approvers, and balance tracking.

Expense claims

Employee advances and expense claims with approval, posted to ERPNext accounts.

Performance

Goals, KRAs, self-evaluation and appraisal cycles.

For a plant, attendance is the detail to check. The Shift Type page says check-ins arrive "from a device or the mobile app", and the auto-attendance job turns them into Attendance records. It also handles devices that do not send an IN or OUT direction by alternating punches. Connecting a specific biometric machine still needs a sync script or middleware, because the documentation does not name supported devices.

The mobile app is a progressive web app (PWA), available from version 15 at your site address plus /hrms. Employees install it from Chrome or Safari, then apply for leave, approve requests, check in and out, and view their profile. The v16.0.0 release notes list expense claims and advances in the PWA and a setting to allow check-in from the app. For the wider picture of phone access to ERPNext, see our ERPNext mobile app guide.

How an ERPNext payroll run works in Frappe HR

Frappe HR payroll flow in ERPNext: salary components, salary structure, assignment, payroll entry, salary slips and bank entry
One monthly run in Frappe HR. The structure is built once; each month starts at Payroll Entry and ends with a bank entry in ERPNext accounts.

The building blocks sit in a chain:

  1. Salary components: each earning or deduction is a component: Basic, HRA, conveyance, PF, ESI, professional tax, TDS. The Salary Component page explains that a component can be a fixed amount or "Amount based on formula", can depend on payment days, can be a statistical component that feeds other formulas without being paid, and can be "variable based on taxable salary", which is how TDS is calculated from the slab.
  2. Salary structure: a template that lists components and formulas, for example Basic as 50% of the monthly CTC base.
  3. Salary Structure Assignment: links a structure to an employee with a base amount and effective date, and records the tax regime.
  4. Payroll Entry: the Payroll Entry document fetches employees by filters, creates salary slips, submits them together, and books an accrual journal entry against Payroll Payable. "Make Bank Entry" then creates the draft payment journal entries.

Leave without pay reduces any component marked "depends on payment days", and one-off items such as a Diwali bonus go through Additional Salary.

Indian payroll rules your system has to follow

These are the rules at the time of writing. Payroll law changed three times in the last twelve months, so check each linked source before you build a component.

The Labour Codes are in force

The Ministry of Labour announced that the Code on Wages, the Industrial Relations Code, the Code on Social Security and the OSH Code took effect on 21 November 2025, replacing 29 central labour laws. Labour is a concurrent subject, so states issue their own rules, and their progress differs; check your state labour department's gazette.

The change that hits salary structures is the definition of wages. Under the proviso to section 2(y) of the Code on Wages, 2019, if the excluded payments (allowances such as HRA and conveyance, and the other items the clause lists) exceed half of total remuneration, the excess is added back to wages. The Ministry's FAQs apply this test to PF contributions. A structure with Basic at 30% of remuneration and the other 70% in excluded allowances fails the test, and the added-back amount raises the PF base.

In Frappe HR this is a formula question. You can add a statistical component that computes wages under the 50% test and point the PF formula at it instead of at Basic. Neither core Frappe HR nor the India Payroll README describes a built-in 50% test, so treat it as configuration you own.

Provident Fund (EPF)

  • Rates: 12% of PF wages from the employee and 12% from the employer. Of the employer's share, 8.33% goes to the pension scheme (EPS).
  • Wage ceiling: The ceiling for mandatory coverage rose from ₹15,000 to ₹25,000 a month with effect from 17 September 2026, notified as S.O. 5109(E) (PIB). PIB states the maximum employer EPS contribution rose from ₹1,250 to ₹2,083 a month; commentators differ on whether the EPS scheme itself has been amended to match, so confirm this with your EPF adviser before you change payroll.
  • Above the ceiling: some establishments contribute on actual wages above the ceiling. The India Payroll app has a setting for this; check your existing practice and EPFO's rules before changing it.

Employees' State Insurance (ESI)

ESIC's contribution page lists 0.75% of wages from the employee and 3.25% from the employer, effective 1 July 2019. Employees with an average daily wage up to ₹176 pay no employee share, though the employer still pays. ESIC's standard note puts the coverage limit at ₹21,000 a month, or ₹25,000 for employees with a disability.

Professional Tax

Professional tax is a state levy, so the rule depends on where the employee works, and some states levy none. Two examples:

  • Maharashtra: MahaGST's rate schedule sets nil up to ₹7,500 a month, ₹175 a month from ₹7,501 to ₹10,000, and ₹2,500 a year above ₹10,000 (₹200 a month, ₹300 in February). Women earning up to ₹25,000 a month pay nil.
  • Other states use different slabs and deduction months. Karnataka, West Bengal, Tamil Nadu and Gujarat, for example, all levy it on their own slabs; check the state commercial tax department before you build the component.

TDS on salary under the Income-tax Act, 2025

The Income-tax Act, 2025 replaced the 1961 Act from 1 April 2026. Section 392 now covers deduction from salary, as section 192 did before. The employer deducts tax at the average rate on the estimated salary income for the tax year, and takes into account particulars the employee furnishes, such as income from a previous employer. The department's transition FAQs describe the new Act as broadly no change in policy, with salary for tax year 2026-27 falling under the new section. Section references in reports and employee letters still need updating.

What Frappe HR handles, by statutory item

Frappe HR Indian payroll coverage: what core Frappe HR, the India Payroll app and custom work handle for PF, ESI, professional tax, TDS and labour codes
Our reading of the Frappe HR docs and the India Payroll README at the time of writing. Test each item on your own data before go-live.
ItemCore Frappe HRWith India Payroll appStill configuration or custom work
PF (12%, EPS split, ceiling)Formula components you writePreconfigured, ECR export for EPFOLabour Code wage base, voluntary higher contributions policy
ESI (0.75% / 3.25%, ceiling)Formula components you writePreconfigured, applies wage ceilingsContribution-period rule for employees crossing the limit
Professional TaxFormula per state you writeState-wise engine (README: monthly and half-yearly rules)Check your state's current slab is present
Labour Welfare FundNot built inState-wise contributionsNone beyond checking your state
TDS on salaryIncome Tax Slabs, exemption declarations, tax componentOld vs new regime selector, quarterly TDS return, Form 16Updating slabs each tax year
HRA exemptionBuilt in (Company HRA settings, India sub-category)Regime selector asks rent and metro cityNone
GratuityGratuity Rule documentNot listed in READMEDefine your rule against the Code on Social Security
Labour Code 50% wage testNot built inNot listed in READMEStatistical component and formulas

Two notes on the table. First, Frappe's India Payroll repository describes it as "a free and open-source layer", licensed GPL-3.0, that installs on top of Frappe HR. Its README lists PF with employer splits and ECR export, ESI within the wage ceiling, a state-wise professional tax engine, Labour Welfare Fund, old and new tax regimes with surcharge, quarterly TDS return filing, Form 16 and statutory reports. Its install instructions point at the develop branch, so pin a tested version for production. Second, the separate India Compliance app many ERPNext users install is for GST, not payroll. Our ERPNext GST accounting post covers that side.

A worked example: one employee, one month

Assumptions, for a typical 30-person plant in Maharashtra: a male machine operator with a monthly gross of ₹20,000, Basic of ₹10,000, no allowances outside Basic and HRA, and ESI wages equal to gross. These are illustrations, not advice for your payroll.

  • Labour Code wages: HRA and other allowances are ₹10,000, exactly half of remuneration, so nothing is added back. PF wages are ₹10,000.
  • PF: employee 12% = ₹1,200. Employer 12% = ₹1,200, of which EPS 8.33% = ₹833 and EPF ₹367.
  • ESI: gross is within ₹21,000, so employee 0.75% = ₹150 and employer 3.25% = ₹650.
  • Professional tax: above ₹10,000, so ₹200 (₹300 in February).
  • TDS: annual salary of ₹2.4 lakh is inside the nil slab (up to ₹4 lakh) of the new regime for tax year 2026-27, per the Finance Bill 2026 memorandum, so TDS is nil. The employee still needs a regime recorded on the assignment.
Frappe HR payroll India worked example: salary slip with PF, ESI and professional tax deductions for a ₹20,000 gross employee
The worked example as salary slip lines. Assumptions as stated in the text; your state, wage structure and tax regime change the numbers.

In Frappe HR, each line is a salary component with a formula and a condition. ESI carries a condition that gross is within the ceiling, and PF reads a statistical "PF wages" component instead of Basic directly. After that, each month is one Payroll Entry.

What an implementation adds

An HR and payroll rollout comes down to these jobs:

  • Map every current pay head to a salary component, and decide which are statistical
  • Build the Labour Code wage base and check each grade against the 50% test
  • Set up PF, ESI, PT and LWF, either through India Payroll or your own components
  • Load opening balances: leave, loans, advances and year-to-date tax
  • Connect biometric devices to Employee Checkin, or roll out mobile check-in
  • Run one or two months in parallel with the old payroll and reconcile line by line

The parallel run is the step we would not skip: two months of matching salary slips against the old system finds formula errors before employees do. If you are moving from Tally, our Tally to ERPNext migration post covers opening balances, and ERPNext implementation cost in India shows how scope drives cost.

Where Frappe HR is a weak fit

  • You want a payroll vendor to file returns for you, not software you run
  • No one in HR or accounts will own salary structures and slab updates
  • You need a ready connector for a specific biometric brand and cannot fund integration work

Is Frappe HR the right payroll software for you?

If you already run ERPNext, or plan to, Frappe HR keeps payroll, attendance and accounts in one database with no per-employee fee. The Indian statutory layer is no longer a blank page: the India Payroll app covers PF, ESI, professional tax and TDS, and what remains is your wage structure, your states and your gratuity policy. If you run Tally for accounts and want payroll only, a hosted payroll service may be simpler.

Metageeks is an independent ERPNext implementer. Our ERPNext implementation service can set up Frappe HR with the rest of the ERP, including the parallel payroll run.

Frequently asked questions

Is Frappe HR free?+

Yes. Frappe HR is published on GitHub under the GPL-3.0 licence, with no per-employee fee. Frappe's India Payroll app, which adds PF, ESI, professional tax and TDS handling on top, is also GPL-3.0. You still pay for hosting, setup and support.

Is Frappe HR the same as the ERPNext HR module?+

It grew out of it. HR and payroll used to be modules inside ERPNext. From version 14, Frappe split them into a separate app called Frappe HR (the code repository is named hrms). It installs on the same site as ERPNext and posts payroll and expense entries into ERPNext accounting.

Does Frappe HR calculate PF and ESI automatically?+

Core Frappe HR calculates whatever salary components you define, so PF and ESI can be set up as formula components. The India Payroll app goes further: it ships preconfigured PF and ESI logic, applies the wage ceilings, and exports an ECR file for the EPFO portal and ESIC registers.

Can Frappe HR handle TDS on salary under the new Income-tax Act?+

Frappe HR calculates monthly income tax from Income Tax Slabs, tax exemption declarations and a tax component that is variable on taxable salary. The slabs and payroll period are data you maintain, so for tax year 2026-27 you configure the new regime slabs yourself. Section 392 of the Income-tax Act, 2025 now governs TDS on salary paid from April 2026.

Does Frappe HR have a mobile app?+

Yes. From version 15 it includes a progressive web app at your site address followed by /hrms. Employees install it from Chrome or Safari and use it to apply for leave, approve requests, check in and out, and see their profile. Version 16 added expense claims and advances to it.

Free ERPNext fit check

Will ERPNext fit your factory?

Answer a few quick questions. On a short call we tell you whether ERPNext fits how you make, stock and sell, and what the rollout looks like.

Check my fit →

About the author

Pankaj Kumar, Founder · Metageeks Technologies

Pankaj Kumar

Founder · Metageeks Technologies

Metageeks builds software and AI products for growing businesses. Every build is scoped in writing before it starts, and you see progress every week. We write about what holds up once it reaches production.

  • Tags
  • erpnext
  • erp
  • india
  • hr payroll
  • manufacturing

Share this article

Subscribe to Our Newsletter

The AI Build Brief: practical playbooks on how to build, price and ship AI features, in one short email every other week.

No spam. Unsubscribe anytime.

Free ERPNext fit check

Will ERPNext fit your factory?

Answer a few quick questions. On a short call we tell you whether ERPNext fits how you make, stock and sell, and what the rollout looks like.

Check my fit →← Back to insights