Push GSTR-1 to the GST Portal (Automatic Filing)
Updated Sep 11, 20266 min read
Every month, someone has to turn your Shopify orders into a GSTR-1 and key it into the GST portal. GST Pro's Automatic Filing does the heavy lifting: it builds the GSTR-1 for a month from your orders, shows you every value, and saves the return to the GST portal as a draft with one click. You then log in to gst.gov.in, confirm the numbers, and file.
What it does and does not do. Automatic Filing saves your GSTR-1 data to the GST portal as a draft. It never files the return. Submitting and filing with EVC or DSC always happens on gst.gov.in, under your control.
This is different from the Generate GST Reports tab, which produces downloadable GSTR-1 reports and offline JSON/CSV files for you or your CA. See Generating Reports in GST Pro for those.
Availability
Automatic Filing is rolling out to stores on the current version of GST Pro. When it is enabled for your store, the Reports item in the navigation reads Reports & Filing and the Reports page gains an Automatic Filing tab. If you do not see it yet and would like early access, reach out to support.
Monthly filing only. Quarterly filing (QRMP / IFF) is coming soon. Pushing GSTR-3B is shown on the tab with a Coming soon badge.
Step 1: Enable API access on the GST portal
GST Pro talks to the portal through its official API, which you must switch on once per GSTIN:
Sign in at gst.gov.in.
Go to My Profile → Manage API Access.
Select Yes, set the duration to 30 days, and save.
The same steps are available inside GST Pro under the Setup guide button described below.
Step 2: Connect your GSTIN in GST Pro
Go to Settings → Integrations and find the GSTR-1 portal card. It lists every GSTIN saved on your store (from Settings → General, or from your locations if location mode is on).
Click Connect next to a GSTIN.
Enter your GST username (your gst.gov.in login) and click Send OTP. The OTP goes to the mobile number and email registered with that GSTIN.
Enter the 6-digit OTP and click Verify OTP. The GSTIN now shows Connected.
If your GSTIN has stray spaces at the start or end, GST Pro asks you to fix it under Settings before connecting.
The portal session created by the OTP is valid for a limited time (currently around six hours). If a GSTIN shows Not connected when you come back to file, click Connect and verify a fresh OTP. Use the trash icon to disconnect a GSTIN and remove its stored credentials.
Step 3: Generate the GSTR-1 for a month
Go to Reports & Filing and open the Automatic Filing tab.
On the Push GSTR-1 to portal row, click Generate.
Pick the Month, Year and GSTIN. Only connected GSTINs are listed. The previous full month is selected by default.
Click Generate.
GST Pro exports the month's orders and refunds from Shopify, runs them through the same tax logic used for your invoices and reports, builds the GSTR-1 JSON and validates it against the GSTN schema. Large months can take a few minutes. You can leave the page; the filing waits for you under History → Autofile.
What is included
Section | GSTR-1 table |
|---|---|
B2B Invoices | 4A |
B2C Large | 5 |
B2C Small | 7 |
Credit Notes, Registered (CDNR) | 9B |
Credit Notes, Unregistered (CDNUR) | 9B |
HSN Summary | 12 |
Exports (EXP), amendments, advances (AT / ATADJ), nil-rated and exempt supplies, and documents issued (Table 13) are not generated. Add those directly on the GST portal before you file.
Step 4: Review the values
When the status changes to Ready for review, click Review & upload. The review page shows:
A Summary table with document count, taxable value, IGST, CGST, SGST and cess for each section, and a Net total (sales - credit notes) line. The HSN summary restates the supplies above grouped by HSN and is not added to the total.
One detail table per section with portal-style columns (recipient GSTIN, invoice number and date, invoice value, place of supply, rate, taxable value and tax amounts). Invoice and credit-note numbers are clickable and open the Shopify order in a new tab, so you can trace any figure back to its source.
Nothing has been sent to the portal at this point. If something looks wrong, click Discard, fix the underlying orders or settings, and generate again.
Step 5: Upload to the GST portal
Click Upload to GST portal.
Confirm in the dialog. The status moves to Processing on portal while GSTN validates the data, usually under a minute.
When the portal confirms, the status becomes Saved to portal and GST Pro shows the Portal reference ID.
Step 6: File on gst.gov.in
Log in to gst.gov.in → Returns Dashboard → select the period → GSTR-1. Compare the saved data with the summary in GST Pro, then Submit and File with EVC or DSC.
Statuses
Status | Meaning |
|---|---|
Queued / Generating | Orders are being exported and the return is being built |
Ready for review | Preview available. Nothing sent yet |
Processing on portal | Sent. GSTN is validating |
Saved to portal | Saved as a draft on gst.gov.in. Not filed yet |
Partially saved | Some records accepted, some rejected by the portal |
Upload failed, retry | The portal never received the data. Fix the cause and upload the same filing again |
Rejected | The portal rejected the data. Discard and generate a fresh filing |
Failed | Generation failed before anything reached the portal |
Discarded | You abandoned the draft |
Fixing problems
Upload failed, retry. Usually the portal session lapsed. Reconnect the GSTIN with a new OTP, open the filing and click Upload to GST portal again. No need to regenerate.
Rejected. Click the error in the History table to read the portal's message. Fix what it points at, Discard the filing, and Generate a new one for the same period.
Partially saved. The accepted records are already on the portal. Correct the rejected records directly on gst.gov.in. Do not regenerate and re-upload the period from GST Pro, since that could duplicate the records already saved.
Generation stopped. Common causes and their fixes:
Products without an HSN code in the period. Set HSN codes on those products, or a default HSN under Settings, and regenerate.
Export orders (shipping outside India) are not supported yet and stop generation.
Duplicate invoice numbers after removing characters GSTN disallows. Invoice numbers must be unique and at most 16 characters using letters, digits,
/and-.Refund details could not be fetched from Shopify. Retry the filing.
Good to know
Periods follow Indian Standard Time.
Refunds are placed in the month they were issued, so an order sold in one month and refunded in the next shows up as a credit note in the second month only.
B2C Small has no credit-note table on the portal, so refunds net directly into its figures and can produce negative values.
Stores with multiple GSTINs generate one filing per GSTIN.
Automatic Filing uses its own GST portal connection. It does not need your e-invoice (IRP) or e-way bill credentials.
Was this article helpful?
Related articles
Still need help?
Start a chat and we'll pick it up right here.