Tax GST

India GST for the Tax plugin: CGST and SGST in the seller's state, IGST elsewhere, GSTIN and HSN on the invoice.

This version needs ShopClass 7.1, which is in beta. Try it on a test site, not a live one.

Version
0.2.2
Updated
18 November 2026
Works with
Shops
Needs
ShopClass 7.1 or later
PHP
8.2 or later
Tested with
ShopClass 7.1
Category
Integrations
Price
Free
Licence
GPL-3.0+
Downloads
19
Made by
Navjot Tomer
  • A tax invoice with IGST, GSTIN and HSN
    A tax invoice with IGST, GSTIN and HSN

India GST for the Tax plugin. Tax works out the amounts. This plugin decides how GST is split and what the invoice calls things.

Requirements

  • Tax plugin 0.2 or later, enabled. Without it this plugin does nothing and the admin sees a notice.
  • ShopClass 7.1.0 or later, with shop mode
  • PHP 8.2 or later

Works on shared hosting. No cron, worker, Redis or shell.

Install

  1. Open Plugins → Browse (or upload the zip from the GitHub release).
  2. Install.
  3. Activate.

Set up

There is nothing to set here. Set up Tax first (Billing → Tax):

  1. Seller country IN and your Seller state, such as Delhi.
  2. Seller tax number (your GSTIN) and the rates: a default, and by category with HSN codes.
  3. Prices: on for GST-inclusive prices, off to add GST on top.

How it works

  • Buyer in the seller's state: CGST and SGST, each half the rate (18% shows as CGST 9% + SGST 9%).
  • Buyer in another state: IGST at the full rate.
  • The invoice calls the seller's number GSTIN and the tax codes HSN. It adds the place of supply (such as 07-Delhi), the kind of supply, "Reverse charge: No" and the state code of the buyer's GSTIN.
  • With Tax's buyer tax number field on (Tax 0.2 and later), a buyer in India of an Indian seller is asked for a GSTIN. It is checked for format, state code and check digit, and printed on the invoice. It is not looked up on the GST portal.
  • States are matched by GST state code. "Delhi", "NCT of Delhi" and "New Delhi" are one state, as are "Orissa" and "Odisha". A name that is not an Indian state falls back to Tax's own comparison.
  • A buyer with no address yet counts as in the seller's state, so the cart drawer shows CGST + SGST.
  • Each line's tax is split in whole rupees by largest remainder, so CGST + SGST always equals the line's GST.

Notes / limits

  • GST applies only to a sale from India to India with the seller's state set. Any other sale keeps Tax's single tax line.
  • Reverse charge: the invoice always says No. A site can return true from the tax_gst_reverse_charge filter to print Yes; amounts do not change.
  • Not included: e-invoicing (IRN and QR code), per-category reverse charge, cess, composition-scheme rules, PDF invoices.
  • Stores nothing. Orders keep the tax lines they were charged.

For developers

Listens to Tax's filters tax_parts (the CGST, SGST and IGST split), tax_invoice (GSTIN, HSN, place of supply, reverse charge) and tax_buyer_id (GSTIN check). It adds the filter tax_gst_reverse_charge (bool, order).

Tests: ./tests/run.sh, or SHOPCLASS_CORE=../shopclass DRIFT_DB_PORT=33061 ./tests/run.sh to add the integration test. Tests that need Tax look in ../shopclass-plugin-tax or SHOPCLASS_TAX, and skip without it. Regenerate the template with php tools/make-pot.php.

Support

https://github.com/mindstellar/shopclass-plugin-tax-gst/issues

What's new in 0.2.2

Changed

  • Works with Tax 0.3 and later.

Found a problem with Tax GST? Open an issue on GitHub.