How to File GSTR-1 Using a JSON File (Offline Upload)

By Published
9 min read

You do not have to type every sales invoice into the GST portal. GSTR-1 supports an offline upload: you prepare a JSON file with all your data and the portal reads it in one go. For anyone raising more than a handful of invoices a month, this is faster and far less error-prone than online entry.

This guide explains the JSON, how to get one, and how to go from upload to filed.

What the GSTR-1 JSON contains

The JSON is a single file in the GSTN schema that carries every part of your GSTR-1:

  • B2B invoices (sales to registered buyers, with their GSTIN)
  • B2C-Large (inter-state sales to unregistered buyers above ₹1,00,000)
  • B2C-Others (the summarised small-value retail sales)
  • Exports and credit / debit notes
  • The HSN summary of what you sold
  • The documents-issued table (invoice number ranges)

Two ways to get the JSON

1. The GST Returns Offline Tool. A free utility from the portal: you fill an Excel template (or import a CSV), validate it, and it generates a JSON. It works, but you are still keying or copy-pasting invoice data, and schema or template mismatches are common.

2. Your billing software (the easy way). If you already raise invoices in software, the JSON can be exported straight from them, no re-entry. Wiseventory auto-prepares GSTR-1 from your invoices and exports a download-ready JSON in the correct schema, with B2B/B2C sorting and the HSN summary already done, for both monthly and quarterly periods.

Filing GSTR-1 with a JSON, step by step

  1. Generate the JSON. In Wiseventory, open the GSTR-1 report for the period and click download JSON. (With the offline tool, build it from the Excel template first.)
  2. Open the return on the portal. Log in and go to Services → Returns → Returns Dashboard, choose the financial year and period, and select GSTR-1.
  3. Choose "Prepare Offline" and open the Upload tab. Click Choose File, select your JSON, and upload it.
  4. Wait for processing. The portal processes the file in a few minutes and shows a status. If records were rejected, it tells you how many.
  5. Generate the summary and review. Switch to Prepare Online, click Generate Summary, and check the B2B, B2C and HSN tables against your sales register.
  6. Submit, then File. Submit the return, then file it with DSC or EVC. Only now is the return actually filed.

Upload is not filing. Loading the JSON only puts your data on the portal. The return is filed only after you Submit and File, so always generate the summary and review before you finish.

If the portal flags errors

After processing, the portal lists any records it could not accept. The usual culprits:

  • Invalid or wrong-format GSTIN on a B2B invoice.
  • Duplicate invoice numbers within the period.
  • Dates outside the return period, or an out-of-date schema version.

Download the error report, correct those records at source, regenerate the JSON and upload again. Only the flagged records need fixing. The rest stay. When invoices are raised in software with a clean numbering series and validated GSTINs, most of these errors never occur in the first place.

Tips for a smooth upload

  • Generate the JSON after the period closes so no late invoice is missed.
  • Upload a few days before the 11th to give yourself room to fix any error and re-upload.
  • Always Generate Summary and compare totals with your own sales figure before filing.
  • Keep the final JSON as a record of exactly what you filed.

Frequently asked questions

What is a GSTR-1 JSON file?

It is a structured data file in the GST Network (GSTN) schema that holds everything your GSTR-1 needs: B2B and B2C invoices, exports, credit and debit notes, the HSN summary and the documents-issued table. Instead of typing each invoice on the portal, you upload this one file and the portal reads all of it at once.

Does uploading the JSON file my GSTR-1?

No. Uploading only loads your data into the portal. You still have to generate the summary, review the tables, Submit, and then File with DSC or EVC. Treat the upload as data entry done in one step. The filing happens after you review.

Where does the JSON come from?

Two ways. The free GST 'Returns Offline Tool' lets you fill or import an Excel template and then generates a JSON. It works, but it is slow. The easier way is billing software that exports the JSON directly from your invoices. Wiseventory auto-prepares GSTR-1 and gives you a download-ready JSON in the correct schema for both monthly and quarterly filing.

What if the portal shows errors after upload?

The portal processes the file and flags any records it could not accept (for example an invalid GSTIN or a duplicate invoice number). You can download the error report, fix those records at source, regenerate the JSON, and upload again. Only the flagged records need attention.

Can I upload the JSON more than once?

Yes. Re-uploading adds new records and updates any that share the same invoice number, so you can correct and top up before you file. Nothing is final until you Submit and File.

Why does the schema version matter?

The portal only accepts JSON in its current schema. An out-of-date file is rejected. This is a common reason people get stuck with the offline tool. Software that stays current with the GSTN schema avoids it, because the export is always in the latest format.

Get a portal-ready GSTR-1 JSON

Wiseventory auto-prepares GSTR-1 from your invoices and exports the JSON in the correct schema, B2B/B2C sorted, HSN summary done. Monthly or quarterly. Free to start.

Related guides