Home
EPFO ECR File Format: Complete 11-Column Structure and Text File Creation Guide
The Electronic Challan cum Return (ECR) is the mandatory monthly digital filing that every employer registered under the Employees' Provident Fund Organization (EPFO) must submit. It serves as a unified statement that reports the monthly contributions of employees toward their Provident Fund (PF), Pension Scheme (EPS), and Insurance (EDLI).
In the modern digital infrastructure of the EPFO Unified Portal, the system no longer accepts physical forms like Form 5, 10, or 12A. Instead, employers must upload a specific plain text file that follows a rigid data structure. Understanding the technical specifications of the ECR format is crucial to avoid upload failures, TRRN rejection, and potential penalties for late filing.
The Technical Core of the ECR File Format
Before diving into the columns, it is essential to understand the file’s DNA. The EPFO portal does not accept Excel (.xlsx) or CSV files directly. The required format is a Plain Text (.txt) file.
The most critical element of this file is the delimiter. Unlike standard data files that use commas or tabs to separate data points, the EPFO ECR uses a unique string: #~# (Hash-Tilde-Hash). This specific sequence ensures that common characters used in names or addresses do not interfere with the data parsing logic of the portal.
Summary of File Specifications:
- File Extension: .txt
- Delimiter: #~#
- Structure: One row per employee.
- Encoding: ANSI or UTF-8 (standard text).
- End of File: No blank lines at the end of the file.
Detailed Breakdown of the 11-Column Structure (ECR Version II)
Since the implementation of ECR Version II (the UAN-based system), the number of required data fields has been streamlined to 11 essential columns. Each column must be present in the exact order listed below. Even a single misplaced column will result in a "File Structure Error" on the portal.
| Field No. | Column Name | Technical Validation & Requirement |
|---|---|---|
| 1 | UAN (Universal Account Number) | Must be a valid 12-digit number linked to your establishment. |
| 2 | Member Name | Must match the name registered in the EPFO database. |
| 3 | Gross Wages | Total monthly salary including all components. |
| 4 | EPF Wages | Salary on which PF is calculated (Basic + DA). Usually capped or actuals. |
| 5 | EPS Wages | Salary for Pension calculation. Capped at ₹15,000. |
| 6 | EDLI Wages | Salary for Insurance. Usually equal to EPF wages, capped at ₹15,000. |
| 7 | EPF Contribution (EE) | Employee’s 12% share of EPF Wages. |
| 8 | EPS Contribution (ER) | Employer’s 8.33% share towards Pension (up to ₹1,250). |
| 9 | EPF-EPS Diff (ER) | Employer's 3.67% share towards EPF (Total ER share - EPS share). |
| 10 | NCP Days | Non-Contributory Period (Days for which no wages were paid). |
| 11 | Refund of Advances | Amounts recovered from employees for PF loans (usually 0). |
Deep Dive into Critical Fields and Validation Logic
Generating the file is not just about the format; it is about the mathematical integrity of the data. The EPFO portal runs real-time validation checks on the wages and contributions.
1. The Wage Ceiling Logic (₹15,000)
The current statutory wage ceiling for EPS and EDLI is ₹15,000.
- EPF Wages: Can exceed ₹15,000 if the employer and employee choose to contribute on full wages.
- EPS Wages: Cannot exceed ₹15,000. If an employee earns ₹20,000, this field must reflect ₹15,000. If the employee is over 58 years old or has opted out of EPS, this field should be "0".
- EDLI Wages: Must be equal to EPF wages but capped at a maximum of ₹15,000. If EPF wages are ₹12,000, EDLI is ₹12,000. If EPF wages are ₹18,000, EDLI is ₹15,000.
2. NCP Days (Non-Contributory Period)
Field 10, NCP Days, is the most common reason for discrepancy.
- If an employee works for the full month of 30 days, NCP Days is 0.
- If an employee takes 5 days of unpaid leave (Loss of Pay/LOP), NCP Days is 5.
- Validation Rule: NCP Days cannot exceed the total number of days in the specific wage month. Furthermore, if wages are reported as "0", the NCP Days must equal the number of days in that month.
3. Contribution Rounding
EPFO requires all contribution amounts (Fields 7, 8, and 9) to be rounded to the nearest Rupee.
- Example: A calculation resulting in ₹1250.49 should be reported as 1250.
- Example: A calculation resulting in ₹1250.50 should be reported as 1251. Errors in rounding are a frequent cause for "Total Amount Mismatch" when the portal generates the PDF summary.
Step-by-Step Tutorial: How to Create the ECR Text File Manually
If you are not using automated payroll software, you can generate the ECR file using Microsoft Excel and a text editor like Notepad.
Step 1: Data Preparation in Excel
Open a new Excel sheet. Do not include any headers (no "UAN", "Name" labels at the top). Start directly with the data in Row 1.
- Column A: UAN (e.g., 100XXXXXXXXX)
- Column B: Name (e.g., ANKIT SHARMA)
- Column C to K: Follow the 11-column table provided above.
- Verification: Ensure there are no formulas in these cells. Copy and "Paste as Values" before proceeding.
Step 2: Saving as CSV
- Go to File > Save As.
- Select the file type as CSV (Comma Delimited) (*.csv).
- Name the file (e.g.,
ECR_April_2024.csv).
Step 3: Delimiter Conversion
The CSV file uses commas, but the EPFO portal needs #~#.
- Right-click the saved CSV file and select Open With > Notepad.
- You will see your data separated by commas:
100123456789,ANKIT SHARMA,20000,15000... - Press Ctrl + H (Replace) on your keyboard.
- In "Find what", type a comma (
,). - In "Replace with", type the delimiter:
#~#. - Click Replace All.
Step 4: Final Cleanup and Saving
- Check the end of every row. Every row must end with the delimiter
#~#. Note that the standard format isField1#~#Field2#~#...#~#Field11#~#. Some portal versions require a trailing delimiter; ensure your output matches theUAN#~#Name#~#...#~#Refund#~#pattern. - Crucial Check: Scroll to the very bottom of the document. If there is a blank line (a cursor that can move to a line with no data), delete it. A trailing empty line will trigger an "Incorrect Field Count" error.
- Go to File > Save As. Set encoding to UTF-8. Save the file as
ECR.txt.
The Upload Process on the EPFO Unified Portal
Once your file is ready, the filing process involves several stages of validation.
- Login: Access the Unified Employer Portal using your Establishment ID and Password.
- Navigation: Go to the Payments menu and select ECR Upload.
- File Upload:
- Select the Wage Month and Year.
- Select the Date of Disbursement (the date the salary was actually paid).
- Select the File Type as "ECR".
- Choose your
.txtfile and click Upload.
- Validation Check: The system will place the file in a queue. If the format is correct, the status will change to "Validation Successful". If there are errors (e.g., UAN not linked, name mismatch), you must download the Error File, rectify the records, and re-upload.
- TRRN Generation: Once validated, a Temporary Return Reference Number (TRRN) is generated. You can now view the ECR PDF. This document is your final chance to verify the data before making the payment.
- Finalization and Payment: Click on "Approve". Once approved, the payment link will appear. You can pay via Net Banking from an authorized bank.
Handling Arrear ECR Files
Sometimes, an employer may need to pay contributions for a past period (e.g., due to a late salary hike or an omitted employee). This requires an Arrear ECR.
The Arrear ECR format is slightly different from the monthly ECR. While the monthly return has 11 fields, the Arrear file is often simpler but must be uploaded under the "Arrear" file type selection. It specifically focuses on:
- UAN
- Name
- Arrear EPF Wages
- Arrear EPS Wages
- Arrear EDLI Wages
- Employee Share (EPF)
- Employer Share (EPF)
- Pension Fund Contribution
When uploading arrears, ensure you select the correct "Wage Month" for which the arrears are being paid to ensure the interest calculation (under Section 7Q) and damages (under Section 14B) are accurate if the filing is delayed.
Common Error Messages and Solutions
Based on practical experience in payroll management, here are the most frequent hurdles encountered with the ECR format:
1. "Invalid Delimiter or Column Count Mismatch"
- Cause: You likely have an extra comma in a member's name or have missed the
#~#at the end of a line. - Solution: Open the text file in Notepad++ and show all characters (View > Show Symbol > Show All Characters). Ensure every line has exactly the same number of delimiters.
2. "Member Not Linked to Establishment"
- Cause: You are trying to file a return for a UAN that has not yet been "connected" to your establishment ID via the Member Onboarding process.
- Solution: Go to Member > Register Member (Individual) and ensure the employee is successfully onboarded before uploading the ECR.
3. "Wages Greater than Gross Wages"
- Cause: Field 4 (EPF Wages) cannot be higher than Field 3 (Gross Wages).
- Solution: Check your payroll calculation. Even if you are contributing on a higher wage, the Gross Wage must reflect the total earnings including HRA and other allowances that may not be part of the PF calculation.
4. "Invalid NCP Days"
- Cause: Entering NCP days for a month that has fewer days (e.g., entering 31 NCP days for February).
- Solution: Validate your leave records against the specific calendar month.
Summary and Compliance Checklist
To ensure your ECR filing is seamless and to avoid the 15th-of-the-month deadline rush, follow this checklist:
- Format Check: Is the file a
.txtusing the#~#delimiter? - UAN Verification: Are all new joiners' UANs active and linked?
- Wage Capping: Is the EPS wage capped at ₹15,000 for relevant employees?
- Member Names: Do the names in your file match the EPFO portal records exactly?
- Zero-Wage Members: If an employee had zero wages, are the NCP days correctly updated to the full month?
- Trailing Lines: Have you removed any empty lines at the bottom of your text file?
By adhering to the strict Version II 11-column structure, you minimize the risk of technical rejections and ensure that your employees' social security benefits are credited without delay.
Frequently Asked Questions (FAQ)
What is the deadline for filing the ECR each month?
The statutory deadline is the 15th of the following month. For example, the ECR for April wages must be filed and paid by May 15th. Filing after this date attracts interest under Section 7Q and penal damages under Section 14B.
Can I edit an ECR after it has been uploaded?
You can delete an ECR as long as it has not been "Approved." Once you click "Approve" and a TRRN is generated, you can still cancel it if payment hasn't been made. However, once the payment is successful, the ECR cannot be edited. Any corrections must be handled through a physical application (Joint Declaration) or adjusted in subsequent months (if applicable).
Is the ECR format different for companies with 10% contribution rates?
The file structure (11 columns) remains identical. You simply select the "10%" rate in the dropdown menu on the EPFO portal during the upload process. The validation logic will then expect 10% of wages instead of the standard 12%.
Why does my text file show "Format Error" even if I used #~#?
This often happens if you have hidden characters or formatting (like bold text or special fonts) copied from Excel. Always use a plain text editor like Notepad to perform the final save to ensure all hidden metadata is stripped from the file.
Can I file an ECR with zero employees?
If your establishment is temporarily closed or has no eligible employees for a specific month, you are not required to file a "Nil" ECR, but it is often recommended to submit a "Nil" return or notify the regional PF office to avoid "Default" notices.
-
Topic: ELECTRONIC CHALLAN CUM RETURN VERSION IIhttps://www.epfindia.gov.in/site_docs/PDFs/EPFOUnifiedPortal/Introduction_ECR2.0.pdf
-
Topic: How to File PF ECR in 2026: Step-by-Step Guide for HR Teams - EZHRMhttps://ezhrm.in/how-to-file-pf-ecr-2026-guide/
-
Topic: How to File ECR (Electronic Challan cum Return) on EPFO Portal - Investment EPFOhttps://investmentepfo.com/how-to-file-ecr-electronic-challan-cum-return-on-epfo-portal/