Skip to content

How to record a GST rate change for an HSN code in Smart Books

Record a new GST rate for an HSN or SAC code from a given date, then update the items and accounts that use it, without changing posted vouchers.

Level: advanced · Updated 15 Nov 2026

Before you start

Why record an HSN rate change

GST rates for goods and services change from time to time. Each change applies from a date, which accountants call WEF (with effect from). Aicountly Smart Books lets you record the change for an HSN or SAC code, then update your items and accounts that use it, so new invoices pick up the right rate. Vouchers you have already posted are not rewritten.

Open the page

Go to the GST area of Aicountly Smart Books. In the menu group GST Reconciliation & E-docs, choose HSN rate history. You can also select HSN rate history & assisted WEF on the GST hub page. You need permission to read GST data.

Look up the history of a code

  1. In Lookup timeline, type the code in HSN / SAC, for example 2523. A code must have at least 4 characters and at most 8.
  2. Select Load history. The table shows From, To, Rate %, Source and Notification for each period. A rate with no end date shows Open.

If nothing is found, the page says there is no rate history for this HSN yet.

Add your own rate change

In Add company rate change, fill in the form:

  • HSN / SAC: the code.
  • Rate %: a number from 0 to 100.
  • Effective from: the date the new rate starts.
  • Notification ref: optional, for example the notification number you are following.
  • Description: optional note.

Select Save rate change. The message Rate change saved appears and the timeline refreshes.

Update your items and accounts

The Assisted WEF section helps you move your masters to the new rate. Select Preview impacted masters. Aicountly Smart Books lists the items and accounts for that HSN whose current rate differs from the new one, with their Current % and Proposed %. A Note column explains any row that cannot be changed, and those rows cannot be ticked.

  1. If a list of tax categories appears, choose the one that matches the new rate in Tax category for target rate.
  2. Tick the rows you want to update.
  3. Select Apply WEF to selected.

You will see how many masters were updated. If some failed, a message tells you how many and suggests you check the item WEF dates. The preview then refreshes so you can confirm what is left.

Tips

  • Enter the date from the official notification, not the date you are working.
  • Preview first. Apply only after you have checked the rows.
  • Existing posted vouchers keep their old rate.

Steps

  1. Open GST in Smart Books and choose HSN rate history under GST Reconciliation & E-docs.
  2. Type the HSN or SAC code and select Load history to see its past rates.
  3. In Add company rate change, enter the code, the Rate %, Effective from and optionally the notification reference, then select Save rate change.
  4. In Assisted WEF, select Preview impacted masters to list items and accounts whose rate differs.
  5. Tick the rows you want, check the tax category, then select Apply WEF to selected.

Troubleshooting


Still stuck? Contact support or ask in the community.