This procedure explains how to use BeezUP to publish your products on the Worten marketplace.
CONTENTS
1. Prerequisites to know before integrating the Worten 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.
b. Mandatory EANs
Worten only accepts products with an EAN.
2. Integration Procedure
✔️ If you do not have an account, contact the Worten sales team.
✔️ In BeezUP, add "Worten API" (available for Portugal and Spain) in the "Channels" tab.
✔️ Categorize the categories you wish to transmit.
✔️ Proceed with the "Worten 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 Worten 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 Worten, you can consult the "Latest Publications" tab, which will provide you with all the details necessary for any changes to your feed and/or mapping.
✅ The most important thing, if your products have never been created on Worten, is to ensure that the "product" feeds are OK; these are what allow product creation.
Once "OK," ask Worten 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 Worten. You can do this via the "Filtering - Stock" field and, of course, add the corresponding filter ("Product Exclusion" tab).
Map the "Parent ID" field (parent_id) 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 Worten, 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.