Shop MyLocal is an online marketplace for the liquor industry that is managed and maintained by Metcash. To join, please contact Metcash head office or your business development manager (BDM).
The setup for Shop MyLocal and Shopfront is a multi-stage process. First, you'll need to have your store setup on Shop MyLocal. Secondly you'll need to provide Metcash with a product file that contains a list of products that you intend to list on the marketplace. Thirdly you'll need to complete the Shopfront side of the integration.
Get Setup on Shop MyLocal
To have your store added to Shop MyLocal you'll need to contact Metcash or your BDM and let them know that you would like to integrate your Shopfront store with Shop MyLocal. They'll then ask for a product file out of Shopfront (see the next step) and provide you with the keys required to integrate the two systems.
Generate a Product File
Once Metcash requests a product file, you'll have to perform the first part of the integration with Shop MyLocal. Using an account with either no role or a role with the required permissions, you'll need to integrate the Shopfront - Shop MyLocal application into Shopfront.
The required permissions for the Shopfront - Shop MyLocal integration are currently:
- Modify Integrations,
- See Products,
- View Product,
- Create Products (for the internal Shop MyLocal delivery product),
- Edit Products (for the same product),
- Modify Payment Methods (for the internal Shop MyLocal payment method),
- Modify Settings (To create the Sell on Shop MyLocal toggle)
- See Webhooks,
- Create Webhooks,
- Perform Sales
To do this, on Shopfront open the Menu and go to Setup then Integrations
On this page you'll be displayed with a list of integrations, scroll down to the Shop MyLocal integration and press the blue Integrate button.
You'll then be redirected to the integration approval screen, select AUTHORIZE to continue.
After a moment, you'll be redirected back to the Shopfront integrations page. Scroll back down to the Shop MyLocal integration and press the green Settings button.
On the settings page you'll need to enable the Shop MyLocal application to access your data for each Outlet that you're integrating and fill in "test" for all fields. If you're on the Premium subscription you can also select a price set to use so you can use a different set of pricing for Shop MyLocal.
Once the outlets have been selected and the details filled in, press Save.
When the save has finished, you can now press Download Barcode File underneath each Outlet's settings to download the product file to provide to Metcash.
After you press the button, Shopfront will prepare the file in the background and you'll receive a notification once it has been completed which you can click on to download the file.
Once downloaded, you can disable the integration for each Outlet by toggling the Synchronise with Shop MyLocal to off and pressing save. After this has been completed, provide the file to Metcash for verification.
When Metcash has finished processing the barcode file you're ready to move on to the next step!
Finishing the Integration
Once you have been provided with an Application Key, Store ID and a Site ID you're ready to complete the integration between Shopfront and Shop MyLocal.
Navigate back to the Shop MyLocal settings (Menu > Setup > Integrations, scroll down to Shop MyLocal and then press the Settings button). Once there, enable the toggle labelled Synchronise with Shop MyLocal and fill in the details with those provided by Metcash (if you're using a separate price set, also select that). When all details are correct, press the Save button.
When the integration has finished saving, you'll need to press the Perform Full Product Synchronisation button to upload all of your products and prices to Shop MyLocal. This typically takes a couple of minutes to complete (you can leave the page as it will be completed in the background).
Now Shop MyLocal has been fully integrated with Shopfront and is ready to go, all product changes will automatically propagate to Shop MyLocal and you'll be able to handle invoices directly from the sell screen.