Come trasferire prodotti, varianti, clienti e ordini in Shopware 6 tramite CSV e quali errori evitare.
L’importazione CSV di Shopware è un modulo integrato in Shopware 6 con cui trasferisce prodotti, clienti, categorie e altri dati da un file CSV. Lo trova nell’Administration in Impostazioni, Automazione, Import/Export. Ogni file passa attraverso un profilo che stabilisce quale colonna va in quale campo di Shopware. Il file deve essere codificato in UTF-8, usare il punto e virgola come separatore e il punto come separatore decimale.
Per singole aree di dati il CSV è la via più rapida, per un cambio completo di piattaforma di solito no. Prodotti, prezzi, giacenze ed elenchi clienti si gestiscono bene via CSV. Storico ordini, recensioni, URL SEO e documenti si trasferiscono in modo più pulito con il Migration Assistant se proviene da Shopware 5 o da un’altra installazione Shopware 6. Le sincronizzazioni continue con un gestionale o un ERP richiedono un’integrazione.
La maggior parte degli errori di importazione nasce prima del caricamento. Excel altera caratteri speciali, separatori e zeri iniziali, le varianti richiedono un ordine preciso e i clienti ricevono email di registrazione se non si prepara l’importazione. Se preferisce non occuparsene in prima persona: con l’abbonamento shop di solution25 creiamo fino a 200 o 500 prodotti a seconda del pacchetto, e il pacchetto Enterprise include la migrazione dei dati.
Questo articolo è rivolto a titolari di negozi online, responsabili e-commerce e sviluppatori che devono trasferire dati in uno shop Shopware 6: all’avvio di un nuovo shop, durante un relaunch o nella gestione ordinaria di cataloghi ampi. Scoprirà quale metodo è adatto a quale caso, come preparare profili e file e come importare prodotti, varianti, clienti e ordini senza perdere dati.
Il modulo Import/Export fa parte delle funzioni standard di Shopware 6. Non serve alcuna estensione. Nell’Administration apra Impostazioni, Automazione, Import/Export. Troverà tre schede: Importazione, Esportazione e Profili.
Shopware fornisce profili standard, tra gli altri per prodotti, categorie, proprietà, iscritti alla newsletter e configurazione delle varianti. La documentazione contiene anche riferimenti ai campi per clienti, ordini, media, prezzi, cross-selling e codici promozionali. Per ciascuno di questi tipi di oggetto può creare profili propri.
All’avvio Shopware controlla ogni record. Le righe valide vengono importate, quelle errate finiscono in un file CSV separato con la colonna aggiuntiva _error. Lei scarica questo file, lo corregge e lo importa di nuovo. Il registro mostra le importazioni degli ultimi 30 giorni, con file di origine, profilo e file degli errori.
Un pulsante importante è la prova a vuoto (dry run). Esegue l’intera importazione senza scrivere dati. Così vede in anticipo se alcune righe falliranno ed evita un set di dati importato solo a metà.
Un’importazione può solo aggiungere o sovrascrivere dati, non eliminarli. Un esempio dalla documentazione: un’assegnazione a un canale di vendita, una volta impostata, non si rimuove tramite importazione. Per ripulire le assegnazioni deve usare l’Administration o l’API. Anche l’interruzione non annulla nulla: i record scritti fino a quel momento restano nel sistema.
Prima di costruire il primo file, verifichi se il CSV è davvero lo strumento giusto. Shopware offre tre modi per portare dati nello shop, e ognuno si adatta a un caso diverso.
| Metodo | Adatto per | Limiti |
|---|---|---|
| CSV Import/Export | Prima configurazione del catalogo, modifiche massive di prezzi e giacenze, elenchi clienti da un vecchio sistema | Nessuna eliminazione, varianti solo in più passaggi, nessuna guida standard per gli ordini |
| Migration Assistant | Trasferimento da Shopware 5 o da un altro Shopware 6, secondo la documentazione Shopware anche da Magento | Metodi di pagamento, flow, gruppi di prodotti dinamici e dati delle estensioni vanno ricreati |
| API o integrazione | Sincronizzazione continua con gestionale, ERP o PIM | Costi di sviluppo, gestione e monitoraggio dell’integrazione |
Il CSV è forte quando i dati arrivano una sola volta o a intervalli ampi e la struttura è semplice. Casi tipici: un commerciante avvia lo shop con 800 articoli da un listino fornitore. Un negozio cambia i prezzi di 2.000 prodotti prima del Black Friday. Un grossista trasferisce l’elenco clienti da un vecchio portale B2B. In tutti questi casi un CSV ben costruito si importa in pochi minuti.
Se proviene da Shopware 5, usi il Migration Assistant ufficiale. Secondo Shopware trasferisce media, categorie, prodotti, proprietà, produttori, recensioni, cross-selling, clienti, ordini con documenti, URL SEO, iscritti alla newsletter, liste dei desideri e promozioni. Ricostruire tutto questo via CSV richiede molto più tempo e fa perdere le relazioni tra i dati. Come funziona questo trasferimento lo spiega l’articolo Migrare da Shopware 5 a Shopware 6.
Quando i dati devono fluire ogni giorno o ogni ora, ad esempio le giacenze dal magazzino o gli ordini verso la contabilità, il CSV manuale è la strada sbagliata. Serve allora un collegamento con il Suo gestionale. Quali sistemi esistono e come funziona il collegamento lo descrive l’articolo Shopware e gestionale. Una soluzione intermedia sono le importazioni CSV automatizzate da riga di comando, di cui parliamo più avanti.
Shopware si aspetta un vero file CSV con regole precise. La documentazione ne indica tre: UTF-8 come codifica, punto e virgola come separatore di campo, virgolette intorno ai testi. Per i numeri si aggiunge il punto come separatore decimale, quindi 5.00 e non 5,00. In Italia, dove la virgola è il separatore decimale abituale, è un errore frequente.
La maggior parte dei commercianti prepara gli elenchi in Excel. Salvando come CSV succedono tre cose tipiche: i caratteri accentati vengono codificati male, i punti e virgola diventano virgole o viceversa, e gli zeri iniziali spariscono. Il codice articolo 00451 diventa 451, un EAN di 13 cifre si trasforma in un numero in notazione scientifica. Shopware consiglia quindi un programma che scriva file CSV nativi e cita OpenOffice Calc come esempio. LibreOffice Calc o un editor di testo con scelta della codifica funzionano altrettanto bene.
La via più affidabile verso la struttura giusta: crei a mano due o tre prodotti di prova, li esporti con il profilo che userà poi per l’importazione e usi il file esportato come modello. Nomi delle colonne, ordine e formato saranno così corretti. Nel forum di Shopware si consiglia proprio questo approccio per il messaggio di errore sui formati di file non supportati. Diversi utenti riferiscono che lo stesso caricamento falliva in Firefox e funzionava in Chrome.
Un profilo è la traduzione tra il Suo file e il database di Shopware. Può duplicare un profilo standard o crearne uno nuovo. Importante: selezioni la lingua predefinita del sistema, altrimenti secondo la documentazione il profilo non funziona.
Questi due interruttori sono una protezione semplice. Per un puro aggiornamento dei prezzi disattivi la creazione. Un errore di battitura in un codice articolo non crea così un prodotto nuovo e vuoto, ma finisce come errore nel file degli errori.
Nel mapping assegna a ogni campo del database un nome di colonna. Per ogni riga stabilisce se il campo è obbligatorio, quale valore predefinito riceve e in quale posizione si trova. Se carica un CSV esistente, Shopware propone i campi dalla riga di intestazione. I campi obbligatori li aggiunge il sistema:
| Tipo di oggetto | Campi obbligatori secondo la documentazione |
|---|---|
| Prodotto | id, taxId, productNumber, stock, name |
| Cliente | id, defaultBillingAddressId, defaultShippingAddressId, customerNumber, firstName, lastName, email |
| Categoria | id, type, name |
Internamente Shopware lavora con lunghi UUID. Nessun vecchio sistema conosce questi ID. Nelle impostazioni avanzate del profilo può quindi definire un secondo identificativo univoco, per i prodotti di solito il codice articolo (productNumber). Shopware troverà così il prodotto giusto durante l’aggiornamento tramite il codice. Si assicuri che questo identificativo sia davvero univoco. Valori duplicati fanno sì che alcuni record vengano saltati.
L’importazione dei prodotti è il caso più frequente e quello con più dettagli nascosti. Con il profilo standard per i prodotti arriva lontano se tiene conto dei punti seguenti.
I campi prezzo seguono lo schema price.DEFAULT.net e price.DEFAULT.gross. DEFAULT indica la valuta predefinita. Indichi entrambi i valori oppure decida prima quale valore prevale. Un errore comune è un prezzo lordo ricalcolato con un’aliquota sbagliata, che lascia nello shop importi con centesimi strani.
Il file prodotti prevede le colonne tax_id, tax_rate e tax_name. In tax_id inserisca l’UUID di un’aliquota esistente. Se il campo resta vuoto, secondo la documentazione Shopware crea una nuova aliquota. Sembra innocuo, ma porta presto a più aliquote duplicate con la stessa percentuale che poi nessuno distingue più. Recuperi gli UUID prima, tramite un’esportazione o dall’Administration.
Il campo media contiene gli URL delle immagini prodotto, l’immagine di copertina ha un campo proprio. Shopware scarica le immagini da questi indirizzi, che devono quindi essere pubblicamente raggiungibili. Link da condivisioni cloud con scadenza o da un portale fornitori con login non funzionano. Per cataloghi ampi conviene una cartella dedicata su un server, da svuotare dopo l’importazione.
I prodotti si assegnano tramite gli ID delle categorie. Crei quindi la struttura delle categorie prima dei prodotti, a mano o con il profilo standard per le categorie. Lì parent_id definisce la categoria padre. L’ID di una categoria lo vede nella barra degli indirizzi dell’Administration quando apre la categoria.
I testi in altre lingue passano per campi secondo lo schema translations.DEFAULT, dove DEFAULT viene sostituito dal codice lingua, ad esempio it-IT o de-DE. Per uno shop multilingue preveda per ogni lingua una colonna per nome, descrizione e meta dati. Shopware consiglia un backup del database prima di importare le traduzioni.
Le varianti sono il punto in cui falliscono la maggior parte delle importazioni CSV. Il motivo: una variante dipende da un prodotto principale e da proprietà che devono esistere entrambi prima. La documentazione di Shopware descrive quindi quattro passaggi.
Nell’importazione delle varianti sono obbligatori parent_id, product_number, active, stock e optionIds. Più ID di opzione si separano con una barra verticale, quindi id-rosso|id-xl.
Generare è più rapido quando deve esistere ogni combinazione e le varianti differiscono solo per le opzioni. Importare è meglio quando deve trasferire codici articolo, EAN, giacenze o prezzi propri per ogni variante. Nella pratica spesso combiniamo le due cose: generiamo le varianti, poi aggiungiamo codici, giacenze e prezzi con un’importazione di aggiornamento. È un’esperienza dai nostri progetti, non una regola di Shopware.
Un ipotetico negozio di moda ha 300 magliette, ciascuna in 5 taglie e 4 colori. Sono 300 prodotti principali, 2 gruppi di proprietà con 9 opzioni, 2.700 righe di configurazione delle varianti (300 per 9) e 6.000 varianti (300 per 20). Chi prova a mettere tutto in un unico file fallisce. In quattro file ben separati è un’importazione gestibile.
Nell’importazione dei clienti non si tratta solo di nomi e indirizzi. Tre punti decidono se il trasferimento passa inosservato ai Suoi clienti.
Shopware invia un’email di registrazione quando viene creato un cliente. Con 5.000 clienti importati sarebbero 5.000 email a persone che non si sono registrate di nuovo. La documentazione consiglia quindi di disattivare l’invio delle email in Impostazioni, Sistema, Mailer prima dell’importazione e di riattivarlo dopo.
Dopo il trasferimento i clienti devono poter accedere con la vecchia password. Shopware prevede a questo scopo i campi legacyPassword e legacyEncoder. Contengono l’hash cifrato del vecchio sistema e il metodo con cui è stato creato. Quando il cliente accede, Shopware verifica la vecchia password e la salva di nuovo nel proprio formato. Le password in chiaro non devono mai trovarsi in un file di importazione. Se Shopware non supporta il metodo del vecchio sistema, resta solo un’email per reimpostare la password dopo il go-live.
Ogni cliente ha bisogno di un indirizzo di fatturazione e di uno di spedizione predefiniti. Per i clienti B2B si aggiungono gruppo clienti, ragione sociale e partita IVA. Crei prima i gruppi di clienti e verifichi che paesi e titoli nel vecchio sistema abbiano gli stessi valori di Shopware.
In Italia crei prima dell’importazione dei prodotti le aliquote IVA del 22 % e quelle ridotte del 10 %, 5 % e 4 %, e inserisca i loro ID nel file prodotti. La fatturazione elettronica non passa dallo shop ma dal gestionale collegato, che riceve gli ordini e trasmette le fatture al Sistema di Interscambio. Verifichi quindi che codice fiscale, partita IVA e codice destinatario o PEC dei clienti B2B arrivino in campi che il gestionale sa leggere. Per i dati dei clienti vale il GDPR. Agenzie Shopware con sede in Italia le trova nella directory dei partner di Shopware tramite il filtro paese Italia.
Indipendentemente dal paese: trasferisca solo i clienti di cui ha ancora bisogno. Un trasferimento è una buona occasione per eliminare gli account inattivi secondo i Suoi termini di conservazione. I file di importazione con dati dei clienti non vanno inviati come allegati email né lasciati in cartelle cloud aperte, e vanno cancellati dopo l’importazione. Approfondisca nell’articolo Protezione dei dati nel negozio online.
Per gli ordini la documentazione di Shopware contiene un riferimento ai campi, ma nessuna guida passo per passo come per prodotti o varianti. Come campi minimi indica id, salesChannelId, orderDateTime e stateId. A questi si aggiungono righe d’ordine, indirizzi, stato di pagamento e di spedizione, ognuno collegato a tabelle proprie.
Il nostro consiglio dai progetti: non trasferisca lo storico ordini via CSV se esiste un’altra strada.
Se pianifica un trasferimento da un’altra piattaforma, dia uno sguardo anche all’articolo Passare da Shopware a Shopify. Mostra dalla direzione opposta quali dati si perdono di solito con un cambio di piattaforma.
Quando popola un nuovo shop, l’ordine decide quanto lavoro serve. Ogni passaggio ha bisogno degli ID del precedente. Questa sequenza si è dimostrata valida:
L’importazione in sé è raramente il problema di tempo. Il lavoro sta nella preparazione dei dati. Come orientamento indicativo dai nostri progetti, senza garanzia per il Suo caso:
| Situazione di partenza | Impegno per la preparazione dei dati |
|---|---|
| Fino a 500 prodotti semplici, listino fornitore pulito | Da 1 a 2 giorni lavorativi |
| 2.000 prodotti con varianti e immagini da più fonti | Da 1 a 2 settimane |
| Trasferimento completo con clienti, varianti e traduzioni | Parte di un progetto di migrazione, pianificazione in settimane |
Il maggiore spreco di tempo è quasi sempre la qualità dei dati di origine: codici articolo mancanti, EAN duplicati, taglie a volte come M, a volte come Medium. Preveda una pulizia prima di costruire il primo file. Un ambiente di test su cui ripetere le importazioni senza rischi fa risparmiare tempo in ogni progetto. Su versioni e aggiornamenti dell’ambiente di test trova di più nell’articolo Aggiornamenti e versioni di Shopware.
Per le importazioni ricorrenti non deve aprire ogni volta l’Administration. Shopware ha un comando da console import:entity che, secondo il riferimento dei comandi, importa entità da un file CSV. Gli argomenti esatti li mostra bin/console import:entity --help sulla Sua versione installata. Così può, ad esempio, caricare ogni notte un elenco giacenze del fornitore, gestito da un cronjob sul server.
Tenga presenti due punti:
messenger:consume, i lavori successivi come l’indicizzazione restano in sospeso. Un hosting configurato bene se ne occupa, maggiori dettagli nell’articolo Hosting per Shopware.import-export:delete-expired elimina i file di importazione ed esportazione scaduti. Soprattutto con dati dei clienti, non devono restare sul server in modo permanente.Quando un’importazione CSV automatica serve più di una fonte di dati o deve funzionare in entrambe le direzioni, di solito anticipa una vera integrazione. Da quel momento conviene un collegamento con gestionale o ERP.
Sono gli errori che vediamo più spesso nei progetti. La maggior parte si evita con dieci minuti di preparazione.
Un’importazione scrive subito. Un campo prezzo mappato male cambia migliaia di prezzi in un colpo, e l’interruzione non annulla nulla. Provi ogni nuovo file prima con la prova a vuoto e in un ambiente di test. Prima degli aggiornamenti più grandi serve un backup del database.
Chi in un aggiornamento lascia vuota la colonna ID e non ha impostato un secondo identificativo come il codice articolo, ottiene prodotti nuovi invece di prodotti aggiornati. Alla fine nello shop ci sono duplicati. Per i semplici aggiornamenti disattivi nel profilo la creazione di nuovi record.
Shopware stessa avverte che il messaggio dopo l’importazione non significa che tutto sia andato bene. Controlli nel registro quanti record non sono riusciti e scarichi il file degli errori.
Un’importazione aggiunge e sovrascrive, non elimina. Se un prodotto deve sparire da una categoria, non basta togliere la categoria dal file.
Molti shop salvano dati nelle estensioni, ad esempio campi aggiuntivi per merci pericolose o prezzi unitari. Verifichi prima se un plugin porta con sé profili o campi di importazione propri. Quali estensioni si sono dimostrate valide lo trova nell’articolo Plugin per Shopware 6.
In un relaunch gli URL dei prodotti cambiano. Senza redirect perde posizionamenti e link. Un’importazione CSV crea nuovi URL, ma nessun redirect da quelli vecchi. Per questi serve un elenco a parte.
No. Il modulo Import/Export è incluso in Shopware 6. Le estensioni dello Shopware Store offrono formati aggiuntivi come XML o Excel, pianificazioni e mapping più comodi. Per la maggior parte dei casi basta lo standard.
Codifica UTF-8, punto e virgola come separatore, virgolette intorno ai testi e punto come separatore decimale. Il punto di partenza più sicuro è un file esportato prima da Shopware.
La documentazione contiene un riferimento ai campi per gli ordini, ma nessuna guida. Per i trasferimenti da Shopware 5 o 6 il Migration Assistant è la strada migliore, per altri sistemi di solito un’importazione via API.
Sì, se trasferisce l’hash della password e il metodo nei campi legacyPassword e legacyEncoder e Shopware supporta quel metodo. Altrimenti i clienti reimpostano la password una volta.
Non è possibile. L’importazione aggiunge o sovrascrive. Le eliminazioni si fanno nell’Administration o via API.
Molti commercianti gestiscono le importazioni in autonomia, e con questa guida per prodotti, prezzi ed elenchi clienti è fattibile. Quando si sommano varianti, traduzioni, password e redirect, cresce il rischio che gli errori emergano solo dopo il go-live.
Possiamo aiutarLa in tre modi:
Ci scriva tramite la pagina contatti quali dati vuole trasferire e da quale sistema provengono. Le diremo con franchezza se può gestirlo bene in autonomia.

Besnik Bilalli è fondatore e CEO di solution25, l’agenzia Shopware con sede a Brema. Prima di fondare l’agenzia nel 2017 ha costruito in prima persona un negozio online e lo ha portato a oltre 500 ordini al giorno. Da allora accompagna i merchant nei progetti Shopware, dal primo calcolo dei costi alla gestione operativa. Risponde volentieri di persona alle domande sull’articolo: contattaci.
Responsabile di contenuto e aggiornamento: Besnik Bilalli. Aggiornato a: novembre 2026. Prossima revisione dei contenuti: febbraio 2027.