# Come configurare un canale Kaufland (API) (V2)

Kaufland è un marketplace online con sede in **Germania**, con vetrine online disponibili in **Repubblica Ceca, Austria, Polonia,** **Slovenia, Francia,** e **Italia**.

In questo articolo imparerai come configurare un canale Kaufland V2 per pubblicare i tuoi prodotti su Kaufland. Ti guideremo nella connessione del tuo account venditore Kaufland a Channable, nella configurazione degli annunci e nella risoluzione degli errori.

***

### **Prima di iniziare** <a href="#h_01jvma22pwcrd7wsjbvjq7pfde" id="h_01jvma22pwcrd7wsjbvjq7pfde"></a>

**Ti servirà**

* [Un account venditore globale Kaufland](https://www.kauflandglobalmarketplace.com/en/seller-university/registration/seller-registration/)&#x20;
* Dati prodotto importati nella lingua locale della regione in cui vuoi vendere (es. dati prodotto in polacco per vendere in Polonia).

**Buono a sapersi**

* Visita [la Seller University di Kaufland](https://www.kauflandglobalmarketplace.com/en/seller-university/) per informazioni specifiche su Kaufland.
* Per vendere su Kaufland in più paesi, devi creare un nuovo canale per ciascun paese.
  * Dovrai abilitare ogni paese nel tuo account venditore Kaufland prima di attivare il canale.&#x20;

#### Passo 1: Crea il tuo canale Kaufland <a href="#h_01jvma22pxhj90yy43s0hacxxq" id="h_01jvma22pxhj90yy43s0hacxxq"></a>

{% hint style="info" %}
**Suggerimento:** Per maggiori informazioni, passa con il mouse sul <i class="fa-circle-question">:circle-question:</i> tooltip.
{% endhint %}

1. In Channable, vai a **Progetti** > **\[Il tuo progetto]** > **Canali.**&#x20;
2. Clicca **+ Crea canale**, seleziona Kaufland.
3. Configura le impostazioni del canale:
   1. Per **Nome**, scegli un nome per il tuo canale.
   2. Per **ID univoco per articolo**, seleziona il campo che contiene gli ID dei tuoi prodotti. (Spesso è 'id').
   3. Per **Paese Kaufland,** seleziona il paese in cui pubblicizzare i tuoi annunci.\
      **Importante:** Dovrai creare un canale per ogni paese in cui vuoi vendere.
   4. Per **Livello di requisito di quotazione**:
      * Se vuoi solo aggiungere le informazioni della tua offerta a inserzioni prodotto già esistenti su Kaufland, seleziona **Solo offerta**.
      * Se vuoi aggiungere informazioni sul prodotto ad offerte già esistenti su Kaufland, seleziona **Solo prodotto**.
      * Se vuoi inviare informazioni su offerta e prodotto, seleziona **Prodotto e offerta**.
   5. Per Usa gruppo regole principali (opzionale), aggiungi un gruppo di regole master o lascia vuoto.
4. Clicca **Salva**.

{% hint style="warning" %}
**Importante:** Una volta salvate le impostazioni, non potrai modificare la regione (paese Kaufland) o il livello di requisito per le inserzioni.
{% endhint %}

#### Passo 2: Categoria i tuoi prodotti <a href="#h_01jvma22pxx1zwj8jef2kb3p6f" id="h_01jvma22pxx1zwj8jef2kb3p6f"></a>

1. In **\[il tuo canale Kaufland]**, vai al **Passo categorie** passo.
2. Mappa (assegna) le categorie per tutti gli articoli.

#### Passo 3: Crea regole <a href="#h_01jvma22px10cn3tek56p9z8fy" id="h_01jvma22px10cn3tek56p9z8fy"></a>

Quando i tuoi dati prodotto sono incompleti o non corrispondono al formato richiesto da Kaufland, puoi usare le regole per migliorarli.&#x20;

1. Crea regole per ottimizzare i tuoi prodotti e soddisfare i requisiti di pubblicazione di Kaufland.

#### Passo 4: Mappa gli attributi condivisi <a href="#h_01jvma22px72kp0ay63kjjqac4" id="h_01jvma22px72kp0ay63kjjqac4"></a>

{% hint style="success" %}
**Suggerimento:** Passa con il mouse su <i class="fa-circle-question">:circle-question:</i> per maggiori informazioni sull'attributo, sui valori accettati e su un esempio.&#x20;
{% endhint %}

1. Vai al **Build** passo.
2. Nella **Attributi condivisi** scheda, clicca su ogni menu a discesa per mappare un campo del tuo import al corrispondente attributo:
   * **EAN:** Campo che contiene i codici EAN del tuo prodotto
   * **Stock:** Campo che contiene le quantità a magazzino
   * **Titolo:** Campo che contiene il testo del titolo
   * **Descrizione:** Campo che contiene la descrizione dell'articolo
   * Mpn: Campo che contiene le informazioni sul modello o il numero del produttore
   * **Condizione:** Seleziona la condizione del prodotto da **Valori statici**
   * **Commento (opzionale):** Campo che contiene eventuali commenti condivisi su un prodotto specifico
   * **Prezzo:** Campo che contiene le informazioni sul prezzo
   * **Prezzo minimo:** Campo che contiene il prezzo minimo consentito per l'adeguamento automatico dei prezzi ([Smart pricing di Kaufland](https://www.kauflandglobalmarketplace.com/en/seller-university/selling/smart-pricing/))
   * **Immagini:** Clicca **+ Aggiungi** e mappa il campo che contiene le tue immagini
   * **IVA:** Seleziona **Valori statici** e scegli la tua aliquota IVA
   * **ID gruppo di spedizione:** Scrivi manualmente il tuo [ID del gruppo di spedizione](https://sellerportal.kaufland.de/shipping-groups/)
   * **ID magazzino:** L'ID del magazzino in cui si trovano i tuoi prodotti
   * **Tempo di gestione:** Il tempo in giorni dall'ordine alla consegna del prodotto al corriere per la spedizione
3. Mappa tutti gli attributi rimanenti contrassegnati come richiesti dal marketplace.
4. Clicca **Salva**.

#### Passo 5: Mappa gli attributi di categoria <a href="#h_01jvma22px99btnnf4g2z7thze" id="h_01jvma22px99btnnf4g2z7thze"></a>

1. Vai al **Attributi per categoria** mirakl\_unknown\_error\_code - "Il prodotto non esiste"
2. Seleziona una categoria dall'elenco.
3. Per conformarti al Regolamento generale sulla sicurezza dei prodotti (GPSR) per Kaufland, devi fornire informazioni sul tuo Responsabile dell'Unione Europea. Scorri fino alla sezione **Kontakt für Produktsicherheit** (Contatto per la sicurezza dei prodotti).
4. Accanto a **Herstellername / Verantwortliche Person für die EU** (Nome del produttore / Persona responsabile per l'UE), clicca **+ Aggiungi**.
5. Compila le informazioni richieste per il produttore o il tuo Responsabile UE:
   1. **Nome**: Inserisci il nome del produttore o del Responsabile UE.
   2. **Adresse**: Inserisci il loro indirizzo completo.
   3. **Email-Adresse:** Inserisci il loro indirizzo email.
   4. **URL**: Fornisci l'URL della loro pagina di contatto.
   5. **Telefonnummer**: Fornisci il loro numero di telefono per i contatti.
6. Mappa tutti gli attributi rimanenti contrassegnati come richiesti da Kaufland.
7. Clicca **Salva**.
8. Ripeti questi passaggi per ogni categoria.

<details>

<summary><strong>Come mappare le informazioni del produttore</strong></summary>

**Se hai un unico produttore per tutti i tuoi prodotti:** Nel menu a discesa, seleziona **Manuale** e compila le informazioni direttamente.

* **Se hai produttori diversi per i prodotti in questa categoria:** Dovrai creare un nuovo campo per fornire dinamicamente le informazioni sul produttore usando le regole.

</details>

{% hint style="success" %}
**Suggerimento:** Clicca **Auto-map fields** per mappare automaticamente le categorie con le informazioni fornite in precedenza nello stesso canale. [Scopri di più](https://helpcenter.channable.com/list-advertise/list-and-advertise-it/vendi-sui-marketplace/mappatura-automatica-dei-campi-per-marketplace-api).
{% endhint %}

### **Passo 6: Prendi nota della client e della secret key** <a href="#h_01jvma22pw328rfz6mc81hpbmz" id="h_01jvma22pw328rfz6mc81hpbmz"></a>

1. Accedi al tuo **Kaufland** account venditore.
2. Vai a **Impostazioni > Impostazioni negozio** e clicca **Api**.
3. Seleziona **Channable.** Kaufland genererà una Client Key e una Secret Key. Annotale, perché ti serviranno nel passaggio successivo per collegare il tuo canale a Kaufland.

{% hint style="info" %}
**Nota:** Se dimentichi la Client key e/o la Secret key, dovrai rigenerare nuove credenziali nel portale venditore Kaufland cliccando **Genera nuove chiavi API**.&#x20;
{% endhint %}

#### Passo 7: Connetti a Kaufland <a href="#h_01jvma22px3wd3m6z7p50dy6gq" id="h_01jvma22px3wd3m6z7p50dy6gq"></a>

1. Torna a **Impostazioni** passo.
2. Alla voce **Account venditore collegato**, clicca **Seleziona account venditore**.&#x20;
3. Seleziona un account venditore esistente, oppure clicca **+ Aggiungi nuovo collegamento** per aggiungere un nuovo account venditore:
   1. Se aggiungi un nuovo account venditore:
      * Per **Etichetta**: Assegna un nome alla connessione
      * Per **Client Key**: Inserisci la tua client key (raccolta nel passaggio precedente)
      * Per **Secret key**: Inserisci la tua secret key (raccolta nel passaggio precedente)
      * Clicca **Connetti con Kaufland**.

Ti reindirizzeremo a Kaufland per effettuare il login con le tue credenziali e accettare le autorizzazioni.

#### Passo 8: Attiva il tuo canale <a href="#h_01jvma22pxb16qvekzyx7wfs97" id="h_01jvma22pxb16qvekzyx7wfs97"></a>

1. Nella **Impostazioni** in **\[il tuo canale Kaufland]**, clicca **Attiva API.**
2. Clicca **Salva**.
3. Clicca **Esegui** per inviare i tuoi annunci a Kaufland.

Per vedere quali inserzioni prodotto sono ora attive su Kaufland, vai al **Anteprima** passo.

#### Passo 9: Revisiona e correggi gli errori delle inserzioni <a href="#h_01jvma22pxcw5k6eg06yd7k6bv" id="h_01jvma22pxcw5k6eg06yd7k6bv"></a>

1. Vai al **Risultato** passo e clicca il **scheda Feedback. Questa pagina mostra tutti gli errori di elaborazione presenti nei dati dei tuoi prodotti in un dato momento.** mirakl\_unknown\_error\_code - "Il prodotto non esiste"
2. Annota l'errore che causa il problema e risolvilo mappando il campo appropriato o regolando i campi di importazione con le regole.