# How to set up a Kaufland channel (API) (V2)

Kaufland is an online marketplace based in **Germany**, with online storefronts available in **Czechia, Austria, Poland,** **Slovenia, France,** and **Italy**.

In this article, you’ll learn how to set up a Kaufland V2 channel to list your products on Kaufland. We’ll walk you through how to connect your Kaufland seller account to Channable, set up your listings, and resolve errors.

***

### **Before you start** <a href="#h_01jvma22pwcrd7wsjbvjq7pfde" id="h_01jvma22pwcrd7wsjbvjq7pfde"></a>

**You'll need**

* [A Kaufland global marketplace seller account](https://www.kauflandglobalmarketplace.com/en/seller-university/registration/seller-registration/)&#x20;
* Product data imported in the local language of the region you want to sell in (e.g. Polish product data to sell in Poland).

**Good to know**

* Visit [Kaufland’s Seller University](https://www.kauflandglobalmarketplace.com/en/seller-university/) for Kaufland-specific information.
* To sell on Kaufland in multiple countries, you need to create a new channel for each country.
  * You’ll need to enable each country in your Kaufland Seller account before activating your channel.&#x20;

#### Step 1: Create your Kaufland channel <a href="#h_01jvma22pxhj90yy43s0hacxxq" id="h_01jvma22pxhj90yy43s0hacxxq"></a>

{% hint style="info" %}
**Tip:** For more information, hover over the <i class="fa-circle-question">:circle-question:</i> tooltip.
{% endhint %}

1. In Channable, go to **Projects** > **\[Your project]** > **Channels.**&#x20;
2. Click **+ Create Channel**, select Kaufland.
3. Set up your channel settings:
   1. For **Name**, choose a name for your channel.
   2. For **Unique ID per item**, select the field containing your product IDs. (This is often ‘id’).
   3. For **Kaufland country,** select the country to advertise your listings.\
      **Important:** You’ll need to create a channel for each country you want to sell in.
   4. For **Listing requirement level**:
      * If you only want to add your offer information to existing product listings on Kaufland, select **Offer only**.
      * If you want to add product information to existing offers on Kaufland, select **Product only**.
      * If you want to send offer and product information, select **Product & offer**.
   5. For Use master rule group (optional), add a master rule group or leave this empty.
4. Click **Save**.

{% hint style="warning" %}
**Important:** Once you save your settings, you won’t be able to change the region (Kaufland country) or listing requirement level.
{% endhint %}

#### Step 2: Categorize your products <a href="#h_01jvma22pxx1zwj8jef2kb3p6f" id="h_01jvma22pxx1zwj8jef2kb3p6f"></a>

1. In **\[your Kaufland channel]**, go to the **Categories** step.
2. Map (assign) categories for all items.

{% hint style="info" %}
**Note:** You can [generate categories based on a category field](/manage-improve-product-data/categorize-products/create-product-categories/use-the-generate-categories-function.md) or [create categories from scratch](/manage-improve-product-data/categorize-products/create-product-categories/add-categories-manually.md).
{% endhint %}

#### Step 3: Create rules <a href="#h_01jvma22px10cn3tek56p9z8fy" id="h_01jvma22px10cn3tek56p9z8fy"></a>

When your product data is incomplete or doesn’t match the format that Kaufland requires, you can use rules to make improvements.&#x20;

1. Create rules to optimize your products and meet Kaufland’s listing requirements.

{% hint style="success" %}
**Tip:** Use [rule templates](/manage-improve-product-data/rules-bulk-edit-and-enrich/using-rules/rule-templates.md) to quickly set up rules.
{% endhint %}

#### Step 4: Map shared attributes <a href="#h_01jvma22px72kp0ay63kjjqac4" id="h_01jvma22px72kp0ay63kjjqac4"></a>

{% hint style="success" %}
**Tip:** Hover over <i class="fa-circle-question">:circle-question:</i> for more information about the attribute, accepted values, and an example.&#x20;
{% endhint %}

1. Go to the **Build** step.
2. In the **Shared attributes** tab, click on each dropdown to map a field from your import to the corresponding attribute:
   * **EAN:** Field containing your product’s EAN codes
   * **Stock:** Field containing stock quantities
   * **Title:** Field containing title text
   * **Description:** Field containing your item description
   * Mpn: Field containing your model information or manufacturer number
   * **Condition:** Select the product condition from **Static values**
   * **Comment (optional):** Field containing any comments shared on a particular product
   * **Price:** Field containing pricing information
   * **Minimum price:** Field containing the minimum price allowed for automatic price adjusting ([Kaufland’s Smart pricing](https://www.kauflandglobalmarketplace.com/en/seller-university/selling/smart-pricing/))
   * **Images:** Click **+ Add** and map the field containing your images
   * **VAT:** Select **Static values** and choose your VAT rate
   * **Shipping group ID:** Manually write your [shipping group ID](https://sellerportal.kaufland.de/shipping-groups/)
   * **Warehouse ID:** The ID of the warehouse your products are located in
   * **Handling time:** The time in days from order to handing over the product to the carrier for delivery
3. Map any remaining attributes marked as required by marketplace.
4. Click **Save**.

#### Step 5: Map category attributes <a href="#h_01jvma22px99btnnf4g2z7thze" id="h_01jvma22px99btnnf4g2z7thze"></a>

1. Go to the **Attributes per category** tab.
2. Select a category from the list.
3. To comply with the General Product Safety Regulation (GPSR) for Kaufland, you need to provide information about your EU Responsible Person. Scroll down to the **Kontakt für Produktsicherheit** (Product Safety Contact) section.
4. Next to **Herstellername / Verantwortliche Person für die EU** (Manufacturer name / Responsible person for the EU), click **+ Add**.
5. Fill in the required information for your manufacturer or EU Responsible Person:
   1. **Name**: Enter the name of the manufacturer or the EU Responsible Person.
   2. **Adresse**: Enter their full address.
   3. **Email-Adresse:** Enter their email address.
   4. **URL**: Provide the URL of their contact page.
   5. **Telefonnummer**: Provide their contact phone number.
6. Map any remaining attributes that are marked as required by Kaufland.
7. Click **Save**.
8. Repeat these steps for each category.

<details>

<summary><strong>How to map manufacturer information</strong></summary>

**If you have one manufacturer for all your products:** In the dropdown, select **Manual** and fill in the information directly.

* **If you have different manufacturers for products in this category:** You will need to create a new field to dynamically provide the manufacturer information using rules.

</details>

{% hint style="success" %}
**Tip:** Click **Auto-map fields** to automatically map categories with information previously provided in the same channel. [Learn more](/list-advertise/sell-on-marketplaces/auto-map-fields-for-marketplaces-apis.md).
{% endhint %}

### **Step 6: Note your client and secret key** <a href="#h_01jvma22pw328rfz6mc81hpbmz" id="h_01jvma22pw328rfz6mc81hpbmz"></a>

1. Log in to your **Kaufland** seller account.
2. Go to **Settings > Shop Settings** and click **API**.
3. Select **Channable.** Kaufland will generate a Client Key and Secret Key. Note these down, as you will need them in the next step to connect your channel to Kaufland.

{% hint style="info" %}
**Note:** If you forget your Client key and/or Secret key, you’ll need to re-generate new credentials in your Kaufland Seller portal by clicking **Generate new API keys**.&#x20;
{% endhint %}

#### Step 7: Connect to Kaufland <a href="#h_01jvma22px3wd3m6z7p50dy6gq" id="h_01jvma22px3wd3m6z7p50dy6gq"></a>

1. Return to the **Settings** step.
2. At **Linked seller account**, click **Select seller account**.&#x20;
3. Select an existing seller account, or click **+ Add new connection** to add a new seller account:
   1. If adding a new seller account:
      * For **Label**: Name your connection
      * For **Client Key**: Fill in your client key (collected in the previous step)
      * For **Secret key**: Fill in your secret key (collected in the previous step)
      * Click **Connect with Kaufland**.

We'll redirect you to Kaufland to log in with your credentials and accept permissions.

#### Step 8: Activate your channel <a href="#h_01jvma22pxb16qvekzyx7wfs97" id="h_01jvma22pxb16qvekzyx7wfs97"></a>

1. In the **Settings** step in **\[your Kaufland channel]**, click **Activate API.**
2. Click **Save**.
3. Click **Run now** to send your listings to Kaufland.

To see which product listings are now active on Kaufland, go to the **Preview** step.

#### Step 9: Review and fix listing errors <a href="#h_01jvma22pxcw5k6eg06yd7k6bv" id="h_01jvma22pxcw5k6eg06yd7k6bv"></a>

1. Go to the **Result** step and click the **Feedback** tab.
2. Note the issue causing the error, and fix it by mapping the appropriate field or adjusting your import fields with rules.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/kaufland/how-to-set-up-a-kaufland-channel-api-v2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.