GST is one rate charged once and presented under different heads. These plugins never charge tax and never change a total — WooCommerce does that. They decide which head the tax sits under, write it down on the order, and print it. Four rules shape them.
Rule 1: the split is a presentation, and it always adds up
For each line of an order, the tax WooCommerce charged is put under:
- CGST and SGST when the supply stays in your state (intra-state);
- IGST when it goes to another state (inter-state).
The two vocabularies are reconciled first. WooCommerce names Indian states with letters (MH, KA), GST with two-digit codes (27, 29) — the same codes that begin every GSTIN. One table maps them both ways, so a Maharashtra seller and a Maharashtra customer are recognised as the same state.
For an intra-state line, CGST is half the tax rounded to the paisa and SGST is the remainder, never a second rounding. ₹0.05 of tax becomes ₹0.03 CGST and ₹0.02 SGST, which adds back to ₹0.05 exactly; rounding both halves would give ₹0.06 and an invoice a paisa over the order.
The rate shown on a line is worked out from the line itself: its tax over its taxable value (after discounts). A line worth nothing shows no rate rather than 0%, because 0% is a real GST rate.
An order whose place of supply cannot be matched to your state — no Indian state on the address, for example — is treated as inter-state.
Rule 2: the record is frozen on the order
When the checkout creates an order, the plugin writes onto it, once:
- your GSTIN and state as they were;
- the place of supply and whether it was intra- or inter-state;
- the split for the whole order;
- every line, with its name, HSN code, quantity, taxable value, rate and heads — plus a Delivery line with your SAC code when the order has shipping.
The invoice, the order screen, the emails and the GSTR-1 export all read that record. GST rates change, HSN codes get corrected, shops move state — and an invoice already filed with a return must not change because you fixed a code in August. Orders placed before the plugin was set up, or while it was switched off, have no record and are left exactly as they were.
The split appears in the order totals wherever WooCommerce shows them — the order screen, the customer's emails, the order-received page and My Account — as CGST, SGST and IGST rows (a head with nothing in it is not shown), followed by the customer's GSTIN when there is one.
Rule 3: a GSTIN is checked by its check digit
A GSTIN's fifteenth character is a check digit over the first fourteen. The plugin checks it, not just the length or the shape, so a transposed pair of characters is caught at the checkout rather than weeks later by the customer's accountant. It also checks the GSTIN's first two digits — the state that issued it — against the billing state.
At the checkout:
- The shopper types a GSTIN (spaces and lower case are fine).
- If it fails the check digit, the order is refused with a message asking them to check it against their registration certificate.
- If it was issued in a different state from the billing address, the order is refused with a message naming the state.
- A GSTIN that did not pass is never written onto an order. An invoice carrying a number nobody can claim against is worse than one with none.
The Checkout block's field is registered through WooCommerce's own Additional Checkout Fields API and refuses a GSTIN that fails its check digit. The state check runs there too, on WooCommerce's woocommerce_blocks_validate_location_address_fields (a field's own check never sees the state), for the billing address, with the same message as the classic checkout.
Rule 4: invoice numbers are consecutive and never move
A tax invoice number must be unique and consecutive within a financial year. India's financial year runs from April to March, so the series is kept per year — gmgst_series_2026-27 for 1 April 2026 to 31 March 2027 — and the year is part of the number: GST/2026-27/00042.
- A number is drawn when the order is paid — when it reaches Processing or Completed, for an order carrying a GST record — and then stored on the order. It never changes. Printing or exporting a pending, failed or cancelled order draws nothing, and its invoice says it is not yet invoiced, so an unpaid order never leaves a gap in the series.
- The year comes from the order's date, not the day it is printed.
- The draw is one atomic database statement, so two invoices printed at the same moment cannot get the same number, and the number is read back from that statement itself.
Printing
- From the order's GST box, click Print tax invoice; or select orders on the orders list, choose Print GST invoices from Bulk actions and click Apply — up to 20 orders at a time in the free edition, 100 in the full edition.
- A standalone page opens with one invoice per order: seller and buyer (with GSTINs), place of supply, the kind of supply, each line with its HSN code, taxable value and heads, the totals, and (full edition) your note.
- Print it, or save it as PDF from your browser's print dialog.
The page is plain HTML with a print stylesheet; there is no PDF library, so there is nothing to install and no font problem with Hindi or other Indian scripts. It is only shown to users who can edit orders, behind a nonce.
GSTR-1 export — Full edition
WooCommerce → India GST → GSTR-1 export, choose From and To, and click Download CSV.
- One row per invoice line, read from each order's frozen record.
- Orders in processing or completed, created within the dates.
- B2B for an order with a customer GSTIN, B2C for the rest.
- Place of supply as code and name, for example
27-Maharashtra. - Orders without a GST record are skipped rather than invented.
- An order never printed is given its invoice number as it is exported.
- The file starts with a byte-order mark so Excel on Windows shows the rupee sign and Indian scripts correctly, and cells that could be read as spreadsheet formulas are neutralised.
Columns: invoice_no, invoice_date, order_number, shape, gstin, place_of_supply, supply_kind, description, hsn, taxable_value, rate, cgst, sgst, igst, invoice_total.
The export reports what was invoiced. Refunds and credit notes are not included.
HSN codes — which one wins
For each line: the variation's own code, then the product's own code, then (full edition) the code on any of its categories or their parent categories, then your default. A code is never invented. A line with none is blank on the invoice and counted in the order's GST box ("1 line has no HSN code").
