The Shopify integration keeps your Qoblex catalog, stock, prices, and orders in step with your Shopify store. It works in two halves: a one-time import that seeds Qoblex with your Shopify products and open orders, and an ongoing background sync that keeps the two systems aligned as things change on either side.
This article is a map of how the integration is put together: the initial import, the automated sync that runs afterwards, the idea of a chosen direction for each kind of data, and the four settings sections you use to configure it all. After reading it you will understand what the integration does on its own and where to go for the step-by-step detail on each part.
The two halves of the integration
Setting up Shopify has two distinct stages.
A one-time import. When you finish setup you run an initial import that brings your Shopify products, variants, images, prices, and stock into Qoblex. Once the products are in, Qoblex imports your open Shopify orders so nothing in flight is missed. You start this from the settings page: Finish Setting Up Your store opens the import window, where you click Import Products. You can also import a historical range of orders yourself from Sales. See Import products from Shopify and Import historical Shopify orders.
Ongoing automated sync. After the import, the integration mostly runs itself. Qoblex connects to your store, so Shopify notifies Qoblex the moment an order is placed, edited, fulfilled, or refunded, and (when you have told Qoblex that Shopify is a source) when a product changes. Qoblex applies those changes in the background without you doing anything.
Source of truth: each data type has a direction
The heart of the integration is deciding, for each kind of data, which system is in charge. Qoblex calls this the sync direction, and you set it separately for inventory levels, product information, pricing, and cost. A direction is one of:
- Do not sync. Neither side updates the other for that data type.
- Sync from Qoblex to Shopify. Qoblex is the source. Changes flow out to Shopify, and manual changes made in Shopify are overwritten by Qoblex.
- Sync from Shopify to Qoblex. Shopify is the source. Changes flow into Qoblex, and Qoblex changes for that data type do not sync out.
- Sync both ways. Changes made in either system sync to the other.
Not every data type offers all four directions. Inventory levels, for instance, are Qoblex-managed: you can only choose Do not sync or Sync from Qoblex to Shopify, because stock quantities are meant to be driven from Qoblex. When you set inventory to sync from Qoblex to Shopify, the settings page notes that “Manual stock level changes made directly in Shopify will be overwritten by Qoblex”. Product information offers the full range including Sync both ways. Pricing can be set to any of Do not sync, Sync from Qoblex to Shopify, or Sync from Shopify to Qoblex, while cost data is Qoblex-managed like inventory and offers only Do not sync or Sync from Qoblex to Shopify (cost never flows in from Shopify). Choosing the direction per data type is how you decide whether Qoblex creates records, updates existing ones, or leaves your data untouched.
The defaults Qoblex ships with are: inventory levels sync from Qoblex to Shopify, product information syncs both ways, prices sync from Shopify to Qoblex, and cost data does not sync. You can change any of these on the settings page. What each direction does in practice is covered in Connect Shopify and choose your sync settings and How Shopify product and inventory sync works.
The settings surface at a glance
Open Shopify from Integrations. The settings page is organized into four numbered sections. This is the whole configuration surface; the detailed articles walk through each one.
- Inventory levels Synchronization. Choose the direction for stock levels (quantity adjustments, stock transfers, purchases, and so on). Covered in Connect Shopify and choose your sync settings.
- Location Mapping. Map each Shopify location to a Qoblex warehouse location, optionally create missing Qoblex locations, choose per-location inventory syncing, and pick the default location for orders created through the web channel. Covered in Shopify locations, currency, and price lists.
- Product Synchronization. Choose how Qoblex matches similar products across stores, set the product information direction, decide whether to automatically sync and publish new Qoblex products to Shopify, and tick which product properties to sync (Name / Title, Description, Brand, Options and their values (ex. color, size…), Product Type, Product Tags, Product Handle (url), Images, Sync Barcode, Inventory Tracking Policy, Continue selling when sold out). Covered in How Shopify product and inventory sync works.
- Pricing Synchronization. Choose the price sync direction, assign the price list and the Compare At price list, choose the cost data direction (cost can only be Do not sync or Sync from Qoblex to Shopify), and, when your store currency differs from your Qoblex base currency, set the exchange rate used to store prices. Covered in Shopify locations, currency, and price lists.
Along the bottom of the page you also have the actions that manage the connection. A store that has not finished setup is temporary and shows Finish Setting Up Your store alongside Save; a fully connected store shows Cancel and Save & Close. Disconnect store removes the app. If Shopify needs additional permissions, a banner reads “Update your integration to grant Qoblex the necessary permissions for seamless store management.” with an Update button.
What the ongoing sync handles for you
Once setup is done, these events flow automatically from Shopify into Qoblex:
- New, edited, or cancelled orders. A new or edited order in Shopify is picked up as an order update, so your Qoblex order stays current, and cancellations flow through too. See How Shopify order sync and order editing work.
- Fulfillments. Fully and partially fulfilled orders, plus fulfillment holds, moves, merges, and routing, keep Qoblex fulfillment in step.
- Refunds and returns. Refunds created in Shopify, and returns disposed of through reverse fulfillment, are reflected in Qoblex. See How Shopify refunds, returns, and fulfillment sync.
- Product changes. When Shopify is a source for pricing or product information, products created or updated in Shopify update the matched Qoblex product, and a product deleted in Shopify is unlinked from Qoblex (the Qoblex product itself is not deleted).
- App and store lifecycle. If the app is uninstalled or the store subscription is cancelled in Shopify, Qoblex responds automatically.
Where to go next
- Connect Shopify and choose your sync settings walks through the settings page and every sync direction.
- Shopify locations, currency, and price lists covers location mapping, currency, exchange rates, and price lists.
- How Shopify product and inventory sync works and How Shopify order sync and order editing work explain the automated sync in detail, including field-by-field mapping.
- How Shopify refunds, returns, and fulfillment sync covers refunds, returns, and fulfillment.
- Import products from Shopify and Import historical Shopify orders cover the manual imports.
- Troubleshooting Shopify collects common problems and fixes.
