Il formato del file csv

Il file deve essere in formato csv, con separatore “;”. Ogni colonna verrà interpretata in base al nome della colonna (ovvero il calore della prima riga). Ad esempio la colonna “name” conterrà il nome da dare al prodotto. La colonna “reference” conterrà il campo Riferimento del prodotto.

Un esempio semplice:

reference;name;price;quantity
C001;Cassettiera modello 1;20.00;12
C002;Cassettiera modello 2;22.00;12

Creerà due prodotti con i campi

Codice
Titolo
Prezzo
Quantità

Segue l’elenco completo dei possibili valori per le colonne e come verranno usate.

Se non è possibile nominare le colonne in questo modo, vedere la sezione “Mappatura”

Note:

* L’unica colonna obbligatoria è la colonna “reference” che serve ad indicare un prodotto esistente da aggiornare

* Se un campo è vuoto quella colonna viene ignorata

* Se il campo non è vuoto quella colonna viene sempre aggiornata

L’ asterisco indicati i cambi obbligatori quando si crea un nuovo prodotto.

Sezione	Nome colonna	Descrizione
	reference	Testo alfanumerico con il campo ‘Riferimento’. E’ il codice univoco usato per aggiornamenti successivi e per aggiungere combinazioni (max 128 caratteri)
	name	Titolo del prodotto (max 128 caratteri)
	description_short	Riepilogo (max 800 caratteri)
	description	Descrizione
Prezzi	price*	Prezzo Iva esclusa.
	price_tin	Prezzo Iva inclusa (in alternativa a price) * Se esiste price, questo viene ignorato * Se non esiste il campo ‘vat’ (o ‘id_tax_rules_group’) diventa iva esclusa
	vat	Iva, valore numerico in % (es.: 4,10,22). Cerca tra le tasse quelle che contiene questo nel nome e prende quello com e tassa Questa tassa deve esistere e deve essere stata creata (immagine in fondo)
	vat_name	Se esiste, vat viene ignorata. Come sopra, ma si può indicare un nome completo preso da “aliquote iva” (case insensitive re ricerca parziale)
	id_tax_rules_group (avanzate)	Se esiste vat viene ignorata. In alternativa al campo sopra, ID tassa preso da tabella (=id_tax_rules_group)
	wholesale_price	Prezzo di acquisto
	quantity*	Quantità disponibile del prodotto o combinazione
Categorie	categories	Categoria. Separa da virgola se su più livelli es.: * Categoria, Sottocategoria, etc.. * Usa * per indicare la categoria di default (altrimenti sarà la prima) * Per associare più categorie usa righe successive (basta reference, categoria) * Per disassociare si può ‘azzerare’ le categorie, usa ??? =0 (zero?) Usare il separatore pipe (\|) per indicare categorie multiple
	category_default	Categoria di default
	category_check	=0 tutte, =1 prima etc (vedi category_check)
	categories_images	Elenco immagini con stesso ordine delle categorie (imagine categoria1.png, ,immagine categoria3.png)
Altro	active	Indica se il prodotto è attivo o disattivo ( 1 = attivo, 0 = disattivato)
	manufacturer	Nome del Produttore, se non esiste lo crea.
	manufacturer_image	Immagine per il produttore
	supplier	Nome del fornitore, se non esiste lo crea
Taglia/Colore	reference_variant	Se impostato indica il riferimento per la combinazione. Se manca sarà reference_taglia_colore
	combinations
	size	Taglia (es.: S, M etc)
	color	Colore
Altri	images*	url delle immagini (o nome immagine se impostata la url globale) separati da pipe (\|) vedi gestione immagini(@todo)
	legends*	Etichette delle immagini, sono associate in base allo stesso ordine. Possono essere usate come chiave per le combinazioni
	ean13*	Ean13. Se non valido verrà scartato
	tags	elenco tags separati da pipe(\|)
	weight
	height
	depth
	unity
	available_now
	available_date
	delivery_in_stock
	additional_delivery_times
	additional_shipping_cost
	on_sale
	meta_title
	meta_description
	condition
	language	en_EN,il_IT
	features	Caratteristiche. Inserisci i valori come coppie separate da virgola (Nome , Valore). Per aggiungere più caratteristiche usa il separatore pipre (\|) Ad esempio, per indicare due caratteristiche, RAM da 8 GB e SSD da 512GB, inserisci: Ram,8GB\|SSD,512GB
COMBINAZIONI	VariantReference*	Codice della variante (deve essere univoco)
	Variant*	Es.: Color:Red,Size:Small Eliminare una combinazione: mettere “0” o “delete” per eliminare la combinazione che ha il codice “VariantReference”
	VariantEan	Codice EAN valido
	VariantImage	Etichetta dell’immagine da associare (vedi images e labels) es.: “Red-Small”
	VariantQuantity	Quantità per la combinazione. Mettere -1 per cancellare la combinazione
	VariantPrice	Differenza di prezzo rispetto al prezzo base (se=0 è uguale al prezzo base) Il prezzo si riferisce alla VARIAZIONE sul prezzo tasse ESCLUSE
SCONTO PRODOTTO	offer_price	Prezzo in offerta Se positivo indica il prezzo finale NOTA: se negativo indica l’ammontare fisso dello sconto Se =0 elimina le offerte del prodotto Se vuoto viene ignorato
	offer_tax	Indica offer_price è considerato con o senza tasse (default false) 1= office_price tasse incluse (!!)@TODO: deve essere COERENTE con prezzo quindi aggiorna quando definisci prezzo ma rimane comunque se voglio usare il valore sopra come differenza
	offer_percent	è lo sconto in percentuale (non fisso),(es.: 5%) è ignorato se esiste offer_price Se =0 elimina le offerte del prodotto Se vuoto viene ignorato
	offer_from	Data inizio offerta (opzionale)
	offer_to	Data fine offerta (opzionale)
	offer_from_quantity	Quantità dalla quale parte l’offerta (opzionale, default = 1)
	offer_params	Es.: se resettare
	ogger_group	ID del gruppo

Combinazioni

Ogni combinazione è costituta di una o più di coppie Attributo/Valore, dove attributo è la variante, come colore, taglia, dimensione etc. del prodotto.

Va inserita nel formato:

Attributo1:Valore1,Attributo2,Valore2

nella colonna in “Variant”

esempi.:

..;Variant;..
..;Colore:Rosso,Taglia,XL
..;Colore:Verde,Taglia,L

Deve sempre essere presente il campo “reference” per indicare il prodotto a cui si applica

La combinazione è definita in “Variant”

reference;VariantReference;Variant;VariantQuantity
C001;C001_R;Colore:Rosso;12
C001;C001_V;Colore:Verde;5

Crea due combinazioni (rosso e verde) per il prodotto “C001”

Le colonne disponibili sono

Nome colonna	Descrizione
VariantReference*	Codice della variante (deve essere univoco)
Variant*	Es.: Color:Red,Size:Small Eliminare una combinazione: mettere “0” o “delete” per eliminare la combinazione che ha il codice “VariantReference”
VariantEan	12345678
VariantImage	Etichetta dell’immagine da associare (vedi images e labels) es.: “Red-Small”
VariantQuantity	Quantità per la combinazione. Mettere -1 per cancellare la combinazione
VariantPrice	Differenza di prezzo rispetto al prezzo base (se=0 è uguale al prezzo base) Il prezzo si riferisce alla VARIAZIONE sul prezzo tasse ESCLUSE