Skip to main content
India Statutory Payroll Pack (PF/ESI/PT/TDS) — A build-to-order Frappe app that turns ERPNext HR & Payroll into a compliant I — 1/1Illustrative preview

A build-to-order Frappe app that turns ERPNext HR & Payroll into a compliant India statutory engine:

EPF/UAN, ESI, state-wise Professional Tax, TDS with income-tax projection, gratuity accrual, and Form 16 / Form 24Q reporting.

ECOSIRE scopes, builds, installs and supports it on your bench.

What is India Statutory Payroll Pack (PF/ESI/PT/TDS)?

A build-to-order Frappe app that turns ERPNext HR & Payroll into a compliant India statutory engine: EPF/UAN, ESI, state-wise Professional Tax, TDS with income-tax projection, gratuity accrual, and Form 16 / Form 24Q reporting. ECOSIRE scopes, builds, installs and supports it on your bench. Built to order by ECOSIRE for ERPNext v15, v16 — indicative price from $999.00 USD; request a quote for a scoped proposal.

Key Features

EPF/UAN engine: employee 12% + employer split with EPS diversion, VPF handling and the statutory wage-ceiling cap applied at Salary Slip validate
ESI contribution calculation at current 0.75% employee / 3.25% employer shares with gross-wage eligibility cut-off and mid-period exit handling
State-wise Professional Tax via a `Professional Tax Slab` DocType keyed by state and effective-from date, resolved per employee work location
TDS (Section 192) computed from a projected annual-income model, spread across remaining pay periods and recomputed on declaration changes
`TDS Declaration` DocType for employee investment proofs (80C, 80D, HRA, home-loan interest) feeding the projection engine
EPFO ECR fixed-width text file export generated as a Script Report from submitted Salary Slips, ready for portal upload
ESIC monthly contribution statement report matching the portal upload format
Form 16 Part B and Form 24Q quarterly annexure exports as print formats / report downloads
Gratuity liability accrual maintained by a `scheduler_events` background job so the provision stays current between payroll runs
Statutory Salary Components auto-wired into your Salary Structure so PF/ESI/PT/TDS deductions compute deterministically, not by hand
Server-side calculation in `hooks.py` doc events (`Salary Slip` validate/on_submit) plus `@frappe.whitelist()` recompute methods for auditability
Role Profiles and DocType permissions scoping statutory config to Payroll Managers while employees see only their own declarations
Frappe REST API access to statutory figures and reports for downstream reconciliation or a self-service portal
Client Scripts for real-time PT/PF eligibility hints on the employee and salary-structure forms
Built and tested for Frappe/ERPNext v15 and v16, delivered as a versioned, upgradable app on your bench

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

  1. 1

    You order

    Start with a one-time build price. We scope it with you at kickoff.

  2. 2

    We build & install

    ECOSIRE builds, configures and installs it on your ERPNext.

  3. 3

    Go live + support

    You go live in about one working week, with two weeks of go-live support. Defects in the code we deliver are fixed free of charge.

Technical Specifications

ERPNext Compatibility
—
License
Licence confirmation required
Python Requirement
Python 3.10+
Database
MariaDB 10.6+

About this Product

Running Indian payroll on ERPNext looks fine until statutory month-end. Native HR & Payroll gives you Salary Structures, Salary Components and Payroll Entry, but it has no built-in understanding of the EPF wage ceiling, the ESI gross-wage eligibility cut-off, per-state Professional Tax slabs, or Section 192 TDS projection across the financial year. Teams end up maintaining parallel spreadsheets, hand-keying ECR text files into the EPFO and ESIC portals, and reconciling Form 24Q returns by hand — which is exactly where errors, late-filing interest and audit exposure creep in.

This build-to-order product is a proper Frappe application (india_statutory_payroll) with its own module, installed alongside ERPNext HR & Payroll on your bench rather than bolted on as loose customizations. We add configuration DocTypes — PF Settings, ESI Settings, Professional Tax Slab (keyed by state and effective-from date), and TDS Declaration for employee investment proofs — plus computed statutory Salary Components wired into your Salary Structure. Contribution math runs as server-side logic in hooks.py document events on Salary Slip (validate and on_submit) and in dedicated @frappe.whitelist() methods, so employer/employee EPF splits, EPS diversion, the ESI 0.75%/3.25% shares, PT slab lookup and monthly TDS deduction are calculated deterministically from the employee's structure — never re-typed.

On top of the calculation layer we build the outputs that actually get filed. A Query/Script Report generates the EPFO ECR text file in the correct fixed-width layout from submitted Salary Slips; a matching report produces the ESIC monthly contribution statement. TDS runs off a projected annual-income model per employee — total tax estimated across the financial year, spread evenly across remaining pay periods, and recalculated when a TDS Declaration or mid-year revision is submitted. Form 16 (Part B) and Form 24Q quarterly annexures are produced as print-format / report exports, and a scheduled scheduler_events job maintains gratuity liability accruals so the balance-sheet provision stays current without a manual month-end run. Role Profiles and DocType permissions scope PF/ESI/TDS configuration to Payroll Managers while employees only see their own declarations, and every whitelisted method is permission-checked so nothing leaks across the org.

Because this is build-to-order, nothing ships until we have agreed your scope. We start with a short scoping call to confirm your states for PT, your PF/ESI registration specifics, financial-year conventions, and target Frappe/ERPNext version (v15 or v16). We then build against a staging bench, run UAT with your real salary structures, and hand over installable source, a git repository, documentation and a training session. Typical delivery is one working week from confirmed scope, and every deployment includes a rollback plan plus a post-go-live support window.

What you get

  • Installable source code for your agreed Frappe/ERPNext version (v15 or v16), as a proper `india_statutory_payroll` app
  • Installation and configuration on your bench, including Salary Component wiring, PT slabs and PF/ESI settings
  • Technical documentation: DocType reference, hooks/doc-event map, whitelisted methods and scheduler jobs
  • User guide plus a live training session for your payroll and HR team
  • UAT on a staging bench against your real salary structures, with a documented rollback plan
  • Post-go-live support window for defect fixes and statutory-config adjustments
  • Git repository handover with full commit history and upgrade notes
  • Sample ECR / ESIC / Form 24Q outputs validated against your registration details

Who this is for

Indian SME finance/HR lead on ERPNext

Runs monthly payroll for 20–500 staff and needs PF, ESI, PT and TDS computed and filed correctly inside ERPNext instead of in side spreadsheets, without hiring a full-time Frappe developer.

Payroll outsourcing / BPO provider

Processes payroll for many client companies across multiple states and needs repeatable, state-aware statutory logic, ECR/ESIC exports and Form 24Q generation that scales across tenants on one ERPNext platform.

Frappe/ERPNext implementation partner

Delivering ERPNext to an Indian client and wants a tested, supported statutory payroll app to drop in rather than rebuilding EPF/ESI/PT/TDS logic from scratch on every project.

Finance controller at a growing company

Needs auditable, deterministic statutory calculations, accurate gratuity provisioning on the balance sheet, and Form 16 issuance employees can trust at year-end.

How India Statutory Payroll Pack (PF/ESI/PT/TDS) Compares

CriterionECOSIRECustom BuildCompetitorERPNext Native
PF/ESI/PT/TDS statutory logicPurpose-built engine for all four, wired into Salary Slip eventsWhatever you code yourself, from scratchPartial coverage, often PF/ESI onlyNo India-specific statutory engine built in
EPFO ECR & ESIC file exportCorrect fixed-width ECR + ESIC statement reportsMust be designed and validated by youSometimes ECR only, format may driftNot available — manual portal entry
TDS with annual projectionSection 192 projection recomputed on declarationsComplex to model and maintain correctlyOften flat/manual, no projectionNo India TDS projection
Form 16 / Form 24QGenerated as print formats / report exportsBuild the report layouts yourselfVaries; frequently absentNot provided
Fit to your states & registrationsScoped to your states, PF/ESI IDs and FY conventionsFully yours, but all effort is yoursGeneric defaults, limited state coverageNone
Version support & upgradesBuilt and tested for v15/v16 with upgrade notesYou own every future upgradeDepends on vendor's release cadenceCore upgrades only, no statutory layer
Delivery modelBuild-to-order, one working week, UAT + rollback planOpen-ended internal project timelineInstant install but generic fitAlready present, but no statutory features
Support & handoverPost-go-live support window + git repo handoverSelf-supported unless you retain a devTicket support, limited customizationCommunity/self-support only

Frequently Asked Questions about India Statutory Payroll Pack

How long does delivery take?

This is build-to-order, not an instant download. After a short scoping call to confirm your states, PF/ESI registration details and target version, typical delivery is one working week from confirmed scope. We build on a staging bench, run UAT with your real salary structures, then install to production with a rollback plan.

Is this a ready-made Frappe Marketplace app I can just install?

No. ECOSIRE designs, builds, installs and supports it specifically for your bench and your compliance scope. You receive installable source code and a git repository at handover, but the app is produced to order rather than downloaded pre-built.

Which Frappe/ERPNext versions are supported?

We build and test for Frappe/ERPNext v15 and v16. We confirm your exact version during scoping and deliver an app matched to it, with upgrade notes so it can move forward with your bench.

How are ongoing statutory rate and slab changes handled?

Rates (EPF ceiling, ESI shares, PT slabs, TDS parameters) are stored in configuration DocTypes like `PF Settings`, `ESI Settings` and `Professional Tax Slab`, so most changes are edits your team makes — no redeploy. The post-go-live support window covers defect fixes; larger regulatory reworks can be scoped as a follow-on engagement.

Does it produce the actual files I upload to the EPFO and ESIC portals?

Yes. The app generates the EPFO ECR text file in the correct fixed-width format and the ESIC monthly contribution statement from submitted Salary Slips, plus Form 16 Part B and Form 24Q quarterly annexures as report/print exports.

How does it work with our existing ERPNext HR & Payroll?

It installs as a companion Frappe app alongside HR & Payroll and extends it — statutory components are wired into your Salary Structure and calculations run on `Salary Slip` document events. Your existing employees, structures and payroll entries stay intact; we add the statutory layer on top.

Can we pull statutory figures into other systems?

Yes. Statutory values and reports are accessible via the Frappe REST API and whitelisted methods, and permissions are scoped by Role Profile, so downstream reconciliation, dashboards or a self-service portal can read the data securely.

Request a quote

India Statutory Payroll Pack

A build-to-order Frappe app that turns ERPNext HR & Payroll into a compliant India statutory engine: EPF/UAN, ESI, state-wise Professional Tax, TDS with income-tax projection, gratuity accrual, and Form 16 / Form 24Q reporting. ECOSIRE scopes, builds, installs and supports it on your bench.

  • EPF/UAN engine: employee 12% + employer split with EPS diversion, VPF handling and the statutory wage-ceiling cap applied at Salary Slip validate
  • ESI contribution calculation at current 0.75% employee / 3.25% employer shares with gross-wage eligibility cut-off and mid-period exit handling
  • State-wise Professional Tax via a `Professional Tax Slab` DocType keyed by state and effective-from date, resolved per employee work location
  • TDS (Section 192) computed from a projected annual-income model, spread across remaining pay periods and recomputed on declaration changes

Request a Quotation

Tell us about your India Statutory Payroll Pack requirements and we'll send pricing, licensing options and a tailored proposal — usually within one business day.

No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.