First of all, you need to activate the Mergado Marketplaces app in the Mergado Store. Before you start, make sure you have:
Verified business account on Kaufland
Product feed in Mergado Editor with EAN codes
Heureka/Mall availability feed
In this tutorial we will show you how to create a campaign and upload products to Kaufland Global Marketplace.
First, you need to create and set up your Kaufland Global Marketplace account correctly. Detailed information about registering on the Kaufland marketplace can be found here: https://www.kaufland.de/i/seller-university/en/registration/.
Creating a connection
In the Marketplaces app, you first need to go to the “Connections” tab and then click on the blue icon to add a connection at the Kaufland marketplace. The “Connection detail” tab will open.
On the “Connection Detail” tab you need to enter the API keys which you can find in your administration directly on the Kaufland marketplace website. Here you go to “Settings” → “Store Settings” → “API”. Your API keys (“Client Key” and “Secret Key”) are listed at the top. If there are none here yet, simply generate new ones. Save the keys safely after generating them, you will only see them after they have been generated - after that you will not be able to view them again.
Then enter these keys into the Mergado Marketplaces app under the “Connection detail” tab and proceed with the connect button - the connection should now be active.
If you re-generate keys in Kaufland administration and get new ones, the original ones will lose their validity. So if you have old keys stored in Marketplaces and you generate new ones in Kaufland Administration, the connection will no longer work.
Creating campaign in the app
In the menu, go to the “Campaigns” tab and then click on the “Create Campaign” button. You will be greeted by a campaign creation wizard with five steps.
1. General
First step is to fill in the campaign name. The name can be any name you want. However, we recommend one that makes it clear at a glance what the campaign is about.
2. Marketplace
In the next step you need to select which marketplace you want to upload the offers to. So we choose “Kaufland”. Then a field for selecting “Storefront” (the country in which the offers will be sold) will open.
Here you can also select the CONDITION and HANDLING_TIME value for all products in the campaign at once (see the description of the field elements). However, if all your products don’t have the same condition or order handling time, you can pair this data to your product feed later.
3. Mergado
In the next step you need to select from which Mergado project and query you want to upload products to the marketplace.
You don’t have any export to choose yet? See how to upload a product feed to Mergado Editor here.
If you don’t want to send all products from a given project to the marketplace, create a selection of products you want to upload to the marketplace in Mergado Editor. Please note that you cannot change the selection later in the campaign settings. It is also not possible to edit the product composition in the application using the hide rule, as this rule is not transferred to Mergado Marketplaces.
This will then open the section for mapping elements from the selected project in Mergado to elements in the Marketplace app. It is obligatory to map the elements EAN, PRODUCT_ID and PRICE.
Mapping is usually pre-filled, but it may not be correct. Check if you are mapping the correct elements - i.e. the ones that contain the required values in the Mergado project (these values are then uploaded to the marketplace). The element mapped to PRODUCT_ID must be the one that is used to match products from the availability feed.
If you selected a value for CONDITION and HANDLING_TIME in the previous Marketplace step, do not pair these elements here.
Please note that for DE and SK storefront you have to pair the price in EUR and for CZ storefront in CZK.
4. Availability feed
5. In the next step insert the URL of the availability feed in Heureka or Mall format. After clicking on the “Next” button, the availability feed will be checked. If there are any missing products from the selected query, the application will inform you about it. If you get the information that all products are missing, you have probably entered a different availability feed or you have incorrectly mapped the PRODUCT_ID element in the Mergado step. Products that are in the selection but missing in the availability feed will not be uploaded to the marketplace. If your availability feed is somehow restricted you need to remove this restriction.
If you encounter the error message “An error occurred while downloading the availability feed, please make sure the file is available”, it is likely that you have the availability feed secured and so the application cannot access it. If you have your online store on Shoptet, then here you can find instructions on how to adjust the security of your availability feed in Shoptet administration so that the application can access it.
5. Completion
The last step is just a final summary. Make sure you have everything filled out correctly and correct the information if necessary. Finish creating your campaign with the “Save” button on the bottom right. This will create the campaign and the offers will automatically start uploading to the Kaufland marketplace. This process may take some time.
After the synchronization of the product feed is complete, click on the campaign detail and check the validation section for any error messages. For an explanation of the most common validation messages, see here.
Do you have the error message “No product card with this EAN code was found in the Kaufland catalogue, please go to the ‘Product cards’ section to create one” in the validation? This message means that a product card does not yet exist for the products in the Kaufland catalogue. You can find detailed instructions on how to create a product card via our app here.