Skip to main content

Shopify Integration

Tom Higgs avatar
Written by Tom Higgs
Updated over a month ago

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:


Setting Up Your First Shopify Connection

Use this method when connecting a Shopify store to Mintsoft for the first time.

  1. Log in to your Shopify store.

  2. Go to the Shopify App Store.

  3. Search for Mintsoft.

  4. Click Install App.

  5. Accept the permissions when prompted.

  6. You will be redirected to Mintsoft to log in with your warehouse credentials.

  7. After logging in, you'll see the Shopify page within Mintsoft with the URL field automatically populated.

  8. Configure your connection settings using the Configuration Options section below.

  9. Set the connection to Active when ready.

  10. 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.

  1. In Mintsoft, click Connect then Order Integrations.

  2. Click Shopify.

  3. Find your Shopify store and click View Integrations.

  4. Click Add Account.

  5. The URL field will be automatically populated.

  6. Configure your connection settings using the Configuration Options section below.

  7. Set the connection to Active when ready.

  8. 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.

  • 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 partially fulfilled orders into 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

  • Sync New Products: Enable this to import new Shopify products into Mintsoft. [Note: Initial cycle can take up to 30 minutes when first enabled].

  • 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.

Technical Settings

  • URL: Your MyShopify URL (automatically populated during setup).

  • API Version: Ensure you're using the latest version (2025-01).

  • Despatch Update Frequency (Minutes): Set the delay for dispatch updates synchronising back to Shopify.

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:

  1. In Mintsoft, click Connect then Order Integrations.

  2. Click Shopify.

  3. Click Get Location next to your newly created connection.

  4. Click Set Location.

  5. Choose the location where you'll manage stock and orders.

  6. Click Edit next to your connection.

  7. Set Active to ON.

  8. Click Update.

Managing Multiple Locations

To import orders from a specific Shopify location:

  1. Click Connect then Order Integrations.

  2. Click Shopify.

  3. Click Edit next to the connection you want to update.

  4. Click the Advanced tab.

  5. Set Only Import Orders Fulfilled from LocationId to ON.

  6. Click Update.


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.

Did this answer your question?