Marketplace Sync Troubleshooting
Diagnose connection, webhook, queue, SKU mapping, stock and fulfilment problems without corrupting local inventory.
Blank/failed connection
Check HTTPS URL, DNS, SSL, credentials and seller approval. Run Test Connection and read the exact error log.
401 token error
Refresh or reconnect access token; verify client ID/secret and expiry.
403 scope error
Enable the required role/scope in the marketplace developer portal.
No orders imported
Check automatic orders toggle, webhook status, queue jobs and the incremental cursor.
SKU unmapped
Open Product / SKU Mapping and map seller SKU to the correct product variant.
Stock mismatch
Verify warehouse mapping, reservations, safety buffer and deduction stage.
Webhook rejected
Verify secret/signature, timestamp, HTTPS and callback URL.
Queue stuck
Run Sync Now; stale locks older than 20 minutes reset automatically.
Duplicate order
Existing idempotency keys and order-item unique keys prevent a second stock deduction.