Setting up a Manor API

Manor (Mirakl) — Setup guide

UI update: There is a new channel selection page and overview for Feeds and Marketplaces (previously called APIs)! Some visuals and instructions may not be up-to-date.

Important: EAN codes are mandatory for Manor. Make sure you have valid EAN codes for all your products, otherwise no product listings can be created for your products.

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), 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.

2

Create a new Manor API in Channable

Go to the APIs overview in your project. Click on "+ Add new API", select the Manor connection you just created 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.

3

Create your product listings in Channable

Once you have created the Manor API, set up your product data by following the steps of the API.

1

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.

2

Rules

Create different rules to optimize your products listings.

3

Build - Shared attributes

Shared attributes are attributes that apply across all your items, like price and stock.

1. Start by mapping fields to attributes marked as required by the marketplace.

2. Check the remaining attributes and map fields to ones relevant for your business.

3. Click Save.

4

Build - Attributes per category

Category attributes are attributes that apply to items from specific categories, like battery information for electronic items, or sizing information for clothing.

1. Start by mapping fields to attributes marked as required by the marketplace.

2. Check the remaining attributes and map fields to ones relevant for your business.

3. Click Save.

4

Send your product data to Manor

If you have not activated your project, go to your project settings on the left-hand side of the screen and click 'activate project'. Then go back to Channel and go to Your Manor channel > Settings, and activate the channel by selecting "Activate API". From there, click Run now to send your listings.

5

Check your product listings for errors

After sending your product listings to Manor, go to the Preview tab of your Manor API. Click/filter on 'error'. You can see which product listings have errors and were 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: 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.