Integrazione con Kaufland
Vendete automaticamente i prodotti del vostro negozio su Kaufland.de, Kaufland.at e altre piattaforme: articoli, prezzi e disponibilità vengono aggiornati più volte al giorno, mentre gli ordini vengono importati automaticamente. A partire dalla versione 4.8.09, il negozio verifica inoltre quali offerte sono presenti su Kaufland; a partire dalla versione 4.10.0, verifica anche quali di queste sono visibili su Kaufland.
Come si configura l’integrazione con Kaufland?
Tutte le impostazioni si trovano in Admin → Multicanale → Kaufland → Impostazioni.
Dati di accesso e Storefront
È possibile ottenereClientKey e ClientSecret nel portale venditori di Kaufland alla voce Impostazioni → API. Alla voce Storefront (Paese) selezionare il Paese del proprio account venditore (ad es. de o at) – Kaufland gestisce i gruppi di spedizione e le categorie separatamente per ogni Paese.
Dopo aver apportato modifiche alle impostazioni di Storefront o del portale, clicca sul pulsante«Ricarica gruppi di spedizione, categorie e magazzino».
Gruppo di spedizione predefinito e magazzino predefinito a partire dalla versione 4.8.09
Il gruppo di spedizione predefinito si applica a tutti i prodotti per i quali non è stata effettuata una selezione specifica. Il magazzino predefinito (Warehouse) determina da quale magazzino Kaufland vengono evase le vostre offerte.
Entrambe le impostazioni possono essere sovrascritte per ogni singolo prodotto: scheda «Mercati» del prodotto → campi «Gruppo di spedizione» o «Magazzino» (Warehouse).
Codice articolo su Kaufland a partire dalla versione 4.8.09
Determina quale codice articolo Kaufland utilizza per le vostre offerte: ean (il codice EAN, comportamento precedente) o model (il vostro codice articolo del negozio, come per gli altri marketplace).
Kaufland non consente di modificare il codice articolo delle offerte esistenti. Dopo la conversione, esegua quindi l’operazione“Convertire i codici articolo su Kaufland”, iniziando con “Solo verifica (simulazione)”. Il negozio creerà quindi ogni offerta con il nuovo numero e solo successivamente chiuderà quella precedente; l’articolo rimarrà sempre online.

Importante: senza magazzino non c’è offerta
Kaufland richiede un magazzino per ogni offerta.
Sintomo: «Mancano i dati dell’offerta»
Se i vostri articoli vengono visualizzati sul portale Kaufland senza prezzo e disponibilità («Mancano i dati dell’offerta»), significa che nel vostro account Kaufland non è selezionato alcun magazzino predefinito. In tal caso, Kaufland rifiuterà ogni offerta.
Due soluzioni:
- nel portale venditori di Kaufland, in Impostazioni → Spedizione e magazzino, creare un magazzino e contrassegnarlo come magazzino predefinito: il trasferimento aggiornerà automaticamente le offerte.
- A partire dalla versione 4.8.09: in alternativa, selezionate un magazzino direttamente nel negozio alla voce Magazzino predefinito (Warehouse) – il negozio lo invierà poi insieme a ogni offerta.
Sincronizzazione: offerte sul marketplace a partire dalla versione 4.8.09
Verificate in qualsiasi momento quali offerte sono effettivamente presenti su Kaufland e quali di queste sono già note al vostro negozio.
Esegui ora la sincronizzazione
Carica tutte le offerte del tuo account Kaufland nella panoramica (scheda «Offerte sul marketplace»).
Filtra
Tutte / Collegate / Non collegate: in questo modo puoi visualizzare immediatamente le offerte senza un prodotto corrispondente nel negozio.
Assegna automaticamente
Assegna le offerte al prodotto corrispondente nel negozio in base al codice articolo o all’EAN.
Chiudere l'offerta
Chiude un'offerta non assegnata direttamente su Kaufland – con richiesta di conferma.
La mia offerta è visibile su Kaufland?
a partire dalla versione 4.10.0
Lo stato di caricamento «done» indica semplicemente che Kaufland ha accettato l’offerta. Per sapere se è visibile su Kaufland, controlla la colonna «Live».
La colonna «Live»
Si trova nella scheda «Offerte del marketplace» e nella scheda «Kaufland» (panoramica articoli), dove per ogni articolo con un’offerta Kaufland:
- Live (verde): l’offerta è visibile su Kaufland.
- Non live (rosso): Kaufland non mostra l’offerta.
- – (linea): non è ancora disponibile alcuno stato per questa offerta.
Passando il mouse sull’indicatore, è possibile vedere quando lo stato è stato verificato l’ultima volta. Il filtro «Non attiva» nella scheda «Offerte del Marketplace» elenca solo le offerte interessate.
Da dove proviene lo stato
Kaufland comunica lo stato ad ogni sincronizzazione, ovvero quando si clicca su«Sincronizza ora»nella scheda «Offerte del marketplace» oppure automaticamente, se la sincronizzazione è impostata come cronjob. L’ora dell’ultima sincronizzazione è indicata in alto sotto «Ultima sincronizzazione».
Se dopo l’aggiornamento compare ovunque «–», significa che da allora non è stata eseguita alcuna sincronizzazione: clicca su«Sincronizza ora». Se in seguito rimane ovunque «–», contatta l’assistenza XONIC.
Se Kaufland non riconosce un’offerta, nonostante il negozio la consideri trasferita, la sincronizzazione non fornisce alcuno stato al riguardo. L’offerta non compare quindi nella scheda «Offerte del marketplace» e, di conseguenza, nemmeno sotto il filtro «Non live»; nella panoramica degli articoli, l’articolo rimane su «–». Solo la verifica tramite la lente di ingrandimento accanto allo stato segnala «Il marketplace non riconosce alcuna offerta con il numero …» e mostra «Non attiva» finché non si ricarica la pagina. In questo caso, trasferire nuovamente l’articolo.
Perché un’offerta non è attiva?
Se un’offerta risulta su “Non attiva”, accanto ad essa troverete il pulsante“Perché non è attiva?”. Nella panoramica degli articoli, il pulsante mostra solo una lente di ingrandimento. Se non è ancora disponibile alcuno stato, lo stesso pulsante recita“Verifica stato di attivazione”. Cliccandoci sopra, si richiedono i motivi direttamente a Kaufland: la finestra di dialogo elenca ogni motivo con una spiegazione e il codice Kaufland e, se disponibile, anche un link a ulteriori informazioni su Kaufland. La colonna mostra quindi lo stato richiesto.
Kaufland limita questa richiesta. Il negozio la effettua quindi solo quando clicchi sul pulsante e mai automaticamente.
È possibile risolvere questi motivi nel negozio
- La disponibilità su Kaufland è 0: se l’articolo è disponibile nel negozio, trasferiscilo nuovamente.
- Il prezzo deve essere verificato: controlla il prezzo nel negozio online e le impostazioni dei prezzi per Kaufland (vedi «Quali articoli e prezzi vengono inviati a Kaufland?») e invia nuovamente l’articolo.
- Dati del prodotto incompleti: completare titolo, descrizione, immagini e categoria nel negozio online e trasferire nuovamente l’articolo.
- I dati del prodotto non corrispondono all’articolo: verificare i dati nel negozio, correggerli e trasferire nuovamente l’articolo.
- Mancano i dati di contatto per il GPSR: verificare i dati nella gestione dei produttori (vedi Dati del produttore (GPSR)) e successivamente trasferire nuovamente un articolo di questo produttore.
Per ritrasferire l’articolo, selezionarlo nella panoramica degli articoli e scegliere la voce«Aggiorna prodotto» nel menu«Azione per i prodotti selezionati». La colonna continuerà a mostrare lo stato dell’ultima verifica; per visualizzare lo stato attuale, utilizzare l’icona a forma di lente di ingrandimento. Subito dopo il trasferimento, Kaufland potrebbe segnalare l’offerta come non ancora attiva.
Questa operazione va eseguita su Kaufland
- Offerta sospesa: riattivarla nel portale venditori di Kaufland.
- Numeri di registrazione mancanti (WEEE, EPR e altri): inserirli nel portale venditori.
- Documenti nell’account Kaufland, ad esempio il numero di partita IVA: aggiornarli nel portale venditori.
- Diritti di marchio, diritti d’immagine o diritti di proprietà intellettuale, autenticità, condizioni generali di contratto e motivi senza indicazioni precise: chiarire la questione con l’assistenza venditori di Kaufland.
Quali articoli e prezzi vengono trasmessi a Kaufland?
Le sezioni «Prodotti» e «Prezzi» nella scheda «Impostazioni» regolano la selezione e il calcolo dei prezzi.
Selezione degli articoli
- Solo articoli secondari e singoli: esclude gli articoli principali delle famiglie di varianti e trasferisce solo le varianti e gli articoli singoli.
- Esporta prodotti senza GTIN e filtra i GTIN/MPN duplicati: definiscono come il negozio gestisce i codici identificativi mancanti o assegnati più volte.
- Lista di esclusione produttori/marchi: esclude singoli produttori o marchi dall’esportazione.
- Limitazione per categoria per l’esportazione: una whitelist trasferisce solo gli articoli delle categorie selezionate, mentre una blacklist li esclude. Gli articoli già inseriti che non sono più idonei verranno rimossi durante il prossimo ciclo di aggiornamento.
- Magazzini da considerare: determina da quali magazzini proviene lo stock trasferito. Se non si effettua alcuna selezione, vengono considerati tutti i magazzini attivi.
Prezzi
- Gruppo di clienti per il calcolo del prezzo: base di prezzo comprensiva di prezzi speciali e di gruppo attivi. Se il gruppo non ha un prezzo per un articolo, si applica il prezzo standard.
- Considerare i prezzi delle offerte speciali: include i prezzi speciali.
- Maggiorazione automatica del prezzo: maggiorazioni fisse o percentuali fino a un valore netto. I prezzi del marketplace inseriti nell’articolo hanno la precedenza.
- Arrotondamento automatico del prezzo lordo: con 0,99, il negozio arrotonda tutti i prezzi lordi a x,99.


Come vengono trasmesse a Kaufland le informazioni del produttore (GPSR)?
Il regolamento UE sulla sicurezza dei prodotti (GPSR) richiede il nome e l’indirizzo del produttore; nel caso di produttori al di fuori dell’UE, richiede inoltre l’indicazione di una persona responsabile all’interno dell’UE.
Automaticamente dalla gestione dei produttori a partire dalla versione 4.10.0
Il negozio trasferisce i dati GPSR dal sistema di gestione dei produttori a Kaufland una volta per ciascun produttore; tali dati valgono lì per tutti gli articoli di quel produttore. Se il produttore ha sede al di fuori dell’UE, l’indirizzo all’interno dell’UE ivi registrato viene indicato come persona responsabile.
Per ogni produttore, Kaufland seleziona un dato tra quelli forniti da tutti i rivenditori. Il dato da voi inserito viene quindi trasmesso, ma non necessariamente quello visualizzato.
Cosa richiede Kaufland
- Nome, città e paese; nell’UE anche il codice postale.
- Via con numero civico. Il negozio separa automaticamente i due dati e non trasmette un indirizzo senza numero civico riconoscibile.
- Un indirizzo e-mail o un sito web.
Se manca qualcosa, il negozio lo segnala al momento della trasmissione indicando il nome del produttore. L’offerta online rimane inalterata, i prezzi e le disponibilità continuano ad essere aggiornati.
Come funziona il funzionamento completamente automatico?
Una volta configurato, l’integrazione funziona in modo autonomo.
Trasmissione tramite cronjob
I nuovi articoli e le modifiche a prezzi e disponibilità vengono inviati automaticamente a Kaufland più volte al giorno. Gli ordini vengono importati ogni ora e, una volta spediti, ne viene data comunicazione a Kaufland.
Correzione automatica degli errori a partire dalla versione V4.8.09
Se un'offerta viene temporaneamente rifiutata da Kaufland (ad es. per mancanza di scorte), il negozio riprova automaticamente ogni giorno: non appena la causa viene risolta, l'offerta viene visualizzata senza ulteriori interventi.
Se Kaufland non risponde
a partire dalla versione V4.10.0
Se la connessione con Kaufland si interrompe o Kaufland è temporaneamente non raggiungibile, il trasferimento di articoli, prezzi e giacenze non viene considerato completato: l’articolo mostra lo stato di caricamento « error » e il negozio riprova al ciclo successivo, non solo il giorno successivo. Se si avvia il trasferimento manualmente nel backend, viene visualizzato anche il messaggio «Kaufland non ha fornito una risposta valida».
Il negozio crea gli ordini solo dopo che Kaufland ha trasmesso i dati dell’ordine nella loro interezza. Se il recupero dei dati si interrompe, l’importazione successiva recupererà l’ordine.
Verifica della notifica di spedizione
a partire dalla versione 4.10.0
Se il negozio ha segnalato con successo la spedizione a Kaufland, nella cronologia dell’ordine compare la voce « „Versandübermittlung an Kaufland erfolgreich.“ ». Se manca, controllate innanzitutto il numero di spedizione: senza numero di spedizione, il negozio non segnala la spedizione a Kaufland e non mostra alcuna indicazione al riguardo. Aggiungere il numero di spedizione all’ordine e, successivamente, reimpostare lo stato di spedizione dell’ordine, ad esempio su «spedito».