Configuring Settings in the Integration Management Portal for Shopify

Applies to:

Sellers on Shopify

Overview:

Source service:

• Transmits product and offer information to the Destination
• Receives order information from the Destination

Destination service:

• Receives product and offer information from the Source
• Transmits order information to the Source

 

For Sellers on Shopify, the following set up is required.

After selecting your services and clicking next, you will be prompted to confirm the import dates for:

• Products from Shopify
• Orders from Westfield online
• Orders from Shopify (Order updates such as an order being fulfilled, refunded, or cancelled in Shopify)

If you are new to Westfield online, please leave the dates and settings already populated as this will pull in all products and orders from the date you have created the Services.

If you are already selling on Westfield online you may want to nominate a date to pull in open orders. This can be useful if you are migrating to Shopify from another eCommerce platform.

 

You will then be prompted to Confirm & Save the settings.

 

Connecting Your Shopify Store to the Integration Management Portal

In order for products, offers and orders to flow between Shopify and Mirakl. You will need to connect both your Shopify store and Mirakl Store with the Integration Management Portal, as it is the intermediary between both services. Before proceeding, you will need to Create a Custom App in Shopify and obtain your API credentials. You will use these credentials to connect your Shopify store to the Integration Management Portal.

Rundown

Once you have your API credentials, you will then navigate to the Settings section in the Integration Management Portal. 

 

 

Shopify Credentials

In Settings, under Credentials you will have two collapsible panels. The first panel will be the Source service you selected previously. 

Please complete each field as follows:

Url - Your Shopify store URL (excluding anything after .com/)

API Secret Key: Your API Secret Key from Shopify

Shop Currency: The currency used for your pricing

App Type: Your Shopify App Type will be Custom App, as Shopify has deprecated Private App in 2021.

Admin API Access Token: Your Admin API Access Token from Shopify

 

Westfield online Credentials

 

 

Store ID	The ID of your Mirakl store
Enable stock location Mappings	This is used if you have multiple stock locations on Shopify and would wish to fulfil from different locations.  This does not apply to most retailers who only fulfil from Distribution Centre.   A distribution centre is any location that is not within a Westfield Centre.
Enable Price Buffer	Enable the options to alter pricing
Price Buffer Type	Choose whether to increase or discount pricing on Westfield
Price Buffer Measure	Choose whether to adjust your pricing by a Percentage (%) or Dollar ($)
Price Buffer	Dollar amount or percentage of the increase
Price Buffer Threshold ($)	Use this if you would only like to apply the price buffer above or below a certain threshold. Price Buffer Type "Increase" will only apply to prices below this threshold. Price Buffer Type "Discount" will only apply to prices above this threshold.

 

Connecting Your Mirakl Store to the Integration Management Portal

In order for products, offers and orders to flow between Shopify and Mirakl. You will need to connect both your Shopify store and Mirakl Store with the Integration Management Portal, as it is the intermediary between both services.

Before proceeding, you will need to Create your Mirakl Store and ensure that you are able to successfully login to Mirakl. You will use these credentials to connect your Shopify store to the Integration Management Portal.

Rundown

Once you have your confirmed you have access to your Mirakl account, you will then navigate to the Settings section in the Integration Management Portal. 

 

In Settings, under Credentials you will have two collapsible panels. The second panel will be the Destination service you selected previously. 

If you have more than one Mirakl store, then enter the appropriate Mirakl Store ID in the Credentials page. Otherwise, click the "Sign in with Mirakl" button.

In the new login.mirakl.net window that opens, sign-in using your Mirakl username and password. 

You will then be redirected to another log-in screen which will take you back to the Integration Management Portal. Please use your username and password for the Integration Management Portal.

 

Configuring Your Product Sync Settings

The Integration Management Portal gives you online control of the Product Sync between your Shopify store and your Mirakl store. In practice, this means that you could enable the flow of product information from your Shopify Store to your Mirakl store, whilst keeping disabled the flow of offers (Price and Stock) from your Shopify store and your Mirakl store. You also have the option of enabling or disabling specific syncs for Stock or Price. New and updated products are being imported from Shopify every 10 minutes, and synced to Westfield online.

Rundown

Once you have your confirmed credentials, you will then navigate to the Settings section in the Integration Management Portal.

In Settings, under Products you will have two collapsible panels. The first panel is the Source Service (Shopify) Product Sync Settings whilst the second panel is the Destination (Westfield online) Product Sync Settings. Each panel has a toggle button indicating the sync status. In the example below, you can see Products Sync for Shopify is Active, whilst for Westfield online it is Not Active. You can toggle each setting using the sliders on the right-hand side.

The options below outline possible combinations of Shopify and Westfield online Sync toggle settings, and the expected behaviour of each configuration.

 

Option 1: Products Sync for Shopify is Active, whilst for Westfield online it is Not Active. Product data will be imported from Shopify to the Integration Management Portal, but will not publish to Westfield online.

Note: This configuration should be used during initial integration set-up and mapping, as it will allow you to complete the product mapping before you send the products to Mirakl. Otherwise products will error on import with "1004|The category could not be identified" as you have not yet mapped your source categories with the corresponding Mirakl category.

 

 

Option 2: Products Sync for Shopify is Active, and Westfield online is also Active. Product data imported from Shopify to the Integration Management Portal, then synced to Westfield online. This will send valid product offer data to Westfield online. These will generally be your "live" settings.

 

 

Option 3: Products Sync for Shopify is Not Active, and Westfield online is also Not Active. Product data will not be imported from Shopify to the Integration Management Portal, and any existing data in the portal will not be synced to Westfield online. This is the default configuration prior to any set-up and will be useful if you want to suspend any syncs between your Shopify Store and your Mirakl Store.

 

 

Option 4: Products Sync for Shopify is Not Active, whilst Westfield online is Active. Product data will not be imported or updated from Shopify to the Integration Management Portal, but any existing valid product data in the Integration Management Portal, will be synced to Westfield online. This may be useful if you are making changes to your Shopify store that you do not yet want to update in your Mirakl store e.g. such when enriching data in Shopify and not wanting any partial changes to flow through until all changes have been made.

 

 

Product Sync Settings for Shopify

 

Pull Location Inventory Levels	If enabled, this will import stock information across all your Shopify inventory locations, for all products and variants. This should only be enabled if you have multiple stock locations and are doing stock location mapping, as it is a heavy operation. For most Sellers fulfilling from their Distribution Centre, this setting will not be necessary.
Use Metafields for Mappings	If enabled, this will make your imported Metafields available during Attribute Mapping. For most Sellers who do not use Shopify Metafields, this setting will not be necessary.

 

Product Sync Settings for Westfield online

Product Sync Flags	Each listed field can be toggled individually. If enabled, the field will be synced to Westfield online. For example, if a custom pricing list has been manually imported to Westfield online, you could toggle Price to be OFF, preventing any pricing from Shopify being synced to Westfield online. For most Sellers, this setting will not be necessary, and all syncs should be toggled ON.
Stock Buffer	Because you might not always want to allocate 100% of your inventory to Westfield online, the Integration Management Portal offers a Stock Buffer functionality. For these instances, the Stock Buffer functionality lets you subtract a set quantity from the Inventory Quantity that is synced with Westfield online. For example, if: Shopify Inventory Quantity is 4, and Stock Buffer is 3, then Quantity of 1 is available on Westfield online
Add GST to Prices	Enable this to add GST to your prices.  Only enable this if your prices do not already include GST and require GST

 

Image Mappings Settings

The Image Mappings section of the Westfield online panel allows you to specify a Mirakl Image Mapping (left) for each Shopify Image Source (right). By default, Variant Image 1 from Shopify is mapped to Image 1 in Mirakl and Product Image 1 in Shopify is mapped to Mirakl Image 2, and so forth. For most Sellers, these settings will not need to be changed. However, if you wish to change these then you may do so by mapping the desired image in Shopify with the corresponding Image location in Mirakl. These are a one-to-one mapping relationship, aside from the case of Variant Image 1 (*Product Image 1). Selecting Variant Image 1 (*Product Image 1) will conditionally map Variant Image 1 with a fallback to Product Image 1 if no variant image is available. 

 

Configuring Your Order Sync Settings

The Integration Management Portal gives you online control of the Order Sync between your Shopify store and your Mirakl store. In practice, this means that you could enable the flow of product information from your Shopify Store to your Mirakl store, whilst keeping disabled the flow of orders from your Mirakl store to your Mirakl store. 

New orders are being imported from Westfield online every 10 minutes and created on Shopify.

Order updates made on Shopify will then be polled for every 10 minutes and synced to Westfield online.

Rundown

Once you have your confirmed credentials, you will then navigate to the Settings section in the Integration Management Portal.

In Settings, under Orders you will have two collapsible panels. The first panel is the Source Service (Shopify) Order Sync Settings whilst the second panel is the Destination (Westfield online) Order Sync Settings. Each panel has a toggle button indicating the sync status. In the example below, you can see Order Sync for Shopify is Not Active, and Order Sync for Westfield online it is Not Active. This means that orders are not being pulled from/pushed to Mirakl or pulled from/pushed to Shopify. You can toggle each setting using the sliders on the right-hand side. This is useful for initial integration set-up and mapping.

 

 

Shopify Order Sync Settings

Sync Order Number

If enabled, the order number from Westfield online will be used as the order number in Shopify

 

Westfield online Order Sync Settings

Default Order Origin	A default order origin for new orders. i.e. Distribution-Centre or a Westfield Location (Bondi-Junction, Chatswood, Hornsby, etc). For most Sellers fulfilling from a Distribution-Centre, this should be set to Distribution-Centre.
Auto Accept Orders	If enabled, orders are automatically accepted. If disabled, then any orders which are not successfully created in Shopify will be automatically rejected after 24 hours (e.g. because the is no inventory in Shopify).