Vai al contenuto principale
Tutte le collezioni
Importare prodotti da un file
Importare prodotti da un file

Aggiunta di prodotti e aggiornamento del catalogo utilizzando file XML, YML o Excel

Aggiornato questa settimana

L'importazione da un file è il metodo più rapido e conveniente per riempire e modificare in massa il catalogo, consentendo di aggiungere o aggiornare decine di migliaia di prodotti in poche ore.

Se passate a Cartum da un altro sito o piattaforma, è probabile che abbia un'opzione per esportare tutti i prodotti in un file. Ma anche se volete riempire il catalogo manualmente, vi consigliamo di raccogliere prima tutti i dati in un file e poi di importarli nel sito.

Preparazione del catalogo

Prima di importare nuovi articoli, è necessario eseguire alcune operazioni preparatorie:

  1. Creare le categorie del catalogo;

  2. Creare template del prodotto;

  3. Assicurarsi che il file contenga gli attributi dei prodotti richiesti.

Creare le categorie del catalogo

Se si importano prodotti da un altro sito web, è sufficiente creare una struttura di categorie simile sul nuovo sito. I nomi delle categorie devono essere identici (tutte le lettere minuscole e maiuscole devono corrispondere), senza spazi o altri caratteri aggiuntivi.

Se compilate il file di importazione manualmente, formate prima una struttura di categorie conveniente nel pannello di amministrazione. Nel file create una colonna Categoria con nomi di categoria per ogni articolo nel seguente formato:

Categoria/2° livello di sottocategoria/3° livello di sottocategoria/...

Per saperne di più su come creare e personalizzare le categorie, leggete questo tutorial:

Creazione di template del prodotto

Un template del prodotto è un insieme di proprietà uniche di un certo gruppo di prodotti. Per un'importazione corretta, le proprietà dei prodotti nel file devono corrispondere alle proprietà del template del prodotto per la categoria in cui si importeranno i prodotti. Per ulteriori informazioni sui template, consultare questi articoli:

Attributi obbligatori

Per importare correttamente un nuovo articolo di prodotto, il file deve contenere questi campi obbligatori:

  • Codice articolo — l'identificativo univoco di un prodotto

  • Titolo — il titolo del prodotto

  • Sezione — il nome della categoria.

Campi non obbligatori ma consigliati:

  • Prezzo — il prezzo corrente di un articolo

  • Quantità — quantità degli articoli in magazzino (se il bilancio di magazzino è abilitato)

  • Disponibilità — [In stock, Out of stock] lo stato di disponibilità dell'articolo (se il bilancio delle scorte non è abilitato)

  • Visualizzare — [Sì, No] se mostrare o nascondere un articolo per un acquirente sul sito web; se questo campo è vuoto, l'articolo sarà nascosto

  • Foto — link alle foto dell'articolo.

File per l'importazione

Come importare

L'importazione consiste nelle fasi successive:

  1. Selezione e caricamento del file

  2. Anteprima e regolazione delle colonne

  3. Procedura di importazione

  4. Rapporto sui risultati

Selezione e caricamento del file

  1. Nel pannello di amministrazione, accedere alla sezione Prodotti e fare clic su Importazione.

  2. Trascinare il file nella finestra modale o premere Selezionare su disco per aprire la finestra di selezione del file.

  3. Se il file di importazione è disponibile tramite un link, incollarlo nel campo URL del file.

  4. Attendere che il file venga scaricato e analizzato. Se il file è corretto, verrà visualizzata una schermata di anteprima.

Selecting and uploading file — Cartum

Anteprima e corrispondenza delle colonne

Nella pagina di anteprima, è necessario specificare quali proprietà del prodotto corrispondono a ciascuna colonna del file. Il sistema selezionerà automaticamente il valore se il nome della colonna corrisponde al nome del campo nel template del prodotto.

Se il nome della colonna nel file di importazione è specificato come [Nome del template] Nome attributo, corrisponderà automaticamente alla proprietà richiesta in questo template.

Previewing and column matching — Cartum

Se non viene trovata alcuna corrispondenza, l'intestazione della colonna visualizzerà Non importare. Per importare i dati, selezionare manualmente il valore richiesto. Gli attributi sono raggruppati per template nel menu a discesa per facilitare la selezione.

Attenzione! Le colonne contenenti link a foto (Foto, Galleria, Vista 360) non vengono mai importate per impostazione predefinita. È necessario abbinarle manualmente se si desidera caricare foto.

Manual column matching — Cartum

Attenzione! Se il pulsante Importare non è attivo, una proprietà del prodotto viene selezionata contemporaneamente per due o più colonne. Selezionare valori diversi per correggere questo errore.

Error One property is selected for two columns — Cartum

Cancellazione della corrispondenza delle colonne

È possibile cancellare tutte le colonne corrispondenti con un solo clic. A tale scopo, fare clic sul menu a discesa e selezionare Svuotare le colonne mappate.

Clearing column matching — Cartum

Per annullare l'importazione di una singola colonna, fare clic sulla croce nel campo di corrispondenza.

Aggiornamento dei dettagli del prodotto

Per aggiornare le informazioni, è sufficiente specificare l'articolo e il campo da aggiornare. Ad esempio, è necessario importare la colonna Codice articolo (per identificare chiaramente tutti gli articoli del prodotto) e la colonna prezzo per aggiornare i prezzi. Tutte le altre proprietà del prodotto rimarranno invariate.

Updating product details — Cartum

Procedura di importazione

Per avviare la procedura di importazione, fare clic sul pulsante Importare. Si aprirà una piccola finestra modale per le Azioni con i prodotti. È necessario scegliere le azioni con gruppi di prodotti nuovi e/o esistenti sul sito.

Actions with products during the import — Cartum

Sono possibili le seguenti azioni con gruppi di prodotti:

  • Nuovi prodotti (presenti nel file, non sul sito) — Importare/Non importare.

  • Prodotti esistenti (presenti nel file e già disponibili sul sito) — Aggiornamento/Non aggiornare.

  • Prodotti esauriti (assenti nel file, ma già presenti sul sito) — Nessuna azione/Nasconde prodotti/Modificare lo stato di disponibilità (se la funzione di aggiornamento delle scorte è disabilitata).

Attenzione! L'azione Prodotti esauriti si applica a tutti gli articoli del sito che non sono presenti nel file di importazione corrente. L'impostazione predefinita è Nessuna azione. Non modificarla se non si intende aggiornare tutti i prodotti.

Azioni con foto durante l'importazione

Utilizzando l'importazione, è possibile sostituire e aggiungere nuove foto ai prodotti. Se è stata creata una colonna corrispondente con collegamenti alle foto (Immagine, Galleria, Vista a 360 gradi), nella fase di azione della finestra modale apparirà un nuovo campo aggiuntivo Foto in cui è possibile scegliere:

  • Sovrascrivere — elimina tutte le foto dei prodotti e/o della galleria esistenti e le sostituisce con le immagini del file di importazione.

  • Aggiungere — le immagini del file verranno aggiunte alle immagini esistenti.

Actions with photos during the import — Cartum

Attenzione! L'importazione richiederà molto più tempo se si sceglie di caricare le foto. Se non è necessario aggiornare o aggiungere immagini, si consiglia di escluderle dal processo di importazione per velocizzarlo.

Interruzione dell'importazione

Per mettere in pausa il processo di importazione, fare clic sul pulsante Pausa.

Stopping the import — Cartum

Per riprendere il processo in pausa, fare clic sul pulsante Ripristinare. Per interrompere e uscire, fare clic sul pulsante Pausa.

Resuming the import — Cartum

Risultati dell'importazione

Quando tutti i prodotti sono stati elaborati, viene visualizzata la pagina dei risultati con il filtro dello stato dell'importazione in alto.

Import results — Cartum
  1. Con successo — l'elemento è stato aggiunto o aggiornato con successo e tutti i campi sono stati aggiunti.

  2. Commento — l'elemento è stato aggiunto o aggiornato con successo, ma alcuni campi non sono stati importati con successo.

  3. Errori — l'elemento non è stato importato.

  4. Omesse — l'articolo è stato escluso dall'importazione e non è stato importato.

Le informazioni dettagliate sullo stato del prodotto vengono visualizzate quando si passa il cursore sulla riga.

Detailed import status — Cartum

Scaricare il rapporto sui risultati dell'importazione

È possibile scaricare il rapporto di importazione in formato .xlsx. A tal fine, al termine dell'importazione, fare clic su Scarica il rapporto.

Downloading the import result report — Cartum

Il file di report contiene le informazioni obbligatorie sull'articolo: articolo, nome, categoria e queste colonne:

  • Risultato dell'importazione del prodotto — Importato/Importato con note/Errore.

  • Rapporto — spiegazione del risultato dell'importazione, spiegazione della causa in caso di errore.

Import result report — Cartum

Esempi di errori nel rapporto

  • Category ### not found, or an invalid template was specified for the category

  • Parent product with article ### does not exists

  • The file ### not loaded

Utilizzo del rapporto

È possibile filtrare rapidamente gli elementi del rapporto che presentano errori o commenti durante l'importazione. È quindi possibile scoprire cosa ha impedito l'aggiunta corretta di questi elementi al sito e risolverlo.


È possibile utilizzare il file di report per importare nuovi elementi se la struttura delle categorie sul sito non corrisponde alla struttura delle categorie nei file dei fornitori. A tal fine, scaricare il file di report, selezionare gli elementi non importati perché è stata specificata la categoria sbagliata e indicare i tipi corretti. È possibile importare nuovi elementi da questo file e poi aggiornare le loro proprietà con il file di importazione originale.

Hai ricevuto la risposta alla tua domanda?