Setting up a INNO API

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 "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.

2

Create the API

Once back, select your new connection with INNO and continue setting up your API.

• Configure API settings:

  • Name your API

  • Choose the Unique ID per item (recommended: the id field)

  • Select the language of your API

• Create API: Click "Continue" to create the new INNO API.

3

Create your product listings

To set up your API, follow the steps below. Each step covers a part of the product setup.

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: Automatically assigns categories to your products based on predefined criteria.

• Manual Categorization: Manually assign categories using rules and filters.

• Uncategorized Items: Review and categorize any items that remain uncategorized.

Click here to read more about the Categorization in APIs.

2

Rules

Create rules to optimize and transform your product data (filtering, modifying, enhancing fields).

Click here to read more about the Rules in APIs.

3

Build step

The Build step lets you configure all necessary attributes for your items to match marketplace requirements.

You can fill in the template by clicking each field and selecting what information you want to send. After completing the template, click Save at the bottom of the page.

Note: The required fields to map in the Build step can differ per marketplace.

Click here to read more about the Build step.

4

GPSR and DSA requirements

The European Union (EU) has introduced new GPSR and DSA requirements for online platforms, including marketplaces.

For your INNO API in Channable, make sure to fill in the attributes in the category-specific Attributes per category tab in the Build step:

• Product Safety Info: There are two fields for the regions ‘BE_NL’ and ‘BE_FR’.

Additional requirements for INNO

The following information is specific to INNO, covering the item tab and additional requirements.

Item tab

• Shipping class (logistic class): Enter the logistic class of your product.

• Lead time to ship: Indicate the shipping time in days.

• Eco-contributions: If operating in France, add eco-contributions to your offers. List of available EPR categories.

Title requirements

• No Brand name: Must not include the brand name (brand appears above the name).

• Required language: Mandatory in both Dutch and French.

• Maximum length: 56 characters (including spaces); recommended limit 28 characters for full visibility.

• Name Structure: marketing name (optional) + category + attribute + article number (for watches).

Long description requirements

• No external links or advertising to other products.

• Required language: Dutch and French.

• Unique content: Avoid duplication with your website.

• Maximum length: 5,000 characters.

• Bullet points: May be used; format lines with <br/> at the end.

Short description requirements

• No bullet points (continuous text).

• Required language: Dutch and French.

• Maximum length: 112 characters.

Image requirements

• Up to 6 images per article (1 mandatory, up to 4 additional recommended).

• Minimum dimensions: 1050x1200 pixels.

• Recommended: 1400x1600 pixels.

• Maximum: 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 image showing all articles included.

• No watermarks, logos, or text components.

• Background: White, beige, or light grey only.

• No children models for underwear or beachwear.

• Note: No rich media content (videos) can be uploaded yet.

Following these guidelines will help ensure your INNO listings meet INNO's requirements.

5

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: There are two attributes named SellerArticleId and SellerProductId. SellerProductId refers to the Parent ID, while SellerArticleId refers to 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.

6

Step 4: Send your product listings to INNO

• If you have not activated your project, go to your project settings on the left-hand side and click "Activate project".

• Go to the APIs overview and open [Your INNO API] > Settings, then activate the API by clicking "Activate API".

• Once the API is activated, go back to the API overview and click the blue "Run now" button to send your product listings to INNO.

7

Step 5: Check your product listings for errors

• Navigate to [Result page of the API] > Errors tab to see which product listings have errors.

• Click a specific error to display more information about the cause.

For more information about what the errors mean, read this article.