Step 1: Generate the API credentials in your Decathlon account
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, login and navigate to My User Settings by clicking on your email address in the top right corner. After that you go to API key tab and click "generate API key" if there is no key available yet. If there is an API key available, you can use that one, you don't have to create a new one. Copy the API key, because you will need this for the next step.
Next, you will need to find your Shop ID in your Decathlon account. First, select the shop you want to send products to in the top right corner. Next, go to My Account > Settings to find your Shop ID. Copy your Shop ID as well, you will need this for the next step.
Step 2: Add a new Decathlon connection in Channable
To add a new Decathlon API, you will first need to add a new connection. Go to Channable, open your project and go to APIs > Add new API. A new screen with the API Settings will open where you can click on the "+ Add new connection" button. Now, select Decathlon to create a new Decathlon connection:
Now, you can fill in the Shop ID and API Key you saved from your Decathlon account, as well as a label for the connection:
Click on 'Create' to finish creating the Decathlon connection.
Step 3: Add a new Decathlon API in Channable
You will now return to the "New API" overview where you can select the Decathlon connection 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 Country you want to sell. You can also add a master rule group here if you want. Click on "Continue" to finish creating the new Decathlon API
Step 4: Create your product listings in Channable
Once you have created the Decathlon 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. Take a look at our common rules support article for some examples.
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.
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 5: Send your products to Decathlon
Almost there, your product listings are ready to be sent. If you have not activated your project go to Setup > 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 sent your product listings to Decathlon.
Step 6: 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 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. If you have solved some errors by changing the settings or product information, re-run the Decathlon API to see the new results.