How to set up Maxeda channels (Praxis and Brico)

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 Language, choose the language your product data is in. 
   4. For Use master rule group, you can set a rule group if you already have one to apply to your channel.
   5. For Status, leave your API deactivated for now.
4. Click Save to create your channel.
5. Repeat this whole step to set up a channel for Maxeda Brico.

1. In [your Praxis channel], select Manual Categorization and generate categories using the field containing your category information.
2. Click Save.
3. Once your categories are ready, go to the Categories step in [your Brico channel].
4. Click on the Manual categorization tab and select Copy categories:
   1. For From project, select [the project containing your Praxis and channels]
   2. For From channel, select [your Praxis channel].
      
      Learn more about categorizing for marketplaces

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

The Build step is where you configure your product listings to match Maxeda's 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

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.

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

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.

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

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. 
4. We'll redirect you to Mirakl to log in with your credentials and accept permissions.
5. Repeat this whole step for your Maxeda Brico channel.

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.

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.

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 for remaining errors.
5. Repeat this entire step for [your Brico channel].
6. When you're ready, run [your Praxis channel] again by clicking Run now. 
7. Do the same for [your Brico channel].

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

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

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.

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.

1. At My catalog structure, click Root and select Category. This opens up all mapping related to categories.
2. Click Category again and select Remove mapping. 
   
3. Return to [your Maxeda Praxis channel] in Channable and click Run now to run it again.
4. Do the same with [your Maxeda Brico channel].

Your category mismatch should be resolved.