Sync troubleshooting

Stokk syncs from your ERP on a schedule. Most discrepancies come from timing, mapping, or a sync that failed silently. Start here.

Check sync status

Admin → Sync Status shows the last run for each sync type (products, locations, sales, stock, etc.) with a timestamp and record count. A red row means the last attempt failed — click it for the error.

Common issues

Stokk stock doesn't match ERP stock

• Stock syncs run at a fixed time. Movements after that time won't be reflected until the next run.
• A SKU exists in the ERP but doesn't have a row in Stokk's products table — usually because it was created after the last products sync.

Sales aren't appearing in the forecast

• Sales sync only pulls completed transactions. Open or held tickets won't count.
• The forecast pass runs once per day. New sales don't change the forecast until the next nightly run.

A supplier or location is missing

• Verify the master record exists and is active in the ERP.
• Check that suppliers/locations sync successfully on the Sync Status page.

Forcing a manual sync

Company admins can trigger an out-of-band sync from Admin → Integrations. Use this sparingly — full syncs are heavy and rate-limited by the ERP.