Gstann: guide
Help release c4e6d48f22a45602 · Generated 22 November 2026. Online at docs.mycadesk.in/modules/gstann/.
Help explains how the software works and is not professional advice; refer to the statute or notification.
GST annual returns (GSTR-9 and GSTR-9C)
GST annual returns prepares GSTR-9 and GSTR-9C workbooks for a GSTIN and year. Every figure is suggested from filed returns and books; a person confirms each row, a reviewer freezes a version, the client approves it and a partner signs it off.
GST annual returns (menu: GST annual) prepares a client's GSTR-9 annual return and, where needed, the GSTR-9C reconciliation statement, for one GSTIN and financial year. The app suggests; there is no automatic figure that is not confirmed by a person.
How a workbook moves
- Open a workbook for the GSTIN, year and form (Open a GSTR-9 or GSTR-9C workbook). A GSTR-9C workbook belongs to the GSTR-9 workbook of the same GSTIN and year.
- Derive suggestions from the client's filed GSTR-1, GSTR-3B and GSTR-2B and the books (through the Map a client's ledgers to the annual return).
- Confirm each row, or enter a different value with a reason and note (Confirm the rows of a GST annual workbook).
- Submit for review. A reviewer at or above the firm's minimum role, who did not prepare or last edit any row, raises review notes and then Review and freeze a version.
- Client approval of the version's summary, in the portal or recorded by a partner with evidence (Approve, sign off and file a GST annual version).
- Sign off by a partner, then Export JSON and upload it on the GST portal, or hand it off to Filing. The ARN is recorded on the tracked return in Filing.
Who files GSTR-9 and GSTR-9C, and until when, is in Who files GSTR-9 and GSTR-9C, and until when (sign in to read).
Pages
| Page | Use it to |
|---|---|
| Open a GSTR-9 or GSTR-9C workbook | list and open workbooks |
| Follow the GST annual season | see the season: workbooks by stage and returns without a workbook |
| Confirm the rows of a GST annual workbook | confirm rows, answer review notes, work on GSTR-9C |
| Approve, sign off and file a GST annual version | approval, sign-off, downloads and filing of a frozen version |
| See every GSTIN of a client's PAN | all GSTINs of the client's PAN and the aggregate turnover |
| Map a client's ledgers to the annual return | map the client's ledgers to GSTR-9 rows |
| Check how regularly suppliers file | supplier filing regularity |
| Review the signed annual returns of an engagement | the read-only view for an external reviewer |
| GST annual settings | the firm's GST annual settings |
Features switched on per firm
The GSTR-9 workbook (ff.gstann.gstr9), the GSTR-9C workbook (ff.gstann.gstr9c), the multi-GSTIN
PAN view and aggregate turnover (ff.gstann.pan_view), supplier filing regularity
(ff.gstann.vendor_score) and the hand-off of a signed version to Filing
(ff.gstann.filing_handoff) are rolled out per firm. You see a part only when it is on.
Approve, sign off and file a GST annual version
A frozen version goes to the client for approval (or a partner records an offline approval), a partner signs it off, and the signed JSON is uploaded on the GST portal or handed off to Filing.
The version page shows the version number, who Reviewed it and whether it is Signed. If A later version exists., work on the later one.
Client approval
When your firm requires it (the default), the client approves the version's summary before sign-off.
- Ask the client to approve sends the summary PDF to the client contacts you choose, in the portal.
- Record an offline approval (partners only, with a fresh identity check): name an evidence document of this client and give a reason of at least 20 characters. The partner who records it does not sign this version.
An approval older than the firm's limit (default 15 days) no longer counts at sign-off.
Sign off
A partner chooses Sign off and confirms it's them. Sign-off needs the latest reviewed version, unchanged inputs (when the firm blocks on a change) and a current client approval.
Downloads
Before sign-off, the summary PDF and the rows (XLSX) are watermarked drafts. After sign-off, Export JSON gives the file to upload on the GST portal; the JSON is checked against the published return schema first. Every download is recorded.
Filing
Upload the JSON on the GST portal, then record the ARN on the tracked GSTR-9 return in Filing. Where your firm has the hand-off on, Hand off for filing sends the signed version to Filing as a draft instead. When the return is filed, the workbook shows Filed.
Check how regularly suppliers file
For one GSTIN and a window of months, the app shows how regularly each supplier's invoices reached the client's GSTR-2B, how many were filed late and the reconciliation exceptions, with a regular, irregular or not enough data label.
The label is built from this client's own data only. It is never a score, a rating or a GSTN status, and no supplier is contacted.
Steps
- Pick the GSTIN and the Last month of the window (YYYY-MM); it cannot be after the current month.
- Choose Compute supplier regularity. The computation runs in the background and appears under Computations.
- Open it to see, per Supplier: Months with purchases, Months missing from GSTR-2B, invoices Filed late, the ITC at risk, Reconciliation exceptions and the Label.
If newer GSTR-2B or books data is imported, the computation says so: compute again. Managers and partners can Download the list (CSV) after confirming it's them. While the thresholds are awaiting CA review, the page says so.
Thresholds
| Setting | Key | Default | What it does |
|---|---|---|---|
| Vendor indicator window (months) | gstann.vendor.window_months | 12 | 3 to 24. Months in the window. |
| Vendor indicator minimum months | gstann.vendor.min_months | 3 | 1 to 12. With fewer months with purchases, the label is not enough data. |
| Vendor indicator: missing months | gstann.vendor.missing_pct | 25 | 1 to 100, a percentage. A supplier missing from GSTR-2B in a larger share of months is irregular. |
| Vendor indicator: late months | gstann.vendor.late_pct | 25 | 1 to 100, a percentage. A supplier filing late in a larger share of months is irregular. |
These thresholds are not on the GST annual settings page; contact support if one should change for your firm.
Confirm the rows of a GST annual workbook
A workbook shows each row's suggested, confirmed, portal and filed figures side by side. Confirm each suggestion or enter a different value with a reason, clear validations and review notes, then submit it for review.
Sources
Returns and books used lists the filed returns and books each suggestion is built from, by month, and which months are missing. Choose Derive suggestions after new data is imported; the derivation runs in the background.
Rows
Choose a Table to see its rows with the Suggested value, the Confirmed value and, where available, the Portal and Filed figures. How derived shows the datasets and versions a suggestion came from.
- Confirm the suggestion when it is right.
- Edit to enter a different value. A value that differs from the suggestion by more than the firm's tolerance needs a reason and a note of at least 10 characters (The value differs from the suggestion (sign in to read)); some rows also need an evidence document of the client.
- Not applicable for a row with nothing to report.
- Computed rows add up other rows and cannot be edited.
Validations
Validations lists the findings. Blocking findings, and mandatory rows not yet confirmed, stop the review.
Review
Steps
- Submit for review when every row is confirmed.
- The reviewer raises Review notes; the preparer answers each one, and someone other than the person who answered clears it.
- The reviewer chooses Review and freeze a version. The reviewer must be at or above the firm's minimum role and must not have prepared or last edited any row. The inputs must be unchanged since the last derivation.
The frozen version opens on its own page (Approve, sign off and file a GST annual version). Withdraw closes a workbook that should not be filed.
GSTR-9C
On a GSTR-9C workbook, the reconciliation panel splits the turnover of the financial statements across the PAN's GSTINs (by the GSTIN on each voucher, by Tally company, or entered with a document of the client: Use this split). The shares must add up to the turnover. Then Add an item or a reason on a row: an amount to add or less, with a description and an optional evidence document, or a reason for an unreconciled difference (Tables 6, 8, 10, 13 and 15). Any additional tax is paid outside the app.
Working papers and e-invoice checks
Working papers attaches documents of the client to the workbook or a row. E-invoice and e-way bill checks shows, per month, whether the registers were uploaded and the latest reconciliation run, with a link to the reconciliation queue.
Map a client's ledgers to the annual return
The ledger map says which Tally ledgers or groups hold input tax credit, capital goods, input services, turnover and the rest, so the books can feed the GSTR-9 suggestions.
Mapped ledgers and groups lists the current map. Suggested from the books lists ledgers whose names the firm's synonym list recognises; a person accepts each one.
Steps
- Accept a suggestion, or choose Add a mapping and pick the ledger or group and what it holds.
- Remove a mapping that is wrong.
- Choose Save ledger map. The client's open workbooks are derived again with the new map.
Open a GSTR-9 or GSTR-9C workbook
The workbooks list shows the GST annual workbooks of clients you can see. Open one per GSTIN, year and form; every figure in it is suggested from filed returns and books.
Filter by Financial year, Return and Status (Preparing, In review, Reviewed, Awaiting client, Signed, Filed, Filed elsewhere, Withdrawn). The Derived column shows when suggestions were last derived.
Open a workbook
Steps
- Choose Open a workbook.
- Pick the client, the GSTIN, the Financial year and the Return: GSTR-9 annual return or GSTR-9C reconciliation statement. Open the GSTR-9 workbook first; a GSTR-9C workbook belongs to it.
- The app checks that the GSTIN's registration files an annual return, that the year is not past its filing bar and that a table layout is published for the year, then opens the workbook and derives suggestions in the background.
There is one workbook per GSTIN, year and form (A workbook for this GSTIN, year and form is already open (sign in to read)). If the compliance calendar has no annual return for the GSTIN and year, the workbook opens with a warning.
Follow the GST annual season
The season dashboard counts the firm's GSTR-9 and GSTR-9C workbooks of a year by stage, shows each one's date risk from the compliance calendar, and lists the returns the calendar expects that have no workbook yet.
Choose the Financial year. Only clients you can see are counted.
- Workbooks by stage: each workbook with its Return, Stage, the compliance calendar's date and its Risk.
- Expected by the calendar, no workbook yet: GSTINs whose annual return the calendar expects for the year, with no workbook open. Open one from Open a GSTR-9 or GSTR-9C workbook. When the list is empty, every expected return has a workbook.
Managers and partners can download the list as CSV, after confirming it's them. It names clients, never a GSTIN.
GST annual settings
The firm's GST annual rules - the lowest role that may review and freeze, the rupee tolerance for suggestions, whether a changed input blocks sign-off, and whether and for how long a client approval is needed.
Open GST annual → Settings. Partners and firm administrators change the module settings; security settings need the owner or a partner, with a fresh identity check and a reason. Every change is recorded in the firm's audit log.
| Setting | Key | Default | What it does |
|---|---|---|---|
| Lowest role that may review | gstann.review.min_role | Manager | Senior or manager: the most junior role that may review and freeze a version. |
| Tolerance before a change needs a reason (₹) | gstann.tolerance_inr | 1 | 0 to 100 rupees per head. A confirmed value within this of its suggestion counts as equal (no reason needed), and validation equalities hold within it. |
| Block sign-off when a source changed | gstann.block_on_source_change | Yes | Security setting. A reviewed, unsigned version whose inputs changed needs a new review before sign-off. |
| Client approval required before sign-off | gstann.approval.required | Yes | Security setting. Sign-off needs the client's approval of the summary, or a partner-recorded approval. |
| Client approval valid for (days) | gstann.approval.max_age_days | 15 | 1 to 60. An older client approval is stale at sign-off. |
The supplier regularity thresholds are described on Check how regularly suppliers file.
Review the signed annual returns of an engagement
A read-only view, for a reviewer such as a peer reviewer, of the signed GST annual returns of one engagement with their review notes and working papers.
Annual returns for review lists the signed versions of the engagement. Open one to read its Review notes and Working papers. Nothing can be changed here.
If the page shows No signed annual return yet, nothing has been signed off for the engagement. If it says there is nothing to review, the engagement has no annual return or your access to it has ended.
See every GSTIN of a client's PAN
The PAN view lists every GSTIN of the client with its GSTR-1 and GSTR-3B status for the year, its annual-return workbooks and open reconciliation exceptions, and suggests the aggregate turnover of the PAN.
Choose the Financial year. GSTINs of the PAN lists each GSTIN with its GSTR-1 and GSTR-3B status, its Annual return workbook (or No workbook) and its open reconciliation exceptions.
Aggregate turnover
Choose Compute aggregate turnover. The app adds up the turnover of all the PAN's GSTINs from their filed returns, leaving out Supplies to the client's other GSTINs, and shows the suggested figure with its Band and whether E-invoicing would apply. A new or changed figure is proposed to the client profile as a suggestion someone confirms there; nothing is applied from this page. The compliance calendar then uses the confirmed figure.
From here, open the client's Ledger map (Map a client's ledgers to the annual return) or Supplier filing regularity (Check how regularly suppliers file).