The purpose of this procedure is to explain how to use BeezUP to publish your products on the Kiabi marketplace.
SUMMARY
1. Prerequisite to know before integrating Kiabi marketplace
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.
Products publications are, by default, inactive. If you want to turn them on, please go to "API settings" page.
Required EANs
Kiabi accepts only products provided with EAN.
2. Integration process
✔️ If you don't have any account, contact Kiabi support service.
✔️In BeezUP, add the channel "Kiabi API" in 'my listings.
✔️Proceed to categorization for the categories you want to send.
✔️Proceed to the mapping of "Kiabi API" 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".
✔️ Enable Kiabi API (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 Kiabi, to make sure they do create your products.
Once Kiabi creates your products, check your "Offers" publications, to make sure then your offers appear online on KIabi. 🎉
✔️ If everything is fine (products & offers), your products are ready to be sold and your sales will appear in the "Order" tab within BeezUP or your own back-office if you enabled this option.
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 Kiabi. You can do this via the "Filtering - Stock" field and, of course, add the corresponding filter ("Product Filters" tab).
Map the "Produit parent" field (variant_group_code) to your "ParentID" 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 Home 24, you can filter on the "Variation Axis" field in our tool.
4. Attributes meaning
Very often, in your product release report, you will get a code list attributes in error. Unfortunately, these codes can be difficult to understand.
To help you know their correspondence with the attributes from the mapping page, we created a portal: 👉 click here to discover it.
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 Kiabi!