Authorised IT Filing Platform by Indian Income Tax DepartmentGoogle Logo 4.8 ★★★★★ Excellence since 2016
LATEST
<>
Home/GST/Help Center/Upload GSTR-1 JSONLast Updated: Apr 25th 2026
⬆️
Guide #21

How to Upload GSTR-1 JSON to the GSTN Portal

Complete guide to uploading your GSTR-1 JSON file to the GSTN portal. Learn portal login procedures, file validation, error resolution, and finalization steps for successful GST return filing.

GSTR-1 UploadGSTN PortalJSON SubmissionGST Return FilingFile Validation
📊

Overview

Once you have prepared and downloaded the GSTR-1 JSON file from EZTax.in GST Accounting, the final step is to upload it to the GSTN (Goods and Services Tax Network) portal for official filing. The GSTN portal is the government's official platform where all GST returns must be submitted. This guide walks you through the entire upload and filing process.

Important: Before uploading, ensure your GSTR-1 JSON file is complete and accurate. Once filed on the GSTN portal, the return cannot be resubmitted. Only amendments can be made in subsequent periods.

🔐

Accessing the GSTN Portal

Follow these steps to access the GSTN portal and prepare for GSTR-1 upload:

  1. 1
    Visit GSTN Website

    Open your web browser and navigate to the official GST portal at https://www.gst.gov.in/. You may also access this directly through EZTax.in which provides a direct link to the portal.

  2. 2
    Login with GSTIN

    Click on the login section and enter your GSTIN (Goods and Services Tax Identification Number). This is a 15-digit unique identifier assigned to your business by the tax authorities. Use your registered username and password to access your GST account.

  3. 3
    Verify OTP

    The portal will send a One-Time Password (OTP) to your registered mobile number or email. Enter this OTP to complete the authentication process and access your GSTN account dashboard.

  4. 4
    Navigate to GSTR-1

    Once logged in, navigate to the "Returns" section and select "GSTR-1" from the available return types. The portal will display options for filing new returns or viewing filed returns for different periods.

📤

JSON File Upload Process

The upload process involves several key steps. Follow this sequence for a successful submission:

  1. 1
    Select Return Period

    Choose the month or quarter for which you are filing the GSTR-1 return. The portal displays all open periods for filing along with their respective due dates.

  2. 2
    Upload JSON File

    Click on the "Upload" button and select your GSTR-1 JSON file downloaded from EZTax.in. The file must be in the exact JSON format as generated by EZTax.in for compatibility with the GSTN system.

  3. 3
    System Processing

    The GSTN portal will process your uploaded JSON file. This typically takes a few seconds to complete. During processing, the portal validates the file format and structure to ensure compliance with GST regulations.

  4. 4
    Review Uploaded Data

    After processing, the portal displays a summary of the data imported from your JSON file. This includes invoice counts, total taxable values, and tax summaries by invoice type (B2B, B2C, Credit/Debit Notes, etc.). Review this carefully before proceeding.

File Validation and Review

The GSTN portal performs automatic validation of your uploaded JSON file. This includes:

  • Format Validation: Confirms the file is a valid JSON format recognized by GSTN
  • Data Structure Check: Verifies all required fields are present and in correct format
  • GSTIN Verification: Cross-references customer and supplier GSTINs against GST database (may show as unregistered if they are newly registered)
  • HSN/SAC Validation: Checks HSN (Harmonized System of Nomenclature) and SAC (Service Accounting Code) codes for accuracy
  • Tax Calculation Review: Validates that tax amounts are correctly calculated based on HSN/SAC codes and applicable rates

Green Flags vs. Warnings: The portal displays validation results. Green flags indicate successful validation. Warnings or errors must be resolved. Some warnings (like unregistered GSTINs) may be acceptable if the entity is newly registered.

⚠️

Common Upload Errors and Solutions

If you encounter errors during upload, follow these common troubleshooting steps:

Invalid JSON Format

File is not in valid JSON structure. Regenerate the JSON file from EZTax.in ensuring no manual modifications are made.

Missing Required Fields

Invoice data is incomplete. Return to EZTax.in and verify all invoices have complete GSTIN, dates, amounts, and tax details.

Invalid HSN/SAC Code

HSN or SAC code is not recognized. Check EZTax.in product master and correct the codes using official GST HSN/SAC finder.

Portal Session Timeout

Session expired during upload. Login again and retry the upload. Large files may take longer to process.

Best Practice: If errors occur, download the error report from the GSTN portal, make corrections in EZTax.in, regenerate the JSON file, and re-upload. Never manually edit JSON files.

📋

Return Finalization and Submission

Once your JSON file is validated and all issues are resolved, proceed with return finalization:

  • Final Review: Review the data summary one last time before submission. This is your last opportunity to make changes.
  • Submit Return: Click the "Submit" button to officially file your GSTR-1 return with GSTN. The return status changes to "Filed".
  • Digital Signature: Some transactions may require DSC (Digital Signature Certificate) authentication. Use your certified DSC to authorize the filing.
  • Download Receipt: After successful filing, the portal provides a unique filing receipt/acknowledgment number. Download and save this for your records.
  • Confirmation Email: GST portal sends a confirmation email with the filing details and acknowledgment number to your registered email address.

Post-Filing: The GSTN portal may auto-populate data for GSTR-3B and GSTR-2B based on your filed GSTR-1. Check these returns in subsequent periods and address any discrepancies promptly.

Need Help Uploading GSTR-1 to GSTN Portal?

Our GST experts can guide you through the upload process and resolve any portal errors.



Disclaimer: This article provides an overview and general guidance, not exhaustive for brevity. Please refer Income Tax Act, GST Act, Companies Act and other tax compliance acts, Rules, and Notifications for details.