Title: GST Report for WooCommerce Author: Setups Works Published: 16 di Mai dal 2026 Last modified: 16 di Mai dal 2026 --- Search plugins ![](https://ps.w.org/gst-report-for-woocommerce/assets/banner-772x250.png?rev=3533545) ![](https://ps.w.org/gst-report-for-woocommerce/assets/icon-256x256.png?rev=3533545) # GST Report for WooCommerce By [Setups Works](https://profiles.wordpress.org/nitheeshdr/) [Download](https://downloads.wordpress.org/plugin/gst-report-for-woocommerce.2.1.0.zip) * [Details](https://fur.wordpress.org/plugins/gst-report-for-woocommerce/#description) * [Reviews](https://fur.wordpress.org/plugins/gst-report-for-woocommerce/#reviews) * [Installation](https://fur.wordpress.org/plugins/gst-report-for-woocommerce/#installation) * [Development](https://fur.wordpress.org/plugins/gst-report-for-woocommerce/#developers) [Support](https://wordpress.org/support/plugin/gst-report-for-woocommerce/) ## Description **GST Report for WooCommerce** is a lightweight, fast admin dashboard built entirely with native PHP and direct database queries. It generates GST-compliant reports for Indian WooCommerce stores, handles both intra-state (CGST + SGST) and inter- state (IGST) tax calculations across 18% and 5% GST rates, and lets you export to Excel or open a PDF tax invoice in one click — all without leaving WordPress admin. Designed for Indian store owners who need to file GSTR-1, GSTR-3B, or provide tax invoices to B2B buyers, without the overhead of a full accounting plugin. #### Key Features * **Setup Wizard** — On first activation, a guided wizard checks your HSN codes, GST tax rates, and PDF Invoices plugin configuration so your dashboard is accurate from day one. * **GST Report tab** — Line-item breakdown per order with CGST/SGST (intra-state) and IGST (inter-state) at 18%, 5%, and 0% rates, with separate columns for each. Cancelled and refunded orders appear as negative entries. * **Orders tab** — Card-based order view showing customer name, GSTIN, billing state, order status, and a full per-order GST breakdown (CGST, SGST, IGST). * **Products tab** — All published products with thumbnail, SKU, HSN code, price, stock quantity, GST rate, and stock status. * **Excel export** — Download the filtered report as a properly formatted `.xlsx` file using a zero-dependency PHP XLSX writer. Includes date, invoice number, DC number, customer, GSTIN, state, HSN, quantity, subtotal, and all GST columns. * **PDF invoice** — Opens the WooCommerce PDF Invoices & Packing Slips invoice for any order in a new tab with one click. Access key is read automatically from the order — no manual configuration needed. * **Flexible HSN lookup** — Reads HSN from product meta (`hsn`, `_hsn_code`), product attributes (any attribute whose name contains “HSN”), or order-item meta — whichever is present. Checks variation first, then parent product. * **HPOS compatible** — Works with both the classic `wp_posts` order table and WooCommerce High-Performance Order Storage (HPOS/COT). Detects automatically. * **Filtering & search** — Filter by start/end date, sort newest or oldest, search by order ID or billing email. Paginated at 50 orders per page. * **Summary stat cards** — Total orders, total products, revenue, total GST collected, and average order value — calculated via a single SQL aggregation query (no N +1 queries). #### Who Is This For? * Indian WooCommerce store owners filing GSTR-1 or GSTR-3B returns * Stores selling to GST-registered buyers (B2B) who need tax invoices with GSTIN * Accountants or store managers who need a quick Excel export of GST data for a given period * Stores in Tamil Nadu (TN) needing CGST + SGST split, or any other state needing IGST #### How GST Calculation Works The plugin uses WooCommerce’s own tax totals stored against each order line item: * **Intra-state (TN):** If billing state is Tamil Nadu, tax is split 50/50 as CGST + SGST. * **Inter-state:** All other billing states are treated as IGST. * **5% GST:** Products assigned to a tax class whose name contains `5` (e.g. “GST 5%”) are reported under the 5% columns. * **18% GST:** All other taxed products are reported under the 18% columns. * **0% / Exempt:** Products with no tax are reported under the zero-rated supply column. #### Technical Notes * Pure PHP — no JavaScript frameworks, no React, no REST API. * All data fetched via `WC_Order_Query` and direct SQL with `$wpdb->prepare()`. * All `$_GET` input is sanitised with `sanitize_key()`, `sanitize_text_field()`,` absint()`, and `wp_unslash()`. * All output escaped with `esc_html()`, `esc_url()`, `esc_attr()`, `wp_kses_post()`. * Stats query result cached with `wp_cache_get/set`. * Nonce-protected on all export actions. ## Installation #### Automatic Installation 1. Go to **WordPress Admin Plugins Add New**. 2. Search for **GST Report for WooCommerce**. 3. Click **Install Now**, then **Activate**. 4. The Setup Wizard will launch automatically — follow the 3 steps to verify your store configuration. #### Manual Installation 1. Download the plugin zip file. 2. Go to **WordPress Admin Plugins Add New Upload Plugin**. 3. Choose the zip file and click **Install Now**. 4. Activate the plugin. The Setup Wizard will launch automatically. #### After Activation * The Setup Wizard checks HSN codes on your products, your GST tax rates, and whether PDF Invoices & Packing Slips is correctly configured. * You can re-run the wizard anytime from **WordPress Admin GST Report Setup**. * The dashboard is available at **WordPress Admin GST Report**. #### Requirements * WordPress 5.9 or higher * WooCommerce 5.0 or higher * PHP 7.4 or higher * WooCommerce tax rates configured (18% on the Standard class; a tax class containing` 5` for 5% GST items) * **[PDF Invoices & Packing Slips for WooCommerce](https://wordpress.org/plugins/woocommerce-pdf-invoices-packing-slips/)**— required for the Invoice button. Set **Document link access type** to **Full** in WooCommerce PDF Invoices Debug for invoice links to open without login. ## FAQ ### Does the plugin work right after activation? Yes. The Setup Wizard runs automatically on first activation and guides you through three checks: HSN codes, GST tax rates, and PDF Invoices plugin. After completing the wizard, the GST dashboard is ready to use. ### How does the plugin determine CGST/SGST vs IGST? The plugin reads the billing state of each order. If the billing state is **TN**( Tamil Nadu), the tax is split equally as CGST + SGST (intra-state). All other billing states are treated as IGST (inter-state). To change the home state, edit the `is_tn()` method in `includes/class-gst-calculator.php`. ### How do I set the HSN code for my products? Go to **Products Edit Product** and add a custom field with the key `hsn` (or ` _hsn_code`) and the HSN code as the value. Alternatively, add a product attribute whose name contains “HSN” (e.g. “HSN Code”, “HSN/SAC”). The plugin checks variations first, then the parent product. ### How do I mark a product as 5% GST? Assign a WooCommerce tax class whose name contains `5` (e.g. “GST 5%”, “5 Percent”) to the product. The default tax class and all other classes are treated as 18% GST. ### The Invoice button is not working. What should I do? 1. Make sure **PDF Invoices & Packing Slips for WooCommerce** is installed and active. 2. Go to **WooCommerce PDF Invoices Debug File System & Access**. 3. Set **Document link access type** to **Full** and save. 4. Invoice buttons will now open PDF invoices in a new tab directly from the GST dashboard. ### Does the plugin support WooCommerce HPOS (High-Performance Order Storage)? Yes. The plugin automatically detects whether HPOS is enabled and adjusts its SQL stats query between the `wc_orders` table (HPOS) and the classic `wp_posts` / `wp_postmeta` tables accordingly. ### Can I filter the Excel export by date range? Yes. Apply the date filters on the GST Report page, then click **Export Excel**. The exported `.xlsx` file will contain only the orders matching the active filter. ### Does the plugin work with variable products? Yes. The HSN code lookup checks the specific variation first (more precise), then falls back to the parent product if no HSN is found on the variation. ### Can I search for a specific order in the dashboard? Yes. Use the Search field to find orders by **Order ID** (numeric) or **Billing Email**. The search applies to all three tabs and to the Excel export. ### Does the plugin store any customer data? No. The plugin only reads WooCommerce order and product data that already exists in your database. It does not create, modify, or transmit any customer data. ### Is the plugin compatible with multisite? The plugin is designed for single-site WooCommerce installations. Multisite compatibility has not been tested. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “GST Report for WooCommerce” is open source software. The following people have contributed to this plugin. Contributors * [ Setups Works ](https://profiles.wordpress.org/nitheeshdr/) [Translate “GST Report for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/gst-report-for-woocommerce) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/gst-report-for-woocommerce/), check out the [SVN repository](https://plugins.svn.wordpress.org/gst-report-for-woocommerce/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/gst-report-for-woocommerce/) by [RSS](https://plugins.trac.wordpress.org/log/gst-report-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 2.1.0 * Added: Plugin icon and banner published on the WordPress.org directory. * Improved: Setup Wizard now more clearly guides new users through HSN, GST rate, and PDF invoice configuration. * Improved: Invoice URL generation uses per-order WooCommerce order key — no global key configuration required. * Improved: WCPDF invoice number shown in the Inv. No column when available; falls back to sequential order number. * Improved: Variation product HSN lookup uses on-demand wc_get_product() with static cache for accuracy and performance. #### 2.0.8 * Fixed: Renamed all plugin classes to use the GST_Report_ prefix to meet WordPress. org naming standards. * Added: Requires Plugins header declaring WooCommerce as a dependency. * Fixed: HSN code now correctly resolved for product variations via on-demand wc_get_product() lookup with static cache. * Fixed: Fatal error during Excel export caused by calling object methods on plain strings returned by WC_Product_Variation::get_attributes(). * Added: Invoice number column now shows WPO WCPDF invoice number when available, falling back to sequential order number. #### 2.0.4 * Fixed: Invoice access key now read automatically from each order using `$order- >get_order_key()` — matches the WPO WCPDF “Full” access type URL format (`wc_order_XXXXX`). No manual key entry needed. * Fixed: Wizard step 4 now checks “Document link access type” setting and guides user to set it to Full if needed. * Fixed: Removed crash-prone global access key detection via WPO_WCPDF PHP object. * Fixed: Wizard simplified — no manual key input field; keys are per-order and automatic. #### 2.0.3 * Fixed: Fatal error when accessing wizard step 4 — `$obj->settings->debug` accessed without null check causing crash on PHP 8. * Fixed: Added `try/catch \Throwable` around all WPO WCPDF detection code. * Fixed: Removed auto-save side effect from render method. #### 2.0.2 * Added: Setup Wizard launches automatically on first plugin activation. * Added: Wizard Step 1 — Welcome screen with Setups Works branding. * Added: Wizard Step 2 — HSN code check scans all products and lists missing ones with edit links. * Added: Wizard Step 3 — GST tax rate check verifies 18% and 5% rates are configured in WooCommerce. * Added: Wizard Step 4 — PDF Invoices plugin check and access key configuration. * Added: Invoice buttons open in a new tab (`target="_blank"`). * Fixed: Orders tab invoice URL was still pointing to the removed internal invoice handler. #### 2.0.1 * Fixed: Escaped `$class` in tab navigation with `esc_attr()`. * Fixed: Wrapped `paginate_links()` output with `wp_kses_post()`. * Fixed: Replaced `date()` with `wp_date()` for timezone-safe Excel filename. * Fixed: Replaced `tempnam()` with `wp_tempnam()` and `unlink()` with `wp_delete_file()`. * Fixed: Added `wp_unslash()` to all `$_GET` reads before sanitization. * Fixed: Added result caching to stats SQL query via `wp_cache_get()` / `wp_cache_set()`. * Fixed: Replaced `phpcs:ignore` with `phpcs:disable`/`phpcs:enable` blocks to cover multiline SQL queries. * Fixed: Reduced plugin tags to the WordPress.org maximum of 5. #### 2.0.0 * Complete rewrite — native PHP, direct DB queries, no JavaScript frameworks, no REST API. * Added HPOS (High-Performance Order Storage) compatibility with automatic detection. * Added 5% GST rate support alongside 18% — detected via tax class name. * Added Excel (.xlsx) export using a zero-dependency PHP XLSX writer. * Added PDF invoice button (via WooCommerce PDF Invoices & Packing Slips plugin). * Added Products tab with thumbnail, SKU, HSN code, price, stock, and GST rate. * Added Orders tab with card-based view and per-order GST breakdown. * Added HSN lookup across product meta, attributes, and order-item meta. * Added SQL-based stats aggregation (no N+1 queries). * Added nonce protection on all export and download actions. ## Meta * Version **2.1.0** * Last updated **5 mês ago** * Active installations **10+** * WordPress version ** 5.9 or higher ** * Tested up to **6.9.10** * PHP version ** 7.4 or higher ** * Language * [English (US)](https://wordpress.org/plugins/gst-report-for-woocommerce/) * Tags * [GST](https://fur.wordpress.org/plugins/tags/gst/)[india](https://fur.wordpress.org/plugins/tags/india/) [invoice](https://fur.wordpress.org/plugins/tags/invoice/)[tax](https://fur.wordpress.org/plugins/tags/tax/) [woocommerce](https://fur.wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://fur.wordpress.org/plugins/gst-report-for-woocommerce/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/gst-report-for-woocommerce/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/gst-report-for-woocommerce/reviews/) ## Contributors * [ Setups Works ](https://profiles.wordpress.org/nitheeshdr/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/gst-report-for-woocommerce/)