Step 1: Add a new Decathlon connection
The Decathlon API uses the Mirakl platform, which means you will need a Mirakl account to start sending your product listings to Decathlon.
When you have a Mirakl Decathlon 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 Decathlon. Fill in the label for your connection, for example, Decathlon, and then click on ''Connect with Decathlon''. 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 Decathlon API in Channable
Go to the "APIs > +Add new API" and select the new connection you created with Decathlon.
Select the field you want to use for Unique ID per item (we recommend the 'id' field). Selecting a specific Country will allow you to choose categories and attributes in the related language. For example, if you select "France", the categories in the API tab "Categories" will be in French. To send your products to several countries enabled in one seller account, you can fill in the attributes available in different languages (such as "Composition" in the screenshot below).
Finally, you can also add a master rule group here if you would like, and click "Continue" to finish creating the new Decathlon API.
Step 3: Create your product listings in Channable
Once you have created the Decathlon API you can set up 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 'Stock' should display the stock 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: France introduced legislation for eco-participation. If your company is operating in France, your company has the obligation to add eco-contributions to your offers on the marketplace. An eco-contribution, also known as an environmental contribution, is an amount added to the price of a product to compensate for the environmental impacts related to its manufacturing, distribution or disposal.
An eco-contribution consists of three parts: EPR category code, Producer ID and Amount. In this paragraph, you can find a list of available EPR categories.Sales channels: Next to the Item tab, you will find the tabs for the sales channels that you possibly have activated in Step 2. With a project field, you can dynamically use the
Disabledsetting to adjust which products in your API are sent to each activated channel.
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 products to Decathlon
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 Decathlon API Name" > Settings where you activate the API by selecting "Activate API". After you have completed this step navigate back to the APIs overview and select the blue "Run now" button to send your product listings to Decathlon.
Step 5: Check your product listings for errors
After you have sent your product listings to Decathlon, go to the Results tab of your Decathlon API. Click a filter on 'error'. Now you can see which product listings have errors and which have not been listed. Click on a specific error to see more information on what is causing the error. If you have solved some errors by changing the settings or product information, re-run the Decathlon API to see the new results.