Appearance
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:
- Check your order quota: Open Apps → GST Manager → Plans to ensure you haven't reached your monthly order limit.
- 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.
- 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:
- In Shopify admin, open Settings → Taxes and duties.
- Click on India and ensure all state rates are set to 0%.
- Under Global settings, uncheck "Include sales tax in product price and shipping rate" and "Charge tax on shipping rates".
- Follow the full 0% tax configuration guide.
3. The CGST / SGST vs IGST split is incorrect
If an order was charged IGST instead of CGST + SGST (or vice-versa):
- Go to Apps → GST Manager → Settings → Business Settings.
- Check that your Primary GSTIN and Registered state match your actual business location.
- If dispatching from a secondary warehouse, ensure the warehouse is configured under Settings → Store Locations.
- 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:
- In Shopify admin, go to Online Store → Themes → Customize.
- Click App embeds (third icon on the left sidebar).
- Ensure Collect Customer GST is toggled On.
- Click Save in the top right.
- 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:
- Open Apps → GST Manager → Products.
- Search for the product name.
- Check the assigned GST % and HSN code.
- If no rate is assigned, the app automatically applies your store's Default GST rate (configured in Settings → Tax Configuration).
- 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:
- Go to Apps → GST Manager → Settings → Integrations → Email Delivery.
- Ensure Enable email delivery is toggled On.
- Ensure Send Tax Invoice is checked.
- Click Send test email to verify delivery to your inbox.
- If using custom SMTP or Resend (Pro), verify your API key and server credentials.
Related pages
- Error reference — complete list of app error banners
- Configure Shopify taxes — step-by-step 0% tax setup
- Settings reference — all configuration options
- FAQ — frequently asked questions