Risposta diretta: migrare i prodotti su Shopify significa trasformare il catalogo di origine in una struttura coerente di prodotti, varianti, opzioni e dati personalizzati. Un file importato senza errori non dimostra che prezzi, combinazioni, immagini, disponibilità e filtri siano corretti.
Individuare la fonte autorevole del catalogo
Prima dell'esportazione occorre capire dove vivono le informazioni. In alcuni negozi è il CMS a gestire prezzi e giacenze; in altri sono ERP, PIM o software di magazzino a decidere quali dati pubblicare.
La matrice di origine deve distinguere almeno identificativo interno, SKU, barcode quando presente, titolo, descrizione, opzioni di vendita, prezzo, prezzo di confronto, disponibilità, immagini, categorie e attributi. Per ogni campo si registra: sistema autorevole, valore di esempio, destinazione Shopify, trasformazione e controllo atteso.
Se le scorte arrivano dal gestionale, la migrazione non deve far diventare un CSV statico la nuova fonte permanente di verità.
Prodotti, opzioni e varianti: evitare conversioni meccaniche
Una maglietta disponibile in più taglie e colori è un caso diverso da un prodotto con accessori personalizzabili. L'origine può usare combinazioni, attributi o campi custom che non corrispondono esattamente al modello Shopify.
Per ogni famiglia di prodotti si definisce quali valori formano le varianti acquistabili e quali costituiscono soltanto specifiche informative. Prima di procedere è necessario verificare i limiti e le funzionalità correnti dei prodotti Shopify, senza riportare soglie storiche per opzioni o varianti.
La documentazione ufficiale per l'importazione con CSV illustra la relazione fra righe e colonne: eliminare o modificare una colonna può cambiare il modo in cui prodotti e varianti vengono interpretati.
SKU, barcode e identificativi stabili
L'SKU deve restare un riferimento stabile, dove il catalogo lo usa per ordini, ERP o magazzino. Va verificata l'unicità nel contesto delle varianti e vanno documentati i casi con SKU mancanti, duplicati o non uniformi.
EAN, UPC e GTIN non sono sinonimi di SKU: se presenti, devono essere mappati come codici appropriati senza inventare valori. Conservare una tabella fra identificativo di origine e identificativo di destinazione permette di riconciliare dati e integrazioni dopo il lancio.
Un test negativo utile è verificare un prodotto con SKU duplicato per accertare che venga rilevato prima della pubblicazione, non dopo il primo ordine.
Metafield e metaobject: dove finisce il dato personalizzato
Schede tecniche, composizione, tempi di lavorazione, compatibilità, specifiche e altre proprietà possono richiedere metafield o metaobject. Non conviene incollarli tutti nella descrizione HTML: diventa difficile usare le informazioni in filtri, template e integrazioni.
Prima di creare definizioni personalizzate si controlla quali dati Shopify gestisce già in modo nativo. La scelta tra metafield di prodotto, metafield di variante e metaobject dipende da riuso, cardinalità, tipizzazione e necessità editoriale.
Una buona mappatura documenta nome campo, tipo, esempio, regola di importazione e punto in cui apparirà nello storefront. I campi facoltativi rimasti vuoti non devono produrre sezioni vuote sul sito.
Categorie, collezioni e filtri
Le categorie del CMS di origine non diventano automaticamente collezioni Shopify con gli stessi URL e la stessa gerarchia. Occorre distinguere navigazione principale, insiemi commerciali, categorie SEO e attributi usati per filtrare.
Il risultato può prevedere collezioni manuali o automatiche, filtri e contenuti editoriali separati. I vecchi URL delle categorie vanno poi mappati a destinazioni pertinenti: è un'attività SEO collegata ma distinta dal mapping dei dati.
Immagini, disponibilità e rappresentazione prodotto
Per il campione di prova includere immagini multiple, prodotto senza immagine, varianti con immagini dedicate, prodotto esaurito e inventario su più sedi. Controllare che la scheda mostri la variante selezionata e che il carrello rispetti disponibilità e prezzo effettivi.
I nomi dei file e gli URL delle immagini possono cambiare; è necessario verificare il rendering, l'ALT utile, i formati e le prestazioni delle immagini, anziché assumere che la presenza del riferimento nel CSV basti.
Piano di importazione e riconciliazione
Un percorso controllato può seguire questa sequenza:
- Conservare un export di origine e la mappa dei campi.
- Pulire SKU duplicati, record incoerenti e valori impossibili.
- Importare un campione rappresentativo.
- Confrontare valori e relazioni, non soltanto i conteggi.
- Correggere la trasformazione e ripetere il test.
- Importare il catalogo completo con log degli errori.
- Riconciliare prodotti, varianti, immagini, scorte e prezzi.
- Verificare la sincronizzazione con sistemi esterni prima del go-live.
Il confronto deve produrre una lista esplicita di anomalie risolte e aperte. Un negozio con mille schede visibili può avere ancora varianti non acquistabili o disponibilità sbagliate.
Un mapping pilota con dati ipotetici
Prendere un prodotto con due colori, tre taglie e disponibilità in due magazzini. I dati di origine potrebbero rappresentarlo come un prodotto con sei combinazioni; la destinazione deve mantenere le varianti realmente acquistabili e le informazioni di magazzino attraverso gli strumenti appropriati.
| Dato di origine | Controllo dopo l'importazione |
|---|---|
| SKU per combinazione | Identificativo corretto della variante |
| Prezzo e valuta | Prezzo dell'opzione selezionata |
| Giacenza per sede | Disponibilità nella sede pertinente |
| Attributo «materiale» | Campo tipizzato o filtro coerente |
| Galleria prodotto | Immagine e ALT associati correttamente |
La documentazione CSV Shopify chiarisce che alcune colonne di variante dipendono dalla presenza delle colonne delle opzioni. La rimozione indiscriminata di campi durante l'aggiornamento può modificare o eliminare varianti: perciò l'operazione va riprodotta su un campione, con backup e confronto.
Come definire il test di riconciliazione
Non fermarsi al conteggio dei prodotti. Misurare prodotti, varianti, SKU duplicati, prezzi fuori intervallo, immagini mancanti e prodotti senza destinazione di categoria. Per ogni difformità registrare record d'origine, valore atteso, valore ottenuto e correzione.
Il risultato dell'importazione deve essere verificabile nel carrello e, se presente, nel gestionale: una variante corretta nel backend ma non acquistabile non soddisfa il requisito.
Quando il catalogo può essere considerato pronto
Il catalogo è pronto quando i dati risultano coerenti nel backend, nel frontend e negli eventuali sistemi collegati, e un cliente può selezionare e acquistare le varianti corrette. La guida tecnica generale alla migrazione Shopify colloca questi test nel progetto completo.
Per progettare il passaggio partendo dal proprio catalogo, il servizio Migrazione a Shopify è seguito direttamente da Francesco Guiducci.
Fonti citate nell’articolo
Documentazione ufficiale e riferimenti esterni collegati nel testo. Le funzioni di Shopify cambiano: confronta sempre con la versione corrente.
- documentazione ufficiale per l'importazione con CSV Shopify · help.shopify.com