Marketplaces > Marketplaces G-M > Kaufland.de > CHANNEL SHEET: KAUFLAND.DE (MARKTPLATZ)

CHANNEL SHEET: KAUFLAND.DE (MARKTPLATZ)

TIP:
Use the integration guide to integrate new channels and refer to this Channel Sheet whenever the guide prompts you to.

This Channel Sheet contains all channel-specific information for Kaufland.

CHANNEL BASICS

The following channels are available for Kaufland:

CHANNEL	SIGN	ID	CURRENCY
Kaufland.de (Marktplatz)	hide	179	EUR

TIPP: The new main channel
If you want to connect to one of the new country channels, switch to the new main channel:

CHANNEL	SIGN	ID	CURRENCY
Kaufland (Hauptkanal)	kfmc	701	---
Kaufland.de	kfde	702	EUR
Kaufland.sk	kfsk	703	SEK
Kaufland.cz	kfcz	704	CZK
Kaufland.at	kfat	711	EUR
Kaufland.pl	kfpl	712	PLN
Kaufland.it	kfit	827	EUR
Kaufland.fr	kffr	828	EUR

PRELIMINARY INFORMATION

•New to TB.One? Our webinars help you find your way around the software.

•The channel provides a test system (sandbox). While you're in the integration phase, use it to check how your content will look.

•Generate your API access data in your retailer account in the backend of Kaufland and forward them to your Solution Delivery Manager.

•Provide your product data in German.

•Go to the menu "Basic data > Storage > Warehouse settings" and check your settings for the channel (for more information, click here).

•Kaufland uses these values to calculate the delivery time displayed on kaufland.de:
handling_time (transport preparation time): number of working days until handover to the carrier. This value is automatically exported to the channel and calculated from the values of "delivery time" and "delivery time offset" in TB.One:
1. Store the value "delivery time" in the article data (open the article via the article list, stay on the tab "Article data", and go to the section "Stock")
2. Store the value "delivery time offset" at "Basic data > Storage > Warehouse settings".
transport_time (shipping time): number of working days from handover to the carrier until arrival at the end customer. Store this value in the channel back-end.

•At Kaufland you can create links between your products. These links will be shown in the shop (for example as an upselling option). Click here to learn how to create and configure links between products.

ATTENTION: Perfluoroalkyl and polyfluoroalkyl substances (PFAS) prohibited
The sale of products containing perfluoroalkyl and polyfluoroalkyl substances (PFAS) is prohibited in France since the 1st of January of 2026. PFAS is commonly used in waterproof or stain-resistant finishes and cosmetics, please audit your articles on French platforms to ensure they are compliant.

CHANNEL-SPECIFIC SETTINGS, FEATURES, AND PROCESSES

REFERENCE NUMBER

CHANNEL-SPECIFIC INSTRUCTIONS

B-01: Payments

Find your payment methods at "Basic data > Payment > Payment methods".

At Kaufland you manage the payments yourself.

D-01: Product designation

The length of the product designation is limited to 512 characters.

For Kaufland, the product title is composed of brand, designation, size, colour and manufacturer's article number.

Technically, the title length is restricted to 512 characters. For the purpose of better readability, please keep your product titles significantly below the maximum length.

D-02: Special text

Kaufland does not use the field "Special text".

D-03: Description

The length of the product description is limited to 5,000 characters .

D-04: Components

The following components are mandatory at Kaufland:

•Energy efficiency class (for relevant product)

•Depending on the product category, different components may be mandatory (identifiable from the attention symbol in the value mapping)

•Provide GPSR information for manufacturer's name, address and additional contact information. Use this format for the manufacturer's address: "Examplestreet 1, Examplecity, Postcode, DE”

D-05: Attributes

The following attributes are mandatory at Kaufland:

•Base price indications (if applicable)

E-01: Article numbers

Provide the following article numbers:

•Article number

•EAN

•Manufacturer's article number (optional)

E-02: Shipping information

Provide the following shipping information:

•Pack sizes (height, length, width in cm) (recommended)

E-03: Variant dimensions

There are no variants for Kaufland. The variants maintained in TB.One are displayed on the channel as individual articles.

F-01: Media

•Provide images in a commonly used format such as png or jpg.

•Number: min. 1 product image, several article images recommended

•Size: min. 1,200 px edge length

•Resolution: min. 72 DPI

•Other: white background, first image as crop-out

•Assign all media types except safety data sheets to the export key "IMAGE"

•Assign safety data sheets to the export key "SAFETYDATASHEET"

•Energy efficiency labels have to be transmitted as images (master media type "ENERGY" assigned to export key "IMAGE")

TIP:
According to the EAA (European Accessibility Act) you need to store alt texts for your images. You can specify them in your TB.One CSV import for product/article data:

Add the following columns to your import files for alt texts:

•Item images: “a_media_alt_text[key]{lfdnr}”

•Product images: “p_media_alt_text[key]{lfdnr}”

Make sure that the values “[key]” and “{lfdnr}” in the alt text column correspond exactly to those in the associated image column (“a_media[key]{seqno}” / “p_media[key]{seqno}”). Only then will your alt texts be assigned to the correct image.

G-01: Carrier

•Ship with DHL or use a carrier of your choice

•You can define surcharges for your Kaufland shipping types at "Basic data > Prices > Surcharges/Discounts".

G-02: Delivery note

The delivery notes are transmitted to TB.One by the channel. They are attached to the orders. To print them, open the order via the order list and click on "external documents". If you don't manage your orders in TB.One, ensure your system can process the attachments and print PDFs.

G-03: Invoice

You don't need to print invoices for Kaufland. The channel sends the invoices to the customers. Print invoices for your own records only.

G-04: Proposed return code

Dispatch advices you forward to the channel must include a proposed return code for the return shipment label.

To that end, do one of the following:

a)configure a number range in TB.One.

b)if you manage orders outside TB.One, configure your system so that it forwards the return code to TB.One (CSV/XML: "IDCODE_RETURN_PROPOSAL").

c)manually enter return codes during order processing.
Activate the required input field in the menu "Admin > System settings > Order processing" under "Manual input Return code proposal". The field ("Ret.-Code Prop.") will then be displayed for each order on the tab "Delivery & Cancellation".

G-05: Delivery documents in package

Delivery note

G-06: Refund deduction

At Kaufland you can deduct a percentage from the reimbursed amount, if an article is returned in bad condition. In that case, specify the precentage you want to deduct on corresponding order's "Returns" tab.

Contact the channel, if you want to use this.

G-07: Return causes

To create return causes and states, go to "Basic data > Returns > Return causes" and "Basic data > Returns > Return states" .

Kaufland does not process return causes and states.

X-01: Size grid

Kaufland does not use size grids.

X-02: Base prices

Provide base prices (price per kg, price per liter, etc.) for all articles that legally require you to do so.

X-03: Categories

For a complete list of all categories, go to "Basic data > Classification > Typification". To reduce the number of categories available for selection at the product, mark categories that you do not use as "not assignable".

Channels change their categories from time to time. Any major changes will be announced in TB.One. Outdated categories are highlighted with a red icon. Move all affected products to valid categories.

X-04: Value mapping

Map at the category level for Kaufland. The available channel values may differ from category to category.

TIP:
If you recently switched to the new main channel, then you have to re-map your old values.

X-05: Pending orders

Kaufland transmits pending orders.

X-06: Partial deliveries

Partial cancellations and partial deliveries on article level.

X-07: Commission group

Kaufland does not use commission groups.

X-08: Service logos

Kaufland will not display service logos you transfer in the shop.

X-09: Error and status messages

Kaufland does not provide error and status messages.

X-10: Templates

At Kaufland you cannot use templates.

X-11: Text configurator

The text configurator cannot be used for Kaufland.

X-12: Product text profile

Product text profiles cannot be used for Kaufland.

X-13: Title profile

You can use title profiles to configure the product titles shown in the channel's shop. For more information on title profiles, click here.

X-14: Cross prices

Kaufland does not display cross prices.

SPECIAL REQUIREMENTS

For tax reasons, Kaufland indicates in the order file whether the ordered articles originate from within or outside the EU.

This information is available in your TB.One when accessing the order via the order list (“Orders > Order list”, tab “Consignee & Positions”). In the bottom line, you receive the note "is_marketplace_deemed_supplier" with one of both values:

•"true": The article comes from outside the EU.

•"false": The article originates from within the EU.

Both values may apply within one order consisting of several articles. In such a case, the order will be separated into two orders - each with the respective value. If, e.g., the order includes article A originating from within the EU and article B from outside the EU, two orders with different IDs are transferred from the channel to your TB.One. You will then receive two orders in your order list. Further order processing is carried out as usual.

Make sure the order data containing this additional information (as part of the so-called “Order Services”) can be processed smoothly in your system.

DATA EXCHANGE TIMES

DATA	TIME/FREQUENCY
Catalogue (Full)	1 x weekly
Catalogue (Delta)	1 x daily
Stock (Delta)	every hour
Media	With catalogue
Retrieve and import orders	every half hour
Order messages	every half hour