Zync Docs
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

ProblemFix
The Zoho sign-in window does not openYour browser blocked the popup. Allow popups for admin.shopify.com and click Connect via OAuth again
Zoho shows redirect URI mismatchCopy the redirect URI from the app's Connection page into the Zoho API Console, exactly, and click UPDATE
Invalid client or invalid client secretCopy 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 failsThe 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 connectedDisconnect, enter the right Organization ID and connect again
The connection stopped workingClick Test Connection. If it fails, Disconnect and connect again

Orders

ProblemFix
An order is SkippedRead 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 allCheck that Enable order auto sync is on and Zoho is connected. Then use Reconcile to find and sync what is missing
No payment was recordedPayments need an invoice. Check the document option and that Record payments is on
A refund made no credit noteCredit 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 missingRun 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 supplyThe 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 ShopifyUsually tax or rounding. See Amount differences
The document number is not the Shopify numberZoho 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 existAdd the currency in Zoho under Settings → Currencies
A line has no item in ZohoNo item matched and Create the item in Zoho when none matches is off. See Items
An invoice was not voided on cancellationIt 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 backfillShopify returns only the last 60 days of orders unless the app has access to all orders. Contact support

Products and inventory

ProblemFix
Duplicate items appeared in ZohoThe 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 syncMap 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 ShopifyWith Zoho as the source, choose Scheduled sync, or click Inventory Sync
Warehouses cannot be createdEnable Multi-Warehouse in Zoho Inventory under Settings → Preferences → Warehouses, or map every location to one warehouse
The image did not syncTick Image under Choose fields to sync and resync the product

Customers

ProblemFix
Duplicate contacts in ZohoContacts are matched by email. Customers without an email are matched by name only. Merge the duplicates in Zoho
An order went to the wrong contactCheck Match customers by under Customers on orders. Matching by name can pick a namesake

The whole app

ProblemFix
A banner says Zoho API limit reachedSyncing resumes on its own. See Zoho API limits
The app keeps opening Pricing PlansNo plan is active, or your Shopify plan changed. Select the enabled plan. See Subscription
A sync is "queued" but nothing changesWait a minute and reload. If Logs shows nothing new after several minutes, contact support
The Sync to Zoho action is missing from the Shopify adminSee 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.