Most Shopify orders flow into Qoblex on their own, from Shopify to Qoblex, as covered in How Shopify order sync and order editing work. Sometimes, though, you need to send data the other way: push an order you created in Qoblex up to your Shopify store, or let Shopify know an order has shipped. Qoblex handles both.

This article explains the two ways order data moves from Qoblex to Shopify: the manual Sync to store action that pushes a Qoblex sale order up to a connected store, and the automatic fulfillment update Qoblex sends to Shopify when you ship an order. After reading it you will know when to use Sync to store, what it creates in your store, what can block a sync, and how shipping in Qoblex marks the matching Shopify order as fulfilled.

Which way order data flows

Order creation runs one way, from Shopify into Qoblex. Two separate actions go back the other way, from Qoblex to Shopify:

Sync to store (manual). You select orders in Qoblex and push them up to a connected store. Qoblex creates the matching order in Shopify, or updates it if that order already exists in the store.
Fulfillment update (automatic). When you dispatch a shipment in Qoblex for an order linked to Shopify, Qoblex marks that order as fulfilled in Shopify and sends the tracking details. You do not start this yourself.

Editing an order in Qoblex does not push the change back to Shopify on its own. The automatic sync only listens for changes made in Shopify. Sync to store is the deliberate, manual way to send a Qoblex order up to your store.

Before you start

For an order to sync cleanly to Shopify, make sure:

The store is connected. Only connected stores appear in the store picker. See Connect Shopify and choose your sync settings.
Every line has a product variant. Lines that point to a variant you later deleted will block the sync.
Every line has a tax class set. Lines and shipping charges without a tax class are rejected.
Your locations are mapped. The fulfillment update ships from the Qoblex location mapped to a Shopify location. See Shopify locations, currency, and price lists.
You can edit orders. The Sync to store action only appears for users with permission to edit orders.

Push an order to your store (Sync to store)

Go to Sales > Orders.
Select the order or orders you want to push, using the checkboxes in the list.
Open the bulk actions menu and choose Sync to store.
In the Sync to store window, open Select a sale channel and choose the store you want to push to. Only connected stores are listed; if you have none, the list shows No connected stores.
Select Sync.

Qoblex queues each selected order and pushes it in the background. You will see a brief confirmation that your orders are queued to sync to store, and each order is then sent to your store one at a time. Watch your notifications and Activity feed for the result of each order, rather than assuming the push is finished the moment the window closes.

For each order, Qoblex:

Creates a new order in Shopify when that order is not already in the store, carrying its line items, customer, billing and shipping addresses, taxes, discount total, and shipping charges.
Updates the existing Shopify order instead of creating a duplicate when the order is already linked to that same store.
Links the Qoblex order to the store by recording the Shopify order reference, so later updates and shipments line up with the same order.
Sends the fulfillment too when the order already has a completed shipment, using the automatic fulfillment update described below.
Posts a confirmation to your notifications reading that the order was successfully synced, or a warning or error if it could not be pushed.

Sync to store creates a brand-new order in your Shopify store when the Qoblex order is not already there. Use it for orders that originated in Qoblex, such as phone or manually entered orders you want reflected in Shopify. An order can belong to only one store, so an order that already came from a different Shopify store cannot be pushed to another one.

Refunds are not sent to Shopify. If a pushed order has refunds recorded in Qoblex, Qoblex notes on your Activity feed that the refunds were not synchronized. Record those refunds in Shopify directly.

What can block a Sync to store

Qoblex checks each order before it pushes it. If a check fails, the order is skipped and Qoblex records the reason on your Activity feed:

The order is already linked to another integration (it belongs to a different store).
One or more order lines or shipping charges have no tax class set.
One or more lines reference a variant that has been removed.
The order contains duplicate lines that reference the same product or variant (Qoblex matches lines to Shopify by product name, so each product and variant must appear once).
A shipping charge has a quantity above 1 (shipping line quantities must be 1).
An address uses a country name Qoblex cannot recognize as a valid country.

Automatic fulfillment sync-back (shipping in Qoblex)

Once an order is linked to a Shopify store, whether it arrived from Shopify or you pushed it with Sync to store, shipping it in Qoblex updates Shopify automatically.

When you dispatch a shipment in Qoblex, Qoblex creates a fulfillment on the matching Shopify order. This marks the order as fulfilled (or partly fulfilled) in Shopify and sends the shipment’s tracking number, carrier, and the quantities shipped. By default Shopify then notifies the customer, as it would for any fulfillment.

Only shipments that are completed and have not already been sent to Shopify are pushed, so dispatching further shipments on the same order adds new fulfillments rather than duplicating earlier ones.

The fulfillment ships from the Shopify location paired with the shipment’s Qoblex location, and Qoblex moves the fulfillment to that location in Shopify if it needs to. If the shipment’s location is not mapped, or there is nothing left to fulfill on the Shopify order, Qoblex cannot complete the fulfillment and records the reason on your Activity feed.

The fulfillment update needs the shipment’s Qoblex location mapped to a Shopify location. If it is not mapped, Qoblex cannot fulfill the order in Shopify and asks you to review your location mapping. Map every location you ship from under Shopify locations, currency, and price lists.

Order field mapping (Qoblex to Shopify)

The tables below show what Qoblex sends to Shopify, derived from the outbound order and fulfillment builders. Blank Qoblex values are handled as noted.

Order (Sync to store)

Shopify field	Qoblex field	Notes / transform
Order name	Order number	The Qoblex order number becomes the Shopify order name.
Source	Fixed value `S&B`	Pushed orders show `S&B` as their source in Shopify, marking them as sent from Qoblex.
Currency	Order currency	The order’s currency.
Tags	Order tags	Sent only when the order has tags.
Note	Order comments	The order’s comments become the Shopify order note.
Taxes included	Tax-inclusive setting	Marks whether line prices already include tax.
Financial status	Payment status	Unpaid becomes Pending, fully paid becomes Paid, partially paid becomes Partially paid.
Fulfillment status	Order status	An invoiced order is marked Partial; otherwise the status is left unset for Shopify to manage.
Discount	Sum of line discounts	Sent as a single fixed-amount discount code named `Discount` totalling the order’s line discounts.
Customer	Order contact	The contact name is split into first and last name; email and saved addresses are included.
Billing address, Shipping address	Order addresses	The contact name is split into first and last name, and the country name is converted to its country code.
Line items	Order lines	Each line sends its SKU, product name, quantity, unit price, and tax lines.
Shipping lines	Landed cost items	Each shipping charge sends its name, total, and tax; its quantity must be 1.

Fulfillment (shipping)

Shopify field	Qoblex field	Notes / transform
Location	Shipment location	The Shopify location paired with the shipment’s Qoblex location; the shipment fails if the location is not mapped.
Tracking number	Shipment tracking code	The tracking number recorded on the Qoblex shipment.
Tracking company	Shipment carrier	The carrier recorded on the Qoblex shipment.
Line items	Shipped items	Each shipped line and its quantity, matched to the corresponding Shopify order line.

Troubleshooting

Sync to store is not in the bulk actions menu

The action only appears for users who can edit orders. Ask your administrator to grant you edit permission for orders, then reopen the Sales list.

The store I want is not in the picker, or it says No connected stores

Only connected stores appear in Select a sale channel. Connect the store first (see Connect Shopify and choose your sync settings); once it is connected it will appear in the list.

Qoblex says the order is already linked to another integration

An order can belong to only one store. This message means the order already came from, or was pushed to, a different store, so it cannot be synced to the one you chose. Check which store the order belongs to before pushing it.

Qoblex says one or more order items tax class is not set

Every order line, and every shipping charge, must have a tax class before the order can be pushed. Open the order, set a tax class on each line and on any shipping charge, then run Sync to store again.

Qoblex says one or more variant has been removed

A line on the order points to a product variant that has since been deleted. Replace or remove that line so every line points to a current variant, then sync again.

Qoblex says the order contains duplicate lines

Qoblex matches lines to Shopify by product name, so the same product or variant cannot appear on more than one line. Combine the duplicate lines into a single line for that product, then sync again.

Qoblex says shipping lines quantities must be 1

A shipping charge on the order has a quantity greater than 1. Set the quantity of each shipping charge to 1 and sync again.

I shipped the order in Qoblex but Shopify is not fulfilled

Check two things. First, confirm the shipment’s location is mapped to a Shopify location, since the fulfillment ships from the mapped location. Second, check whether there is anything left to fulfill on the Shopify order: if the order was already fulfilled in Shopify, there is nothing for Qoblex to add. Qoblex records the specific reason on your Activity feed.

A pushed order is missing its refunds in Shopify

Refunds are not sent to Shopify. When you push an order that has refunds, Qoblex records on your Activity feed that the refunds were not synchronized. Record those refunds in Shopify directly.

How syncing orders from Qoblex to Shopify works