Start a project
contact@dicecodes.com
GST and billing

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

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

  1. Sign in to the GST portal and open Returns Dashboard.
  2. Choose the financial year and the period.
  3. Open GSTR-1 and choose to prepare offline.
  4. Upload the JSON and wait for processing, which can take several minutes.
  5. 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 saysWhat it meansWhat to do
Invalid GSTINThe buyer’s number fails the check digit, or is not registeredConfirm it with the buyer and check it on the portal’s search tool
Duplicate invoice numberThat number was already filed in this periodFind the earlier entry; usually the invoice was exported twice
Invalid place of supplyThe state code does not match a real state, or is missingSet the state on the invoice, not just the address text
Rate not applicableA GST rate was used that does not exist for that HSNCheck the rate against the HSN you put on the line
Processed with errorOne or more rows failed; the rest went throughDownload 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.

Dice Codes
written by

Dice Codes

Matinderpal Singh is the founder of Dice Codes, a digital agency in Batala, Punjab. He has more than ten years of experience building WordPress sites, Shopify stores and custom web applications, and maintains the free DiceStack plugin on WordPress.org.