Run a SKU sync
Pull new SKUs from ShipHero on demand, watch a run finish, and read the sync history.
A SKU sync pulls SKUs from ShipHero for one account and reconciles them against the SKUs already in the system. Anything it can't recognize lands in the review queue. This guide covers starting a sync yourself and reading what past runs did.
Where this lives
Open Settings → SKU Sync. The Queue and Sync history tabs both carry a Sync Now control. Every signed-in user can run a sync.
How syncs start
New SKUs arrive two ways:
- Daily cron: a scheduled job runs every day at 07:00 UTC and syncs every eligible account automatically. You don't have to do anything for this.
- Sync Now lets you trigger one account on demand from the SKU Sync screen.
Only accounts that have a saved ShipHero access token are eligible. The daily cron additionally skips any account that hasn't finished its initial import.
Trigger a sync now
- Open Settings → SKU Sync.
- In the top-right, pick an account from the brand dropdown. The dropdown only lists accounts you have access to that are connected to ShipHero.
- Click Sync Now.
The button stays disabled until you've picked an account. Once you click it, the app starts a run in the background for that account.
One account at a time
Sync Now runs the account you selected. To sync several accounts, run them one after another.
Watch it run
While a sync is in progress the screen shows a yellow A sync is running banner naming the account (or a count if several are running). The queue and history refresh on their own every few seconds while anything is running, so new SKUs appear as they're queued. You don't need to reload the page. When the run finishes, the banner clears and the tables settle.
Read the run
Each run records a small scorecard. You'll see these counts on the Sync history tab and in the run detail:
- Found: how many SKUs the run saw from ShipHero.
- Queued: how many new SKUs it added to the review queue.
- Skipped: how many it ignored because they already exist.
A run also carries a status (running, completed, or failed) and an
error message if it failed.
Browse sync history
Open the Sync history tab to see past runs, newest first. Each row shows when it started, the account, its status, the found/queued/skipped counts, and any error.
- Search by SKU name or code to find runs that touched a particular SKU.
- View Details opens one run and lists every SKU it processed, with the action the sync took on each (created, linked, or skipped) and the SKU type.
After a sync
A sync's job is to find and queue SKUs, not to create them. Newly queued SKUs sit in Pending until someone classifies them. Head to the queue guide to turn them into real SKUs.
SKU sync talks to ShipHero directly
Unlike most automation, SKU sync reads ShipHero's API directly rather than routing through N8N. For the wider picture, see Data Flows.
Related
- Resolve the SKU queue: classify what a sync queued.
- Settings feature guide: the screen in context.
- SKU Sync database tables:
sku_sync_runs,sku_sync_items, andsku_pending_queue.