Decoding GSTR-2 JSON Errors
Quickly resolve your GSTR-2 JSON errors with our expert solutions and tips.
Companiesinn
Created: 16th July, 2025 3:39 PM, last update:16th July, 2025 3:39 PM
Article Content
Introduction
Filing GSTR-2 can be challenging, particularly when taxpayers face JSON errors that obstruct the submission process. Understanding these errors and knowing how to address them is vital for ensuring compliance and avoiding penalties. This guide details the most common JSON errors linked to GSTR-2 filings and offers straightforward, actionable solutions.
Common JSON Errors and Their Solutions
| Error Code | Error Message | Description |
|---|---|---|
| RET291190 | Checksum mismatch. Unable to process. | This error signifies that the data you are attempting to submit is based on outdated information. To resolve this, download the latest GSTR-2A, reconcile it with your records, and try saving your GSTR-2 again. |
| RET291107 | Invoice No.(s) already exist in GSTR 1 or 5 of 072017 | If your invoice number has been previously utilized by your supplier, you will need to change the invoice number. This allows for provisional ITC claims by updating and re-uploading your document. |
| RET291109 | The GSTIN of supplier is invalid. | Ensure that the GSTIN entered for your supplier is accurate. You can verify the GSTIN through the official portal to prevent this error. |
| RET291106 | Error in JSON structure validation | If you encounter this error, it is advisable to contact support at gst-json-errors@cleartax.in, providing them with the JSON data you attempted to submit. |
| RET291252 | Receiver is not allowed to accept modified invoices/notes. | This occurs when an invoice has been modified and was previously accepted. To rectify this, reject the invoice in GSTN, and then re-upload it. |
| RET291206 | Invalid Eligibility type. | This error arises if the Place of Supply in the invoice has been altered. Contact gst-json-errors@cleartax.in for assistance if this error occurs. |
| RET291241 | Invalid UQC value | If you’ve entered a Unit Quantity Code (UQC) that isn’t recognized, update it according to the accepted list available on GSTN and re-upload your invoice. |
| RET291113 | Date is invalid. | The date of the invoice must be after the receiver’s GST registration date. Adjust the date accordingly and resubmit. |
| RET291119 | Duplicate invoice found in payload. | For this error, consult with the support team at gst-json-errors@cleartax.in to resolve the duplication issue. |
| RET291240 | If PoS and Receiver States are Different, then Eligibility Should be None. | You cannot claim ITC if the Place of Supply differs from your GSTIN state. Modify the invoice to reflect ineligibility or reject and create a new invoice with the correct state. |
| RET291131 | Date is Invalid. | Ensure that the date on your invoice falls within the return period. For instance, for GSTR-2 filing for July, the invoice date should be between July 1st and July 31st. |
| RET291114 | Date is invalid. | Similar to the previous error, ensure the date is post the supplier’s registration under GST to avoid submission failure. |
Conclusion
By familiarizing yourself with these common JSON errors and their solutions, you can streamline your GSTR-2 filing process. If you continue to experience issues, don’t hesitate to seek professional assistance to ensure compliance with GST regulations.
Frequently Asked Questions
What should I do if I encounter a checksum mismatch error (RET291190) while filing GSTR-2?
If you face a checksum mismatch error, it typically means that the data you're trying to submit is outdated. To resolve this, you should first download the latest GSTR-2A, which is a summary of your purchases. After that, reconcile it with your records to ensure everything matches. Once you've confirmed that your records are current, try saving and resubmitting your GSTR-2 again. Keeping your data updated is crucial to avoid such errors.
How can I fix the error regarding an invoice number already existing (RET291107)?
This error occurs when the invoice number you're trying to submit has already been used by your supplier in GSTR-1 or GSTR-5. To fix this, you'll need to change the invoice number to a unique one that hasn't been used. After modifying the invoice number, update your document accordingly and re-upload it. This allows you to make provisional Input Tax Credit (ITC) claims without any issues.
What steps should I follow if the GSTIN of the supplier is invalid (RET291109)?
If you receive an error indicating that the GSTIN of your supplier is invalid, the first step is to double-check the GSTIN you entered. Ensure that it's accurate and free of any typos. You can verify the GSTIN on the official GST portal. If the GSTIN is indeed incorrect, reach out to your supplier for the correct details. Once you have the right GSTIN, update your invoice and resubmit the GSTR-2 to avoid this error.
What can I do if I encounter an error in JSON structure validation (RET291106)?
An error in JSON structure validation usually indicates that there's something wrong with the format of the JSON data you're submitting. If this happens, the best course of action is to reach out to the support team at ClearTax by emailing them at gst-json-errors@cleartax.in. Make sure to provide them with the JSON data you attempted to submit, as they can assist you in identifying and fixing the specific issues in your JSON structure.
How do I resolve the issue with modified invoices being rejected (RET291252)?
When you encounter the error stating that the receiver is not allowed to accept modified invoices/notes, it means the invoice you are trying to submit has been modified after it was initially accepted. To resolve this, you need to first reject the invoice in the GSTN system. After rejecting it, you can then re-upload the invoice with the necessary modifications. This process helps ensure compliance and allows you to continue with your GSTR-2 filing.
What does it mean if I see an invalid eligibility type error (RET291206)?
An invalid eligibility type error usually occurs when the Place of Supply in your invoice has been changed. This can affect your ability to claim Input Tax Credit (ITC). If you encounter this error, it’s advisable to reach out for assistance by emailing gst-json-errors@cleartax.in. They can provide guidance on how to correct the eligibility type based on your invoice details. Always ensure that the Place of Supply aligns with your GSTIN to prevent such errors.
What should I do if I encounter a duplicate invoice found in the payload (RET291119)?
If you see a duplicate invoice found in the payload error, it means that the system has identified that the same invoice has been submitted more than once. To resolve this, it's best to consult with the support team at ClearTax. You can reach out to them at gst-json-errors@cleartax.in and provide details about the duplicate invoice. They can help you to identify the issue and guide you on how to proceed with your GSTR-2 filing without submitting duplicates.
Start Your Business Today
Complete company registration with expert guidance