GST Return Filing Errors: How to Fix
Troubleshooting guide for common GST return filing errors on the GST portal. Fix GSTR-1, GSTR-3B, JSON upload errors, and ITC mismatch issues.
Official Links
GST Return Filing Errors: How to Fix
Filing GST returns on the GST portal is mandatory for all registered businesses. The portal frequently shows errors during filing, especially near due dates when millions of taxpayers file simultaneously. This guide covers all common GST return filing errors and step-by-step solutions.
Common Error Messages and Symptoms
- "System error. Please try after some time" โ server overload
- "JSON file is invalid" โ JSON upload fails during GSTR-1 filing
- "Data processing failed" โ uploaded data could not be processed
- "ITC mismatch โ please check GSTR-2A/2B" โ Input Tax Credit differences
- "Offset liability failed" โ error during tax payment in GSTR-3B
- "Digital signature error" โ DSC not recognized or expired
- "EVC validation failed" โ OTP verification fails during filing
- "Return already filed for this period" โ duplicate filing attempt
- Portal shows "In Progress" for hours without completion
- GSTR-1 summary not generating
- Late fee calculation showing incorrect amount
- NIL return filing button not clickable
- HSN summary errors blocking GSTR-1 submission
Why GST Return Filing Errors Occur
1. Server Overload Near Due Dates
The GST portal handles 1.4 crore+ taxpayers. When a large percentage files in the last 2-3 days before the deadline, servers become overwhelmed.
2. Browser and Technical Issues
The portal requires specific browser configurations and has known compatibility issues with certain browsers and extensions.
3. Data Format Errors
JSON files generated by accounting software may have formatting issues, incorrect field values, or exceed size limits.
4. DSC/EVC Issues
Expired Digital Signature Certificates, incorrect Aadhaar-linked mobile for EVC, or Java plugin issues can block final submission.
5. ITC and Liability Mismatches
Differences between GSTR-2A/2B data and your purchase records cause reconciliation errors.
Step-by-Step Troubleshooting
Step 1: Fix Server and Loading Errors
- File before the last 3 days โ portal load reduces dramatically if you file a week before the due date
- Try during off-peak hours: early morning (5-7 AM) or late night (11 PM - 2 AM)
- Clear browser cache and cookies
- Use Google Chrome in Incognito mode
- Disable all browser extensions
Step 2: Fix JSON Upload Errors
- Check file size โ JSON files must be under 5 MB; split large files if needed
- Validate JSON format โ use the GST offline tool to generate JSON files
- Download the latest GST Offline Tool from gst.gov.in โ Downloads
- Import your data into the offline tool and re-generate the JSON
- Ensure all mandatory fields (GSTIN, invoice number, date, taxable value, tax amounts) are filled
- Check for special characters in party names or descriptions โ remove them
Step 3: Fix GSTR-1 Filing Errors
Summary not generating:
- Click Generate GSTR-1 Summary button
- Wait at least 15 minutes โ do not refresh or click again
- If stuck, log out and log back in after 30 minutes
- Check if all B2B, B2C, and other tables have been correctly filled
HSN summary errors:
- Ensure HSN codes are 4 or 6 digits (as per turnover requirements)
- Check that total taxable value in HSN summary matches your invoice totals
- Re-enter HSN data if auto-populated values are incorrect
Step 4: Fix GSTR-3B Filing Errors
Offset liability error:
- Ensure sufficient balance in the Electronic Cash Ledger and Electronic Credit Ledger
- Pay any pending taxes before attempting to offset
- Check if ITC claimed matches available ITC in GSTR-2B
- If offset button is not working, clear cache and try in a different browser
Late fee calculation issues:
- Late fee is auto-calculated โ โน50/day for normal returns, โน20/day for NIL returns (max caps apply)
- If the late fee amount seems incorrect, check the return period and due date
- File a grievance if the amount is clearly wrong
Step 5: Fix EVC/OTP Issues
- Ensure the mobile number linked to Aadhaar of the authorized signatory is working
- Check if Aadhaar is properly linked to the GST portal
- Try the OTP option multiple times โ server delays are common
- If EVC keeps failing, use DSC (Digital Signature Certificate) as an alternative
Step 6: Fix DSC Errors
- Ensure your DSC is not expired โ check validity on the USB token's utility software
- Install the latest emSigner utility from gst.gov.in โ Downloads
- Ensure Java is installed and up to date
- Run emSigner as Administrator (right-click โ Run as administrator)
- Plugin your DSC token before clicking "File with DSC"
- If using a new DSC, register it first under My Profile โ Register/Update DSC on the GST portal
Step 7: Fix ITC Mismatch Issues
- Download your GSTR-2B from the GST portal
- Compare with your purchase register
- Common reasons for mismatch:
- Supplier has not filed their GSTR-1
- Invoice details (number, date, GSTIN) differ between your records and supplier's filing
- Credit notes not accounted for
- Contact suppliers whose invoices are missing from GSTR-2A/2B
- Reconcile and accept only the ITC available in GSTR-2B
Alternative Methods and Workarounds
Use GST Offline Tool
- Download from gst.gov.in โ Downloads
- Fill your return data offline without server dependency
- Generate JSON and upload when the portal is working
- This avoids timeout issues during data entry
Use GST Suvidha Providers (GSPs)
Third-party GSP platforms often provide a more reliable filing experience:
- ClearTax GST
- Zoho GST
- Tally with GST module
- IRIS GST
These platforms connect directly to the GST network and may have better uptime than the portal.
File NIL Return via SMS
If you have no transactions for the period:
- Send SMS to 14409:
NIL <GSTIN> <Return Period> <OTP> - Follow the format specified on the GST portal help section
- This bypasses the portal entirely
Visit GST Seva Kendra
For persistent technical issues:
- Visit a GST Seva Kendra with your documents
- Staff can help file your return
- Locate centres at cbic-gst.gov.in
Helpline Contacts
| Contact | Details |
|---|---|
| GST Helpdesk | 1800-103-4786 (toll-free) |
| GST Portal Support | selfservice.gstsystem.in |
| GSTN Email | helpdesk@gst.gov.in |
| CBIC Mitra Helpdesk | 1800-1200-232 |
| @aboraborAskGST_GOI |
Prevention Tips
- File at least a week before the due date โ avoid the last-day server rush
- Use the offline tool โ prepare your data offline and upload only the final JSON
- Reconcile ITC monthly โ do not wait until filing time to check GSTR-2B
- Keep DSC updated โ renew your DSC before it expires; keep emSigner software updated
- Use accounting software with GST integration โ Tally, Zoho, Busy, etc. reduce manual errors
- Maintain backup of all filed returns โ download acknowledgements and filed returns after each filing
Related Guides
- GST Registration Online
- Income Tax Portal Not Working Fix
- Income Tax Return Filing Guide
- MSME Udyam Registration
- PAN Card Apply Online
Frequently Asked Questions
Why does the GST portal crash near due dates?
The GST portal serves 1.4 crore+ registered taxpayers. A disproportionate number file in the last 2-3 days before the deadline, creating massive server load. The GSTN infrastructure has improved over time, but filing early (at least a week before) is the best way to avoid issues.
Can I file GST returns after the due date if the portal was down?
If the portal was officially down near the due date, the government sometimes extends the deadline. Check for official notifications on gst.gov.in and the CBIC website. If no extension is announced, late fees will apply even if the portal had issues.
How do I fix ITC mismatch between my books and GSTR-2B?
Download your GSTR-2B and compare it invoice-by-invoice with your purchase register. Common issues include: suppliers not filing their GSTR-1, incorrect invoice numbers or dates in supplier filings, and unaccounted credit notes. Contact suppliers to rectify their filings and claim only the ITC reflected in GSTR-2B.
What is the difference between EVC and DSC for GST filing?
EVC (Electronic Verification Code) uses Aadhaar OTP for verification and is simpler โ suitable for proprietorships and small businesses. DSC (Digital Signature Certificate) is a USB token-based digital signature required for companies and LLPs. Both are valid for filing GST returns.
Can I revise a GST return after filing?
No. GST returns (GSTR-1, GSTR-3B) cannot be revised after filing. Any errors must be corrected in the next period's return. For example, if you made an error in January's GSTR-1, correct it in February's GSTR-1 using credit/debit notes or amendments.
Related Guides
How to Check and Download Form 26AS & AIS โ Annual Tax Statement
Learn how to check and download Form 26AS and AIS from incometax.gov.in. Verify TDS, advance tax, high-value transactions before filing ITR.
NPS Tier 2 Account: How to Open, Benefits & Withdrawal Rules
Complete guide to NPS Tier 2 account โ how to open via eNPS, benefits, tax treatment, minimum contribution, withdrawal rules, and comparison with Tier 1.
PPF vs EPF vs NPS: Which Pension Scheme is Best?
Compare PPF, EPF, and NPS pension schemes. Interest rates, tax benefits, lock-in period, withdrawal rules, and returns comparison table.
How to Download e-PAN Card Online (Instant e-PAN via Aadhaar)
Step-by-step guide to download your e-PAN card online for free using Aadhaar from the Income Tax portal, Protean (NSDL), and UTIITSL. Also covers PAN status...
Post Office FD Interest Rates: Calculate Returns & Tax Benefits
Post Office FD interest rates for 1, 2, 3 and 5 year terms. Calculate returns, tax benefits under 80C, premature withdrawal rules and senior citizen rates.