Help
Troubleshooting
Fixes for the problems merchants meet most often when connecting and syncing Shopify with Zoho.
Start with Logs. Almost every problem leaves a row there with the reason.
Connecting to Zoho
| Problem | Fix |
|---|---|
| The Zoho sign-in window does not open | Your browser blocked the popup. Allow popups for admin.shopify.com and click Connect via OAuth again |
| Zoho shows redirect URI mismatch | Copy the redirect URI from the app's Connection page into the Zoho API Console, exactly, and click UPDATE |
| Invalid client or invalid client secret | Copy the Client ID and Secret again from the Client Secret tab in the Zoho API Console. Watch for spaces at either end |
| Connected, but every sync fails | The domains do not match your Zoho region. A zoho.in account needs https://accounts.zoho.in and https://www.zohoapis.in. See Connect Zoho |
| The wrong Zoho organisation is connected | Disconnect, enter the right Organization ID and connect again |
| The connection stopped working | Click Test Connection. If it fails, Disconnect and connect again |
Orders
| Problem | Fix |
|---|---|
| An order is Skipped | Read the reason in Logs. A filter under Order settings held it back, or it has no customer and guest orders are set to be skipped |
| A new order did not sync at all | Check that Enable order auto sync is on and Zoho is connected. Then use Reconcile to find and sync what is missing |
| No payment was recorded | Payments need an invoice. Check the document option and that Record payments is on |
| A refund made no credit note | Credit notes need an invoice, and Create a credit note when an order is refunded must be on |
| Zoho says a tax is not found, or tax is missing | Run Auto-detect from recent orders under Tax mapping. Add the tax in Zoho if it does not exist |
| Zoho asks for a GSTIN or place of supply | The order line was matched to a GST-specific tax. Map that Shopify tax to the right Zoho tax or tax group |
| The Zoho total differs from Shopify | Usually tax or rounding. See Amount differences |
| The document number is not the Shopify number | Zoho rejected it (already used, or a character it does not accept) and used its own numbering. The Shopify number is still the reference number |
| Zoho says the currency does not exist | Add the currency in Zoho under Settings → Currencies |
| A line has no item in Zoho | No item matched and Create the item in Zoho when none matches is off. See Items |
| An invoice was not voided on cancellation | It already has a payment. Zoho does not void a paid invoice. The refund is credited instead |
| Orders older than 60 days are not found by a backfill | Shopify returns only the last 60 days of orders unless the app has access to all orders. Contact support |
Products and inventory
| Problem | Fix |
|---|---|
| Duplicate items appeared in Zoho | The products were synced without a match. Turn on auto-matching or use AI product matching before syncing the rest. Remove the duplicates in Zoho and unlink and re-match those products |
| A product is skipped as "partially accepted AI variant mappings" | Open AI Match, scan that product and save the remaining variant mappings |
| Stock does not sync | Map the location on the Connection page, check that the variant has a Zoho item ID, and check that Inventory Sync is on |
| Stock from Zoho does not reach Shopify | With Zoho as the source, choose Scheduled sync, or click Inventory Sync |
| Warehouses cannot be created | Enable Multi-Warehouse in Zoho Inventory under Settings → Preferences → Warehouses, or map every location to one warehouse |
| The image did not sync | Tick Image under Choose fields to sync and resync the product |
Customers
| Problem | Fix |
|---|---|
| Duplicate contacts in Zoho | Contacts are matched by email. Customers without an email are matched by name only. Merge the duplicates in Zoho |
| An order went to the wrong contact | Check Match customers by under Customers on orders. Matching by name can pick a namesake |
The whole app
| Problem | Fix |
|---|---|
| A banner says Zoho API limit reached | Syncing resumes on its own. See Zoho API limits |
| The app keeps opening Pricing Plans | No plan is active, or your Shopify plan changed. Select the enabled plan. See Subscription |
| A sync is "queued" but nothing changes | Wait a minute and reload. If Logs shows nothing new after several minutes, contact support |
| The Sync to Zoho action is missing from the Shopify admin | See Admin actions |
Contact support
Email support@techspawn.com or WhatsApp +91 7719993399. To get a fast answer, include:
- Your store address (
your-store.myshopify.com). - Zoho Books or Zoho Inventory, and your Zoho region.
- The order number or product name.
- The message from Logs. Export CSV on the Logs page is the easiest way to send it.
We are based in India and usually reply within a few hours, Monday to Friday, 9:00 AM to 6:00 PM IST.