This procedure aims to explain to you how to use BeezUP to publish your products on the xxxLutz marketplace (Germany, Austria).
SUMMARY
1. Prerequisite to know before integrating xxxLutz marketplace
a. Offers and products publications
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.
b. Required EANs
xxxLutz accepts only products provided with EAN (GTIN-13 / EAN-13).
2. Integration process
How to become a seller on the xxxLutz Marketplace?
If you are interested in applying as a trading partner on the xxxLutz marketplace, please contact [email protected]
Within BeezUP, add “xxxLutz DEU API V.2” within the “Channels” tab.
You can categorize the products you want to send.
Proceed to the mapping of "xxxLutz DEU API V.2" in order to send, at least, all required information.
⏩ For more information on each field, you can click on the "i" info to obtain explanations and / or go to 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".
6. Enable xxxLutz DEU API V.2 (Switch ON).
If everything is OK, publications should start within 2h. In order to make sure that publications are well occurring, you can check the "Last publications" tab to access publication results and detailed error page.
✅ Make sure, at first, your "products" publications are OK.
Once all potential errors are fixed on products feed, contact xxxLutz, to make sure they do create your products.
Once xxxLutz creates your products, check your "Offers" publications, to make sure then your offers appear online on www.xxxlutz.de. 🎉
7. 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 xxxLutz. You can do this via the "Filtering - Stock" field and, of course, add the corresponding filter ("Product Exclusions" tab).
Map the "Variant Group Code" (variantGroupCode) 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 xxxLutz, you can filter on the "Variation Axis" field in our tool.
4. Attributes meaning
Sometimes, in your product release report, you will get a code list attributes in error.
You could find the requested attribute by its code or by its label in the search bar on the column mapping page.
👉 To get more information about requested attributes.
We hope this page will help you better understand your error reports and thus allow you to act as quickly as possible on your publications.
We wish you good sales on www.xxxlutz.de!