Shopify Private APP Setup

To setup the Mintsoft integration with Shopify - first you need the API Key & password for the store by generating a Private APP:

Shopify dashboard showing installed apps: Order Printer, Product Options by Bold, Urb-it; highlighted options to manage private apps and access apps.

Click create new private app, then enter mintsoft as the name.

Screenshot of the Shopify admin panel on the Apps page, showing options to discover apps to grow an online store, including Oberlo, Kit, Order Printer, and Product Reviews.

Enable Read / Write Access on Permissions

Please make sure you have enabled read / write access on all relevant permission areas.

Enable read / write on the top four groups of permissions, then click the option to review the disabled permissions.

Scroll down and make sure your permissions are set to read / write for all areas concerning:

  • Products

  • Customers

  • Inventory

  • Orders

  • Fulfilment (all types)

  • Locations (read only)


Then save the app - we will only use the password and API key from this page:

Shopify admin API configuration page with API key, password, and example URL.

Mintsoft Connect Setup - you will need to now speak to us directly about this as you may not have access to this on mintsoft


Now you can setup the connection in Mintsoft by navigating to Connect > Order Integrations > Shopify


You can set your order sync delay (frequency) in intervals of 15 minutes and also choose if stock sync is turned on and the delay for this as well.

A computer screen displaying a settings panel with options for managing stock sync in a Shopify channel, including delay times, toggle switches for active status and stock sync, and a last sync start date.

 Now you have to enter the API Key, Password and myshopify URL

HTTPS My Shopify URL

Please note you must make sure you enter the HTTPS My Shopify URL for the store followed by a slash at the end.

e.g. https://enterwebsitename.myshopify.com/

Screenshot of a settings page showing options for stock synchronization with toggle switches for enabling or disabling, and fields for URL, API key, and API password.

Set Shopify Location ID


Once you have setup the connection go over to the right hand side and hit the Get Location button:

 

A section of a data table with columns labeled for product sync status, URLs, Shopify location ID, and actions. The table contains one row with a URL linking to an online store, and action buttons including Edit, Delete, Property Mappings, Trigger Full Stock Sync, Set Location, Get Locations, Get Webhook URL, and Test Panel.

Then the list of Shopify Locations available is displayed, hit the set location button on the correct location to use:

A screenshot of a table with three rows, displaying address information for different locations. Each row has a 'Set Location' button on the right, with one button highlighted in red.

If the store has multiple locations and you arent sure which is the right one to use - you'll need to go to Shopify to find out which is the right one to set on our connection.

https://yourstore.myshopify.com/admin/settings/locations

Generally, the one titled Default is the correct one to use (but there may be cases where you would not use this):

Screenshot of a location management page showing three addresses: '9 Aquarium, 101 Lower Anchor Street' marked as Default, along with 'FactoryMaster Warehouse' and 'Manchester Warehouse'.

Dealing with Multiple Locations

If your Shopify store you are connecting to has multiple locations, and you only want to import orders for a single locations, please follow these steps;

1) Fulfilment Permissions
 
Please make sure all fulfilment permissions on the Shopify App have Read / Write set.

You may need to click the link to view disabled permissions to grant access to all fulfilment areas.

This includes:

Screenshot of a webpage with sections on fulfillment orders, services, and API access, including details on managed and third-party fulfillment orders, with a light blue information box about the Fulfillment Service API

2) Mintsoft Setup

On the Mintsoft connect setup to to the Advanced tab and toggle on these two options to use multiple locations and only import orders from the specified location ID:

Shopify admin settings page with 'Advanced' tab selected, showing options for multi-location inventory and order import preferences.

Using Webhooks

If you tick the option to use webhooks this will over-ride the stated delay periods and instead import orders directly from shopify when a notification is received of a successful order payment.

If you want to stop orders importing with webhooks you will need to contact support to remove the webhook connection from the account.

 

Cancellations - Enable Cancel Orders Webhooks

When using webhook its also possible to get cancallations from Shopify.

You need to make sure you have enabled statuses in Settings > Customer Account Settings > Default Tabs

Screenshot of a user interface with order status options, including 'Order Statuses that a Client raising a Query would move it to Query Raised,' 'Order Statuses that a Client can Edit a Order in,' and 'Order Statuses that a Client can Cancel a Order in,' with selected tags such as New, Invoiced, OnBackOrder, AwaitingPayment, and Cancel.

Otherwise it will raise an alert advising that the order has been cancelled in Shopify and needs stopping manually.

 

Sync Product Updates

It's possible to sync update to products from Shopify.

This is supported for a number of fields:

  • Barcode

  • Image

  • Weight (If Zero)

  • Price

  • Country Of Manufacture (Country Code of Origin)

  • Commodity Code (Harmonized system code)

 

Advanced Option - using multiple payment statuses

 

By default the connection will only import paid orders on Shopify, however you can change this by entering a list of payment statuses on the advanced tab.

 

Valid financial statuses are:

financial_status

 

  • authorized: Show only authorized orders

  • pending: Show only pending orders

  • paid: Show only paid orders

  • partially_paid: Show only partially paid orders

  • refunded: Show only refunded orders

  • voided: Show only voided orders

  • partially_refunded: Show only partially refunded orders

  • unpaid: Show authorized and partially paid orders.

 

You need to enter these as a comma list (remembering to include paid), e.g:

 

paid,pending,partially_paid,authorized,partially_refunded

Shopify account settings page with 'Advanced' tab selected, showing order status options including paid, pending, partially paid, authorized, partially refunded.