Dati offerta
Gestione manuale delle offerte
Gestione delle offerte tramite file
Caricamento dell’inventario
Questo file sostituisce le offerte esistenti. Quando si inviano i dati delle offerte tramite un file di caricamento dell’inventario a Kaufland Global Marketplace, tutti i dati attuali per il canale di vendita selezionato vengono sostituiti da quelli presenti nel file. I dati delle offerte non inclusi nel file vengono eliminati dal relativo canale di vendita. Tutti i prodotti nuovi e modificati vengono inseriti nel canale di vendita selezionato tramite il file di caricamento dell’inventario.
File CSV:
Scarica file-esempio-di-caricamento-inventario.xlsx in formato CSV
Questo file SOSTITUISCE le offerte esistenti.
File XML:
File XSD (schema con tipi di file, parametri e campi obbligatori):
Gestione dell’inventario
Questo file completa o aggiorna le offerte esistenti. Tramite il file di gestione dell’inventario è possibile pubblicare nuovi prodotti per la vendita o aggiornare un’offerta esistente.
Esempio: attualmente, le offerte A, B e C sono pubblicate sul marketplace Kaufland.it. Con il file di gestione dell’inventario è possibile modificare le informazioni delle offerte A, B e C (ad es. adeguamenti di prezzo, modifiche delle giacenze) o persino aggiungere l’offerta D per ottenere un totale di offerte comprendente A, B, C e D.
Ecco i comandi disponibili:
- UPSERT: viene aggiornata un’offerta esistente o ne viene aggiunta una nuova nel canale di vendita attuale. Se l’offerta è collegata ad articoli in altri canali di vendita, le giacenze di magazzino verranno adeguate di conseguenza.
- DELETE: con questo comando, l’offerta di prodotti sul canale di vendita selezionato viene eliminata. È necessario specificare il codice EAN del prodotto. Una volta inserito, è poi possibile indicare anche una id_offer in modo che venga eliminata solo l’unità specificata e non tutte le unità del prodotto.
- FLUSH: il comando non richiede parametri. Quando Kaufland Global Marketplace riceve un comando FLUSH, elimina tutte le unità dal relativo canale di vendita tramite il quale è stato inviato il file. Questo comando è utile per eliminare tutti i prodotti e reinserirli quando gli aggiornamenti incrementali non sono possibili.
File CSV:
Scarica file-esempio-di-gestione-inventario.xlsx in formato CSV
Questo file COMPLETA o AGGIORNA le offerte esistenti.
File XML:
File XSD (schema con tipi di file, parametri e campi obbligatori):
Conditions
Ecco i valori consentiti per le condizioni del prodotto. È possibile inserire solo valori numerici interi.
| String | Integer |
| “NEW” | 100 |
| “USED – AS NEW” | 200 |
| “USED – VERY GOOD” | 300 |
| “USED – GOOD” | 400 |
| “USED – ACCEPTABLE” | 500 |
| “REFURBISHED___AS_NEW” | 110 |
| “REFURBISHED___VERY_GOOD” | 120 |
| “REFURBISHED___GOOD” | 130 |
| “REFURBISHED___ACCEPTABLE” | 140 |
Maggiori informazioni sono disponibili nella documentazione relativa all’API.
Codice identificativo dell’articolo (SKU)
Lo SKU (Stock Keeping Unit) è un codice articolo specifico del rivenditore, utilizzato per l’identificazione univoca e la gestione interna dei prodotti del proprio stock.
Si prega di notare che lo SKU viene gestito nei feed di caricamento dell’inventario di Kaufland Global Marketplace e nel file di caricamento dell’inventario alla voce “id_offer”.
Si prega di notare che:
- Lo SKU deve essere inserito prima che l’offerta venga creata definitivamente. Non è possibile inserire in un secondo momento lo SKU per le offerte già create. In tal caso, l’offerta già creata dovrebbe essere eliminata e sostituita con una nuova offerta associata allo SKU desiderato.
- Se un determinato SKU è già associato a un codice EAN in un’offerta esistente, lo stesso SKU non può essere utilizzato per un altro codice EAN. Questa combinazione di codice EAN e SKU è valida a livello internazionale per tutti i canali di vendita. Per estendere un’offerta esistente ad altri marketplace (ad es. da Kaufland.de a Kaufland.at), non è necessario crearla nuovamente: il sistema provvede al trasferimento automatico. Questo impedisce la comparsa del messaggio di errore “SKU già assegnato” e garantisce che ogni variante di prodotto sia identificata in modo univoco su tutti i canali.
Trasmissione delle aliquote IVA per offerta
In vista dei prossimi inasprimenti normativi per le piattaforme e i marketplace derivanti dalla Direttiva UE ViDA (VAT in the Digital Age, IVA nell’era digitale), Kaufland Global Marketplace ha aggiornato i requisiti per l’indicazione delle aliquote IVA sui marketplace di Kaufland. I rivenditori hanno ora la possibilità di inserire le proprie aliquote IVA direttamente in fase di creazione dell’offerta.
Chi è interessato dalla nuova regolamentazione?
1. I rivenditori che rientrano nel modello del fornitore fittizio:
Il modello del fornitore fittizio si applica quando si effettuano
- spedizioni di merce da una sede UE a clienti UE, nel caso in cui il rivenditore non abbia sede nell’UE
e
- spedizioni di merce da una sede extra-UE direttamente a clienti UE (indipendentemente dalla sede del rivenditore), qualora il valore intrinseco della merce non superi i 150 €.
Le aliquote IVA trasmesse dal rivenditore saranno applicate in modo vincolante alle offerte a partire da metà agosto.
Cosa accade se non vengono indicate aliquote IVA o se sono errate?
Qualora non venga indicata alcuna aliquota IVA per le offerte, il sistema applicherà automaticamente l’aliquota massima predefinita per ciascun canale di vendita (Kaufland.de, Kaufland.cz, Kaufland.sk e, a partire dalla data del lancio, anche Kaufland.pl e Kaufland.at).
Esempio: qualora non venga indicata alcuna aliquota per un’offerta su Kaufland.de, nonostante sia prevista un’aliquota ridotta del 7% (come nel caso dei libri), il sistema applicherà automaticamente l’aliquota IVA standard per la Germania, pari al 19%, per l’IVA da versare.
Qualora venga indicata un’aliquota IVA ridotta e, in seguito a un controllo futuro, risulti non corretta, il sistema correggerà automaticamente l’aliquota indicata applicando l’aliquota massima vigente.
2. Tutti gli altri rivenditori:
I rivenditori che non rientrano nel modello del fornitore fittizio possono già prepararsi alle prossime normative fiscali e inserire da subito le aliquote IVA per le proprie offerte.
Modalità di inserimento delle aliquote IVA
Le aliquote IVA possono essere inserite e gestite direttamente al momento della creazione dell’offerta.
Creazione manuale delle offerte nel Seller Portal:
Accedere alla vista dettagliata della propria offerta e inserire l’aliquota IVA corrispondente nel campo “VAT”.

Tramite file di caricamento dell’inventario:
Qualora le offerte vengano caricate tramite il file di caricamento dell’inventario nel Seller Portal, è possibile indicare le aliquote IVA direttamente nel file delle offerte utilizzando gli indicatori IVA. Per ciascuna aliquota IVA è necessario indicare il “vat_indicator” corrispondente.
Tabella per l’assegnazione degli indicatori IVA:
| Paesi in cui operano i marketplace Kaufland | Codice Paese | Aliquota standard | Aliquota ridotta 1 | Aliquota ridotta 2 | Aliquota fortemente ridotta | Aliquota zero |
|---|---|---|---|---|---|---|
| Austria | AT | 20,00% | 13,00% | 10,00% | 0,00% | |
| Repubblica Ceca | CZ | 21,00% | 12,00% | 0,00% | ||
| Germania | DE | 19,00% | 7,00% | 0,00% | ||
| Polonia | PL | 23,00% | 8,00% | 5,00% | 0,00% | |
| Slovacchia | SK | 23,00% | 19,00% | 5,00% | 0,00% | |
| Francia | FR | 20,00% | 10,00% | 5,50% | 2,10% | 0,00% |
| Italia | IT | 22,00% | 10,00% | 5,00% | 4,00% | 0,00% |
| Spagna | ES | 21,00% | 10,00% | 4,00% | 0,00% | |
| Paesi Bassi | NL | 21,00% | 9,00% | 0,00% | ||
| vat_indicator | standard_rate | reduced_rate_1 | reduced_rate_2 | super_reduced_rate | zero_rate |
Nei Paesi in cui non è presente un marketplace Kaufland, il sistema applica automaticamente l’aliquota standard del Paese corrispondente a meno che non venga specificata un’aliquota fiscale diversa.
Tramite Marketplace Seller API Marketplace Seller V2:
La trasmissione dei dati delle offerte a Kaufland Global Marketplace avviene tramite l’interfaccia di un partner software?
Nessun problema, il rispettivo partner software è già stato informato al riguardo. È consigliabile contattare il proprio partner software per sapere quando saranno disponibili i relativi aggiornamenti.
Qualora venga utilizzata un’interfaccia sviluppata internamente (“Inhouse_development”) per connettersi alla Marketplace Seller API V2, tutte le informazioni necessarie per la trasmissione del nuovo parametro opzionale “vat_indicator” sono disponibili nella nostra documentazione API.
Trasferimento dell’inventario
1. Trasferimento completo dell’inventario
È possibile trasferire l’inventario esistente da un canale di vendita a un altro. L’inventario può essere selezionato per gruppi di spedizione e copiato dal canale di vendita di origine al canale di vendita di destinazione.

Ecco come procedere:
- Accedere al Seller Portal e selezionare “Gestione importazioni” > Trasferisci inventario.
- Nella sezione “Impostazioni di trasferimento”, selezionare il canale di vendita di origine dal quale si desidera trasferire l’inventario nonché il gruppo di spedizione di origine.
- Determinare poi il canale di vendita di destinazione a cui trasferire l’inventario e il relativo gruppo di spedizione.
- Procedere all’adeguamento del prezzo di destinazione dell’offerta. Se i canali di vendita selezionati utilizzano valute diverse, i prezzi nel canale di vendita di destinazione vengono convertiti automaticamente in base al tasso di cambio corrente visualizzato. Nella stessa schermata è inoltre possibile adeguare i prezzi in base a una percentuale o a un valore fisso, in modo da applicare prezzi diversi per Paesi differenti.
- Per confermare le impostazioni inserite, fare clic su “Trasferisci inventario”.
Nota
Questa funzione è disponibile esclusivamente per le offerte in cui il tempo di elaborazione è stato definito nelle impostazioni dell’offerta.
Il trasferimento automatico delle offerte si applica esclusivamente ai dati di prodotto inseriti autonomamente. Se le proprie offerte si basano sui dati dei prodotti di altri rivenditori, il trasferimento automatico non è possibile. Al fine di sfruttare appieno questo servizio, è necessario procedere autonomamente con l’inserimento dei dati dei prodotti.
Nuovo aggiornamento della funzione disponibile dal 27/01/2025
- Selezione di più gruppi di spedizione: al momento è possibile selezionare un solo gruppo di spedizione dal canale di vendita di origine e assegnarlo al canale di vendita di destinazione. A partire dalla data sopra indicata, sarà possibile associare più gruppi di spedizione dal canale di vendita di origine a quello di destinazione.
- Nessuna sovrascrittura delle offerte esistenti: qualora siano già presenti offerte nel canale di vendita di destinazione, queste vengono prese in considerazione e non vengono sovrascritte.
2. Trasferimento di singole offerte
È possibile trasferire manualmente anche singole offerte da un canale di vendita Kaufland a un altro.
Ecco come fare:
- Per trasferire manualmente le offerte su un altro canale di vendita, è necessario innanzitutto accedere all’offerta attiva desiderata.
- Nel menu a tre punti in alto a destra, alla sezione “Azioni”, è possibile selezionare l’opzione “Aggiungi al canale di vendita” per trasferire l’offerta su un ulteriore canale di vendita.
L’offerta trasferita non è da intendersi come una nuova offerta, ma come un duplicato dell’offerta esistente.
Nota
Si prega di prestare attenzione a non creare manualmente offerte identiche in diversi canali di vendita. Se viene utilizzata nuovamente la stessa combinazione di codice EAN e SKU, il sistema genera un messaggio di errore che segnala che tale combinazione è già in uso. È sufficiente inserire codice EAN e SKU una sola volta. Questa combinazione è valida a livello di sistema e può essere utilizzata su tutti i canali di vendita desiderati.
Domande frequenti
Qual è la differenza tra i dati di prodotto e i dati dell’offerta?
I dati del prodotto comprendono diversi attributi dei prodotti (ad esempio dimensioni, materiale ecc.). I dati dell’offerta, invece, contengono informazioni quali prezzo, disponibilità e tempi di consegna.
Per poter pubblicare i prodotti sulla piattaforma, il nostro sistema necessita innanzitutto dei dati di prodotto, che includono, tra le altre cose, attributi obbligatori e attributi speciali. Gli articoli non ancora presenti nel catalogo devono essere prima creati o caricati con nuovi dati di prodotto nella sezione “Gestione dei dati di prodotto”.
I cosiddetti attributi obbligatori devono essere inseriti in ogni caso, affinché gli articoli risultino validi e sia possibile gestire i dati delle offerte. Gli attributi speciali possono essere inseriti facoltativamente, qualora lo si ritenga opportuno. Ulteriori informazioni sui dati dei prodotto sono disponibili qui.
La gestione dei dati delle offerte avviene successivamente all’inserimento dei dati dei prodotti.
In cosa consiste la determinazione automatica del prezzo minimo e come è possibile utilizzarla?
La determinazione automatica del prezzo minimo consente l’adeguamento automatico dei prezzi fino al prezzo minimo indicato: in questo modo viene garantito che l’offerta sia sempre un centesimo più conveniente rispetto a quella della concorrenza, a condizione che altri rivenditori offrano lo stesso prodotto. In tale contesto, il prezzo preso in considerazione è quello comprensivo di spese di spedizione.
Per utilizzare la funzione di determinazione automatica del prezzo minimo, è sufficiente indicare un prezzo minimo nei dati delle offerte.
Come è possibile effettuare una modifica manuale per tutti gli articoli contemporaneamente, ad esempio per tutti i tempi di consegna o i prezzi?
Accedere alla sezione “Offerte” e, in “Gestione offerte”, spuntare la casella in alto a destra per selezionare più offerte o tutte le offerte contemporaneamente. Selezionare quindi l’azione desiderata dal menu a tendina adiacente per applicarla a tutti gli articoli contemporaneamente. È possibile eseguire le seguenti azioni:
- metti in pausa
- assegna magazzino
- aggiorna prezzi
- aggiorna prezzo minimo
- aggiorna tempi di consegna
- modifica gruppo di spedizione
- elimina
File di caricamento dell’inventario: come viene calcolato il tempo di consegna visualizzato nell’offerta?
Il tempo di consegna mostrato è il risultato della somma tra il tempo di elaborazione dell’ordine e il tempo di trasporto.
Il tempo di elaborazione resta parte integrante dei dati delle offerte, mentre il tempo di trasporto può essere aggiornato nelle Impostazioni di spedizione.
Il tempo di trasporto è definito per ogni gruppo di spedizione creato. Il tempo di trasporto corrisponde al tempo richiesto dal fornitore di servizi di spedizione per consegnare la merce a un cliente finale nella rispettiva area geografica.
Il tempo di elaborazione è riportato per ogni singola offerta nel nuovo tipo di file offerte “File di caricamento dell’inventario”. Il tempo di elaborazione corrisponde al tempo richiesto per il processo di prelievo e imballaggio in magazzino.
Per il calcolo del tempo di consegna si considerano solo i giorni lavorativi. Il sabato non è considerato un giorno lavorativo. Vengono presi in considerazione solo i giorni festivi del Paese in cui i prodotti vengono commercializzati (esempio: su Kaufland.de il tempo di consegna tiene conto dei giorni festivi nazionali tedeschi, su Kaufland.sk dei giorni festivi slovacchi).
In che modo è possibile impostare il tempo di consegna delle offerte?
Per impostare il tempo di consegna è necessario configurare il tempo di elaborazione e il tempo di trasporto. La somma dei due valori determina il tempo di consegna visualizzato sull’online marketplace.
Tempo di elaborazione: per tempo di elaborazione si intende il periodo di tempo necessario prima che l’articolo ordinato venga affidato al fornitore di servizi di spedizione. Il tempo di elaborazione viene configurato e trasmesso insieme all’offerta (ovvero tramite API V2, file di caricamento dell’inventario o inserimento manuale).
Tempo di trasporto: il tempo di trasporto corrisponde al tempo medio che impiega il fornitore del servizio di spedizione per consegnare l’articolo ordinato al cliente. È possibile specificare i tempi di trasporto nei propri gruppi di spedizione. In questo modo è possibile impostare tempi di trasporto diversi per diversi luoghi di destinazione.
Esempio
Il tempo necessario per la consegna dell’articolo al corriere è di un giorno. Il fornitore del servizio di spedizione impiega in media 1-2 giorni per la consegna al cliente nel luogo di destinazione interessato, ad esempio la Germania. Di conseguenza, le impostazioni saranno le seguenti:
- Tempo di elaborazione: 1
- Tempo di trasporto: 1-2
Il tempo di consegna visualizzato sull’online marketplace è quindi composto dal tempo di elaborazione e dal tempo di trasporto. Sulla base dell’esempio riportato, il tempo di consegna visualizzato dal cliente è di 2-3 giorni.
Attenzione
Se è già stato impostato un tempo di trasporto nei gruppi di spedizione, ma nelle offerte vengono trasmessi unicamente i tempi di consegna minimo e massimo, il tempo di trasporto non verrà preso in considerazione. Tale condizione si verifica esclusivamente quando viene specificato anche il tempo di elaborazione.
Considerazione dei giorni festivi specifici per ogni Paese:
Nel calcolo del tempo di consegna si considerano unicamente i giorni festivi del Paese di destinazione dei prodotti.
Esempio
- Su Kaufland.cz vengono presi in considerazione i giorni festivi cechi.
- Su Kaufland.de vengono presi in considerazione i giorni festivi tedeschi.
Come è possibile modificare il tempo di elaborazione e il tempo di trasporto per tutti gli articoli contemporaneamente (modifica in blocco)?
Tempo di trasporto
Il tempo di trasporto è già impostato in modo centralizzato tramite i gruppi di spedizione. Qualsiasi modifica del tempo di trasporto deve pertanto essere apportata separatamente per ogni gruppo di spedizione.
Tempo di elaborazione
L’adeguamento del tempo di elaborazione varia in base alla modalità di inserimento delle offerte. Per effettuare tale adeguamento, sono disponibili le seguenti opzioni:
- Pubblicazione tramite interfaccia API: qualora le offerte vengano pubblicate tramite interfaccia API, il tempo di elaborazione deve essere impostato e definito nel software utilizzato. Non sono disponibili altre opzioni per configurare il tempo di elaborazione in modo centralizzato tramite il Seller Portal.
- Pubblicazione tramite file di caricamento dell’inventario: qualora le offerte vengano caricate tramite file, è possibile definire un valore centrale per il tempo di elaborazione. Per farlo, è sufficiente accedere a Gestione offerte – Gestione importazioni – Configurazione del file dell’offerta. A tal fine, spuntare la casella a destra sotto “Tempo di elaborazione” (vedere screenshot) e inserire un valore standard (ad es. 1). Dopo aver salvato e caricato nuovamente il file delle offerte, il valore verrà considerato nel calcolo. Questa procedura è possibile solo se nel file delle offerte non è stato inserito alcun valore per il tempo di elaborazione.

- Pubblicazione manuale: qualora le offerte vengano pubblicate manualmente, è possibile modificare il tempo di elaborazione per tutte le offerte contemporaneamente tramite la funzione di modifica in blocco nella sezione Offerte. A tal fine, spuntare la casella “Stato” nella prima pagina della visualizzazione delle offerte, sopra la prima offerta; dopodiché, il sistema selezionerà automaticamente tutte le offerte. Successivamente sarà possibile effettuare la relativa modifica in blocco tramite Seleziona azione – Aggiorna tempo di elaborazione.

Attenzione
Se si opta per il metodo di pubblicazione manuale e successivamente vengono trasmessi altri valori per il tempo di elaborazione tramite interfaccia API o file, il valore impostato manualmente verrà sovrascritto.
Dove è possibile visualizzare il tempo di consegna impostato?
Di norma, è possibile verificare i tempi di consegna impostati per le proprie offerte accedendo alla sezione “Offerte” nel proprio account rivenditore. Inoltre, tramite la sezione Report è possibile scaricare il report “Articoli offerti” per avere una panoramica dei tempi di consegna attualmente impostati.
Dove è possibile trovare ulteriori informazioni sulle finestre di consegna e sui ritardi di consegna?
Le informazioni relative alle finestre di consegna e ai ritardi di consegna sono disponibili nella dashboard delle performance.
Per quali fornitori di servizi di spedizione Kaufland Global Marketplace offre attualmente il tracciamento automatico delle spedizioni?
Se nella marcatura di spedizione viene fornito un link di tracciamento e indicato un fornitore di servizi di spedizione, Kaufland Global Marketplace invierà un’e-mail con queste informazioni ai clienti del marketplace. Il sistema genera automaticamente un link per il tracciamento della spedizione.
I fornitori di servizi di spedizione supportati sono i seguenti: