India Payroll extends Frappe HR with the statutory schemes and tax rules that Indian businesses are required to follow. Once configured, the correct deductions appear on every salary slip automatically and flow straight into the compliance reports and returns.
Indian payroll is governed by a web of statutory rules: provident fund ceilings, state-wise professional tax and labour welfare fund slabs, employee state insurance thresholds, income tax regimes, and quarterly TDS returns. Most of this is sold as expensive, closed software. India Payroll brings it to Frappe HR as a free and open-source layer, so you can run compliant payroll without scripting a single salary formula.
- Employee Provident Fund (EPF): Calculates employee EPF and Voluntary Provident Fund on every salary slip, applies the wage ceiling, reconstructs the employer split (EPF, EPS, EDLI and admin charges), and exports a ready-to-upload ECR file for the EPFO portal.
- Employee State Insurance (ESI): Deducts the combined ESI contribution for employees within the wage ceiling, with coverage decided on the full monthly gross so a high earner is not wrongly pulled in during a loss-of-pay month.
- Professional Tax: A state-wise slab engine covering monthly and half-yearly states, including special rules such as Maharashtra's February charge and women exemption thresholds.
- Labour Welfare Fund (LWF): State-wise employee and employer contributions, applied at the correct monthly, half-yearly, or annual frequency for each state.
- Income Tax and TDS: New and old regime slabs, surcharge with marginal relief, quarterly TDS return (Form 24Q) e-filing through the Sandbox API, and Form 16 generation.
- Tax Regime Selector: A guided page where employees declare their exemptions and investments, compare the old and new tax regimes side by side, and lock in the regime that lowers their tax.
- Statutory Reports: Provident Fund Register (with ECR export), ESIC Register, Professional Tax Register, LWF Register, and Bank Mandate Report, each with its own export for filing with the relevant authority.
View Screenshots
- Frappe HR: The open-source HR and Payroll platform that India Payroll builds on. It handles salary structures, payroll processing and income tax, while India Payroll adds the India-specific statutory layer.
- Frappe Framework: A full-stack web application framework written in Python and JavaScript, providing the database layer, user authentication and REST API.
India Payroll requires Frappe HR and installs on top of an existing bench.
cd $PATH_TO_YOUR_BENCH
# Get the app
bench get-app $URL_OF_THIS_REPO --branch develop
# Install it on your site
bench --site $YOUR_SITE install-app india_payrollInstalling the app creates the statutory salary components it needs (Provident Fund, VPF, the employer contribution components, Employee State Insurance, Professional Tax and Labour Welfare Fund).
To get started, enable the schemes you need under Payroll Settings > India Payroll, then configure each employee on the India Payroll tab of their Salary Structure Assignment.
- Frappe School: Learn Frappe Framework and Frappe HR from courses by the maintainers and the community.
- Documentation: Scheme-by-scheme documentation for India Payroll.
- Discussion Forum: Engage with the Frappe HR community.
This app uses pre-commit for code formatting and linting. Please install it and enable it for this repository:
cd apps/india_payroll
pre-commit installGNU General Public License v3.0
