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.
INNO is a popular retail chain specializing in fashion, beauty, and household products, primarily operating in Belgium. For businesses looking to expand their reach by selling through INNO, Channable offers a seamless integration via the INNO API. In this article, we discuss how you can set up an INNO API connection in Channable.
Table of contents
- Create a new connection
- Create the API
- Create your product listings
- Send your product listings to INNO
- Check your product listings for errors
Step 1: Create a new connection
To create a new INNO connection, follow the steps below:
- Begin 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 'INNO' connection by clicking through the pages, after finding the 'INNO' connection, provide a label for this new connection.
- Click on "Connect with INNO" You will be redirected to INNO for the next step. Once redirected, log in using INNO credentials.
After successfully logging in, the connection with INNO 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 INNO 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 INNO API.
Step 3: Create your product listings
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.
Additional requirements for INNO
The following information is specific to INNO, we discuss the item tab and some additional requirements.
Item tab
-
Shipping class (logistic class): The logistic classes determine the respective shipping costs for your items. Enter the logistic class of your product.
- Lead time to ship: The shipping lead time indicates the time required until the package is handed over to the shipping, Indicate the shipping time in days.
- Eco-contributions: France introduced legislation for eco-participation. If your company is operating in France, you must add eco-contributions to your offers on the marketplace. In this article, you can find a list of available EPR categories.
Title requirements
- No Brand name: Must not include the brand name to avoid redundancy (as the brand appears above the name).
- Required language: Mandatory in both Dutch and French.
- Maximum length: 56 characters (including spaces); recommended limiting the name to 28 characters for full visibility on all pages. If longer, the name will be cut off after 28 characters.
- Name Structure: Follows the pattern: marketing name (optional) + category + attribute + article number (in case of watches).
Long description requirements
- No external links: May not contain any advertising for other products or references (links) to other sources of information.
- Required language: Mandatory in both Dutch and French.
- Unique content: Should be unique to avoid duplicate content with your own website.
- Maximum length: 5,000 characters (including spaces).
-
Bullet point clarity: Bullet points may be used for clarity, formatted with
<br/>at the end of each line.
Short description requirements
- No bullet points: Must be continuous text.
- Required language: Mandatory in both Dutch and French.
- Maximum length: 112 characters (including spaces).
Image requirements
You can upload up to 6 images per article. While only one image is mandatory, providing up to 4 additional images showing different views of the product (back view, side view, detailed view, sets/pack shots) is highly recommended by INNO
- Minimum dimensions: 1050x1200 pixels.
- Recommended dimensions: 1400x1600 pixels.
- Maximum dimensions: 2625x3000 pixels.
- Required image ratio: 7:8.
- Supported formats: gif, jp2, jpg, jpeg, png, tiff, tif.
- Main image: Front view, fully visible (worn on a mannequin for apparel).
- Sets: Provide an image of the sets/packs showing all articles included.
- No Watermarks, logos, or text components: Only the product itself should be shown.
- Background: White, beige, or light grey only. So no Black & White Images.
- No children models for underwear or beachwear.
Note: No rich media content (videos) can be uploaded yet.
Following these guidelines will help you make sure your INNO listings are set up correctly and in line with their requirements.
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: Please note that 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. Click here to read more.
Step 4: Send your product listings to INNO
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 INNO 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 INNO.
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.