Home24 is an online furniture and home decor retailer that operates primarily in Europe and Latin America. The company offers a wide range of home products, including furniture, home accessories, and garden items. This is a guide on how you can set up a Home24 Marketplace with an API in Channable.
Preparation
- The home24 API is able to connect to the German, Austrian, Swiss, and French markets.
- home24 is a Mirakl-based platform, which means you will need a Mirakl account to start sending your product listings to home24.
- EAN codes are mandatory for home24, make sure you have valid EAN codes for all your products, otherwise, no product listings can be created for your products.
Step 1: Create the connection
1. Begin by navigating to the API page within your project and click on the "+Add new API" button. This action will redirect you to your company's connections page.
2. On the connections page, select "+Add a new connection".
3. Search for the 'Home24' connection by clicking through the pages, after finding the 'Home24' connection, provide a label for this new connection.
4. Click on "Connect with Home24." You will be redirected to Home24/Mirakl for the next step. Once redirected, log in using your Mirakl-credentials.
After successfully logging in, the connection with Home24 is now established and available for use! You will be brought back to the API setup.
Step 2: Create the API
Once back, you have to select your new connection with home24 and continue setting up your API.
- Give your API a name.
- Select the field you want to use for "Unique ID per item" (we recommend the 'id' field) and the "Language" you want to sell in.
- You can also add a master rule group here if you would like.
Click on “Continue” to finish creating the new home24 API.
Step 3: Setting up your 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, create new categories from scratch, or you can further check out the smart categorization feature to make the categorizing of your products even easier.
2. Rules
Create different rules to optimize your product listings. For example, take a look at our common rules support article.
3. Build
Here you can find our preset template for the product listings. All you have to do is fill it out by clicking on the field itself and selecting what you would like to go in there.
For example, the field 'Title' should display the title of your product and so on. When you have finished setting up the product listings, just click "Save" at the bottom of the screen.
Eco-contributions
France introduced legislation for eco-participation. If your company is operating in France, your company must add eco-contributions to your offers on the marketplace. In this article, you can find a list of available EPR categories.
4. Attributes
Almost done! Next up is filling in the fields in the Attributes step. A detailed explanation of what to do in the Attributes step can be found in our Attributes support article.
Step 4: Activating the API and checking for errors
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 home24 API] > Settings, where you activate the API by clicking "Activate API".
Once you have activated the API, navigate back to the API overview and click on the blue "Run now" button to send your product listings to home24.
To check for errors, navigate to the Result page of the API > Errors tab, where you see which product listings have errors. By clicking on the specific, it will display more information on what is causing the error. For more info on how to see what your errors mean, read this article.
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.