VauPrime DocsAdvanced FeaturesGST Return Filing
Advanced FeaturesCurrent app behaviorDart-source backed

GST Return Filing

Prepare and review GST return data for a selected return type and period, validate the current data, export supported GSTN JSON files, review filing history and continue to filing or challan-related actions from one workspace.

Main tabs

2 tabs

Summary / Return Summary and History / Filing History

Period modes

3 modes

Monthly, Quarterly and Annually

GSTN JSON

GSTR-1 + GSTR-3B

Official JSON export currently implemented for these return types

Platforms

Android + Windows

Compact action stack on Android and wide action row on Windows

What is GST Return Filing?

Purpose and current behavior of this feature.

GST Return Filing is VauPrime’s advanced GST workspace for compiling organization GST transactions into a selected return period, reviewing tax values, running validation and continuing to return-related actions.

The screen separates the current return workspace from filing history. It uses the selected financial year to build available GSTR periods, then reloads GST transaction data when the user changes the period.

The selectable return list is broad, but some actions have narrower implementation support. In particular, the current GSTN-compatible JSON exporter is implemented for GSTR-1 and GSTR-3B; other return selections should not be assumed to support official JSON export just because they appear in the Return Type picker.

Android UI structure

Screen-by-screen structure, tabs, lists, taps and action behavior on Android.

Top layoutAndroid shows the Global Header above the GST Return Filing workspace. The Windows left sidebar is not shown inside the compact Android layout.
Two tabsAndroid labels the tabs “Summary” and “History”. Summary is the working return screen; History is the filing-history screen.
Summary — Return ConfigurationThe first card contains Return Type, Period Type and GSTR Period. On narrow width the Return Type and Period Type controls stack vertically.
Return Type pickerTap to open the return selection sheet. The current screen offers forms from GSTR-1 through GSTR-11, including GSTR-2A, 2B, 3B, 5A, 9A and 9C variants.
Period TypeChoose Monthly, Quarterly or Annually.
GSTR PeriodChoose the period generated from the current financial year. Changing it reloads the GST data shown below.
Android action stackOn compact width the actions are stacked as Generate Return → Validate Return → Download GSTN JSON → File Return. Each major action has its own contextual help where provided.
Generate ReturnCompiles the current GST data into a draft return workflow for review. The screen explicitly describes this as a preliminary step rather than the final submission.
Validate ReturnRuns the current GST checks and shows Passed, Warning or Failed results in the validation report.
Download GSTN JSONExports GSTN-compatible JSON when the selected return is currently supported and the data passes required checks. The resulting file is intended for manual upload in the GST portal/offline tool.
File ReturnOpens the screen’s final filing action/confirmation flow. Review all return information before continuing because the UI treats filing as the final submission stage.
Validation reportDisplayed below Return Configuration so errors and warnings can be reviewed before export or filing actions.
GST transaction tableShows Voucher Type, Invoice No., Date, Party Name, Taxable Value, CGST, SGST, IGST, Total and Running Tax Balance, plus a total row.
Tap transaction rowOpens the selected transaction body/details in a bottom sheet so the GST result can be traced back to its accounting entry.
Summary cardsBelow the table Android displays Total Invoices, Taxable Value, Net Tax Payable and Total Amount in a compact two-by-two arrangement.
Tax BreakdownShows CGST, SGST, IGST and Total Tax.
Create ChallanThe final action in the Summary content opens the GST challan workflow using the calculated liability values.
History tabShows Filing History. When no filing records are available, the current empty state reads “No filing history found”.

Windows UI structure

Desktop layout, wide-screen controls, tables and row actions on Windows.

Desktop shellWindows uses a 290px Window Global Sidebar, the Global Header, then the GST Return Filing content in the remaining desktop workspace.
Two tabsWindows labels the tabs “Return Summary” and “Filing History”.
Return ConfigurationOn wider screens Return Type and Period Type appear side by side, followed by the GSTR Period selector.
Wide action rowDesktop provides Generate Return, Validate Return, Mark Filed, Download GSTN JSON and File Return in the wide action layout.
Mark FiledThis desktop-width action records the selected period through the screen’s Mark Filed workflow. A period must be selected first.
Validation reportThe same Passed / Warning / Failed report appears below the configuration card.
GST tableWindows gives the GST data table more horizontal room. Columns are Voucher Type · Invoice No. · Date · Party Name · Taxable Value · CGST · SGST · IGST · Total · Running Tax Balance.
Total rowThe GST table shows calculated totals at the bottom rather than requiring the user to total the visible rows manually.
Row clickClicking a GST transaction opens its transaction details/body for review.
Summary cardsOn wide layout the four cards — Total Invoices, Taxable Value, Net Tax Payable and Total Amount — are presented in one horizontal row.
Tax Breakdown / ChallanCGST, SGST, IGST and total tax appear below the summary cards, followed by Create Challan.
Filing HistoryThe second desktop tab is Filing History. The current screen has a dedicated empty state when there are no filing records.

Return configuration and review controls

Current selections, calculated data and return actions exposed by the GST Return Filing screen.

Return TypeCurrent selectable list: GSTR-1, GSTR-2, GSTR-2A, GSTR-2B, GSTR-3, GSTR-3B, GSTR-4, GSTR-5, GSTR-5A, GSTR-6, GSTR-7, GSTR-8, GSTR-9, GSTR-9A, GSTR-9C, GSTR-10 and GSTR-11.
Period TypeMonthly, Quarterly or Annually.
GSTR PeriodThe actual filing period. VauPrime builds available periods from the organization’s current financial year.
Generate ReturnBuilds the draft return view from the current GST transaction data for review.
Validate ReturnRuns current return checks and surfaces errors/warnings before later actions.
Download GSTN JSONDownloads a GSTN-compatible JSON file for supported return types. Current official JSON generation is implemented for GSTR-1 and GSTR-3B.
Mark FiledAvailable in the current wide/desktop action layout and requires a selected period.
File ReturnFinal filing action exposed by the screen. Use only after reviewing and validating the return information.
GST data tableVoucher-level GST review with taxable value and CGST/SGST/IGST totals. Row selection opens the transaction detail body.
Summary valuesTotal Invoices, Taxable Value, Net Tax Payable and Total Amount.
Tax BreakdownCGST, SGST, IGST and Total Tax calculated from the current return data.
Create ChallanStarts the GST liability challan generation flow from the calculated tax amounts.

Prepare and review a GST return

Follow the current in-app flow from start to completion.

01

Select Return Type

Choose the required GSTR form from Return Configuration. Remember that selection availability is broader than official JSON-export support.

02

Choose period mode

Select Monthly, Quarterly or Annually, then choose the GSTR Period derived from the current financial year.

03

Review GST transactions

VauPrime loads the period’s GST activity into the table. Review invoices, parties, taxable values and tax components; tap/click a row to inspect its transaction details.

04

Generate Return

Compile the current GST data into the screen’s draft return workflow.

05

Validate

Run Validate Return and review the compact validation report. Resolve Failed checks before attempting GSTN JSON export.

06

Export GSTN JSON when supported

For GSTR-1 or GSTR-3B, Download GSTN JSON can create the supported government-format file after period, data, validation and GSTIN checks pass.

07

Upload JSON manually if using export

The downloaded JSON is intended for manual upload through the GST portal/offline tool; downloading the file itself is not the same as portal submission.

08

Review tax liability

Use summary cards and Tax Breakdown to review net payable values. Create Challan is available for the liability workflow.

09

Continue filing

Use the filing controls only after review. Desktop also provides Mark Filed as a separate workflow action.

10

Check History

Open History/Filing History to review filing records when available.

Validation and common checks

Checks and restrictions applied by the current screen.

A GSTR Period must be selected before GSTN JSON export and before the desktop Mark Filed action.
GSTN JSON export requires GST data for the selected period; an empty period cannot be exported.
Failed validation results block GSTN JSON export until the underlying issues are corrected.
A valid company GSTIN is required for GSTN JSON generation. If the GSTIN is missing or invalid, VauPrime asks the user to update the organization/GST configuration.
Official GSTN JSON export in the current screen is implemented for GSTR-1 and GSTR-3B only.
When no GST transactions are available, the screen shows “No GST transactions found” and suggests trying a different period or return type.

Important behavior and notes

Details worth knowing before using the feature in daily work.

Android and Windows use the same GST data, but their tab labels and action layout differ: Android uses Summary/History while Windows uses Return Summary/Filing History.
The current wide Windows layout includes Mark Filed; the compact Android action stack does not show that button in the same action group.
Generate Return is described by the screen as a draft/preliminary compilation step, not the final GSTN submission.
Download GSTN JSON creates a file for manual GST portal/offline-tool upload. Do not treat a successful download as a filed return.
The GST table has a total row and each transaction can be opened for underlying entry review.
Sales and purchase GST values contribute differently to the calculated tax summary, which is why Net Tax Payable can differ from the sum of outward tax alone.
Filing History is a separate second tab; an empty history has its own “No filing history found” state.