# How to set up a Home24 channel

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.

***

### 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.

{% stepper %}
{% step %}

### Create a Home24 channel

1. In your Channable account, create a new project or select an existing project to add your channel to.
2. In the sidebar, go to **Channels > + Create channel**.
3. Search for "Home24" and select **Home24**.
4. Fill in your channel settings:
   1. For **Name**, give your channel a name. This name is for your reference only to help you distinguish between your channels.
   2. For **Unique ID per item**, select a field containing your products EAN codes (this is often "ean").
   3. For **Language**, choose the language your product data is in.
   4. For **Use master rule group**, you can set a rule group if you already have one to apply to your channel.
5. Click **Save**.

{% endstep %}

{% step %}

### Create product listings

This step contains categorization, rules, and building your listings.

{% stepper %}
{% step %}

#### Categorize your products

To set up your product data, assign categories to your products.

* **AI product categorization:** Automatically assigns product categories through our algorithm.
* **Manual Categorization:** Manually assign product categories with custom rules. You can create detailed filters to map each product to the correct category.
* **Uncategorized Items:** Products that still need to be reviewed and categorized

[Learn more about categorizing for marketplaces](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-categorization-step)
{% endstep %}

{% step %}

#### Set up rules

Rules help you quickly optimize your product data for the marketplace you want to sell on.

* **Rule templates:** Commonly used rules you can adjust for your use case.
* **Rules setup:** Set up rules to refine your product data. This can include filtering, modifying, or enhancing data fields to meet marketplace requirements.

[Read more about using rules for marketplaces](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-rules-step)
{% endstep %}

{% step %}

#### 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**: Recommended to avoid errors and improve performance

**Shared attributes**

* Shared attributes are common fields that apply across your products, such as EAN, prices, and titles.
* **Use static or dynamic Values**
  * **Static values:** Fixed values that don’t change (e.g. brand name, manufacturer)
  * **Dynamic values:** Fields that automatically change based on the linked data (e.g. stock, prices)

**Category-specific attributes**

* Fields that specifically apply to the category for your products (e.g. size for clothing or dimensions for furniture).
* Fill in attributes that are specific to the selected category.

[Learn more about the Build step for marketplaces](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-build-step)
{% endstep %}

{% step %}

#### Check the quality of your set up

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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-quality-step)
{% endstep %}

{% step %}

#### Preview before activating

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 **All categories** dropdown and select the category you want to filter by.

Before you continue:

* **Review Shared attributes**: Ensure all mandatory shared attributes are filled.
* **Review Category-specific attributes**: Ensure all mandatory category-specific attributes are filled.
* **Check for errors**: Correct any red-marked fields.

[Learn more about the Preview step for marketplaces](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-preview-step)
{% endstep %}
{% endstepper %}

{% hint style="success" %}
**Tip:** Click **Auto-map fields** to automatically map using information using information from your other channels or other similar setups. [Learn more](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/auto-map-fields-for-marketplaces-apis).
{% endhint %}
{% endstep %}

{% step %}

### 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 `SellerArticleId` and `SellerProductId` 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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/mirakl-marketplaces/mirakl-guide-settings-and-solutions).
{% endstep %}

{% step %}

### Additional requirements for Home24

#### GPSR and DSA requirements

The European Union (EU) has introduced new [GPSR and DSA requirements](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/what-you-need-to-do-to-be-gpsr-and-dsa-compliant).

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. See the list of [available EPR categories](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/mirakl-marketplaces/setting-up-mirakl-eco-contributions).
{% endstep %}

{% step %}

### Connect to Home24 via Mirakl

To send your listings to Home24, you need to connect your channel to your Mirakl SSO account account.

{% hint style="warning" %}
**Important:** Nothing will change **yet** - any existing listings stay exactly the same until you activate.
{% endhint %}

1. In **\[your Home24 channel]**, go to the **Settings** step.
2. At **Linked seller account**, click **Select seller account**.
3. Select an existing account, or add a new account.
   1. If adding a new seller account:
      1. For **Label**: Name your seller account connection.
      2. Click **Connect with Home24**. We'll redirect you to Mirakl to log in with your credentials and accept permissions.
         {% endstep %}

{% step %}

### Activate your channel

Once your product listings are ready, you need to send them to Home24:

1. Select the **Settings** step in **\[your Home24 channel]** and click **Activate API**.
2. Click **Save**.
3. Click **Run now** to send your product listings to Home24.
   {% endstep %}

{% step %}

### 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:

1. In **Description**, click on the error name. This takes you to an overview of the products with that error.
2. 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.
3. 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.
4. For more information about the attribute and its accepted values, hover over the info icon.
5. Resolve the error.
   {% endstep %}
   {% endstepper %}

### Common Errors and Solutions

<details>

<summary>mirakl_unknown_error_code</summary>

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:

1. 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](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/categorize-products).
2. 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.

</details>