# How to set up a Showroomprivé channel

Showroomprivé is a French online retailer that specializes in flash sales of exclusive fashion and lifestyle goods.

In this article, you'll learn how to set up a Showroomprivé channel to create, update and manage your Showroomprivé listings in Channable.

***

### Before you start

**You’ll need**

* [A Mirakl account](https://www.miraklconnect.com/)
* A project in Channable with your imported products
* Products with EAN codes

**Good to know**

* Showroomprivé uses the Mirakl platform
* Some attributes may be mandatory even if they don't seem relevant for your specific situation (e.g. an attribute for adding a Spanish title when you’re only selling in Germany). You can leave these attributes unmapped.

### Step 1: Create a Showroomprivé channel

1. In Channable, go to **Projects > \[Your project] > Channels**.
2. In the search bar, enter “Showroomprivé” and select **Showroomprivé**.

{% hint style="info" %}
Note: If it doesn’t appear, click Clear to reset your filters.
{% endhint %}

3. Set your channel settings:
4. For **Name**, give your channel a name.
5. For **Unique ID per item**, select a field containing your products EAN codes (e.g. ean, id)
6. For **Language**, choose the language your product data is in. 
7. For **Use master rule group**, you can set a rule group if you already have one to apply to your channel.
8. For **Status**, leave your API deactivated for now. 
9. Click **Save**.

### Step 2: Create product listings

Follow these sub-steps to set up your channel.

#### **Categorize your products**

Set up your product data by assigning categories to your products.

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

#### **Set up rules**

Rules help you quickly optimize your product data for your target marketplace.

* [Rule templates](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/using-rules/rule-templates): Commonly used rules you can adjust and customize for your needs.
* [Rules setup:](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/rules-in-channable) Set up rules to refine your product data. With rules, you can filter, modify, and/or enhance data fields to meet marketplace requirements.

#### **Build your listings**

{% hint style="info" %}
Note: Showroomprivé has four sales channels: France, Spain, Portugal and Belgium. Add prices for one of these channels or leave these fields blank if you don't want to sell on any of these.
{% endhint %}

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 fields:** Required to list your products on this marketplace

**Recommended:** Suggested to avoid errors

{% hint style="info" %}
Important: Some attributes may be mandatory even if they don't seem relevant for your specific situation (e.g. an attribute for adding a Spanish title when you’re only selling in Germany). You can leave these attributes unmapped.
{% endhint %}

#### **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 are fields that specifically apply to your product's 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).

{% 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://channable-test.gitbook.io/channable-test-docs/list-advertise/list-on-marketplaces/auto-map-fields-for-marketplaces-apis).
{% endhint %}

#### **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/hc/en-us/articles/360012678720-Mirakl-guide-settings-and-solutions).

#### Check the quality of your setup

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/hc/en-us/articles/19452435834642-Marketplaces-Quality-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.

[Learn more about the Preview step for marketplaces](https://helpcenter.channable.com/hc/en-us/articles/19452509593746-API-s-Preview-step)

{% hint style="info" %}
**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.
  {% endhint %}

### Additional requirements for Showroomprivé

#### Meet GPSR and DSA requirements

The European Union (EU) has introduced new[ GPSR and DSA requirements](https://helpcenter.channable.com/hc/en-us/articles/22175644897042) for online platforms, including Showroomprivé. 

You can map these fields in the **Category-specific attributes** in the **Build** step of your **Showroomprivé** channel. Note that you will have to categorize your products in the **Categories** step before you can set these fields.

### Step 3: Connect to Showroomprivé via Mirakl

To send your listings to Showroomprivé, you need to connect your channel to your Mirakl Connect account. 

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

1. Log in to your Mirakl connect account.
2. In **\[your Showroomprivé channel]**, go to **Settings**.
3. At Linked seller account, click **Select seller account**. 
4. Select an existing seller account, or click **+ Add new connection** to add a new seller account.
5. If adding a new seller account:
6. For **Label**: Name your seller account connection. This is only used to identify your connection within Channable.
7. Click **Connect with Showroomprivé**. 

You’ll be redirected to Mirakl to log in to your account. This is to authenticate your connection to ensure Channable can list products for you. 

After successfully logging in, your connection will be ready, and you will be navigated back to your channel.

### Step 4: Activate your channel

Once your product listings are ready, you can send them to Showroomprivé: 

1. Select the Settings step in \[your Showroomprivé channel] and click Activate API.
2. Click Save.
3. Click Run now to send your product listings to Showroomprivé.

### Step 5: 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 .
5. 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**:

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://helpcenter.channable.com/hc/en-us/articles/360020365580-What-are-categories-in-Channable).
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.

<br>