Importazione di prodotti con un file CSV

L'importazione dei prodotti nel tuo negozio Shopify tramite un file con valori separati da virgola (CSV) è utile quando passi a Shopify da un'altra piattaforma o quando desideri apportare molte modifiche ai prodotti o alle scorte.

Quando importi i prodotti, i dati vengono convertiti dal file CSV in prodotti e puoi selezionare se pubblicare i nuovi prodotti su tutti i canali di vendita o solo sul tuo negozio online.

Prima di iniziare

Prima di importare prodotti con un file CSV, assicurati di aver letto i seguenti argomenti:

Le importazioni di prodotti avviate con un file CSV non possono essere annullate una volta iniziate e non è possibile visualizzare la cronologia delle importazioni passate. Per esaminare le modifiche recenti apportate da un'importazione, controlla il registro attività del tuo negozio.

Testare le importazioni con un development store

Se sei un Partner di Shopify e stai effettuando un'importazione su larga scala per un merchant, assicurati di testare prima un piccolo sottoinsieme di modifiche utilizzando un development store prima di eseguire il lavoro di importazione effettivo.

Considerazioni sulla sovrascrittura dei dettagli dei prodotti con un file CSV di importazione

Quando importi un file CSV, puoi selezionare l'opzione Sovrascrivi prodotti con handle corrispondenti. Se selezioni questa opzione, quando l'handle nel file CSV di importazione corrisponde a un handle esistente nell'elenco dei prodotti, i valori nel file CSV sovrascrivono i valori nelle colonne corrispondenti nell'elenco dei prodotti esistente. Se l'opzione di sovrascrittura non è selezionata, i prodotti che corrispondono a un handle esistente vengono ignorati durante l'importazione del CSV.

  • Se una colonna non obbligatoria nel file CSV di importazione è vuota, il valore corrispondente nell'elenco dei prodotti viene sovrascritto e lasciato vuoto.
    • Ad esempio, per Vendor il valore nell'elenco dei prodotti esistente è John’s Apparel, ma per Vendor la colonna nel file CSV importato è vuota, il valore John’s Apparel viene sovrascritto e lasciato vuoto.
  • Se una colonna non obbligatoria non è inclusa nel file CSV di importazione, ma è inclusa nell'elenco dei prodotti esistente, il valore nell'elenco dei prodotti rimane invariato.
    • Ad esempio, se la colonna Variant image URL è inclusa nell'elenco dei prodotti esistente, ma tale colonna non è inclusa nel file CSV di importazione, il valore nell'elenco dei prodotti rimane invariato.
  • Se una colonna non obbligatoria inclusa nel file CSV di importazione si basa sui dati di un'altra colonna non inclusa nel file, i dati esistenti vengono eliminati o rimossi.
    • Ad esempio, se la colonna SKU è inclusa nel file CSV di importazione, ma non le colonne Option1 value e Option1 name, l'opzione della variante di prodotto viene eliminata.
  • I file CSV non possono essere utilizzati per eliminare prodotti in blocco. Se desideri eliminare prodotti in blocco, puoi utilizzare le azioni in blocco nella sezione Prodotti del pannello di controllo.
  • I file CSV non possono essere utilizzati per aggiornare in blocco la disponibilità dei prodotti su altri canali di vendita. Scopri di più su come impostare la disponibilità dei prodotti in altri canali di vendita.

Importare prodotti da un altro negozio

Se disponi di un file CSV esportato da un altro negozio o proveniente da un'altra fonte, verifica che corrisponda al formato di file CSV. Se il formato non corrisponde o se mancano delle intestazioni, l'importazione non andrà a buon fine.

Il CSV del prodotto non può superare i 15 MB. Se ricevi un errore dopo aver provato a caricare un nuovo file CSV, o se il caricamento scade, suddividi il file CSV in più file più piccoli, quindi carica ogni file.

Passaggi:

  1. Dal pannello di controllo Shopify, vai a Prodotti.

  2. Clicca su Importa.

  3. Clicca su Aggiungi file, quindi seleziona il file CSV che desideri importare.

  4. Facoltativo: se desideri pubblicare nuovi prodotti solo sul negozio online anziché su tutti i canali di vendita, deseleziona Pubblica nuovi prodotti su tutti i canali di vendita.

  5. Facoltativo: per modificare gli URL sovrascrivendo i valori per gli handle esistenti, seleziona Sovrascrivi prodotti con handle corrispondenti. I valori esistenti verranno sostituiti per tutte le colonne incluse nel CSV.

  6. Clicca su Carica e continua.

  7. Controlla i dettagli sull'importazione, quindi clicca su Importa prodotti.

Una volta caricato il file CSV, riceverai un'email di conferma da Shopify all'account email che hai utilizzato per configurare il tuo negozio Shopify. Consulta alcune soluzioni ai problemi comuni.

Importare prodotti con un file CSV

Se desideri apportare modifiche ai prodotti utilizzando un file CSV, devi prima esportare i prodotti. Puoi apportare modifiche al file CSV in un programma per fogli di calcolo, come Google Sheets, quindi importare il CSV aggiornato nel pannello di controllo Shopify.

Passaggi

  1. Dal pannello di controllo Shopify, vai a Prodotti.

  2. Clicca su Importa.

  3. Clicca su Aggiungi file, quindi seleziona il file CSV che desideri importare.

  4. Facoltativo: se desideri pubblicare nuovi prodotti solo sul negozio online anziché su tutti i canali di vendita, deseleziona Pubblica nuovi prodotti su tutti i canali di vendita.

  5. Facoltativo: per modificare gli URL sovrascrivendo i valori per gli handle esistenti, seleziona Sovrascrivi prodotti con handle corrispondenti. I valori esistenti verranno sostituiti per tutte le colonne incluse nel CSV.

  6. Clicca su Carica e continua.

  7. Controlla i dettagli sull'importazione, quindi clicca su Importa prodotti.

Una volta caricato il file CSV, riceverai un'email di conferma da Shopify all'account email utilizzato per configurare il tuo negozio Shopify. Consulta alcune soluzioni ai problemi comuni.

Risoluzione dei problemi delle importazioni CSV

Se riscontri problemi durante l'importazione di un file CSV, consulta le seguenti informazioni per la risoluzione dei problemi.

Se noti caratteri o simboli imprevisti nelle descrizioni dei prodotti, nei titoli o in altri contenuti dopo aver importato un file CSV, è possibile che il file non sia stato salvato con la codifica UTF-8 (Unicode Transformation Format - 8-bit).

La codifica UTF-8 è necessaria per evitare che nel contenuto vengano visualizzati caratteri imprevisti. Per impostazione predefinita, Fogli Google salva automaticamente i file con la codifica UTF-8. Altri software per fogli di calcolo potrebbero richiedere un passaggio aggiuntivo per il salvataggio con la codifica UTF-8.

Correggi manualmente gli articoli interessati

Esamina ogni prodotto interessato e modifica o rimuovi manualmente i caratteri. Questa è la soluzione migliore se sono interessati solo pochi articoli.

Importa una versione precedente

Se disponi di una versione precedente del file CSV salvata con la codifica corretta, importa quella versione.

Salva di nuovo con la codifica corretta

Apri il file CSV con la codifica errata e salvalo di nuovo con la codifica UTF-8. La procedura varia a seconda del sistema operativo e del programma per fogli di calcolo. Per istruzioni, consulta la sezione File CSV.

Se ricevi il messaggio di errore Errore di rete: Unexpected token < in JSON at position 0, i titoli delle colonne CSV non corrispondono esattamente agli header del modello CSV richiesti. I nomi degli header di colonna sono sensibili alle maiuscole.

Controlla e correggi gli header di colonna

  1. Consulta la guida al formato CSV per la formattazione CSV corretta.
  2. Confronta i titoli delle colonne del file CSV con il file di esempio.
  3. Verifica che gli header del file CSV corrispondano esattamente a quelli del file di esempio, inclusa la distinzione tra maiuscole e minuscole. Ad esempio, utilizza Handle invece di handle.
  4. Correggi gli header del file CSV in modo che corrispondano a quelli del file di esempio. Puoi scaricare una copia del file di esempio dalla guida al formato CSV.

Un errore relativo all'uso delle virgolette si verifica quando nel file CSV sono presenti virgole e virgolette non codificate in UTF-8.

Affinché un CSV di prodotto venga importato correttamente, tutte le virgolette e gli apostrofi devono essere codificati in UTF-8 e trovarsi nella posizione corretta. Ad esempio, le virgolette non codificate in UTF-8 sono curve: “ ”, mentre quelle codificate in UTF-8 sono dritte: " ".

Salva il file con la codifica UTF-8

Salva il file originale con la codifica UTF-8 prima di importarlo.

Se ricevi un errore che indica che righe specifiche non sono valide senza fornire ulteriori dettagli, il problema potrebbe essere causato da conflitti con le opzioni delle varianti di prodotto esistenti. Questo accade quando tenti di modificare un valore dell'opzione da una posizione di opzione a un'altra.

Causa del problema

L'importazione CSV non riesce quando un file tenta di assegnare un valore dell'opzione esistente a una nuova posizione di opzione, creando un conflitto poiché le opzioni della variante devono essere univoche. Ad esempio, se provi a spostare Size dall'opzione 1 all'opzione 2 e ad aggiungere Type come nuova opzione 1, il database verifica la presenza di nomi duplicati prima di importare nuovi valori e la procedura non riesce.

Risolvi il conflitto

Utilizza un nome opzione temporaneo durante l'importazione per poi aggiornarlo in seguito:

  1. Nel file CSV, utilizza un nome temporaneo alternativo per l'opzione che causa il conflitto. Ad esempio, utilizza Size. (con un punto) invece di Size.
  2. Importa il file CSV con il nome opzione temporaneo.
  3. Una volta completata l'importazione, crea un nuovo file CSV che modifichi il nome opzione temporaneo con quello desiderato.
  4. Importa il file CSV aggiornato per applicare il nome opzione definitivo.