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;SKU;Price;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 | |||
| 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 | Sì | 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 | Sì | 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 | Sì | 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: SKU | |||
| Obbligatorio | No | Descrizione | È il codice SKU associato al Prodotto. |
| Valore | In caso di esportazione del catalogo in .TXT o .CSV, questo parametro viene ripreso dal campo Codice SKU della finestra Impostazioni Prodotto > Generale. | ||
| Parametro: Price | |||
| Obbligatorio | Sì | 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: Weight | |||
| Obbligatorio | No | Descrizione | È 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 | È 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 | 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 > 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 | No | Descrizione | È 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. | ||
| Parametro: Availability Type | |||
| Obbligatorio | No | Descrizione | Specifica che tipo di indicazione viene fornita sulla disponibilità a Magazzino del Prodotto. |
| Valore | In 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:
| ||
| Parametro: Available | |||
| Obbligatorio | No | Descrizione | Specifica la disponibilità indicativa o effettiva impostata per il Prodotto. |
| Valore | In 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:
In caso di Disponibilità Effettiva, questo parametro corrisponde al numero impostato per l'opzione Quantità attualmente a magazzino. | ||
| Parametro: pending | |||
| Obbligatorio | No | Descrizione | In caso di disponibilità effettiva, indica quanti Prodotti sono da inserire/rimuovere rispetto a quanti presenti a magazzino. |
| Valore | In 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 | |||
| Obbligatorio | No | Descrizione | È 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 ; ... | ||
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.