09. Troubleshooting Shopify

Most Shopify issues fall into two groups: the settings page refuses to save, or something in Shopify is not showing up in Qoblex the way you expect. Almost all of these come from a setting you can change yourself on the Shopify settings page, so before you contact anyone, it is worth checking the sync directions, location mappings, and price lists you chose when you connected the store.

This article lists the symptoms and blocking messages you may see, with the fix for each. After reading it you will be able to clear the save-blocking validations on the settings page, understand why a Shopify change did or did not flow into Qoblex, and know when to fall back to a manual import.


The page tells you to refresh or re-install your Shopify integration

When Qoblex cannot load your store details or your Shopify locations, it shows “Oops, there was a problem a little glitch! please refresh the page or re-install your shopify integration.” and sends you back to the integrations list.

This usually means the selected store is no longer connected to this Qoblex company, or the connection can no longer read your store. Refresh the page first. If it happens again, open the store from the integrations list and reconnect it, and confirm you are working in the Qoblex company that owns that store.

Qoblex asks you to update your integration permissions

If your access scopes are out of date, the settings page shows a banner reading “Update your integration to grant Qoblex the necessary permissions for seamless store management.” with an Update button. The same thing can happen when loading locations fails on a permissions error, which opens the update-scopes dialog.

Click Update, complete the Shopify authorization prompt, then return to Qoblex and retry your save or import. Until the scopes are granted, Qoblex may be unable to read locations or manage your store.

No products appear to import

A product import reads the catalog from your connected store, so an empty or partial result points back at the store and the connection rather than at Qoblex. Confirm you selected the correct store, that its permissions are current (see the update-permissions row above), and that the products you expect are present in that Shopify store.

[!info] The import runs in the background and can take a few minutes depending on how many products you have. Qoblex emails you when the import finishes, so wait for that email before deciding a product is missing.

Save is blocked: you have more locations in Shopify than in Qoblex

If Shopify has more store locations than you have locations in Qoblex, the save is rejected with: “You have more locations in Shopify than in your Qoblex Account. Click Create Location next each Shopify location to create a corresponding entry in Qoblex”.

In the Location Mapping section, use the Create location button next to each unmapped Shopify location to add the matching Qoblex location, then save again. Every Shopify location needs a Qoblex location to map to.

Save is blocked: a Qoblex location is mapped more than once

If you point two Shopify locations at the same Qoblex location, the save is rejected with a message naming the location: “Location [name] in Qoblex is mapped to multiple locations in Shopify. Please check your location mappings under Location Mappings section above”.

Open the Location Mapping section and give each Shopify location its own distinct Qoblex location, then save again.

Save is blocked by a price list rule

The Pricing Synchronization section enforces a few rules before it will save. You may see any of these messages:

  • Price and Compare At price lists must be different” – choose a different list for the Compare At price than for the Price.
  • Price and Compare At price lists must have the same currency” – pick two lists that share a currency.
  • Price price list must have the same currency as your store (<currency>)” – and the matching “Compare At price list must have the same currency as your store (<currency>)”, where <currency> is your store currency code – choose lists whose currency matches your Shopify store currency.

Fix whichever lists are flagged under “Which price list would you like to assign to your product prices on your store?” and its Compare At counterpart, then save again.

Save is blocked: “Please define a currency exchange rate first.”

This appears when your Shopify store currency differs from your Qoblex base currency and no exchange rate exists for that store currency yet. Qoblex needs the rate to store your Shopify prices in your base currency.

In the Pricing Synchronization section, use the Setup Exchange rate button (shown under the “Currency setup” note) to define the rate, then save again.

A change I made in Shopify did not sync to Qoblex

Whether Qoblex listens for product changes in Shopify depends on your sync directions. Qoblex only subscribes to Shopify product create, update, and delete events when at least one of your product information or pricing settings is set to bring data from Shopify to Qoblex.

To turn this on, open the settings page and set one of these to a Shopify-source direction, then save:

  • In the Product Synchronization section, set “How would you like us to sync your products information?” to Sync from Shopify to Qoblex or Sync both ways.
  • In the Pricing Synchronization section, set “How would you like us to sync your product prices?” to Sync from Shopify to Qoblex.

If both of those are set to “Do not sync” or “Sync from Qoblex to Shopify”, Qoblex is not registered to receive product changes from Shopify, so edits made in Shopify will not appear in Qoblex. The Inventory levels Synchronization control only offers “Do not sync” and “Sync from Qoblex to Shopify”, so it cannot make Qoblex listen for Shopify changes. See How Shopify product and inventory sync works for what each direction does.

[!info] Order, refund, and fulfillment events are always received once the store is connected. Only product change events depend on the sync direction you chose.

I deleted a product in Shopify but it still exists in Qoblex
This is expected. When a product is deleted in Shopify, Qoblex unlinks that product from the store, it does not delete the Qoblex product. Your Qoblex product and its stock history stay intact and simply stop being tied to the deleted Shopify product. If you also want it gone from Qoblex, remove it in Qoblex yourself.
Live updates seem paused right after an import
While a product import is running for a store, Qoblex holds that store’s live updates so the import and incoming changes do not collide, then resumes them once the import completes. If updates look frozen immediately after you start an import, wait for the completion email before expecting live changes to flow again.
Historical orders are missing after connecting
Connecting a store and importing products brings in your open orders, not your full order history. To bring in older orders, run a manual import from Sales, choose the store, and select the date range you need. See Import historical Shopify orders for the steps.
A refund or fulfillment is not showing in Qoblex
Qoblex subscribes to refund and fulfillment events for every connected store, so these should arrive automatically. If one is missing, first confirm the store is still connected and its permissions are current (see the update-permissions row above), then re-check the order in Shopify to confirm the refund or fulfillment actually completed there. See How Shopify order sync and order editing work for how these events flow into Qoblex.
I have unsaved changes and Qoblex warns me before leaving
If you try to navigate away with pending settings changes, Qoblex asks “You have pending changes, if you leave this page you will lose those changes. Do you want to continue?”. Stay on the page and use Save & Close (or Save while first setting up) to keep your changes. Continue past the prompt only if you want to discard them.
Was this article helpful?

Related Articles