# 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](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/categorize-products/create-product-categories/use-the-generate-categories-function) or [create categories from scratch](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/categorize-products/create-product-categories/add-categories-manually).
{% 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](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/using-rules/rule-templates) 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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/auto-map-fields-for-marketplaces-apis).
{% 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.