This procedure explains how to use BeezUP to publish your products on the Maxeda marketplaces (Brico.be and Praxis.nl).
CONTENTS
1. Prerequisites to know before integrating the Maxeda marketplace
a. Frequency & update modes
The product publication period is every 24 hours, that of offers depends on your subscription: dynamic (up to every 5 minutes), every hour or every 2 hours.
Note that they can also be launched manually from the "Publications" page of the marketplace.
Offers publications use "update" mode ('normal' on Mirakl side): publications only send offers matching these criteria:
modified offers since last successful publication
last publication failed offers
deactivated (or removed or filtered) offers since last publication : are sent with quantity=0
✅ Note : if your offers are all exactly similar to last successful publication, next publication will be skipped.
Products publications are, by default, inactive. If you want to turn them on, please go to "API settings" page.
b. Mandatory EANs
Maxeda only accepts products with an EAN.
2. Integration Procedure
✔️ If you do not have an account, contact the Maxeda sales team.
✔️ In BeezUP, add "Maxeda API" (Maxeda BEL API V.2 for the Brico.be marketplace and Maxeda NLD API V.2 for the Praxis.nl sales channel) in the "Channels" tab.
✔️ Categorize the categories you wish to transmit.
✔️ Proceed with the "Maxeda API" mapping to transmit, at a minimum, all mandatory fields.
⏩For more information on each field, you can click on the "i" info to obtain explanations and/or visit our dedicated portal here.
✔️ Go to API settings tab and enter your API access:
- Shop ID: which you will find in the "Dashboard" tab of your seller account on the Mirakl platform, opposite "Identifier"
- API Key: which you will find by clicking on your Profile at the top right, then "API Key".
✔️ After activating the Maxeda API (switch to ON), within a maximum of 2 hours - if everything is OK - publications should begin. To verify that submissions are being made correctly to Maxeda, you can consult the "Latest Publications" tab, which will provide you with all the details necessary for any possible changes to your feed and/or mapping.
✅ The most important thing, if your products have never been created on Maxeda, is to ensure that the "product" feeds are OK; these are what allow product creation.
Once "OK," ask Maxeda to launch product creation if they are not automatically created.
Once created, your offer feeds will be "OK" (and no longer "The product does not exist"), meaning that your products are now online and therefore purchasable! 🎉
✔️ From your first sales, these will appear - in BeezUP - in the "Orders" tab and possibly on your PrestaShop / WooCommerce back office or other, if your module is configured for it.
3. Special case of products with variations
If your products have variations such as sizes and/or colors, make sure your incoming feed adheres to the specifications indicated here.
If your incoming feed adheres to this structure, you must:
Filter the "parent" products; only the "child" products should be transmitted to Maxeda. You can do this via the "Filtering - Stock" field and, of course, add the corresponding filter ("Product Filters" tab).
Map the "Parent Product ID" field (parentproductid) to your "Parent ID" field, or any other field that contains a value common to all products in the same family.
Map the fields corresponding to the possible variation axes. To discover the axes authorized by Maxeda, you can filter on the "Variation Axis" field in our tool.
4. Attribute Mapping
Very often, in your product publication report, you will see a list of error attribute codes. These codes can unfortunately be difficult to interpret. To help you understand their correspondence with the attributes on the mapping page, we have created a portal: click here to discover it.
We hope this page will help you better understand your error reports and allow you to act as quickly as possible on your publications.