Skip to main content

2P: Structural Errors

Structural errors cause the entire uploaded file to be rejected — no invoice from the file enters the system until all structural errors are resolved, the file corrected, and re-uploaded. After structural validation passes, the system checks for duplicate records, followed by business validation errors and warnings.

ErrorDescriptionHow to Resolve
Missing mandatory fieldA mandatory field (e.g. GSTIN of Taxpayer, Invoice No., Invoice Date, Taxable Value, POS) is blank or missing.Fill the mandatory field. Refer to the article “2P: GSTR2 (1) Fields, Regular Transactions and CDN” for the full mandatory field list.
Invalid GSTIN formatGSTIN does not match the 15-character alphanumeric format, or fails the GSTN checksum validation.Verify at https://services.gst.gov.in/services/searchtp. Correct and re-upload.
Invalid date formatInvoice Date or Document Date is not in DD-MM-YYYY format (e.g. entered as 2026-07-01 or 01/07/2026).Correct all dates to DD-MM-YYYY in Excel. Format the date cell as Text to prevent Excel from auto-reformatting.
Invalid return period in Cell B1Cell B1 is blank or not in MMYYYY format (e.g. 072026 for July 2026).Enter the correct period in MMYYYY format and set the cell as Text to preserve the leading zero.
Incorrect Document Type codeDocument Type is not one of the accepted values: RI, BS, C, D, R.Use only the accepted codes in the article “2P: Document Types and Invoice Types”. Refer to Tab 4 (Meta Data Codes) in the template.
Incorrect Invoice Type codeInvoice Type is not one of the accepted values: B2B, SEWP, SEWOP, DE, IMS, IMG, RCM, B2BUR.Use only the accepted codes in the article “2P: Document Types and Invoice Types”.
Incorrect ITC Eligibility codeITC Eligibility is not one of: ip, cp, is, no.Correct to one of the four valid codes. Default is ip.
Incorrect Tax Applicability codeTax Applicability is not one of: T, L, E, N.Correct to T, L, E, or N. Default is T.
Value format errorNumeric fields contain non-numeric characters (currency symbols, thousand-separator commas), exceed decimal precision, or are negative where not permitted.Remove all special characters. Decimal precision must be Decimal(11,2) for tax amounts and Decimal(15,2) for total invoice value.
Column structure mismatchColumns have been added, deleted, or reordered compared to the original template.Use the original input format template without any column modifications.
Blank rows in data rangeBlank rows exist between data rows starting from Row 4. The system stops reading at the first blank row.Remove all blank rows so data is continuous from Row 4 to the last data row.
Invalid data valuesValues provided are not as per the field specification mentioned in input formatProvide the accurate values as applicable as per Input format
Reconciliation already in progressRe-upload attempted while an active reconciliation run is in progress for the same GSTIN.Complete or abort the active reconciliation before re-uploading.
File size exceeds 20 MBThe CSV or ZIP file exceeds the 20 MB limit.Split into smaller files or compress multiple CSVs into a ZIP under 20 MB.
Unsupported file formatFile is not a CSV or ZIP.Convert to CSV or ZIP before uploading.
Cell B2 edited or missingCell B2 has been modified from its pre-filled value “GSTR2”.Re-download the template. Do not edit cell B2 under any circumstances.