GST error codes, explained
Your GSTR-1 upload failed and the portal gave you a code and one terse line. Here is what each one actually means, why it happened, and how to fix it — written for people who file, not for search engines.
16 codes covered · 11 of them are catchable before you upload
A GSTIN in your upload failed validation — either it is malformed, or it is not the GSTIN the portal expected for this account.
You split tax into CGST and SGST on a supply the portal considers inter-state — or the reverse.
You charged IGST but the place of supply is your own state, which makes it an intra-state supply.
A tax rate on your invoice is not one of the notified GST slabs.
Taxable value × rate does not equal the tax you declared, within rounding tolerance.
An invoice with this number is already on the portal for this period.
The invoice date precedes the date GST registration took effect.
The invoice number is missing, too long, or contains characters the rules do not permit.
A credit or debit note points at an original invoice the portal cannot find.
The portal could not parse the file — this is a file-level problem, not a single bad invoice.
The uploaded file is corrupt or was altered after it was generated.
The portal found nothing to file — either the sections are empty or turnover is not set.
On an export invoice, the shipping bill date is before the invoice date or in the future.
This invoice number is already present in the filed GSTR-1.
The supplier GSTIN on an invoice failed validation.
The purchase-side file could not be parsed — the GSTIN is missing or the structure is wrong.
Most of these are avoidable
11 of the 16 codes above come from something already sitting in your invoice data. Check the batch before you generate the JSON and you never see them.
Check a batch before filing