Sync Log and troubleshooting channel errors

The Sync Log at /dashboard/sync-log is the machine-side audit trail. Every time a channel pushes a product, pulls an order, or fails to do so, an event lands here with a timestamp, payload, and result. Use it as your first stop when a channel looks out of sync.

Event states

• queued — picked up but not yet running
• running — in flight
• success — completed cleanly
• error — failed, with an error message + stack on the detail panel

Filters

• Channel (Shopify, Facebook Shops, eBay, Back Market, etc.)
• Data source (product push, order pull, webhook in, sync job)
• Date range
• State — narrow to just errors when debugging

Common errors and what to do

• "Invalid credentials" — the channel token expired or was revoked. Disconnect and reconnect the channel from Sales Channels.
• "Rate limited" — the marketplace throttled us. Safe to ignore; the job re-queues with backoff.
• "Product not found on channel" — the listing was deleted on the marketplace side. Re-register the product from its detail page.
• "Webhook signature invalid" — almost always a transient clock-skew issue. Only investigate if it persists over many events.
• "Inventory mismatch" — stock drift between Techfleet and the channel. Trigger a manual resync from the channel detail page.

Sync Log vs Activity

Sync Log is machine events — channel adapters, webhook deliveries, background jobs. /dashboard/activity is the human-side audit: who logged in, who edited what product, who issued a refund. Reach for Activity when you need "who did this", Sync Log when you need "why did this fail".

Retrying

Most errored jobs re-queue automatically with exponential backoff. For a stuck job, open its detail panel and click Retry — the same payload re-runs against the latest credentials.