GSTR-7 in HelloBooks: who files it, how to set it up, end-to-end walkthrough

GSTR-7 is not a return for the average private business. Section 51 of the CGST Act draws a small, closed list of organisations who must deduct GST-TDS when they pay a supplier, and then file GSTR-7 every month to report what they deducted:

• Central and state government departments and establishments.
• Local authorities such as municipal corporations and panchayats.
• Government agencies set up by an Act of Parliament or a state legislature.
• Public-sector undertakings (notified by the government from time to time).
• Authorities, boards, or other bodies set up by the government with at least fifty-one per cent equity or control.
• A society established by the central or a state government, or a local authority, registered under the Societies Registration Act.

A private limited company paying its own vendors is not on this list — even if it is large, even if it pays a great deal of GST every month. If you are unsure, the simplest check is your GST registration certificate. A GST-TDS deductor holds a separate registration with the registration type recorded as Tax Deductor at Source; the certificate itself names you a deductor. If you do not have such a certificate, you are not required to file GSTR-7.

When a deductor pays a supplier on a contract whose value is more than ₹2,50,000, two per cent of the taxable value (the value before GST) must be deducted and paid into the GST cash ledger. For intra-state contracts the deduction is one per cent CGST and one per cent SGST. For inter-state contracts the deduction is two per cent IGST. Compensation cess is not subject to the deduction.

The threshold is per single contract — not per invoice, and not per financial year. A series of small purchase orders to the same vendor below ₹2,50,000 each does not trigger the deduction; a single contract above ₹2,50,000 does. Once the threshold is crossed, the deduction applies to the whole contract, not only to the excess. The deduction is on the taxable value, not on the GST charged on top.

GSTR-7 is filed monthly, by the tenth of the month after the month in which the deduction was made. So deductions made in May are reported in the GSTR-7 filed by 10 June. The return has six tables. The most important one is Table 3, which lists every deductee, the GSTIN of each, the value of the contract, and the amount of CGST, SGST or IGST deducted. Tables 4, 5 and 6 cover amendments to earlier filings, interest and late fee, and refunds claimed from earlier returns.

Within five days of filing, the deductor has to issue a GSTR-7A — the deduction certificate — to every deductee. The deductee then uses that certificate to claim the deducted amount as a credit in its own electronic cash ledger on the GST portal.

This is the single biggest point of confusion we see. Income-tax TDS and GST-TDS sound alike, and both produce a withholding on a vendor payment, but they are two completely different tax regimes:

If you are filing 24Q or 26Q each quarter from HelloBooks, that is income-tax TDS and has nothing to do with GSTR-7. GSTR-7 is filed only if your organisation is one of the notified deductors listed above and holds a deductor GSTIN.

The setup is a one-time switch on the entity. Once it is on, the compliance calendar surfaces GSTR-7 every month, the bill screen accepts the GST-TDS deduction, and the GSTR-7 dashboard becomes available under the GST menu.

Step 1 — Open the entity settings

From the main menu, go to Settings → Tax. This is the same screen where you set your GSTIN, place of business and tax registration details.

Step 2 — Switch on the deductor flag

Look for the option “I am a Section 51 GST-TDS deductor”. Toggle it on. Enter the deductor GSTIN issued by the GST department — this is the one whose registration type is “Tax Deductor at Source” and is usually different from your regular trading GSTIN. Save the entity.

Step 3 — Verify the calendar

Go to Compliance → Calendar. You should now see a row for “GSTR-7 — GST TDS monthly return”, due on the tenth of the next month. Clicking the row jumps straight to the GSTR-7 dashboard for the relevant period. If the row does not appear, the deductor flag is off or the entity is not flagged as an Indian entity — double-check the country and the deductor flag.

A typical month for a GST-TDS deductor looks like this. We use May 2026 as the example below — the filing is due on 10 June 2026.

Step 1 — Record bills as usual, with the GST-TDS box ticked

Enter your supplier bills under Purchases → Bills. On every bill where the contract value is above ₹2,50,000, tick the option marked “Section 51 GST-TDS applicable”. HelloBooks reads the supplier’s state from their GSTIN and works out whether to compute CGST + SGST or IGST on its own. The deduction value is shown alongside the bill so you can see what will be reported in the return.

Step 2 — Watch the compliance calendar

Starting around the first of June, the calendar shows the GSTR-7 row with a countdown to the tenth. The row links straight into the GSTR-7 dashboard for the May period — there is no need to navigate through menus, just click the row.

Step 3 — Build the draft

On the dashboard, pick the period (May 2026) and click Create Draft. HelloBooks gathers every May bill where the GST-TDS box was ticked, groups them by deductee GSTIN, and lays out Table 3 — one row per supplier, with the taxable value, the CGST or IGST deducted, the SGST deducted, and the total deduction. You can review every line before filing. If something looks wrong, fix the underlying bill and click Refresh; the draft picks up the change.

Step 4 — Validate

Click Validate. HelloBooks checks every GSTIN against the standard format, makes sure the totals reconcile, and lists any missing fields. Fix anything the validator flags. Once the draft is clean, the dashboard marks it as “Validated”.

Step 5 — File at the GST portal

Submit the validated return to the GST portal. Pay the deducted amount through Form GST PMT-06 into the cash ledger so that the liability is settled at the time of filing. The GST portal will issue an acknowledgement reference number for the filing.

Step 6 — Share GSTR-7A with each deductee

Within five days of the filing acknowledgement, every deductee can download the GSTR-7A certificate from their own GST login. As the deductor you can also download a copy from the portal and email it across to the supplier — this is what they will use to claim the deducted amount as a credit in their electronic cash ledger.

A few mistakes account for most of the support tickets we see on this return:

• Treating every TAN-holder as a GSTR-7 deductor. The compliance calendar may surface GSTR-7 if a TAN is present, because TAN is the only signal we have for some entities. Always cross-check against your GST registration certificate before filing. If you are not a notified deductor, leave the deductor flag off.
• Deducting at the wrong rate. The rate under Section 51 is a flat two per cent of the taxable value. Not 1 per cent, not 10 per cent — those are income-tax TDS rates and do not belong on this return.
• Deducting below the ₹2,50,000 contract threshold. The threshold applies per single contract, before GST. Small purchase orders to the same vendor that individually fall under ₹2,50,000 do not trigger the deduction even if they aggregate above the threshold across the year.
• Using the wrong GSTIN for the deductee. If the vendor is unregistered (no GSTIN), Section 51 does not apply and no deduction is required. If they are registered but the GSTIN on the bill is wrong by even one character, the deductee will not see the credit and the validator will reject the draft.
• Confusing GSTR-7 with the income-tax statement. If you are filing 24Q or 26Q every quarter, that is the income-tax filing and is separate. Both can exist for the same organisation, and both can be filed from HelloBooks, but they have different deadlines, different portals and different forms.
• Filing late. The late fee is ₹100 per day each under CGST and SGST (capped at ₹5,000 each), plus 18 per cent interest per annum on the amount deducted but not paid by the due date. More importantly, your supplier cannot claim the credit until you file.