GST · 5 November 2026 · 8 min read
Filing GSTR-1 with a JSON file: a step-by-step guide for shop owners
How to file GSTR-1 by uploading a JSON file from your billing software instead of typing invoices into the portal: what goes in B2B, B2C and HSN, and the checks to do before you submit.
By the Tatva ERP team at Kentron Technologies
GSTR-1 is the return of your outward supplies: every sale you made in the period. You can type it into the GST portal invoice by invoice, but if your billing software already has those invoices, the faster and safer route is to upload a JSON file the software prepares for you.
What GSTR-1 contains
| Section | What goes in it |
|---|---|
| B2B (table 4) | Invoices to registered buyers, one by one, with the buyer's GSTIN. |
| B2C large (table 5) | Inter-state invoices to unregistered buyers above the prescribed value. |
| B2C small (table 7) | All other sales to unregistered buyers, summarised by place of supply and rate. |
| Credit / debit notes (table 9B) | Sale returns and rate changes against earlier invoices. |
| HSN summary (table 12) | Quantity and value by HSN code, split B2B and B2C. |
| Documents issued (table 13) | Invoice and note number ranges used in the period. |
Step by step
- Close the period's billing. Make sure every sale and sale return for the month (or quarter, under QRMP) is saved.
- Check party GSTINs. A B2B invoice with a wrong GSTIN lands in someone else's GSTR-2B. Fix it in the party master before exporting.
- Open the GSTR-1 screen and review the summary. In Tatva ERP, GST → GSTR-1 shows the B2B, B2C and HSN sections with totals for the period.
- Download the JSON. Choose "JSON for GST portal". (Excel and CSV are also there if your accountant prefers the offline tool.)
- Upload on the portal. On gst.gov.in go to Returns → GSTR-1 → Prepare offline → Upload, and choose the file.
- Wait for processing and read the error report. The portal validates every invoice; a rejected invoice is listed with the reason.
- Compare the portal summary with your software, then file with EVC or DSC.
The checks that save a revision later
- Place of supply. An inter-state sale billed as intra-state (CGST + SGST instead of IGST) is the most common error, and it cannot be corrected by an amendment of tax type alone.
- HSN digits. Businesses above ₹5 crore turnover must report six-digit HSN; others four. Keep your item master right and the summary is right.
- Returns. A sale return must reference the original invoice. Tatva ERP makes returns against the bill, so the note carries the reference automatically.
After GSTR-1: GSTR-3B
GSTR-1 tells the system what you sold; GSTR-3B is where you pay. Tatva ERP prepares GSTR-3B from the same bills and works out the set-off of input tax credit in the order the law requires. We explain that order in our guide to the GSTR-3B set-off.
Want to see your own month as a GSTR-1 JSON? Ask for a demo and we will import a sample of your bills.