My historical import didn’t finish

A historical import brings your past orders into QuickBooks. If one was started and stopped part-way, TruSync now tells you so — in Settings → Sync Settings, above Sync Historical Orders, and as Historical import didn’t finish on your dashboard.

Everything else about your store keeps working while this is true, which is exactly why it is worth saying. New orders sync normally, your dashboard looks healthy, and nothing fails. The only thing missing is the older orders the import never reached.

What it means for your books

Orders the import never reached aren’t in QuickBooks, so three things follow:

• They don’t appear in your QuickBooks sales.
• A settlement that pays them out can’t be reconciled — TruSync holds the whole deposit until every order on it has a QuickBooks document. See Bank Deposits & payouts.
• They raise no Order Exception, because an exception means TruSync saw an order and couldn’t post it. These were never fetched at all, so there is nothing to see on that page.

How to fix it

Open Settings → Sync Settings, expand Sync Historical Orders, and run the import again from the same start date.

The message tells you where the last run got to — for example “It imported 97 orders and reached 10 April 2026” — so you know which dates are missing. Choose a start date at or before that point, within how far back your store lets an import reach (see below).

If the import started later than you asked

How far back an import can reach depends on your storefront, not on TruSync. Shopify makes about the last 60 days of orders available to connected apps; other platforms allow more, and some state no limit. If you ask for a start date further back than your platform allows, TruSync starts from the earliest date it can read and says so in the import result. Trudy tells you that earliest date before offering start dates, and only offers dates on or after it. Orders older than that can’t be imported, so enter them in QuickBooks directly if you need them.

There is a second limit if you created Inventory items during setup. QuickBooks won’t accept a document dated before the day an Inventory item started tracking quantity on hand, and items created during setup start about 90 days back. An imported order from before that date fails to sync for that item, with a QuickBooks error saying you can’t create or modify a transaction dated before you started tracking quantity on hand. Orders that don’t contain that item are unaffected.

To fix it, open the item in QuickBooks and move the date it started tracking quantity on hand back to a date earlier than your oldest order. Orders that were still being retried then sync on their own the next time TruSync retries them, with no support ticket and no re-import. An order that has stopped retrying shows as failed in Sync History: press Retry on its row once the date is fixed. If you’d rather not edit QuickBooks yourself, ask Trudy or contact support with the order number. Don’t delete the item.

Running it again is safe. TruSync checks QuickBooks before creating anything, so orders already in your books are skipped rather than duplicated.

Afterwards, open Bank Deposits and press Reconcile Now. Settlements that were held because of the missing orders post on the next run.

Why an import stops

The usual cause is simply that it ran out of time: a large date range can take longer than the request allows, and the run ends part-way. It can also stop if your store’s connection drops mid-run.

One stop is deliberate and reads differently. If the message says the import stopped on purpose and imported nothing, TruSync couldn’t rule out creating duplicate documents in QuickBooks and declined rather than risk it. Nothing was imported, so there is nothing to undo — but what to do next depends on which of two things the message says.

If it says there are too many existing transactions in the range, run it again over a shorter range — a month or two at a time. The check reads every QuickBooks transaction in the range in one pass, and a very large range is more than it can cover.

If it says TruSync couldn’t reach QuickBooks to run the check, check your QuickBooks connection and run it again over the same range. A shorter range won’t help here, because the problem wasn’t the size of it. This is usually temporary. See QuickBooks connection issues.

Contact support if either message keeps coming back after you’ve tried that.

If it keeps stopping

Run it in shorter stretches — a month or two at a time, oldest first. Each run that completes is recorded, so you can work forward. Contact support with your store name if the same range keeps stopping.

FAQ

I asked for an earlier start date but the import started later. Why? Your storefront limits how far back an import can reach. Shopify allows about the last 60 days; other platforms differ. TruSync starts from the earliest date it can read and reports that date. Older orders have to be entered in QuickBooks directly.

My dashboard says “Historical import didn’t finish”. What do I do? Open Settings → Sync Settings, expand Sync Historical Orders, and run the import again from the same start date. The message tells you the date the last run reached, so you know what’s missing. Orders already in QuickBooks are skipped rather than duplicated. See My historical import didn’t finish.

Will running the import again create duplicate entries in QuickBooks? No. TruSync checks QuickBooks for an existing sales receipt or invoice before creating anything, and skips orders that are already there. That check is why a re-run is the normal way to recover an unfinished import.

My store looks fine and orders are syncing. Why does it say something didn’t finish? Because the two are unrelated. Live order sync and the historical import are separate: new orders have been syncing normally the whole time. What stopped was the one-off job that brings in orders from before you connected. Nothing fails while it is unfinished, which is why TruSync now says so rather than leaving you to notice.

Why are some old orders missing with no Order Exception? An Order Exception means TruSync fetched an order and couldn’t post it. An order the historical import never reached was never fetched, so there is nothing to raise an exception about. That silence is the tell: missing orders with no exception usually mean an unfinished import. See My historical import didn’t finish.

A payout won’t reconcile and the orders holding it say “TruSync never imported this order”. Is that this? Yes. Those orders were placed before TruSync started syncing your store, or a historical import that should have covered them didn’t finish. Run the import over their dates, then press Reconcile Now on the Bank Deposits page. See Bank Deposits & payouts.