Mirakl marketplace (general) channel integration is one, big integration that supports almost every single marketplace under Mirakl. By saying almost every, we mean that Mirakl gets new marketplaces every single day and we are trying to implement them as soon as possible!
This topic will cover the process of configuration and the full launch of the integration.
Channel integration configuration is split into two different parts:
The account part is used for configuration & connection to your marketplace. The first step is to select your marketplace under the marketplace list (pic 1.). If you are unable to find one you are using and want to integrate, you can also type in the marketplace link yourself (for example https://digikey-prod.mirakl.net) (pic 2.). Below that you are required to type in the API key to connect the integration to your Mirakl marketplace API (pic 3.).
And this is how we get a copy of our API token. This is very important to mention, that having more than one user under the store in your Mirakl marketplace, will result in everyone having their own, automatically generated API tokens. This means that different API tokens will have different permissions, to different features. Only the owner of the store can add and revoke permissions, and because of that, we highly recommend using the token of the store’s owner.
After having our API token copied, marketplace selected/typed in, we are ready to finish our installation. Every single point of the integration has an explanation question mark next to them, which could consult you on what is what, for faster Q&A. And at the end of the day, your installation settings should look like this:
Order subsection has a few major options that every single owner should consider. Usually, it might take a few days in order for the order to be checked for fraud check. Due to the order synchronization date in Linnworks always moving forward, you might want to set your synchronization date a few days back, to make sure you are not missing any orders that were late on the fraud check. This order synchronization date range comes in days (for example from 1 day to 365 days, if you feel like you might need that many).
When Linnworks receives an order from Mirakl, first it has to be accepted in the Mirakl marketplace. Without accepting the order, the order will not be approved and it will not have any information about it except for the ordered item. We implemented an option to automatically accept the order for you, so it will immediately be transferred to Linnworks.
Since most of the Mirakl marketplaces give an option to specify the entrance/floor/etc.etc. for delivery, we implemented that feature to go on the shipping label, so that the courier would have it easier to understand where to deliver the package, instead of contacting the customer. This information will go as Address Line 3.
By default, our integration leaves the job to Linnworks to calculate the VAT taxes. If you have your VAT set in your marketplace and you would like Mirakl marketplace to calculate it instead of Linnworks, you need to let integration know of that, by ticking the checkbox.
Since Linnworks does not have good cooperation with external payment plans, after subscribing to the application you are offered to upgrade your payment plan manually.
Since payment plan updating happens two to three times a day automatically, you might miss the moment and it might not be updated. We strongly suggest you do it manually, so you would instantly be allowed to use all the application’s features without having to wait!
If you would like to update Discount Price instead of Retail Price in your marketplace, you are required to select the checkbox.
Please keep in mind that this will update ONLY the discount price, but not the retail price. The discount price has no start and no end date, which means that the set discount price will be permanent and not dated. The said discount price has to be always lower than the set retail price. If both prices are the same or the Discount Price is higher than the retail Price, the Discount Price will be set one cent lower than the retail price. It is important that both of the checkboxes would be marked, otherwise, neither the retail nor discount prices will be sent.
Once the integration is installed and everything has been set up, it means it has to be tested and enabled. This testing will run through the integration and check for any errors. The errors are named and will always tell you what is wrong, for example, the API token is incorrect, the marketplace’s API is offline and etc. To run the test, you should simply open the configuration page and press the button.
If the integration’s configuration and installation went without any issues and everything was done accordingly, you should see a pop-up that says:
After that, you are fully ready to start downloading the inventory for mapping, enable inventory level and price sync and download your merchant orders! Congratulations!