---
url: /gst-manager-shopify/troubleshooting.md
description: >-
  Quick solutions for common issues in GST Manager — missing invoices, tax
  double-charging, wrong CGST/SGST split, and cart-page GSTIN block display
  problems.
---

# Troubleshooting

Most issues can be resolved in under a minute by checking the **Setup Health** card on your app dashboard (**Apps → GST Manager**).

***

## 1. Invoices are not generating automatically

If new orders do not immediately receive a Tax Invoice:

1. **Check your order quota:** Open **Apps → GST Manager → Plans** to ensure you haven't reached your monthly order limit.
2. **Check Protected Customer Data access:** If order webhooks are not yet active on your store, open the order and click the **Generate now** button to create the invoice on demand.
3. **For B2B orders:** Orders placed by Shopify B2B Companies remain as **Proforma** until the order is marked as fulfilled or paid.

***

## 2. Tax is being added twice on checkout

If your checkout total is higher than the product selling price:

1. In Shopify admin, open **Settings → Taxes and duties**.
2. Click on **India** and ensure all state rates are set to **0%**.
3. Under **Global settings**, uncheck **"Include sales tax in product price and shipping rate"** and **"Charge tax on shipping rates"**.
4. Follow the full [0% tax configuration guide](/gst-manager-shopify/guides/tax-setup).

***

## 3. The CGST / SGST vs IGST split is incorrect

If an order was charged IGST instead of CGST + SGST (or vice-versa):

1. Go to **Apps → GST Manager → Settings → Business Settings**.
2. Check that your **Primary GSTIN** and **Registered state** match your actual business location.
3. If dispatching from a secondary warehouse, ensure the warehouse is configured under **Settings → Store Locations**.
4. Check the customer's delivery state on the order. Intra-state orders (same state) receive CGST + SGST; inter-state orders receive IGST.

***

## 4. The cart-page "Get GST Invoice" block is missing

If customers cannot see the GSTIN input on your cart page:

1. In Shopify admin, go to **Online Store → Themes → Customize**.
2. Click **App embeds** (third icon on the left sidebar).
3. Ensure **Collect Customer GST** is toggled **On**.
4. Click **Save** in the top right.
5. In **Apps → GST Manager → Settings → Other Settings**, ensure **Allow customers to provide a GSTIN** is enabled.

***

## 5. A product is using the wrong GST percentage

If an item on the invoice has an unexpected GST rate:

1. Open **Apps → GST Manager → Products**.
2. Search for the product name.
3. Check the assigned **GST %** and **HSN code**.
4. If no rate is assigned, the app automatically applies your store's **Default GST rate** (configured in **Settings → Tax Configuration**).
5. If using slab rates (clothing/footwear), check that the product's per-unit price matches the threshold rule.

***

## 6. Email delivery is failing

If customers are not receiving their PDF invoices:

1. Go to **Apps → GST Manager → Settings → Integrations → Email Delivery**.
2. Ensure **Enable email delivery** is toggled **On**.
3. Ensure **Send Tax Invoice** is checked.
4. Click **Send test email** to verify delivery to your inbox.
5. If using custom SMTP or Resend (Pro), verify your API key and server credentials.

***

## Related pages

* [Error reference](/gst-manager-shopify/errors) — complete list of app error banners
* [Configure Shopify taxes](/gst-manager-shopify/guides/tax-setup) — step-by-step 0% tax setup
* [Settings reference](/gst-manager-shopify/settings) — all configuration options
* [FAQ](/gst-manager-shopify/faq) — frequently asked questions