This article explains how to integrate Shopify with Mintsoft for order management and stock synchronisation.
What the Integration Offers
The Shopify integration provides:
Order synchronisation from Shopify to Mintsoft.
Stock and product synchronisation from Mintsoft to Shopify.
Despatch updates including status and tracking information.
Property mappings for gift messages and personalisation.
Prerequisites
Before setting up the integration, ensure you meet these requirements:
Your Shopify store must be live to authenticate the API.
Your store cannot be password protected as Mintsoft cannot connect to protected stores.
You need appropriate user permissions (see User Access Requirements below).
User Access Requirements
For Warehouse Users: You can directly authorise the Shopify integration.
For 3PL Client Users: You must be filtered by a warehouse on Mintsoft before installing the Shopify app.
Alternative Access Methods
If your 3PL client prefers not to provide full store access:
They can add you as a Collaborator Account on Shopify.
You can provide Impersonation Rights on Mintsoft for temporary third-party access.
Setting Up Your First Shopify Connection
Use this method when connecting a Shopify store to Mintsoft for the first time.
Log in to your Shopify store.
Go to the Shopify App Store.
Search for Mintsoft.
Click Install App.
Accept the permissions when prompted.
You will be redirected to Mintsoft to log in with your warehouse credentials.
After logging in, you'll see the Shopify page within Mintsoft with the URL field automatically populated.
Configure your connection settings using the Configuration Options section below.
Set the connection to Active when ready.
Click Save.
Adding Additional Connections to Existing Store
Use this method when adding another connection to a Shopify store that already has a Mintsoft connection.
In Mintsoft, click Connect then Order Integrations.
Click Shopify.
Find your Shopify store and click Add Additional Connection.
The URL field will be automatically populated.
Configure your connection settings using the Configuration Options section below.
Set the connection to Active when ready.
Click Save.
Configuration Options
Configure these settings to customise how your integration works:
Basic Settings
Client (3PL Only): Select the client this connection relates to.
Warehouse: Choose the warehouse for this integration.
Channel: Select which channel to import orders through.
Order Prefix: Add a prefix to order numbers imported from Shopify.
Active: Toggle this on to enable order and stock synchronisation.
Order Import Settings
Order Import Sync Frequency (Minutes): Set how often Mintsoft checks Shopify for new orders.
Order Import Delay (Minutes): Set a delay between when an order is placed on Shopify and when Mintsoft imports it. This allows other Shopify apps (like Recharge) time to update orders before import. The Order Import Delay works alongside the Sync Frequency. For example, with a 15-minute sync frequency and 10-minute delay, orders will appear in Mintsoft between 10-25 minutes after being placed on Shopify.
Number of Days to Check Back from Orders: Set how far back Mintsoft should look for orders. We recommend -7 days.
Attempt to Import Partial Fulfilled Orders: Enable this to import orders that have been partially fulfilled in Shopify. This is useful when Shopify has shipped some items directly and you need to fulfil the remaining items through Mintsoft.
Stock Synchronisation Settings
Stock Sync: Enable this to sync on-hand stock quantities back to Shopify.
Stock Sync Frequency (Minutes): Set how often stock levels sync to Shopify.
Product Synchronisation Settings
Note: Initial sync cycles can take up to 30 minutes when first enabled.
Sync New Products: Enable this to import new Shopify products into Mintsoft.
Sync Product Updates: Enable this to sync product changes from Shopify to Mintsoft.
Product Sync Frequency (Hours): Set how often to check for new products on Shopify.
Only Download Published Products in Sync: Enable this to import only published products from Shopify. This controls product visibility in the storefront.
Only Sync Active Products (Exclude Draft): Enable this to only sync stock for active products, excluding draft products. This differs from 'Only Download Published Products' which controls product visibility in the storefront, while this setting controls the product's lifecycle status.
Technical Settings
URL: Your MyShopify URL (automatically populated during setup).
API Version: Always select the latest available version from the dropdown. The format is YYYY-MM (such as 2025-01 represents January 2025). Using the latest version ensures access to the newest features and security updates.
Despatch Update Frequency (Minutes): Set the delay for dispatch updates synchronising back to Shopify.
Important: The following fields are for legacy private or custom app integrations only and should not be used for new setups. New connections must use the public app method.
Custom App Key: Legacy authentication field (obsolete).
API Key: Legacy authentication field (obsolete).
API Password: Legacy authentication field (obsolete).
Webhook settings
Use Webhooks: Enable this to import orders immediately when they reach the correct status, bypassing the Order Import Delay. Webhooks are not supported when using a Custom App.
Enable Cancel Orders Webhook: Enable this to receive order cancellation requests from Shopify into Mintsoft automatically.
Location settings
Shopify Location ID: The Shopify location where stock and orders are managed (set during initial setup).
Only Import Countries in Selected Shipping Zone: Orders will only import if the delivery country matches one of the countries in the selected Shipping Zone. Leave blank to import orders from all countries.
Point of sale settings
Courier Service To Import POS Orders As: Specifies which courier service to assign to POS (Point of Sale) orders when they're imported. Required when Enable POS Order Import is turned on.
Enable POS Order Import: Enable this to import Shopify POS orders (in-store orders) that may not have delivery address details.
Note mapping
Note Mapping Field: Select which Mintsoft field should receive notes from Shopify orders. Options are: Packing Notes, Gift Messages, or Delivery Notes.
For complete configuration options, see our Understanding the Connector guide.
Setting Your Location
After authorising the connection, you must set a location to complete the integration.
In Mintsoft, click Connect then Order Integrations.
Click Shopify.
Click Get Location next to your newly created connection.
Click Set Location.
Choose the location where you'll manage stock and orders.
Click Edit next to your connection.
Set Active to ON.
Click Update.
Managing Multiple Locations
To import orders from a specific Shopify location:
Click Connect then Order Integrations.
Click Shopify.
Click Edit next to the connection you want to update.
Click the Advanced tab.
Set Only Import Orders Fulfilled from LocationId to ON.
Click Update.
Status information
When viewing an existing connection, you'll see these read-only fields that help monitor integration health:
Last Run: When the despatch update job last ran.
Last Product Sync: When products were last synchronised from Shopify.
Last Stock Sync Run: When stock levels were last sent to Shopify.
Last Stock Sync Run Start: When the stock sync job started.
Order Import Count: Total number of orders imported through this connection.
Last Order Import Sync: When the order import job last ran.
These timestamps are useful for troubleshooting if orders or stock updates aren't appearing as expected.
Frequently Asked Questions
Can we integrate with Shopify using a private or custom app? No. Mintsoft only supports integration through the public app method as required by Shopify's partner requirements.
Can I get temporary Shopify access to install the Mintsoft app? Yes. Ask your client to provide a Collaborator Account on Shopify for temporary access without full store permissions.
Can I provide temporary access to Mintsoft? Yes. You can provide Impersonation Rights on Mintsoft for temporary third-party access.
Can a single Shopify store be connected to multiple Mintsoft clients? No. A single Shopify store can only be integrated with one Mintsoft client record.
Is it possible to create multiple connections for the same Shopify store under one Mintsoft client? Yes. Multiple connections are allowed as long as they stay within the same Mintsoft client record.