This guide provides solutions for common issues related to the Shopify integration with Mintsoft. It is divided into the following sections:
Connection Issues
Permission Errors
Dispatch Issues
Product/ Stock Sync Problems
Order Import Issues
Connection Issues
Connection Not Working or Disconnecting
If your Shopify connection is not working (e.g., orders not importing, stock not syncing), check the following:
Connection Disconnecting or Unauthorized
If the connection is inactive, disconnecting frequently, or orders are not importing, follow these steps:
Click Connect, then Order Integrations.
Select Shopify.
Locate the connection and click Disconnect.
Log in to your Shopify store.
Go to the Shopify App Store and search for Mintsoft.
Click Uninstall App, then Install App.
Accept the permissions.
You will be redirected to Mintsoft to log in with your Warehouse credentials.
Make the connection Active and click Update.
Check URL Format
Ensure you are using the correct Shopify URL with a trailing slash, e.g., https://mystore.myshopify.com/. Verify there are no leading or trailing spaces in the Shopify Connection settings within Mintsoft.
Confirm Store is Live
Ensure that your Shopify store is active and not in Paused (On Holiday) mode. Mintsoft can only connect to live stores.
Permission Errors
Shopify Missing Permissions
If you receive errors about the app not having the necessary permissions, ensure you have integrated Shopify using the Mintsoft App method. Shopify integration no longer requires manual permission configuration.
Unauthorised
If you receive the error Unauthorised You do not have sufficient privileges for this operation, if you believe this to be incorrect please contact the Administrator when trying to access your Shopify connection on Mintsoft, ensure that the Warehouse User Account has the appropriate Connect role within the Group-Connect role group for the integration (e.g., Connect-Shopify, Connect-Amazon). If you believe this is incorrect, please contact your Administrator.
Dispatch Issues
Tracking Number Not Syncing to Shopify
If tracking numbers are not synchronising from Mintsoft to Shopify, follow these steps:
Click Shipping Management, then Couriers.
Locate the courier and click Manage Courier Services.
Click Edit for the affected service.
Enter the Tracking URL.
Click Update.
Dispatch or Fulfilment Status Not Updating
Ensure you have integrated Shopify using the Mintsoft App method.
Unable to Dispatch Orders
If you cannot dispatch orders, check the following:
Location ID
Ensure the location in Mintsoft matches the Shopify order location:
Click Connect, then Order Integrations.
Select Shopify and click Get Locations.
Verify that the location name matches the one in Shopify.
Order Changes Post-Import
If an order’s item quantity was changed after being imported into Mintsoft, it must be manually dispatched in Shopify.
Shopify orders shipping with Global-E
Due to a recent change in Shopify, Global-E shipments will be sending a dynamic value when importing orders to Mintsoft. Previously we were able to use Courier Service Mapping, but this cannot be used as we require a static value, and it will now be sending a dynamic value.
You will need to use Courier Service Selection instead to map the orders to Global-E, more information can be found in our Courier Service Selection help guide.
Product/ Stock Sync Problems
Stock syncing problems often arise due to delays or slow updates, SKU mismatches, or configuration setup errors between Mintsoft and Shopify. To optimize initial setup between Mintsoft and Shopify, it is advised to temporarily disable stock sync to avoid disruptions, sync products accurately, and align stock levels before activating the integration.
Location ID
Ensure the correct Location ID is set in Mintsoft’s Shopify connection settings.
Trigger Full Stock Sync
To manually realign stock figures:
Click Connect, then Order Integrations.
Select Shopify.
Locate the connection and click Trigger Full Stock Sync.
Once triggered this can take up to 30 minutes to update on the Shopify store.
Meta Fields
Avoid using more than five meta fields for products in Shopify, as excessive meta fields can cause syncing issues.
Inventory Tracking
Ensure Inventory Tracking is enabled on Shopify. If it was not enabled when the product was first created, stock syncing may not work.
Live Store Requirement
Stock sync only works with active Shopify stores.
Sales Channel Settings
Ensure that Online Store is selected as one of the Shopify Sales Channels.
Stock Changes Syncing from Mintsoft
Stock changes only synchronise from Mintsoft to Shopify, not the other way around.
If inventory levels change in Shopify manually, they may become out of sync.
If refunds/restocking are processed in Shopify without adjustments in Mintsoft, stock levels may be incorrect.
Why is stock being added to Shopify?
This is caused by the stock sync delay for the channel being too quick for our standard stock sync to keep up. To resolve this, increase the delay or toggle on to use webhooks for orders.
Go to Connect then Order Integrations
Click Shopify
Edit the connection you are having issues with
On the Stock Sync Delay field change the default 15 to 30 or 60
Additionally, lowering the product sync frequency to under 1 hour can help maintain more consistent stock updates.
Note: The delay is in minutes, set to 30 but it may need to change to 60 depending on the store.
Alternatively, you could set up the Shopify Integration to use webhooks.Webhooks enable real-time order updates, providing a faster and more reliable synchronization option than time-based syncing.
Re-Stocking After Refunds
Restocking items in Shopify after a refund may double add stock if a return was also processed in Mintsoft.
Linked Warehouse
Ensure the warehouse selected in Mintsoft’s connection settings is the correct one containing the stock.
Tips to Improve Stock Sync Efficiency
Adjust product sync frequency to under 1 hour for faster updates.
Use webhooks to ensure real-time synchronization for orders and stock changes.
Regularly verify SKU matching and inventory tracking settings across platforms.
Alternative Codes on Products
If stock is still not syncing:
Go to the product in Mintsoft.
Click Actions, then Edit.
Click Alternative Codes.
If an ALT Code has the type Shopify-Unprocessable, delete it.
Stock should sync in the next cycle.
Products Importing from Different Fulfilment Location
If products (SKUs) imported from Shopify are designated for fulfillment from a different location than the one set in Mintsoft, they should be configured as DropShip Products in Mintsoft. Occasionally, these products may be imported with orders, even if you do not fulfill them. Setting them as dropship products ensures Mintsoft will ignore them.
Order Import Issues
If Shopify orders are not importing into Mintsoft, check the following:
Order Payment Status
By default, Mintsoft only imports orders in Paid status.
Orders in Payment Pending will not import unless configured otherwise.
Orders marked as Fulfilled in Shopify will not import.
SKU Matching
All SKUs in Shopify must match those in Mintsoft exactly (case-sensitive), or the order will not import.
API Rate Limit Errors
If you receive an import error stating Exceeded 2 calls per second for API client, Shopify’s REST Admin API allows:
40 requests per app per store per minute.
2 requests per second.
Shopify Plus stores have a higher rate limit.
Country Not Found Error
Ensure that:
The shipping address in Shopify is correct.
The country exists in Mintsoft’s Country Mapping.
Once confirmed, resolve the import error and allow the order to import in the next sync cycle.
401 Unauthorized Error
If you see the following error 401 Unauthorized when attempting to get new orders, your Shopify account may be deactivated. Contact Shopify Support for assistance.
Orders Importing from Incorrect Locations
To ensure orders import from the correct location:
Click Connect, then Order Integrations.
Select Shopify.
Locate the account and click Edit.
Go to the Advanced Tab.
Enable Only Import Orders Fulfilled from LocationId.
Fraud Orders
If Shopify orders are imported as FRAUDRISK into Mintsoft, you have two options:
Accept the order, which removes the fraud risk, and proceed with fulfillment in Mintsoft.
Cancel and delete the order from Mintsoft if you choose not to fulfill it.
Note: Using webhooks will cause fraud-risk orders to be imported as NEW into Mintsoft before Shopify completes its fraud check.
To accept the fraud risk of an order in Mintsoft:
Click Orders then Overview.
Search for the Order.
Tick the order.
Select Mark Fraud Risk Accepted from the Bulk Actions drop down.
Finally, click Go.
Orders Not Coming into Mintsoft
If an order is missing from Mintsoft and has not imported from Shopify:
In Shopify, go to Settings then Checkout Settings.
Ensure Do not automatically fulfill any of the order’s line items is selected.
Click Save.
Missing Customer Information
If imported orders are missing customer details (e.g., name, address replaced with periods), ensure that:
The correct Mintsoft App version is installed.
The Custom App method is no longer used.
Restricting Order Imports based on Shipping Zone
To restrict orders from importing from Shopify into Mintsoft, you can create a Shipping Zone to only import orders from countries you fulfil for. To set this up, please follow the steps below:
Firstly, create a Shipping Zone including the countries you want to fulfil for.
Next, click Connect then Order Integrations.
Click Shopify.
Click Edit on the affected connection.
Scroll down to Only Import Countries in Selected Shipping Zone.
Select the Shipping Zone.
Click Update.