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.
This guide provides step-by-step instructions for setting up the Praxis and Brico APIs using Mirakl in Channable, along with guidelines for effective implementation.
Table of Contents
- Praxis and Brico explained
- Account acceptance
- Creating Connections for Praxis and Brico
- Create the APIs for Praxis and Brico
- Creating product listings
- Activating APIs
- Finalizing setup and account verification
- Verify product listings for errors
Praxis and Brico APIs explained
To sell on either Praxis or Brico, you must list your products on both platforms. In Channable, this is managed through two separate APIs, one for each platform. These APIs connect to the same Mirakl seller account, which then links to the individual shops for Brico and Praxis.
Maxeda operates differently compared to other marketplaces because it requires that all data be identical across both APIs. This is an important consideration when setting up your product listings and creating rules, as maintaining consistency is crucial for successful integration.
Account acceptance
To successfully list products on the Maxeda platform, and before setting up your APIs, several steps must be completed to comply with Maxeda guidelines. We'll discuss them below:
-
Create the Praxis NL shop: Start by creating the Praxis NL shop.
Shops creation: - Create users in the Praxis NL shop: Inform the Maxeda Marketplaces team to open the Brico BE shop and duplicate the NL account users.
- Verify account information: After both shops are created, ensure all information in your Mirakl account is filled in according to the guidelines.
- Check shop status: Check the status of each shop in Mirakl. If a shop is not live, additional information may be required. Contact Maxeda for assistance.
Maxeda must also review your products. This will only happen when your shops are live and all necessary product information is provided. For more information, consult the documents at the bottom of this article or contact Maxeda directly.
Step 1: Creating Connections for Praxis and Brico
To complete the setup for Maxeda Praxis and Maxeda Brico connections, you will need to repeat the following steps for each platform:
- Navigate to Connections in Channable.
- Click on +Add a new connection.
- Select either Maxeda Praxis or Maxeda Brico.
- Enter a label name, e.g., "Praxis" for Praxis or "Brico" for Brico.
-
Click on "Create" You will be redirected to Maxeda/Mirakl for the next step. Once there, log in using your Maxeda/Mirakl credentials.
After successfully logging in, the connection with Maxeda is established and available for use.
Step 2: Create the APIs for Praxis and Brico
Once back, navigate to the API's page in your project.
- Click on +Add new API. Select either the Praxis or Brico connection you created earlier,and start configuring the API settings:
- Name your API.
- Select the Unique ID per item, we recommend selecting the 'id' field.
- Select the language of your API, the chosen language does not affect the language of the data sent to Maxeda.
- We strongly advise using a master rule group, to create synergy between the two APIs.
- To create the new API, click "Continue" to create it.
Step 3: Creating product listings
Follow these steps to set up your channel:
1. Categorize your products
To set up your product data, assign categories to your products.
- Smart Categorization: Automatically assigns product categories through our algorithm.
- Manual Categorization: Manually assign product categories with custom rules. You can create detailed filters to map each product to the correct category.
- Uncategorized Items: Products that still need to be reviewed and categorized
2. Set up rules
Rules help you quickly optimize your product data for the marketplace you want to sell on.
- 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.
3. Build your listings
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.
Mandatory and optional fields:
- Mandatory fields : Required to list your products on this marketplace
- Recommended : Recommended to avoid errors
- Optional : Not required to list
Shared attributes
Shared attributes are the common fields that apply across your products, such as EAN, prices, and titles. This step ensures uniformity in basic product information across your listings.
-
Use static or dynamic Values:
- Static values: Fixed values that don’t change (e.g. brand name, manufacturer)
- Dynamic values: Fields that automatically change based on the linked data (e.g. stock, prices)
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 (e.g. such size for clothing or dimensions for furniture.)
Learn more about the Build step for marketplaces
4. Check the quality of your set up
The Quality step provides feedback on your channel before you activate it. It highlights mandatory and optional errors to ensure your product data meets requirements to list on the marketplace.
- Solve errors, prioritizing mandatory errors first.
Actions
- View items: See products with specific issues.
- View in build: Redirects to the Build step to map missing information.
- Set categories: Directs to the Categories step to categorize items.
- Show source: Available for ID fields. Directs to the Settings step.
5. Preview before activating
The Preview step displays the attributes you mapped in the Build step, helping you check if everything is configured correctly by providing an overview of your products and potential errors.
Filtering:
- Filter by error: Click the All dropdown and select if you would like to filter to display only products with errors, or products with a specific error.
- Filter by category: Click the All categories dropdown and select the category you want to filter by.
Before you continue:
- Review Shared attributes: Ensure all mandatory shared attributes are filled.
- Review Category-specific attributes: Ensure all mandatory category-specific attributes are filled.
- Check for errors: Correct any red-marked fields.
Additional information for Praxis & Brico
The following information is specific to Maxeda. Below, we outline important information about the Praxis and Brico APIs, along with the golden rules to follow.
-
Ensure consistency across both APIs
To avoid errors and ensure smooth product listings for both Praxis and Brico, it is essential to maintain consistent product data across both platforms. Inconsistent data can lead to errors such as:
"Rejected product: Mandatory fields are not filled in, add content to both channels (BE+NL)."
To prevent these issues, use the Master Rules feature in Channable. This allows you to centralize and enforce consistency in your product listings for both APIs. You can create a master rule group and apply it to both Praxis and Brico APIs, ensuring all mandatory fields and key data remain synchronized.
For more information on how to use master rules, please refer to our common master rules article. -
Images
Although both APIs indicate that images need to be added in the attributes, Maxeda specifically requests that you only send images via the Praxis API. For the Brico API, leave the image attributes empty. -
The 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
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.Step 4: Activating APIs
Follow the steps below to activate your APIs:
- Go to Settings > Project settings on the left-hand side of the screen.
- Click "Activate project".
- Navigate back to the APIs overview.
- Go to [Your API Name] > Settings.
- Select “Activate API” to activate the API.
Return to the APIs overview and click the blue “Run now” button to send your product listings.
Step 5: Finalizing setup and account verification
After setting up your APIs, it is essential to verify that your products are successfully sent and properly listed in the marketplace. Follow these steps to finalize the setup:
1. Verify product status in the Marketplace
After setting up your APIs, products may be successfully sent to the marketplace but may not yet be live. To resolve this, ensure that your Maxeda account in Mirakl has completed all required steps as discussed in the Account acceptance section of this article.
When you log in to Mirakl, you can see the status of each shop. If a shop is not live, it may indicate that additional information is required. In such cases, contact Maxeda for assistance.
2. "Golden" rules errors
When sending products to Maxeda for the first time, you may encounter the error: "mirakl_unknown_error_code" followed by "The product does not exist". This error occurs when some or all of the EANs/products are not yet reviewed and accepted by Maxeda. These products will be reviewed by Maxeda according to their golden rules policy.
3. Product review timeline
The Maxeda content team typically takes about a week to review products. If the products comply with their policy, the error will be resolved, and the products will go live.
Step 6: Verify product listings for errors
Once you have resolved the "mirakl_unknown_error_code" and the subsequent "The product does not exist" error, you can manage the APIs as you would for any other Marketplace in Channable. However, remember to synchronize changes across both APIs whenever you make modifications.
To review your errors, navigate to the Preview tabs of your APIs. Here, you can see which product listings have errors and need corrections.