With this interface you can connect Xentral with Kaufland 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
-
Change order status on dispatch incl. notification of tracking number
-
Transfer articles individually from Xentral to Kaufland or from Kaufland to Xentral
-
Reporting of current stock figures in case of stock changes
-
Transfer of invoices to Kaufland
Follow the steps below to generate your API data at Kaufland:
-
Log in to the merchant area (www.kaufland.de/seller).
-
Click on Merchant settings > Shop settings in the main menu.
-
Go to the API tab.
-
Select Xentral as interface and save.
-
Click on Generate new API keys.
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.
The view opens on the Details > Interface tab. Here you can enter the API data.
Now click the Check Connection button on the right side. If the connection is successful, a success message will appear.
This section explains the possible settings in the shop interface.
When you open the settings of the Kaufland interface, the Details > Interface tab will be displayed.
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.
-
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 shop importer.
You need to map your products between Kaufland and Xentral . This enables the synchronization of products between Kaufland and Xentral . In addition, it enables the allocation of sales orders from Kaufland to the mapped products in Xentral .
To map the products between Kaufland and Xentral :
-
In the Kaufland shop interface in Xentral go to Details > Product Mapping.
-
Click Pick up item list.
The products from Kaufland are retrieved and listed here. The Assignable column identifies the products that can be mapped automatically to their counterparts in Xentral based on identical EANs.
Xentral automatically creates two entries in the Xentral product's external numbers from the data imported via the shop interface:
-
apiitemid - This is the old designation used by the obsolete API. It is automatically created because it is transferred by the Kaufland shop interface. You can ignore this number.
-
apiunitid - This is the valid designation for the Kaufland external number.
-
-
Click Assign item.
The products that have been identified as Assignable are now assigned. This means:
-
The Assigned column indicates that they have been assigned.
-
In the External Numbers tab of the corresponding product the two Kaufland-related external numbers (apiitemid and apiunitid) become Active.
-
Note
When you click on Pick up item list, any product that was already assigned becomes unassigned. You have to re-assign all products by clicking Assign item again.
If needed, you can manually disable an active mapping of a product or change the mapping to a different product in Xentral .
To manually disable and re-enable the mapping of a product:
-
In the Kaufland shop interface in Xentral go to Details > Product Mapping.
-
In the list of products from Kaufland, click the
icon on the right side of the product whose mapping you want to disable.The assignment is disabled. This means:
-
The Assigned column indicates that they are not assigned.
-
In the External Numbers tab of the corresponding product the Active checkbox of the two Kaufland-related external numbers (apiitemid and apiunitid) is cleared.
These two external numbers will not be deleted but disabled, so that you can re-enable them at any time by assigning the corresponding mapping in the Product Mapping tab, see below.
-
To change the mapping of a Kaufland-listed product to a different Xentral -listed product:
-
In the Kaufland shop interface in Xentral go to Details > Product Mapping.
-
In the list of products from Kaufland, click the
icon on the right side of the product whose mapping you want to change. -
In the Edit Product dialog box that appears, enter the desired product on Xentral side. You can click the
icon in the entry field to search for a suitable product. -
Click Save.
The mapping is created: In the External Numbers tab of the corresponding product the two Kaufland-related external numbers (apiitemid and apiunitid) are created and set to Active.
For more information about importing products from kaufland.de to Xentral , refer to this article.
To be able to list an article at Kaufland, you have to set a link to this webshop at the respective article (Master data → Articles → *Select article* → Online shop options). If the online shop has not been linked yet, you have to click on New entry and enter Kaufland there:
If the cogwheel icon 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 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. If the article is edited directly, mandatory fields are displayed with bold red font.
Note
In the article data (you can get there by clicking on the cogwheel) you can address different fields by variables. You can use either variables or text, but you cannot mix both in one field. For example, if you wrote "{Free field1} liter" to create a quantity with a unit, the variable would not be read correctly and you would get "{Free field1} liter" instead of "10 liter".
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 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.
