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
- Open Plugins → Browse (or upload the zip from the GitHub release).
- Install.
- Activate.
Set up
There is nothing to set here. Set up Tax first (Billing → Tax):
- Seller country
INand your Seller state, such as Delhi. - Seller tax number (your GSTIN) and the rates: a default, and by category with HSN codes.
- 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_chargefilter 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.
