This procedure explains how to use BeezUP to publish your products on the Ubaldi marketplace.
CONTENTS
1. Prerequisites for selling your products on Ubaldi
Update Frequency & 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.
EAN Required
Ubaldi only accepts products with an EAN.
2. Integration Procedure
✔️ If you do not have an account, contact the Ubaldi sales team.
✔️ Within BeezUP, add "Ubaldi API" in the "Channels" tab.
✔️ Categorize the categories you wish to transmit
✔️ Map the "Ubaldi API" to transmit, at a minimum, all required fields.
👉 For more information on each field, you can click on the "i" info to get 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 (switch to ON) the Ubaldi API, within a maximum of 2 hours - if everything is OK - publications should begin. To verify that submissions are being made correctly to Ubaldi, you can consult the "Latest publications" tab, which will give you all the details necessary for any possible modifications to your feed and/or mapping.
✅ The most important thing, if your products have never been created on Ubaldi, is to ensure that the "product" feeds are OK; these are the ones that allow product creation.
Once "OK," ask Ubaldi to launch product creation if they are not automatically created.
Once created, your offers feeds will then be "OK" (and no longer "The product does not exist"), which means 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. 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 in 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 quickly on your publications.
Happy sales on Ubaldi!