How to set up Maxeda channels (Praxis and Brico)

Learn how to set up Maxeda Praxis and Brico channels in Channable, match both channel setups, map required attributes, and send your listings through Mirakl.

Maxeda, the organization behind Praxis (Netherlands) and Brico (Belgium), offers a major marketplace for DIY products in the Benelux region. Through Mirakl, third-party sellers can list products on both platforms, reaching a wide audience while maintaining quality standards.

In this article, you'll learn how to set up a Praxis and Brico channel to create, update, and manage your Praxis and Brico listings in Channable.

---

Before you start

You'll need

• A Mirakl Connect account
• A project in Channable with imported products
• A live Praxis NL shop
• A live Brico BE shop (created by contacting Maxeda's Marketplaces team. Ensure you duplicate the NL account users)

Must know

• To list on Praxis, you need to also list on Brico. This means you must also create a channel for Brico with an identical setup.
• Once you run your channel, Maxeda will review your products before they can be listed. This can take up to a week.

Good to know

• Incomplete account information can prevent your products from listing on Praxis and Brico, even if they were pushed successfully from Channable.
• Some attributes may be mandatory even if they don't seem relevant for your specific situation (e.g. an attribute for adding a Spanish title when you’re only selling in Germany). You can leave these attributes unmapped.

Seller guides for Maxeda (Praxis and Brico)

Maxeda - Golden rules (NL).pdf

PDF · 218KB

Open

Maxeda - Seller guide (EN).pdf

PDF · 4MB

Open

Maxeda - Seller onboarding guide (EN).pdf

PDF · 2MB

Open

1

Create your Praxis channel

1. In your Channable account, go to Channels.
2. Search for and select Maxeda Praxis.
3. Configure your settings for your channel:

   1. For Name, give your channel a name.
   2. For Unique ID per item, select a field containing your products ID codes (e.g. id)
   3. For Attribute language, you can select the language of the marketplace attributes shown in the Build step.
   4. For Master rules, you can set a rule group if you already have one to apply to your channel.
4. Click Save to create your channel.
5. Repeat this whole step to set up a channel for Maxeda Brico.

2

Categorize your items (Categories step)

1. In the Manual categorization tab in the Categories step, assign categories to your items. You can use Generate from field to generate categories using a project field containing your category information, or add category rules to manually assign categories.
2. Click Save.
3. Once your categories are ready, go to the Categories step in [your Brico channel].
4. Go to the Manual categorization tab and select Copy from project:

   1. For From project, select [the project containing your Praxis channel]
   2. For From channel, select [your Praxis channel]. Learn more about categorizing for marketplaces

3

Set up rules (Rules step)

Important: Every rule you make in your Maxeda Praxis channel must identically match the rules in your Maxeda Brico channel.

Tip: If you have shared rules (included in Core Plus and Core Pro plans), you can create rules once in your Praxis channel and apply them easily to your Bricoman channel later.

When your product data is incomplete or doesn’t match the format that Maxeda requires, you can use rules to make improvements and optimize your products to meet listing requirements.

• Rule templates: Commonly used rules you can adjust for your use case.
• Rules setup: Set up rules to refine your product data. This can include filtering, modifying, or enhancing data fields to meet marketplace requirements.

Read more about using rules for marketplaces

4

Build your listings (Build step)

The Build step is where you configure your product listings to match marketplace requirements. It’s an essential step for getting your products live and avoiding errors.

Color key

• Required by marketplace: You need to map this attribute to list your items on this marketplace
• Recommended: It's recommended to map this attribute to avoid errors and improve performance

Important: Some attributes may be mandatory even if they don't seem relevant for your specific situation (like an attribute for adding a Spanish title when you’re only selling in Germany). You can leave these attributes unmapped.

Shared attributes

Shared attributes are common fields that apply across your products, such as EAN, prices, and titles.

1. For Item:

   1. For EAN, map the field containing your product IDs.
   2. For Stock, map the field containing your stock information.
   3. For Price, map the field containing your product price information.

Category-specific attributes

Category-specific attributes fields that specifically apply to the category for your products .This step helps in fine-tune your listings to meet category requirements for your marketplace.

Fill in attributes that are specific to the selected category (such as size for clothing or dimensions like height and width for furniture.)

Learn more about the Build step for marketplaces

Tip: Click Auto-map fields to automatically map using information using information from your other channels or other similar setups. Learn more.

5

Fulfill additional requirements for Maxeda Praxis/Brico

The following information specifically applies to Maxeda channels.

Praxis & Brico channels must match

Your Brico and Praxis channels must have matching product data and be configured exactly the same.

When data doesn't match between the channels, you may encounter errors like:

"Rejected product: Mandatory fields are not filled in, add content to both channels (BE+NL)."

If you have a Core Plus or Core Pro plan, you can set up Shared rules to speed up this process and ensure all data stays synchronized.

Images

Although both channels indicate that images need to be added in the attributes, Maxeda specifically requests to only send images via the Praxis channel. For the Brico channel, leave the attribute Image empty.

Maxeda review process/acceptance criteria (Golden rules)

Maxeda conducts initial checks using the Golden Rules. Once your product meets these criteria, further evaluations will follow. Below are the Golden Rules:

Requirement	Description	Applicable for
Mandatory Fields Completion	Product data must be complete for both Praxis and Brico mandatory fields.	Praxis, Brico
Title Composition (BE-NL, NL-NL)	'brand' – 'product type' – 'serial number' – 'attribute 1' and/or 'dimensions' – 'other keywords' (Max. 85 characters).	Praxis, Brico
Title Composition (BE-FR)	'product type' – 'brand' – 'serial number' – 'attribute 1' and/or 'dimensions'(Max. 100 characters).	Brico
Product Description	Use basic HTML only (no CSS). Highlight key benefits of the product. Clearly list what’s included in the box. (or what's not) Describe product usage and intended audience. Repeat main keywords and brand throughout. Address the customer with 'you' (Min. 150 characters).	Praxis, Brico
Unique Selling Points (USPs)	3 USP’s in all languages is mandatory. Highlight characteristics that make the product stand out. (Max. 65 characters).	Praxis, Brico
Images	At least 2 images with a minimum size of 500x500px. Add dimensions or a manual if relevant.	Praxis, Brico
Number Formatting	Always use '.' (dot) for numbers instead of ',' (comma).	Praxis, Brico

Lead time to ship

You need to provide the average time (in days) between receiving an order and shipping it.

1. In [your Praxis channel], go to the Build step.
2. In the Item section, select the dropdown next to Lead time to ship and select the time in days it takes for you to ship an order (Static values > [time in days])
3. Click Save.

Eco-contributions (Storefronts in France only)

If your company is operating in France, your company must add eco-contributions to your offers on the marketplace. You can find a list of available EPR categories here.

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.

6

Connect to Praxis and Brico via Mirakl

To send your listings to Praxis and Brico, you need to connect your channel to your Mirakl Connect account.

Note: Nothing will change by linking your account - any existing listings stay exactly the same until you activate.

1. Return to the Settings step in [your Maxeda Praxis channel].
2. At Linked seller account, click Select seller account.
3. Select an existing seller account, or add a new seller account.

   1. If adding a new seller account:

      1. For Label: Name your connection
      2. Click Connect with Maxeda Praxis.

You’ll be redirected to Mirakl to log in to your account. This is to authenticate your connection to ensure Channable can list products for you.

After successfully logging in, your connection will be ready, and you will be navigated back to set up your channel.

7

Activate and run your channels

1. If you haven't activated your project, go to [your project] > Settings and click Activate project.
2. Select the Settings step in [your Praxis channel] and click Activate API.
3. Click Save and select Run now to send your product listings to Praxis.
4. Return to the Channel overview page and select [your Brico channel].
5. Go to the Settings step and click Activate API.
6. Click Save.
7. Click Run now to send your product listings to Brico.

8

Check your listing status in Mirakl

1. Log in to your Mirakl connect account.
2. Check the status of your Maxeda shops.

If your shop isn't live, you may need to provide additional information. For help, contact Maxeda's support team.

9

Review and fix listing errors

Go to the Result step and click on the Feedback tab. This page displays all possible processing errors your product data has at a given moment.

Resolving errors:

1. In Description, click on the error name. This takes you to an overview of the products with that error.
2. In ID, click the ID number and scroll. You should see a red highlighted callout in the section where the error occurred. Hover over the callout for more information.

   1. If the error is a mapping error, click View in build to be directed to the attribute you need to map/re-map, which is highlighted in blue.
   2. For more information about the attribute and its accepted values, hover over .
3. Resolve the error.
4. Repeat this entire step for [your Brico channel].
5. When you're ready, run [your Praxis channel] again by clicking Run now.
6. Do the same for [your Brico channel].

You can check your successfully listed products in the Successful tab.

For more information on how to solve an error, check Mirakl guide: settings and solutions.

Common Errors and Solutions

mirakl_unknown_error_code - "The product does not exist"

This error happens when Maxeda is reviewing your products. This can take up to a week. After a week has passed, you can assume that the remaining products don't comply with their guidelines.

Solution:

1. Check in on your channel in one week after Maxeda has reviewed your products.
2. If there are errors remaining, check your product data to ensure they meet Maxeda's golden rules policy.

Note: Please be aware that Channable has no influence over this review process. For more information or assistance, contact Maxeda directly

mirakl_unknown_error_code

This error signifies a group of errors that typically occur when Mirakl can’t identify a product’s EAN in the Mirakl database. This means the product is either new to Mirakl, or missing attributes it needs to be recognized as a product.

Solution:

1. Check your categories: In the Categories step, check that your product categories are correctly matched. If they're not, take a moment to map them accurately. For detailed instructions on this process, refer to our article on mapping categories.
2. Check your mapping: In the Build step, check your mapped fields and correct anything that looks incorrectly mapped. You can use rules to create and populate new fields.

Once you’ve checked both your categories and mapped attributes, click Run now to run your channel again.

Error 1004: The category could not be identified

This error occurs when items are sent with categories that don't match the categories on Mirakl. Any existing mapping in Mirakl will override the category mapping you make in Channable.

Solution:

To fix this, remove any existing category mapping from Mirakl.

1. In your Mirakl Connect account, go to Settings > Catalog Mapping.
2. At My catalog structure, click Root and select Category. This opens up all mapping related to categories.
3. Click Category again and select Remove mapping.

   
4. Return to [your Maxeda Praxis channel] in Channable and click Run now to run it again.
5. Do the same with [your Maxeda Brico channel].

Your category mismatch should be resolved.