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.
In this article, you'll learn how to set up a Home24 channel to create, update, and manage Home24 listings.
- Preparation
- Step 1: Create the connection
- Step 2: Create the API
- Step 3: Setting up your API
- GPSR and DSA requirements
- Step 4: Activating the API and checking for errors
Before you start
You’ll need
- A Mirakl SSO account
- A Home24 connection in your Mirakl account
- EAN codes for your products
Good to know
- You can create a Home24 channel for the following markets: German, Austrian, Swiss, and French.
Step 1: Create a Home24 connection
- In your Channable account, create a new project or select an existing project to add your channel to.
- In the sidebar, go to Channels > + Create channel.
- Search for "Home24" and select Home24.
- Click + Add a new connection.
-
At Connect with, select Home24. For Label, give your channel a descriptive name.
Note: This name is for your use only to help you distinguish between your channels. - Click Connect with Home24. We’ll redirect you to Home24/Mirakl to log in and authenticate your connection.
After you log in, you’ll automatically be directed back to continue setting up your channel.
Step 2: Set up your Home24 channel
- Click [your Home24 connection].
- Configure your settings for your channel:
- For Name, give your channel a name.
- For Unique ID per item, select a field containing your products EAN codes (this is often "ean")
- For Language, choose the language your product data is in.
- For Use master rule group, you can set a rule group if you already have one to apply to your channel.
- For Status, leave your API deactivated for now.
- Click Save.
Step 3: Create product listings
1) Categorize your products
Organize your product data by assigning relevant categories to your products.
If you've set up another channel with the same products, you can copy categories from that setup to apply to your Home24 channel.
- In the Categories step, click on the Manual Categorization tab.
- Click Copy categories. In the pop-up, select a project to copy categories from.
- Click Copy here.
- In the Categories step, click on the Manual Categorization tab.
- Click Generate categories. At Set category field, select the field containing your product categories (this is often 'category').
- Click Save.
- If you have remaining products without categories, continue to Manually generate categories.
You can create conditions to assign categories to products in bulk.
- In the Categories step, click on the Uncategorized items tab.
- Check your items to see if you can identify a common pattern you can filter by. (For example, if 'electric' is in the title of all small electric goods)
- Click on the Manual Categorization tab and select Add category.
-
Create a rule to apply categories to products in bulk.
Example: If title contains electric set to category [select relevant category from dropdown]. - Click Save.
- Click Items after in the footer to see how many items were affected by your rule.
- Repeat until you're satisfied with the amount categorized.
2) Set up rules
Rules help you optimize your product data for Home24.
- Rule templates: Commonly used rules you can adjust and customize for your needs.
3) Build your listings
The Build step is where you configure your product listings to match marketplace requirements. It’s an essential step for getting your products live and avoiding errors.
Mandatory and optional fields:
- Mandatory fields : Required to list your products on this marketplace
- Recommended : Suggested to avoid errors
- Optional : Not required to list
Shared attributes
Shared attributes are the common fields that apply across your products, such as EAN, prices, and titles. Mapping your shared attributes ensures uniform and consistent product information across your listings.
-
Use static or dynamic Values:
- Static values: Fixed values that don’t change (e.g. brand name, manufacturer)
- Dynamic values: Fields that automatically update based on the linked data (e.g. stock, prices)
Category-specific attributes
Category-specific attributes fields that specifically apply to your products' categories. This step helps fine-tune your listings to meet category requirements for your marketplace. Fill in attributes that are specific to the selected category (e.g. size for clothing or dimensions for furniture.)
Best practices for Mirakl marketplaces
Adding multiple attribute values
Separate multiple values in an attribute with a pipe symbol "|" for proper detection and processing.
Seller's Product ID for single/simple products
There are two attributes called SellerArticleId and
SellerProductId. SellerProductId is the
Parent
ID, while SellerArticleId refers to variant items.
-
For single products, both
SellerArticleIdandSellerProductIdmust be filled with the same value.
For more information on Mirakl Marketplace errors, how-to's, and best practices, check out our dedicated guide.
Additional requirements for Home24
GPSR and DSA requirements
The European Union (EU) has introduced new GPSR and DSA requirements for online platforms, including marketplaces.
To comply with GPSR and DSA, ensure you map the following attributes in the Attributes per category tab:
- E-Mail-Adresse Oder Url Des Herstellers: Enter the email address of the manufacturer.
- E-Mail-Adresse Oder Url Der In Der Eu Verantwortlichen Person: Enter the email address or URL of the person responsible in the EU.
- Name Der In Der Eu Verantwortlichen Person: Enter the name of the person responsible in the EU.
- Postanschrift Des Herstellers: Enter the postal address of the manufacturer.
- Postanschrift Der In Der Eu Verantwortlichen Person: Provide the postal address of the person responsible in the EU.
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.
Step 4: Review feedback before running
The Quality step provides feedback on your channel before you activate it. It highlights mandatory and optional errors to ensure your product data meets requirements to list on the marketplace.
- Solve errors, prioritizing mandatory errors first.
Actions
- View items: See products with specific issues.
- View in build: Redirects to the Build step to map missing information.
- Set categories: Directs to the Categories step to categorize items.
- Show source: Available for ID fields. Directs to the Settings step.
Learn more about the Quality step for marketplaces
Preview
The Preview step displays the attributes you mapped in the Build step, helping you check if everything is configured correctly by providing an overview of your products and potential errors.
Filtering:
- Filter by error: Click the All dropdown and select if you would like to filter to display only products with errors, or products with a specific error.
- Filter by category: Click the Allcategories dropdown and select the category you want to filter by.
Before you continue:
- Review Shared attributes: Ensure all mandatory shared attributes are filled.
- Review attributes per category: Ensure all mandatory category-specific attributes are filled.
- Check for errors: Correct any red-marked fields.
Step 5: Activate your channel
Once your product listings are ready, you need to send them to Home24:
- Select the Settings step in [your Home24 channel] and click Activate API.
- Click Save.
- Click X to return to the Channel overview page.
- Click Run now to send your product listings to Home24.
Step 6: Review and fix listing errors
Go to the Result step and click on the Feedback tab. This page displays all possible processing errors your product data has at a given moment.
Resolving errors:
- In Description, click on the error name. This takes you to an overview of the products with that error.
- In ID, click the ID number and scroll. You should see a red highlighted callout in the section where the error occurred. Hover over the callout for more information.
- If the error is a mapping error, click View in build to be directed to the attribute you need to map/re-map, which is highlighted in blue.
- For more information about the attribute and its accepted values, hover over .
- Resolve the error.
Common Errors and Solutions
mirakl_unknown_error_code
This error signifies a group of errors that typically occur when Mirakl can’t identify a product’s EAN in the Mirakl database. This means the product is either new to Mirakl, or missing attributes it needs to be recognized as a product.
Solution:
- Check your categories: In the Categories step, check that your product categories are correctly matched. If they're not, take a moment to map them accurately. For detailed instructions on this process, refer to our article on mapping categories.
- Check your mapping: In the Build step, check your mapped fields and correct anything that looks incorrectly mapped. You can use rules to create and populate new fields.
Once you’ve checked both your categories and mapped attributes, click Run now to run your channel again.