Table of contents
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).
Features of the interface
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
Connection
Generate API data at 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
Create interface in xentral
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.
Quick start
To get started as quickly as possible, only a few settings and actions are required. What is necessary for a quickstart with order import, stock number comparison and feedback of tracking numbers you can read here.
Store settings
This section explains the possible settings in the store interface.
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
Settings
Information about this tab can be found here.
Payment methods
Information about this tab can be found here.
Shipping methods
Information about this tab can be found here.
Free fields
Free fields are currently not available for Kaufland.de.
Subshop
Subshop mapping is currently not available for Kaufland.de.
Language/Supply country
Information about this tab can be found here.
Group mapping
Group mapping is currently not available for Kaufland.de.
Smarty
You can learn more about using Smarty in this helpdesk article: Smarty in the store importer.
Article mapping
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.
Workflows
Import articles
How to import articles from WooCommerce to xentral you will learn here.
Export articles
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.
Synchronize stock numbers
How you can synchronize the stock figures, you will learn here.
Import orders
Importing orders from online stores is described in this article.
Special cases / Other information
Invoice transfer
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.
Linking the articles from xentral to Kaufland.
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.