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 e disponibili nella Barra Strumenti della finestra Carrello e-commerce | Sezione 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, occorre 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
• 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

Obbligatorio: No

Descrizione: E' un identificativo univoco per il Prodotto.

Valore: Viene 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

Obbligatorio: Sì

Descrizione: E' la Categoria in cui è inserito il Prodotto.

Valore: E' 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

Obbligatorio: Sì

Descrizione: E' il Nome o il Codice assegnato al Prodotto.

Valore: In caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dal campo Nome/Codice della finestra Impostazioni Prodotto | Generale.

Parametro: Description

Obbligatorio: Sì

Descrizione: E' la descrizione associata al Prodotto.

Valore: In caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dal campo Descrizione della finestra Impostazioni Prodotto | Generale.

Parametro: Price

Obbligatorio: Sì

Descrizione: E' il prezzo associato al Prodotto.

Valore: In caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dal campo Prezzo della finestra Impostazioni Prodotto | Generale.

Parametro: Enable VAT

Obbligatorio: No

Descrizione: Indica se per il Prodotto è prevista l'applicazione di un'IVA particolare.

Valore: In 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 è stata attivata la voce Imposta l'IVA per ogni Prodotto presente nella Sezione Opzioni 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

Obbligatorio: No

Descrizione: E' il valore dell'IVA nel caso in cui è prevista l'applicazione di un'imposta particolare al prezzo del Prodotto.

Valore: In 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 è stata attivata la voce Imposta l'IVA per ogni Prodotto presente nella Sezione Opzioni.
Se l'opzione IVA (%) della finestra Impostazioni Prodotto | Generale viene attivata ma non viene specificato alcun valore, viene ripreso il Valore di default dell'IVA (%) impostato sempre nella Sezione Opzioni.

Parametro: Weight

Obbligatorio: No

Descrizione: E' il peso associato al Prodotto.

Valore: In caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dal campo Peso della finestra Impostazioni Prodotto | Generale.

Parametro: Options

Obbligatorio: No

Descrizione: E' l'elenco delle varianti previste per il Prodotto.

Valore: In caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dal campo Varianti per il Prodotto 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

Obbligatorio: No

Descrizione: Indica se per il Prodotto è previsto uno sconto quantità.

Valore: In caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dall'opzione Attiva sconto quantità della finestra Impostazioni Prodotto | Opzioni.
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

Obbligatorio: No

Descrizione: E' la lista degli sconti quantità da applicare al Prodotto, se previsti.

Valore: In 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 | Opzioni.
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 scivendo:
... ; 20 : 10 | 50 : 15 ; ...
Utilizzando il carattere "|" è possibile inserire tutti gli sconti quantità necessari.

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.

Per maggior chiarezza, è possibile scaricare un piccolo file .CSV di esempio:http://www.websitex5.com/changelog/v9/files/cart9.csv