Do you want to learn interactively all basics related to the creation of an API export, or how to make an advanced setup for an API in Channable? Learn how to create a Channacademy account in the Channable app through this Help Center article and start with the Basic APIs or Expert APIs course.
MediaWorld, the Italian branch of MediaMarkt, is a leading consumer electronics and home appliances retail chain operating across Europe. It offers a vast selection of products, including electronics, home appliances, computers, smartphones, and entertainment items.
In this article, you’ll learn how to set up a MediaWorld API in Channable, allowing you to easily create and manage your listings on the platform.
Table of contents
- Create a new connection
- Create the API
- Create your product listings in Channable
- Send your products to MediaWorld
- Check your product listings for errors
Step 1: Create a new connection
To create a new MediaWorld connection, follow the steps below:
- Start by navigating to the API page within your project and click on the “+Add new API” button. This action will redirect you to your company's connections page.
- On the connections page, select “+Add a new connection”.
- Search for the 'MediaWorld' connection by clicking through the pages, after finding the 'Conrad' connection, provide a label for this new connection.
- Click on “Connect with MediaWorld” You will be redirected to MediaWorld for the next step. Once redirected, log in using Mirakl/MediaWorld credentials.
Important: In Channable, MediaWorld and MediaMarkt share the same connection. To configure the MediaWorld API, make sure to log in with your MediaWorld/Mirakl credentials!
After successfully logging in, the connection with MediaWorld is established and available for use! You will be brought back to the API setup.
Step 2: Create the API
Once back, you have to select your new connection with Conrad and continue setting up your API.
-
Configure API settings:
- Name your API
- Choose the "Unique ID per item". (we recommend the 'id' field)
- Select the language of your API
- Create API: Click on “Continue” to create the new MediaWorld API.
Step 3: Create your product listings in Channable
To set up your API, follow the steps outlined below. Click on each step to expand and view the detailed instructions, which will guide you through the entire process.
1. Categorization
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.
- Smart Categorization: This feature automatically assigns categories to your products based on predefined criteria, simplifying the categorization process.
- Manual Categorization: Manually assign categories to your products by setting specific rules. You can create detailed filters to map each product to the correct category.
- Uncategorized Items: Review and categorize any items that remain uncategorized to ensure all products are properly organized.
2. Rules
Create different rules to optimize your product data. For example, refer to our common rules support article for guidance.
- Rules Setup: Set up various rules to refine your product data. This can include filtering, modifying, or enhancing data fields to meet marketplace requirements.
3. Build step
The Build step in Channable allows you to configure all necessary attributes for your items, ensuring your product data aligns with marketplace requirements. This step is crucial for successful product listings and avoiding errors.
You can fill in this template by clicking on each field and selecting what information you want to send to Amazon. For example, the project field Title should display the title of your product, etc. After completing the template, do not forget to click on “Save” at the bottom of the page.
The required fields to map in the build step can be different per marketplace!
4. Attribute step
You are almost done! Now, you need to fill in the “Attributes”. 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 MediaWorld
Almost there, your product listings are ready to be sent. If you have not activated your project, go to your 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 MediaWorld API] > Settings, where you activate the API by clicking "Activate API".
Once you have activated the API, navigate back to the API overview and click on the blue "Run now" button to send your product listings to MediaWorld.
Step 5: Check your product listings for errors
To check for errors, navigate to the [Result page of the API] > Errors tab, where you see which product listings have errors. By clicking on the specific, it will display more information on what is causing the error. For more information about what the errors mean, read this article.