08. Import historical Shopify orders

When you connect Shopify and import your products, Qoblex automatically pulls in your open orders (orders Shopify has not closed or archived). The manual order import covers everything else: older orders, closed orders, or any specific window of history you want in Qoblex. You choose a store and a date range, and Qoblex imports every Shopify order in that range.

This article shows you how to run a manual Shopify order import from the Sales screen, explains the default and maximum date ranges, and describes what Qoblex builds from each order. After reading it you will know when to use a manual import, how to pick a sensible date range, and what to expect once the import is running.

When to use a manual order import

Qoblex has two ways to bring Shopify orders in:

• Automatic open-order import. Right after you import products, Qoblex imports your open orders on its own. You do not start this manually. See How Shopify order sync and order editing work.
• Manual order import. You start this yourself from Sales when you need orders the automatic import does not cover: historical orders from before you connected, closed or archived orders, or a specific recovery window.

The manual import uses the exact same processing as automatic order sync, so a manually imported order is matched, taxed, and built the same way as one that arrives through live sync. What follows is only about the manual import.

Import your products before your orders. Qoblex matches each order line to a product or variant that already exists in your catalog. If you import orders before products are matched, some lines may not link to the right item and will need review afterwards.

Import orders manually

1. Go to Sales > Orders.
2. Select Import…. The Import sale orders window opens on the Importer Selection step.
3. Choose Shopify (“Import orders from your Shopify store”).
4. On the Action step, open the Which store do you want to import orders from? list and select the store you want. Each store is listed by its Shopify address (for example, your-store.myshopify.com), so pick the right one if you have more than one connected.
5. Under Select a time range, set the start and end dates for the orders you want to import. The range defaults to the last 60 days.
6. Select Start.

Qoblex queues the import and works through it in the background. The Report & Finish step confirms only that the import has started: it tells you your orders are being imported in the background and that you will receive an email when the import is completed. You can close the window and keep working while the orders are processed.

When the run finishes, Qoblex emails the address on your account: a success message that includes how many orders were imported, or a failure message if the import could not complete. The email is your signal that the import is done, so wait for it before you rely on the imported orders being fully in place.

Importing from the wrong store or an over-wide date range creates orders you then have to review or clean up. Confirm the store and narrow the date range to what you actually need before you select Start.

Choose the smallest useful date range

Pick the smallest range that covers the orders you are missing. A tighter range imports faster and gives you less to review. As the import window itself notes, “The import operation might take some time depending on the number of orders you have within the selected time range”.

The date range you can request is limited:

• By default, order imports are limited to the last 3 months (a span of about 93 days from start to end date).
• If you select a wider range, the window blocks the import and shows: “Order imports are limited to the last 3 months by default. Contact support to import a larger date range.” The Start button stays disabled until the range is back within the limit.

To import a longer history, contact Qoblex support: the larger range is unlocked per account rather than from the import window.

What Qoblex builds from each order

The manual import first collects the Shopify order IDs in your date range, then processes each order through the same order pipeline used by live order sync. Because of that, matching, customer handling, and tax treatment are identical to automatic sync. For the full detail of how an order is built, see How Shopify order sync and order editing work.

For each order in range, Qoblex:

• looks up whether the order already exists in Qoblex and updates it, or creates it if it is new (so re-importing an overlapping range does not create duplicates);
• resolves the customer and addresses, matches each line to a product or variant in your catalog, and applies the order’s taxes;
• builds the order’s invoice and payment records, and its shipment and fulfillment information;
• posts a confirmation to your notifications for each order that syncs, and a warning or error for any order it cannot fully process.

Because this runs in the background, orders appear gradually rather than all at once. Wait for the import to finish before you allocate, ship, invoice, or edit the imported orders, so you are working with the complete order rather than a half-built one. You can follow progress and any warnings in your Activity feed and notifications.

If you have already edited or unlocked an order inside Qoblex, the manual import leaves your version alone and does not overwrite it. Qoblex records a note in your notifications when it skips an order for this reason.

Troubleshooting