Step 1: Add a new Manor connection
The Manor API uses the Mirakl platform, which means you will need a Mirakl account to start sending your product listings to Manor.
When you have a Mirakl Manor account, go to "Connections > Add connection". Click on "+ Add a new connection" and you will see a screen, where you can select Manor. Fill in the label for your connection, for example: Manor. And then click on ''Connect with Manor''. You will be redirected to the environment where you can log in with your Mirakl-credentials. After logging in, you will be redirected back to Channable where the connection will be available.
Step 2: Create a new Manor API in Channable
Now go to the API's overview, in your project. And click on "+ Add new API", select the Manor connection you just made and give your new API a name.
Select the field you want to use for Unique ID per item (we recommend the 'id' field), and the Language. You will need to select which language you would like to use for the API as Switzerland has 3 official languages to choose from (German, French and Italian). After choosing a name, click on the "Continue" button to create your new Manor API.
Step 3: Create your product listings in Channable
Once you have created the Manor API, you can set up your product data by following the steps of the API.
-
Categories
For your product listings to be created, your products need a category. Add categories to your products by using the generate categories feature, or create new categories from scratch.
-
Rules
Create different rules to optimize your products listings. For examples, take a look at our common rules support article.
-
Build
Here you can find our preset template for the product listings. All you have to do is to fill it out by clicking on the field itself and selecting what you would like to go in there. For example, the field 'Price' should display the price of your product and so on. When you have finished setting up the product listings, just click 'save' at the bottom of the screen.
Tip! Notice the question mark behind every field, if you hover over it you will see the description of the field and suggestions for possible values. -
Attributes
Almost done! Next up is filling in the fields in the Attributes step. Select the category you want to optimize first. An example of what should be in front of you now can be seen in the screenshot below. A more detailed explanation of what to do in the Attributes step can be found in our Attributes support article.
Step 4: Send your product data to Manor
Almost there, your product listings are ready to be sent. If you have not activated your project, go to your project settings on the left-hand side of the screen and click 'activate project'. After, go back to the APIs overview and go to "Your Manor API Name" > Settings, where you activate the API by selecting "Activate API". After you have completed this step, navigate back to the APIs overview and select the blue "Run now" button to send your product listings to Manor.
Step 5: Check your product listings for errors
If you have sent your product listings to Manor, go to the Preview tab of your Manor API. Click/filter on 'error'. Now you can see which product listings have errors and are not created in Manor. Click on a specific error to see more information.
Best practices
Adding multiple attribute values: when adding multiple values in an attribute field for Mirakl Marketplaces, separate each value with a pipe symbol "|" to ensure proper detection and processing.
Seller's Product ID for Single/simple products: Please note that there are two attributes named 'SellerArticleId' and 'SellerProductId,' respectively. 'SellerProductId' refers to the Parent ID, while 'SellerArticleId' refers to the variant items. For single products, both attributes must be filled with the same value.
For more information on Mirakl Marketplace errors, how-to's, and best practices, check out our dedicated guide. Click here to read more.