| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Employees (hr) • Payroll (hr_payroll) • Employee Contracts (hr_contract) • Time Off (hr_holidays) • Calendar (calendar) |
| Lines of code | 1312 |
| Technical Name |
epf_challan_report |
| License | LGPL-3 |
| Website | https://www.ahex.co |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Employees (hr) • Payroll (hr_payroll) • Employee Contracts (hr_contract) • Time Off (hr_holidays) • Calendar (calendar) |
| Lines of code | 1312 |
| Technical Name |
epf_challan_report |
| License | LGPL-3 |
| Website | https://www.ahex.co |
EPF Combined Challan & EPFO ECR Report
Generate, validate, and export EPFO Combined Challans and standard ECR text files directly from Odoo Payroll.
Automate India EPF Compliance
Managing EPF compliance manually is time-consuming and highly prone to validation errors. Employers must compute contributions, cap salary bases at Rs. 15,000, enforce statutory admin charges minimums, and generate the exact tilde-separated ECR files for upload to the EPFO unified portal. This module automates this entire workflow by extracting validated payslips and generating permanent, audit-ready database logs with a single click.
Key Features
Direct ECR File Export
Generates standard tilde-separated (~) ECR text files containing UAN, wages, contributions, and NCP days, ready for direct portal upload.
Combined Challan PDF
Prints official EPFO Combined Challans covering Accounts 1, 2, 10, 21, and 22 in a 4-copy format (Original, Duplicate, Triplicate, Quadruplicate).
Statutory Base Capping
Automatically caps the EPF, EPS, and EDLI wage bases at Rs. 15,000 per employee, enforcing statutory calculation rules.
NCP & Present Days
Automatically extracts and calculates Physical Present Days and Non-Contributory Period (NCP) Days directly from Odoo work entries.
Validation Safeguards
Detects and flags duplicate payslips for employees in the selected period, ensuring zero EPFO portal upload rejections.
Custom Rule Configuration
Map custom salary rule codes (Basic, DA, PF Employee, PF Employer, EPS, EDLI, Admin) directly within the configuration wizard.
EPFO Official Combined Challan
The module automatically outputs a print-ready Combined Challan in the official EPFO layout covering Accounts 1, 2, 10, 21, and 22. It prints all 4 required copies (Original, Duplicate, Triplicate, and Quadruplicate) with depositor signature fields and bank realization entries.
Step-by-Step Workflow
|
1
|
Company ConfigurationGo to Company Settings -> EPF Configurations and enter your PF Establishment Code and EPFO Office. |
|
2
|
Employee ConfigurationConfigure each employee's UAN Number and PF Member ID under their HR Employee profile fields, ensuring their contract is marked with Provident Fund active. |
|
3
|
Generate Challan (Wizard)Navigate to Payroll -> PF Compliance -> Generate PF Challan. Select the company, target month, and year. Verify your salary rule mapping codes, then generate the challan. |
|
4
|
Confirm and Download ECRReview individual employee lines and contribution bases in Odoo's sheet form view. Click Confirm, then click Download ECR File or Print Combined Challan. |
Statutory Accounts Covered
The module handles contributions across all five required EPF administration accounts, enforcing capping and minimum limit charges:
| Account | Contribution Description | Rate Structure |
|---|---|---|
| A/C No. 1 | Employee Provident Fund (EPF) Contribution | 12.00% |
| A/C No. 1 | Employer EPF Differential Contribution | 3.67% |
| A/C No. 10 | Employer Pension Scheme (EPS) Contribution | 8.33% (capped) |
| A/C No. 2 | EPF Administrative Charges | 0.50% (Min Rs. 500) |
| A/C No. 21 | Employees' Deposit Linked Insurance (EDLI) | 0.50% (Min Rs. 200) |
| A/C No. 22 | EDLI Administrative Charges | Nil |
Technical Details
Make sure all employees have a valid UAN Number and PF Member ID configured under their Employee profile, and that active contracts are set with Indian Provident Fund enabled.
| Information | Detail |
|---|---|
| Technical Name | epf_challan_report |
| Odoo Version | 18.0 (Community & Enterprise Editions) |
| Dependencies | hr_payroll l10n_in_hr_payroll hr_work_entry_contract_enterprise |
| License | LGPL-3 |
| Author | Ahex Technologies |
| Website | www.ahex.co |
Frequently Asked Questions
Does this generate files compatible with standard EPFO portal uploads?
Yes. The exported Electronic Challan-cum-Return (ECR) text file is formatted in the official tilde-separated (~) file format, allowing direct uploads to the EPFO Unified Portal without manual modifications.
How does the module calculate EPF/EPS/EDLI wages?
It automatically pulls values from validated employee payslips using rule codes. As per statutory provisions, the module caps EPF/EPS/EDLI wage bases at Rs. 15,000 for computations while logging the actual gross wages.
Can I edit individual employee details before finalizing?
Yes. While the PF Challan record is in a "Draft" status, you can manually adjust any calculated amounts, present days, NCP days, or remarks directly on the line items inside Odoo.
What happens if calculations are below administrative minimum thresholds?
The module automatically applies statutory limits: enforcing a minimum of Rs. 500 for Account 2 (EPF Admin Charges) and Rs. 200 for Account 21 (EDLI Contribution) to ensure full legal compliance.
Professional Support & Integration
Need help mapping custom salary rule codes, adding customized fields, or expanding this module for other states or localizations? Our engineering team is here to assist.
Please log in to comment on this module