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 "[Your company] settings menu (in the top right corner) > Connections > Add connection". Click on "+ 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 on ''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.
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 API a name.
Select the field you want to use for Unique ID per item (we recommend the 'id' field), and the Language for categories. You can also add a master rule group here if you want. Click on "Continue" to finish creating the new Conforama API.
Step 3: Create your product listings in Channable
Once you have created the Conforama API you can setup your product data by following the steps of the API.
For your product data to be created your products need a category. Add categories to your products by using the generate categories feature or create new categories from scratch.
Create different rules to optimize your product data. For example, take a look at our common rules support article.
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 '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.
Tip! Notice the question mark behind every field, if you hover over the question mark you will see the description of the field and suggestions for possible values.
Note! Conforama needs to have information on eco-contributions included in the offer. We have added the fields for this in the build step.EPR category code: These can be found here. By default, it's set to use a project field, however, these codes are also offered as a static value, which can be used for all your offers. A list of possible EPR codes can be found at the bottom of this page.
Producer ID: A list of identification numbers at state-licensed recycling organizations, in countries where applicable. Producer identifiers must be exactly 15 characters (alphanumeric and underscore only) for French categories and 255 characters maximum for non-French categories.
Amount: This is the eco-contribution amount in the offer currency.
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.
Step 4: Send your product data to Conforama
Almost there, your product listings are ready to be sent. If you have not activated your project go to Settings > 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 Conforama API Name" > Settings where you activate the API by selecting "Activate API". After you have completed this step navigate back to then APIs overview and select the blue "Run now" button to sent your product listings to Conforama.
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 and check out our error solutions section on how to correct errors.