=== 8 Bit GST Invoice for WooCommerce === Contributors: ishantkd Tags: woocommerce, gst, india gst, hsn code, gst invoice Requires at least: 6.0 Tested up to: 7.1 Requires PHP: 7.4 Stable tag: 1.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html India GST for WooCommerce: GSTIN checkout field with checksum validation, HSN codes, CGST/SGST/IGST split, GST tax invoice & GSTR-1 export. == 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 (Optional)" and "Business Registered Name" fields 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. == Installation == 1. Upload the plugin folder to `/wp-content/plugins/` or install the ZIP from **Plugins → Add New → Upload Plugin**. 2. Activate it (WooCommerce must be active). 3. Go to **WooCommerce → GST & B2B Invoices** and enter your Seller GSTIN, legal name, address and store state. 4. Add an HSN / SAC code and GST rate to your products (Product data → General, or per variation). 5. Click **Auto-Populate WooCommerce GST Tax Rates** if you want WooCommerce to charge GST at checkout. == Frequently Asked Questions == = 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. == Screenshots == 1. GSTIN field with live validation on the checkout. 2. GST tax invoice with CGST / SGST / IGST break-up and amount in words. 3. Store GST settings. 4. 1-click GSTR-1 export. == Changelog == = 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. == Upgrade Notice == = 1.0.0 = First release.