Description
Every Indian WooCommerce store has to issue proper GST tax invoices and file GSTR-1. This plugin does the GST part for you — it runs 100% on your own WordPress site, with no external server and no monthly SaaS fee.
Features — all free, nothing locked
- Buyer GSTIN at checkout — “Purchase for Business? Enter GSTIN” and “Business Registered Name” fields (both optional) on both the Classic checkout and the new Block checkout (Store API).
- Real GSTIN validation — 15-character format check plus the official GSTN Mod-36 check-digit algorithm, not just a regex. Typos are caught before the order is placed.
- State match check — the first two digits of the GSTIN must match the buyer’s billing state (all 36 States & UTs, official GST state codes 01–38).
- HSN / SAC code and GST rate on simple products and every variation. The HSN code is frozen onto each order line at checkout, so old invoices never change when you edit a product later.
- Automatic CGST + SGST vs IGST — same state as your store = CGST + SGST, different state or abroad = IGST. Place of Supply is printed with its state code.
- Printable GST Tax Invoice (print or “Save as PDF” from the browser) with seller GSTIN, PAN, buyer GSTIN, Place of Supply, HSN-wise line items, CGST / SGST / IGST break-up, HSN summary, amount in words in Lakh / Crore and an authorised signatory block. Sequential invoice numbers with your own prefix.
- GSTIN shown in the admin order screen (editable), My Account order view, thank-you page and order emails.
- Fully compatible with WooCommerce HPOS (High-Performance Order Storage) and Cart & Checkout Blocks.
- GST 2.0 ready: slabs 0%, 0.25%, 3%, 5%, 12%, 18%, 28% and 40%.
- Auto-populate WooCommerce GST tax rates — one click creates “GST n%” tax classes with CGST + SGST for your state and IGST for every other state.
- Bulk HSN codes — assign HSN + GST rate to a whole product category, or import from a CSV (SKU, HSN, rate).
- 1-Click GSTR-1 export for your CA — B2B, B2C Large, B2C Small and HSN summary (B2B / B2C) CSVs with the GST offline-tool column headers, filtered by month.
Screenshots
Installation
- Upload the plugin folder to
/wp-content/plugins/or install the ZIP from Plugins Add New Upload Plugin. - Activate it (WooCommerce must be active).
- Go to WooCommerce GST & B2B Invoices and enter your Seller GSTIN, legal name, address and store state.
- Add an HSN / SAC code and GST rate to your products (Product data General, or per variation).
- Click Auto-Populate WooCommerce GST Tax Rates if you want WooCommerce to charge GST at checkout.
FAQ
-
Does it work with the new Block checkout?
-
Yes. The GSTIN fields are registered through WooCommerce’s Additional Checkout Fields API and validated in the Store API, so both the Block checkout and the classic
[woocommerce_checkout]shortcode are supported. -
How is the GSTIN validated?
-
The number is normalised (uppercase, spaces removed), checked against the 15-character GSTIN pattern, the state code is checked against the official list, and the 15th character is verified with the GSTN base-36 weighted check-digit algorithm. If “GSTIN must match billing state” is on, the GSTIN state code must also equal the billing state.
-
My prices already include GST. Will the invoice be right?
-
Yes. With “Product prices include GST” (default), the plugin back-calculates the taxable value from the price and the product’s GST rate whenever WooCommerce did not charge tax itself. When WooCommerce did charge tax, that exact amount is used.
-
How is shipping taxed?
-
By default shipping takes the GST rate of the main (highest value) item, as a composite supply. You can switch to a fixed rate and set the SAC code in the settings.
-
Which GSTR-1 tables are exported?
-
B2B (b2b), B2C Large (b2cl, inter-state invoices above ₹1,00,000), B2C Small (b2cs) and the HSN summary split into B2B and B2C. Credit / debit notes, exports and advances are not generated — add them separately in the offline tool.
-
Can I get a PDF?
-
Open the invoice and use the Print / Save as PDF button — every modern browser can save it as a PDF. No PDF library is bundled, which keeps the plugin light and server-friendly.
-
Is any data sent outside my site?
-
No. The plugin does not connect to any external service — all GSTIN checks, tax calculations, invoices and GSTR-1 files are made on your own server.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“8 Bit GST Invoice for WooCommerce” is open source software. The following people have contributed to this plugin.
Contributors
Translate “8 Bit GST Invoice for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.1
- Fix: the Classic checkout GSTIN label no longer shows “(optional)” twice.
- Fix: the live “Valid GSTIN” / error message now appears directly under the GSTIN field.
- Changed: the GSTIN placeholder and format example use a clearly fictitious GSTIN.
- Tested with WooCommerce 11.2.
1.0.0
- Initial release: GSTIN capture with Mod-36 checksum validation (Classic + Block checkout), HSN / SAC on products and variations, CGST / SGST / IGST split, printable GST tax invoice, GST tax-rate generator, bulk HSN tools and GSTR-1 CSV export.