Compatibilità:

WebSite X5 Evo e Pro


Dopo aver creato un Carrello e-commerce può essere utile avere la possibilità di esportare il catalogo dei Prodotti in modo, per esempio, da poterlo reinserire in un altro Progetto o di poterlo utilizzare in altri software, magari dedicati alla gestione della fatturazione. In senso opposto, ovviamente, è altrettanto importante avere la possibilità di importare il catalogo Prodotti in modo da non doverlo ricreare da zero.

In WebSite X5 è possibile portare a termine queste operazioni di importazione/esportazione attraverso gli appositi comandi Importa Prodotti e Esporta Prodotti disponibili nella Barra Strumenti della finestra E-commerce > Prodotti. L'esportazione del catalogo dei Prodotti produce un file in formato .TXT o .CSV che può essere facilmente aperto e modificato tramite un comune editor di testo (per esempio, il Blocco Note di Windows) o Microsoft Excel.

Per modificare manualmente il file ottenuto dall'esportazione del Catalogo Prodotti o crearne uno nuovo da importare, è fondamentale attenersi alle seguenti regole:

  • La prima riga deve contenere l'intestazione dei campi e deve riportare le seguenti diciture:
ID;Category;Name/Code;Description;Price;Enable VAT;VAT Value;Weight;Options;Enable Discounts;Discounts;Availability Type;Available;Pending;Images
  • Eliminare un campo dall'intestazione equivale ad eliminare il dato per tutti i Prodotti. Ovviamente, i campi obbligatori Category, Name/Code, Description e Price non possono essere eliminati dall'intestazione.
  • Ogni riga, successiva all'intestazione, deve corrispondere a un Prodotto;
  • Tutti i parametri devono essere riportati separati dal carattere ";".
  • Per ciascun Prodotto deve essere riportato obbligatoriamente: il nome della Categoria, il nome del Prodotto, la descrizione del Prodotto, il prezzo del Prodotto. Tutti gli altri campi sono opzionali e possono essere omessi (semplicemente non scrivendo nulla fra i caratteri ";" per il campo in questione).
  • L'ID del Prodotto deve essere generato dal Programma e non manualmente: se si inserisce un nuovo Prodotto è corretto lasciare vuoto il campo relativo all'ID.
  • Gli spazi eventualmente inseriti, se superflui, verranno automaticamente rimossi in fase di importazione.


Nello specifico, i parametri presenti nel file .TXT o .CSV sono:


Parametro: ID
ObbligatorioNoDescrizioneÈ un identificativo univoco per il Prodotto.
ValoreViene generato ed associato al Prodotto in automatico dal Programma.

In caso si voglia aggiornare il file .TXT o .CSV ottenuto tramite una precedente esportazione è bene non modificare gli ID già assegnati e lasciare vuoto il campo per eventuali nuovi Prodotti aggiunti. Anche nel caso si crei un file .TXT o .CSV da zero per importare il catalogo nel Carrello non bisogna creare manualmente gli ID dei Prodotti. In fase di importazione, infatti, il Programma confronta gli ID per non avere duplicati e genera quelli mancanti.
Parametro: Category
ObbligatorioDescrizioneÈ la Categoria in cui è inserito il Prodotto.
ValoreÈ possibile riprodurre il percorso di categorie e sotto-categorie utilizzando il carattere ">".

Per esempio, se il Prodotto è una maglietta che nel Catalogo è inserita nella sotto-categoria "Casual" della categoria "Abbigliamento Uomo", nel file .TXT o .CSV si può riportare il percorso nel seguente modo:

... ; Abbigliamento Uomo > Casual ; ...

Con questo tipo di notazione è possibile inserire tutte le sotto-categorie necessarie.
Parametro: Name/Code
ObbligatorioDescrizioneÈ il Nome o il Codice assegnato al Prodotto.
ValoreIn caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dal campo Nome/Codice della finestra Impostazioni Prodotto > Generale.
Parametro: Description
ObbligatorioDescrizioneÈ la descrizione associata al Prodotto.
ValoreIn caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dal campo Descrizione della finestra Impostazioni Prodotto > Generale.
Parametro: Price
ObbligatorioDescrizioneÈ il prezzo associato al Prodotto.
ValoreIn caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dal campo Prezzo della finestra Impostazioni Prodotto > Generale.
Parametro: Enable VAT
ObbligatorioNoDescrizioneIndica se per il Prodotto è prevista l'applicazione di un'IVA particolare.
ValoreIn caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dall'opzione IVA (%) della finestra Impostazioni Prodotto > Generale. Questa opzione è disponibile solo se in E-commerce > Disponibilità è stata scelta la Tipologia "IVA inclusa nel prezzo" per le Impostazioni IVA e serve per associare al Prodotto un'IVA particolare, diversa da quella degli altri Prodotti a Catalogo. In questi casi i prezzi vengono riportati IVA esclusi.

Questo parametro può assumere solo due valori: 0 o 1, rispettivamente per i casi in cui non è stata attivata o è stata attivata l'opzione IVA (%) sopra citata.
Parametro: VAT Value
ObbligatorioNoDescrizioneÈ il valore dell'IVA nel caso in cui è prevista l'applicazione di un'imposta particolare al prezzo del Prodotto.
ValoreIn caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dall'opzione IVA (%) della finestra Impostazioni Prodotto > Generale che, come detto per il parametro precedente, è disponibile solo se in E-commerce > Disponibilità è stata scelta la Tipologia "IVA inclusa nel prezzo" per le Impostazioni IVA.

Se l'opzione IVA (%) della finestra Impostazioni Prodotto > Generale viene attivata ma non viene specificato alcun valore, viene ripreso il Valore di default (%) impostato in Impostazioni Prodotto | Disponibilità.
Parametro: Weight
ObbligatorioNoDescrizioneÈ il peso associato al Prodotto.
ValoreIn caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dal campo Peso della finestra Impostazioni Prodotto > Generale.
Parametro: Options
ObbligatorioNoDescrizioneÈ l'elenco delle varianti previste per il Prodotto.
ValoreIn caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dal campo Elenco Varianti Principali della finestra Impostazioni Prodotto > Opzioni.

In caso di creazione di un file .TXT o .CSV da importare, invece, l'elenco delle varianti di Prodotto può essere introdotto utilizzando il carattere "|", nel seguente modo:

... ; Variante1 |Variante2 | Variante3 ; ...

Con questo tipo di notazione è possibile inserire tutte le varianti necessarie.
Parametro: Enable Discounts
ObbligatorioNoDescrizioneIndica se per il Prodotto è previsto uno sconto quantità.
ValoreIn caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dall'opzione Attiva sconto quantità della finestra Impostazioni Prodotto > Sconto.

Questo parametro può assumere solo due valori: 0 o 1, rispettivamente per i casi in cui non è stata attivata o è stata attivata l'opzione Attiva sconto quantità sopra citata.
Parametro: Discounts
ObbligatorioNoDescrizioneÈ la lista degli sconti quantità da applicare al Prodotto, se previsti.
ValoreIn caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso, come il precedente, dall'opzione Attiva sconto quantità della finestra Impostazioni Prodotto > Sconto.

In caso di creazione di un file .TXT o .CSV da importare, invece l'elenco degli sconti quantità da applicare deve essere scritto rispettando la seguente notazione:

... ; quantità : sconto | quantità : sconto ; ...

In questo modo, se per ordini superiori ai 20 pezzi è previsto uno sconto del 10% e per ordini superiori ai 50 pezzi è previsto uno sconto del 15%, occorre inserire i dati scrivendo:

... ; 20 : 10 | 50 : 15 ; ...

Utilizzando il carattere "|" è possibile inserire tutti gli sconti quantità necessari.
Parametro: Availability Type
ObbligatorioNoDescrizioneSpecifica che tipo di indicazione viene fornita sulla disponibilità a Magazzino del Prodotto.
ValoreIn caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dal menu presente nella finestra Impostazioni Prodotto > Disponibilità.

In caso di creazione di un file .TXT o .CSV, occorre considerare che questo parametro può assumere i seguenti valori:
  • ..;Unset;.. - per l'opzione Nessuna informazione sulla disponibilità del Prodotto; 
  • ..;Fixed;.. - per l'opzione Disponibilità Indicativa;
  • ..;Dynamic;.. - per l'opzione Disponibilità Effettiva.
Parametro: Available
ObbligatorioNoDescrizioneSpecifica la disponibilità indicativa o effettiva impostata per il Prodotto.
ValoreIn caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso da quanto impostato nella finestra Impostazioni Prodotto > Disponibilità.

In caso di creazione di un file .TXT o .CSV, occorre considerare che questo parametro può assumere i seguenti valori:
  • ..;Available;.. - per Disponibilità Indicativa | Disponibilità immediata;
  • ..;Lack;.. - per Disponibilità Indicativa | Disponibilità limitata;
  • ..;Not Available;.. - per Disponibilità Indicativa | Non disponibile.

In caso di Disponibilità Effettiva, questo parametro corrisponde al numero impostato per l'opzione Quantità attualmente a magazzino.
Parametro: pending
ObbligatorioNoDescrizioneIn caso di disponibilità effettiva, indica quanti Prodotti sono da inserire/rimuovere rispetto a quanti presenti a magazzino.
ValoreIn caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso da quanto impostato nella finestra Impostazioni Prodotto > Disponibilità per l'opzione Quantità da aggiungere/rimuovere.

In caso di creazione di un file .TXT o .CSV, questo parametro deve riportare semplicemente il valore impostato.
Parametro: Images
ObbligatorioNoDescrizioneÈ l'elenco delle immagini inserite per il Prodotto.
ValoreIn caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dalla finestra Impostazioni Prodotto > Immagine. Per ogni immagine viene ripreso il percorso assoluto originale.

In caso di creazione di un file .TXT o .CSV da importare, invece, l'elenco delle immagini del Prodotto può essere introdotto utilizzando il carattere "|" e riportando il percorso relativo o assoluto, nel seguente modo:

... ; PathImmagine1 | PathImmagine2 | PathImmagine3 ; ...


Dopo aver importato un file .TXT o .CSV ottenuto da una precedente esportazione o creato manualmente è molto probabile che questo venga aggiornato dal Programma: per esempio, tramite l'inserimento degli ID Prodotti mancanti. Per questo motivo, se si desidera avere una copia aggiornata del file .TXT o .CSV è necessario procedere a una nuova esportazione del Catalogo Prodotti.