Filing GSTR-1 Without Paid Software: JSON Export Step by Step

You can file GSTR-1 without paying for software by producing a JSON file in the format the GST portal expects, uploading it under Returns, and fixing whatever the portal reports back. The file is the easy part. Reading the portal’s error messages is where people give up.
What the portal expects
GSTR-1 is your outward supplies: everything you sold in the period. The portal takes a JSON file with your GSTIN, the return period, and your invoices sorted into sections by type of sale. B2B invoices go in one section with the buyer’s GSTIN, B2C sales above the threshold go in another with the place of supply, and smaller B2C sales are summarised rather than listed one by one.
Getting the sections right matters more than getting the file pretty. An invoice in the wrong section is a mismatch your buyer will chase you about.
Producing the file
Any tool that exports GSTR-1 JSON will do, including our free billing tool. The portal also publishes an offline utility that builds the file from a spreadsheet, which is worth knowing about because it is free, official, and nobody mentions it.
Whatever produces the file, check three things before uploading: the GSTIN is yours and typed correctly, the period matches the month or quarter you mean, and the invoice numbers are the ones actually on the documents you issued.
Uploading it
- Sign in to the GST portal and open Returns Dashboard.
- Choose the financial year and the period.
- Open GSTR-1 and choose to prepare offline.
- Upload the JSON and wait for processing, which can take several minutes.
- Open the error report if one appears, then fix and upload again.
Reading the errors
The portal’s messages are terse. These are the ones that come up most.
| What it says | What it means | What to do |
|---|---|---|
| Invalid GSTIN | The buyer’s number fails the check digit, or is not registered | Confirm it with the buyer and check it on the portal’s search tool |
| Duplicate invoice number | That number was already filed in this period | Find the earlier entry; usually the invoice was exported twice |
| Invalid place of supply | The state code does not match a real state, or is missing | Set the state on the invoice, not just the address text |
| Rate not applicable | A GST rate was used that does not exist for that HSN | Check the rate against the HSN you put on the line |
| Processed with error | One or more rows failed; the rest went through | Download the error file, fix only those rows, upload again |
A file that is “processed with error” has partly filed. Do not re-upload the whole thing without checking, or you will create the duplicates you are about to be warned about.
After a rejected file
Fix the rows the error report names, produce a fresh file containing only those corrections, and upload that. Then open the portal’s own summary and compare the totals to your books before you submit. The summary is the number that counts, not what your software said.
When paying someone is cheaper than your time
Doing this yourself makes sense while you are filing a few dozen invoices a month. Once you are into the hundreds, or you are reconciling against GSTR-2B as well, the hours cost more than an accountant. That is a business decision rather than a technical one.
If the problem is that your invoices are in a spreadsheet rather than a system, start there instead: moving a shop from Excel bills to GST invoices.
Most filing errors start at the invoice rather than at the portal, so if yours come out of a website it is worth getting that right first. That is e-commerce development work, and the Shopify-specific version is GST not showing at Shopify checkout.
Is the government offline utility free?
Yes. The GST portal publishes it at no cost and it builds a valid JSON from a spreadsheet template. It is clunky, and it works.
What happens if I file GSTR-1 late?
A late fee applies per day and your buyers cannot see the invoices in their GSTR-2B until you file, which is usually the louder problem.
Can I edit an invoice after filing?
Not in that return. You amend it in a later period using the amendment sections, which is why getting it right first time is worth the extra ten minutes.
Do I need to list every small retail sale?
No. Small B2C sales are reported as a summary by rate and place of supply rather than invoice by invoice.
Invoicing from a website or a store?
If your invoices come out of WooCommerce or Shopify, we can make the export match what the portal wants.