# Setting up a Conforama API

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

{% hint style="warning" %}
Important: EAN codes are mandatory for Conforama. Make sure you have valid EAN codes for all your products, otherwise no product listings can be created for your products.
{% endhint %}

{% stepper %}
{% step %}

### Step 1: Add a new Conforama connection

The Conforama API uses the Mirakl platform, which means you will need a Mirakl account to start sending your product listings to Conforama.

When you have a Mirakl Conforama account, go to **Connections > Add connection**. Click **+ Add a new connection** and you will see a screen, where you can select Conforama. Fill in the label for your connection, for example, Conforama. And then click **Connect with Conforama.** 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.

|               | ![Conforama\_1.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/L7SY4utSdPCTAgHHHOO2/7649591663506) | ![Sing\_in\_Mirakl\_-Oauth\_\_1.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/E3xncxVxeAfXSeWGNv4d/7649505894930) |
| ------------- | ---------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| {% endstep %} |                                                                                                                        |                                                                                                                                         |

{% step %}

### Step 2: Add a new Conforama API in Channable

Now go to the API's overview, in your project. And click on "+ Add new API", Select the Conforama connection you just made, and give your new channel a name.

Select the field you want to use for **Unique ID per item** (we recommend the 'id' field), and the **Language** for categories. Click on "Continue" to finish creating the new Conforama channel.
{% endstep %}

{% step %}

### Step 3: Create your product listings in Channable

Once you have created the Conforama channel you can setup your product data by following the steps of the channel.

{% stepper %}
{% step %}

#### Categories

For your product data to be created, your products need a category. Add categories to your products by using the [generate categories feature](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/categorize-products/create-product-categories/use-the-generate-categories-function), or [create new categories from scratch](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/categorize-products/create-product-categories/add-categories-manually).
{% endstep %}

{% step %}

#### Rules

Create [different rules](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/using-rules) to optimize your product data. 
{% endstep %}

{% step %}

#### Build

Here you can find our preset template for the product listings. All you have to do is to fill it out by clicking on the field itself and selecting what you would like to go in there. For example, the field 'Price' should display the price of your product and so on. When you have finished setting up the product listings, just click 'save' at the bottom of the screen.

{% hint style="success" %}
**Tip:** Hover over <i class="fa-circle-question">:circle-question:</i> for more information on specific field requirements.
{% endhint %}

\_ 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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/mirakl-marketplaces/setting-up-mirakl-eco-contributions) you can find a list of available EPR categories.

[![HD Conforama Build.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/yPTAhUfiurqJWp4LmSRW/15232665863698)](https://helpcenter.channable.com/hc/article_attachments/15232665863698)
{% endstep %}

{% step %}

#### Category attributes

Almost done! Next up is filling in the fields in the *Attributes* step. Select the category you want to optimize first. An example of what should be in front of you now can be seen in the screenshot below. A more detailed explanation of what to do in the *Attributes* step can be found in [our Attributes support article](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-build-step).

![EN\_-\_API\_Conforama\_6.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/m0yNeP1FaB91RsaKLAsg/360007600220)
{% endstep %}
{% endstepper %}
{% endstep %}

{% step %}

### 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) for online platforms, including marketplaces.

For your Conforama API in Channable, make sure to fill in the [attributes](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-build-step) in the **Attributes** step (V1 marketplaces) or in the category-specific **Attributes per category** tab in the **Build** step (V2 marketplaces):

* **Référence Fournisseur**
  {% endstep %}

{% step %}

### Step 4: Send your product data to Conforama

Once all steps are completed, you are ready to send your product listings. Follow the instructions below to send your product listings:

{% stepper %}
{% step %}
Go to **Settings** > **Project settings**.
{% endstep %}

{% step %}
Click **Activate project**.
{% endstep %}

{% step %}
Navigate back to **APIs** and go to \[ **Your API Name** ] > **Settings**.
{% endstep %}

{% step %}
Select **Activate API** to activate the API.
{% endstep %}

{% step %}
Return to the **APIs overview** and click **Run now** to send your product listings.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Note: At first, your products might be sent to a test environment. After Conforama accepts your products, you can send them to the live environment. Please [contact our support team](https://www.channable.com/company/contact/) to make sure you are sending to the right environment.
{% endhint %}
{% endstep %}

{% step %}

### Step 5: Check your product listings for errors

If you have sent your product listings to Conforama go to the *Preview* tab of your Conforama API. Click filter on 'error'. Now you can see which product listings have errors and are not placed. Click on a specific error to see more information on what is causing the error.
{% endstep %}
{% endstepper %}

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