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;Images;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 
È 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
Descrizione
È 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 
Obbligatorio

Descrizione
È 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

Descrizione 
È 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

Descrizione 
È 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
NoDescrizione
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 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 
Obbligatorio
NoDescrizione
È 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 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 
Obbligatorio
NoDescrizione
È 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: Images 
Obbligatorio
NoDescrizione
È l'elenco delle immagini inserite per il Prodotto.
Valore 
In 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 ; ...
Parametro: Options 
Obbligatorio 
NoDescrizione
È 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 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 
Obbligatorio
NoDescrizione
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 > 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 
Obbligatorio
NoDescrizione
È 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 > 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.


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.