Skip to content
Docs

Troubleshooting sync

Updated 2026-11-18 · 2 min read

On this page
  1. How sync works
  2. Check a missing order
  3. Reconnect a store
  4. Common causes
  5. FAQ
  6. How quickly are orders imported?
  7. Will a retry create a duplicate invoice?
  8. Still stuck?

If an order is missing or late, open the store in Stores and check its sync history. Folio re-fetches the last 48 hours every 6 hours, retries failed jobs automatically, and lets you run Sync now or Retry manually. If a store shows needs attention, reconnect it.

How sync works

  • Webhooks deliver orders in real time. Each is verified, stored with its event id and processed once; duplicates are ignored.
  • Reconciliation re-fetches the last 48 hours every 6 hours to catch webhooks that never arrived.
  • Retries run failed jobs again after 1 minute, 5 minutes, 30 minutes, 2 hours and 6 hours. After that, the job is marked failed and shows a Retry button.
  • Sync history lists every run and webhook with status, counts, duration and any error message.

Check a missing order

  1. Open Stores, select the store and check its status: connected, needs attention or disconnected.
  2. Open sync history and look for the order’s time. Read any error message.
  3. Choose Sync now to fetch recent orders immediately.
  4. If a job shows failed, choose Retry.
  5. If the store needs attention, reconnect it (below).

Reconnect a store

  1. Open Stores and select the store.
  2. Choose to reconnect and repeat the authorization: Shopify, WooCommerce, Wix or BigCommerce.
  3. Choose Sync now to confirm it works.

Common causes

  • Authorization revoked or expired. The store is marked needs attention. Reconnect.
  • App uninstalled on the platform. Reinstall through Folio.
  • WooCommerce: a firewall, security plugin or maintenance mode blocks incoming webhook requests or REST calls; the API keys were deleted or lack Read/Write.
  • Platform rate limits or outages. Folio retries automatically.
  • Invoice not issued though the order arrived. Check the automation’s run log: the order may have been skipped because a condition did not match. Also check whether the invoice is held by your plan limit. See Automation rules and Plans and billing.
  • Historical orders have no emails. This is by design.

FAQ

How quickly are orders imported?

Typically as soon as the platform sends its webhook. The reconciliation job catches anything missed within its next 6-hour run.

Will a retry create a duplicate invoice?

No. Each order has one active invoice, and duplicate webhook events are ignored.

Still stuck?

Contact us from the Support page and include the store name and the time of the missing order.

Still stuck? Visit support or contact us.

Cookie preferences

Read our cookie policy