With this interface you can connect xentral with kaufland.de to import orders from there into xentral and to manage your items sold in the store in xentral. The connection is done via an API interface (Shopimporter).
The Kaufland interface offers the following features:
-
Pick up orders from kaufland.de
-
Change order status on dispatch incl. notification of tracking number
-
Transfer articles individually from xentral to kaufland.de or from kaufland.de to central
-
Reporting of current stock figures in case of stock changes
-
Transfer of invoices to kaufland.de
Follow the steps below to generate your API data at kaufland.de:
-
Log in to the merchant area (www.kaufland.de/seller)
-
Click on "Merchant settings" in the main menu
-
Click on "Shop settings" (submenu of "Merchant settings")
-
Click on "API" (menu bar above)
-
Select xentral as interface and save
-
Click on "Regenerate credentials
Under Administration → Shop interface → Overview → NEW you can select the Kaufland Shop.
Note
Until version 21.1 it's via Administration → Online Shops / Marketplaces→ NEW.
You will land directly in the tab Details → Interface. Here you can enter the API data.
Now click the Check Connection button on the right side. If the connection is successful, "Success" will appear as a message.
This section explains the possible settings in the store interface.
When you open the settings of the Kaufland interface, you will first land in the tab Details → Interface.
Settings:
-
Designation → Name freely selectable for the store (will be displayed e.g. in the article and in the import menu).
-
Active → Check the box to make the interface active. You can set interfaces that are no longer needed to inactive.
-
Project → Link the store to a project. In the project you can make the logistics settings
-
Pickup mode → At Kaufland you can pick up here from a certain date.
-
Date from → Orders will be picked up from this date, updated when you use the Pick up orders function.
-
Import mode → Determines whether the orders from the store should be imported manually (by pressing a button) or automatically
-
Demo (for testing) → The order status in the store is not changed, no items or stock numbers are transferred
-
Manual (with import center) → The orders will only be fetched when the button Fetch orders is clicked
-
Automatically (via process starter) → The orders are picked up automatically from the store on a regular basis. The Shopimporter process starter is required for this purpose.
-
Only 1 order per request → Only 1 order per request is transferred from the store.
-
Orders in intermediate table → When picking up the orders, the orders are not created directly, but are first stored in an intermediate table for review. Here you can decide which orders should be created and which should be imported later.
-
Logging in the logfile → By checking this box you activate the logfile and the information will be logged in it.
-
Client Key → The client key of the API data that you have generated at kaufland.de
-
Secret Key → The secret key of the API data that you have generated at kaufland.de
-
Always transfer product data → At Kaufland, the product data is usually transmitted once and Kaufland then judges whether it is accepted. A product description, for example, is then sent as a suggestion during the first transfer and then no longer. If you check this box, the product data will be transferred with each article export.
-
Automatically remove items without stock from the store when updating → If an item is out of stock, it will be automatically removed from the store at the next update
Action:
-
Check Connection → Checks the connection between both systems.
-
Pick up orders → Pick up orders from your store. Note: You should also make sure that the status messages for "Order open", "Order in process" and "Order ready" are unique. You must not use the same status in multiple places.
-
Store import intermediate table → Jumps to the intermediate table of orders from the store. The intermediate table is filled only in manual import mode and if the 'Orders in intermediate table' option is enabled. In the intermediate table you choose in the left column between "Import", "Garbage" and "Later".
-
Import: Job is imported directly
-
Trash: Job ends up in the trash and cannot be imported a second time.
-
Later: Job can be imported at a later time
-
-
Import old jobs → Old jobs will be loaded into the intermediate table, where you can again decide on
Information about this tab can be found here.
Information about this tab can be found here.
Information about this tab can be found here.
Information about this tab can be found here.
You can learn more about using Smarty in this helpdesk article: Smarty in the store importer.
Using the Article Mapping tab in the module (Shop interface → *Select Kaufland* → Details → Article Mapping, until version 21.1: Online Shops / Marketplaces → *Select Kaufland* → Details → Article Mapping) you can link the existing articles from Kaufland stores with the articles in xentral.
In the first step you should execute the action Fetch article list, which loads the existing articles from Kaufland.
In the loaded list you can assign individual articles to the xentral article by clicking the editor button and entering the article name.
With the action Assign article you finalize the whole thing.
How to import articles from WooCommerce to xentral you will learn here.
To be able to list an article at kaufland.de, you have to set a link to the webshop, in this case Kaufland, at the respective article (Master data → Articles → *Select article* → Online store options). If the store has not been linked yet, you have to click on New entry and enter Kaufland there:
If the "Gear" button does not appear after you have selected the importer, you have to reload the article.
Clicking on the Kaufland settings button will take you to the menu for Kaufland-specific settings. First you have to select a category for the article. The displayed categories are made up of suggestions that Kaufland has determined based on the product description. If the suggestions do not fit, you can explicitly search for a specific category using the manual search:
After you select a category, the category-specific fields are loaded. Fields that can be uniquely assigned by their name are provided with the corresponding wildcard. These values are filled with those from the item properties, so that for example the manufacturer number does not have to be entered again.
Please note that all mandatory values must be filled in for an item to be successfully offered for sale.
Unfortunately, the transfer of images is not possible directly. In order for an image to be transferred, you must enter the URL of the image as an external link in the product options. The link to the image from the file browser is not sufficient, but the image must be uploaded to an FTP server or similar for it to work. You can find the product options via the cogwheel symbol under Product > Online Shop Options > Kaufland interface in the Image field.
Please note that kaufland.de does not transfer item descriptions directly, but first checks them for content. The article description from xentral is therefore not directly displayed on the marketplace, but only helps to improve the already existing one. If an article is not available, although all fields have been entered, it is a good idea to search for the cause of the problem directly on kaufland.de. If the article is edited directly, mandatory fields are displayed with bold red font.
How you can synchronize the stock figures, you will learn here.
Importing orders from online stores is described in this article.
When an order is completed, the invoice PDF is automatically transferred to kaufland.de if the invoice already exists when the order is sent.
Therefore, you must have the invoice created in the project that belongs to the Kaufland store importer already in stage 1 of picking. The option to create the invoice only in the shipping station must therefore not be set.
To ensure a link between the two articles, two things are necessary:
-
Adding the SKU in the article's "Foreign number" tab.
-
Setting up the mapping via the Kaufland store importer in the "Article mapping" tab.
To do this, you must first pick up the items and then map them. The mapping is done based on the previously stored SKU in the article.
Note
In the article data (you can get there by clicking on the cogwheel) you can address different fields by variables. However, it does not work to specify variables & text, for example to add a unit of measurement, because the variable will not be read out and will still be passed as "{Free field1} liter", for example.