Skip to main content

Troubleshoot stock not syncing with sales channels

Steps to diagnose and fix stock level discrepancies between Mintsoft and connected sales channels such as Shopify, eBay, Amazon, and Unleashed.

Written by Tom Higgs

Stock levels may not update correctly between Mintsoft and your connected sales channels for a number of reasons. This guide covers the most common causes and how to diagnose them. You will need access to your channel connection settings in Mintsoft and the ability to view product details. For Shopify-specific steps, see Shopify Troubleshooting.


Check for sync errors

When stock or orders fail to sync, Mintsoft logs the reason on the Import Errors screen. Reviewing these first will usually identify the cause.

  1. Click Connect then Errors.

  2. Review any errors shown for your channel. Common error types include UnableToFindProduct (SKU mismatch) and authentication failures.

  3. Resolve each error using the steps in Integrations - Import Errors, then allow the channel to re-sync.


Verify SKU matching

Stock updates only sync when the SKU in Mintsoft exactly matches the product identifier used by the sales channel. A single character difference — including capitalisation — will prevent the sync from matching products correctly.

  1. Click Products then Overview.

  2. Find the affected product and note the exact SKU shown.

  3. Compare this against the product identifier used on your sales channel. They must match exactly.

  4. Update either the Mintsoft SKU or the channel listing to resolve any discrepancy. Note that changing a SKU in Mintsoft may affect existing orders and integrations.


Check the channel connection is active

An expired or broken connection will prevent all stock updates from syncing to that channel.

  1. Click Connect in Mintsoft and select your sales channel.

  2. Check whether the connection shows an error or expired status.

  3. If credentials have expired, re-enter them or follow the re-authentication steps for your channel.

Note: For Shopify, token expiry and permission changes are a common cause of connection failures. See Shopify Troubleshooting for steps to reconnect.


Check warehouse and client scope (3PL accounts)

Note: For 3PL accounts, stock sync is scoped by client. Ensure the correct client is selected on the channel integration. Stock booked against one client will not sync to a channel configured for a different client.

If the steps above do not resolve the discrepancy, contact the Mintsoft support team or raise a support ticket with details of the affected channel, the SKU(s) involved, and any error messages shown on the Import Errors screen.

Did this answer your question?