Accueil > Intégration par flux CSV ou XML

Integrazione per flusso CSV o XML

Introduzione

I prodotti del vostro sito possono essere integrati su Spartoo per flussi CSV o XML.
In questo caso,il file CSV o XML contenente le informazioni di tutti i vostri prodotti dovrà essere accessibile sul web dal nostro robot.

Il nostro robot scarica circa ogni ora il file e integra le informazioni contenute.
I file devono essere il più possibile aggiornati per evitare che i prodotti non più disponibili siano ancora presenti ancora sulla pagina Spartoo.

Il file deve contenere tutte le informazioni necessarie alla categorizzazione dei vostri prodotti e alla qualificazione del vostro stock.

Ogni campo può essere obbligatorio, raccomandato o facoltativo. Se uno dei campi obbligatori é vuoto o mal compilato, il prodotto non verrà integrato.
Troverete più in basso qualche modello di file CSV o XML. Il modello del file non é imposto da Spartoo. In ogni caso il vostro file deve contenere tutte le informazioni obbligatorie.

Idealmente il file deve utilizzare il codice UTF-8. In caso contrario si prega di contattarci per configurare il trattamento del file.
Per i file CSV, deve essere utilizzato il punto e virgola ';'. In caso contrario, si prega di contattarci per configurare il trattamento del file.

Se non hai a disposizione un server di condivisione file (server ftp) Spartoo ti consiglia l' utilizzo di Dropbox.
maggiori informazioni

Definizione

Parent: Per Spartoo, un prodotto Parent corrisponde ad un modello ed un colore.
Quindi per un modello che é in due colori, vi saranno due prodotti Parent ( quindi due identità prodotti differenti)
Invece un prodotto può avere diverse taglie.
Child : Per Spartoo, un prodotto Child corrisponde ad una specifica taglia.
Quindi per un modello di un colore e di due taglie, ci saranno due "Child" ( quindi una sola identità Parent e due identità prodotto Child)
Le stock deve essere assolutamente associato ad un prodotto Child, é la sola informazione obbligatoria per i Child Le altre informazioni per i prodotti Parent possono essere omesse per i prodotti Child.

Lista delle informazioni per feed CSV

Nome del campo	Campo	Descrizione
SKU / Identificativo del prodotto	Obbligatorio	Lo SKU identifica ogni prodotto Parent. Questo può contenere caratteri alfanumerici e i caratteri: "-" (trattino) "_" (underscore) e "." (punto). Un identificativo può essere fornito per ogni prodotto Child (ad esempio il codice EAN), ma non è obbligatorio.
Parent/Child	Obbligatorio per CSV	Questo campo è obbligatorio quando la scheda contiene una linea per prodotto parent ed una linea per prodotto Child In questo caso bisogna fornire un metodo per identificare se una linea è un prodotto Parent o un prodotto Child Questo campo può contenere ad esempio la parola "Parent" per i prodotti Parent e "Child" per i prodotti Child
Parent SKU	Obbligatorio per CSV	Questo campo è obbligatorio quando la scheda contiene una linea per prodotto Parent ed una per prodotto Child Per ogni prodotto Child, bisogna sapere a quale prodotto Parent corrisponde il prodotto Child. Questo campo deve contenere l'identificativo del prodotto Parent.
Nome del modello	Raccomandato	Non deve contenere la categoria, il colore o la marca del prodotto
Nome della marca	Obbligatorio
Genere	Obbligatorio	Genere del prodotto. Idealmente, utilizzare i codici seguenti: H: Uomo F: Donna M: Unisex adulto B: Bambino G: Bambina K: Unisex bambino
Prezzo del prodotto	Obbligatorio	Deve obbligatoriamente essere in moneta 'EUR'. Il prezzo si applica solo al prodotto Parent. Non è possibile avere prezzi differenti per i prodotti Child.
Categoria	Obbligatorio	Contiene il codice della categoria del prodotto. Si prega di evitare le macro-categorie (in rosso) e di privilegiare le altre, più precise. Nel caso in cui non è possibile fornire il codice Spartoo, potrete mettere il nome della categoria. In questo caso bisognerà utilizzare lo strumento di matching delle categorie per far corrispondere le vostre categorie con quelle di Spartoo. Vedere la lista di tutti i codici di categorie
Selezioni	Facoltativo	Permette di specificare i contesti di utilizzo del prodotto in mezzo ad una lista di id. L'insieme di contesti disponibili è fornito qui
Prix discount	Raccomandato	Contiene il prezzo di discount del prodotto. Se il tasso di discount è riempito e che non corrisponde al prezzo di discount, allora vuol dire che è il prezzo di discount ad essere preso.
Tasso di discount	Raccomandato	Tutte le riduzioni saranno arrotondate (per difetto) da Spartoo per gradi del 5%. Ad esempio, un tasso di sconto del 27% sarà arrotondato al 25%.
Tipo di discount	Raccomandato	Se una promozione è di tipo saldi, bisogna precisarlo in questo campo.
Date delle promozioni	Facoltativo	Le promozioni posso essere configurate con una data d'inizio ed una di fine. nel caso in cui queste non siano precisate, la promozione inizia immediatamente. Può quindi essere interessante per i saldi, indicare la data d'inizio della promozione e gli sconti inizieranno all'ora prevista, senza aspettare la prossima integrazione nella scheda.
Taglia	Obbligatorio	Contiene il nome della taglia del prodotto. Se il campo non è presente o vuoto, il prodotto sarà considerato come avente una taglia unica. Nei casi di taglie di vestiario US, dobbiamo poter sapere se la misura è indicata EU o US: o indicare US nel nome della taglia o aggiungere un campo che indica se la taglia è US o non.
Quantita in stock	Obbligatorio	Per ogni taglia, lo stock deve essere precisato. Per disattivare un prodotto, bisogna mettere lo stock a 0. Quando lo stock è a zero, il prodotto viene disattivato e non apparirà più su Spartoo.
EAN	Obbligatorio	Codice standard internzionale che identifica ogni prodotto e che permette di essere presente su google shopping altri comparatori di prezzo.
Foto	Obbligatorio	Almeno una foto è obbligatoria Il nome del file deve contenere solo caratteri alfanumerici e i caratteri "-" (trattino alto), "_" (trattino basso) e "." (punto). Tutte le lettere con accento non sono autorizzate (per ex. é, è, e à) . Noi consigliamo di inserire almeno 3 foto. Possiamo integrare al massimo 8 foto. Bisogna indicarci il link che rimanda alla foto. La foto sarà scaricata una sola volta e poi verrà stoccata nel nostro database, dopo essere stata ridimensionata nelle dimensioni giuste per Spartoo. Le foto devono essere in formato jpg, quadrate e con minsure minime di 350x350 pixels. Se le dimensioni sono superiori o uguali a 800x800 pixels, ci sarà uno zoom possibile sul sito.
Descrittivo del prodotto	Raccomandato	Descrittivo tessile del prodotto. Non si può inserire un testo HTML. All'eccezione del salto di linea: <br>, come <b>, <i> e <u>. Lo javascript non è autorizzato. Il testo sarà visibile unicamente sulla scheda del prodotto.
Colore filtro	Raccomandato	Identificativo Spartoo per il colore. Utilizzato per i filtri dei menu. Se questo identificativo non è indicato, è possibile utilizzare lo strumento di matching colori per far corrispondere i nomi dei vostri colori con quelli di Spartoo. Vedere la lista dei codici colore
Colore	Raccomandato	Campo di testo per il colore. Quest'ultimo verrà mostrato sulla scheda del prodotto
Composizione	Facoltativo	Unicamente per le scarpe. Spartoo può integrare 4 composizioni differenti: Composizione del gambale Composizione della fodera Composizione della fodera interna Composizione della fodera esterna Spartoo non possiede lo strumento di matching per le composizioni, bisogna quindi utilizzare obbligatoriamente i codici Spartoo. Vedere la lista dei codici di composizione
Altezza del tacco	Facoltativo	Unicamente per le calzature da donna (décolleté, stivali, etc ...) Altezza del tacco in cm.
Stagione	Obbligatorio per MPO	Stagione del prodotto, composto dal codice "AH" (Autunno-Inverno) o "PE" (Primavera-Estate ) nel corso dell'anno. (ex: AH21, PE22)

Lista di informazioni per flusso XML

Balise	Descrizione	Obbligatorio
reference_partenaire	Identificazione del prodotto partner. E' il sku che identifica il prodotto di una marca in un colore preciso Identificazione del prodotto può contenere solo dei caratteri alfanumerici oltre che i caratteri - (trattino) _ (trattino basso) e . (punto).	Si
product_name	Nome del modello Non deve contenere la categoria, il colore o la marca del prodotto Non deve contenere nemmeno caratteri o balise html	No
manufacturers_name	Nome della marca del prodotto	Si
product_sex	Genere del prodotto > Vedere i valori possibili	Si
product_price	Prezzo prodotto in euro (non obbligatorio per i prezzi delle taglie)	Sì / No
color_id	Colori destinati ai filtri dei menù Se non sono precisati, il prodotto non sarà visibile se il cliente utilizza un filtro per colore > Vedere i valori possibili	No
product_style	Categoria del prodotto > Vedere i valori possibili	Si
product_description	Descrittivo del prodotto. Appare sul file del prodotto.	No
product_color	Campo teso libero per il colore. Appare sul file prodotto.	No
taglia	Lista delle taglie di stock. Facoltativo sui prodotti senza taglia (Borse / Accessori). Altrimenti obbligatorio.	Si / No
size_name	Nome della taglia > Vedere il valore possibile	Si	size_quantity	Stock del prodotto per questa taglia	Si
size_reference	Referenza del prodotto alla taglia. Questo campo serve unicamente ad essere rinviato dagli ordini o resi. Una buona abitudine è quella di generare questo riferimento concatenando i campi reference_partenaire e size_name grazie al trattino basso "_" .	No
ean	EAN del prodotto alla taglia	No
foto	Lista delle foto e delle loro url. E’ obbligatoria minimo una foto. Consigliamo di avere minimo 3 foto. Possiamo integrare un massimo di 8 foto. La foto sara caricata una sola volta, sarà poi registrata sui nostri server, dopo essere stata ridimensionata alle dimensioni Spartoo. Les foto devono essere in formato jpg, quadrate e minimo in 350x350 pixels. Se sono superiori o uguali a 800x800 pixels, sarà possibile effettuare lo zoom sul sito.	Sì
url1, url2 ... url8	Link verso le foto Bisogna fornirci il link di ogni foto. Il nome del file deve avere solo dei caratteri afanumerici oltre ai caratteri "-" (trattino), "_" (trattino basso) e "." (punto). Gli spazi, così come le lettere accentate (es. é, à,..) non sono autorizzate.	heel_height	Altezza del tacco in centimetri (cm). Unicamente per le scarpe da donna. Deve essere un multiplo di 0,5.	No
product_composition	Composizione del gambale del prodotto. Unicamente per scarpe e zaini > Vedere i valori possibili	No
voering_composition	Composizione della fodera del prodotto. Unicamente per scarpe e zaini > Vedere i valori possibili	No
first_composition	Composizione della suola interna del prodotto. Unicamente per le scarpe > Vedere i valori possibili	No
zool_composition	Composizione della suola esterna del prodotto. Unicamente per le scarpe > Vedere i valori dei prodotti	No
discount	Permette di applicare una promozione su un prodotto o su una taglia. L'indice rate del campo discount è relativo alla riduzione del prezzo in percentuale rispetto all'indice product_price. L'indice price_discount del campodiscount è relatico all prezzo di discount del prodotto. La percentuale della riduzione indicata sarà calcolata. Se i due indici sono presenti, l'indice price_discount è prioritario sull'indice rate. Se il discount è immediato, non è indispensabile precisare l'indice startdate. Se la balise sales è precisata, la promozione sarà una promozione di saldi. Altrimenti, farà riferimento ad una promozione in senso stretto. Indicare questo parametro permette ai prodotti di essere presenti sulla pagina dei saldi durante il periodo dei saldi.	No
extra_infos	Permette di specificare alcune informazioni complementari dipendenti dal tipo di prodotto. Ogni informazione è costituita da un id ( > Vedi i valori) e di un valore numerico.	No

Format du paramètre xml

I campi testo devono essere protetti da dei balises CDATA se contengono dei caratteri speciali che rendono il XML invalido.

Formato mono Paese

<root>
   <products>
	   <product>
			<reference_partenaire>string</reference_partenaire>
			<product_name>string</product_name>
			<manufacturers_name>string</manufacturers_name>
			<code_idu>string</code_idu>
			<product_sex>char</product_sex>
			<product_price>float</product_price>
			<product_quantity>int</product_quantity>
			<color_id>int</color_id>
			<product_style>int</product_style>
			<product_description>string</product_description>
			<product_color>string</product_color>
			<heel_height>float</heel_height>
			<country_origin>int</country_origin>
			<code_hs>int</code_hs>
			<size_list>
				<size>
					<size_name>string</size_name>
					<size_quantity>int</size_quantity>
					<size_reference>string</size_reference>
					<ean>string</ean>
					<code_hs>int</code_hs>
					<product_price>float</product_price>
					<discount>
						<startdate>timestamp</startdate>
						<stopdate>timestamp</stopdate>
						<price_discount>float</price_discount>
						<rate>int</rate>
						<sales/>
					</discount>
				</size>
				<!-- ... Più opzioni "size" possibili ... -->
			</size_list>
			<product_composition>int</product_composition>
			<voering_composition>int</voering_composition>
			<first_composition>int</first_composition>
			<zool_composition>int</zool_composition>
			<photos>
			   <url1>url</url1>
			   <url2>url</url2>
			   <url3>url</url3>
			   <url4>url</url4>
			   <url5>url</url5>
			   <url6>url</url6>
			   <url7>url</url7>
			   <url8>url</url8>
			</photos>
			<discount>
			   <startdate>timestamp</startdate>
			   <stopdate>timestamp</stopdate>
			   <price_discount>float</price_discount>
			   <rate>int</rate>
			   <sales>0/1</sales>
			</discount>
			<extra_infos>
				<info>
					<id>int</id>
					<value>float</value>
				</info>
				<!-- ... Più opzioni "info" possibili ... -->
			</extra_infos>
			<selections>
				<selection>int</selection>
				<!-- ... Più opzioni "selection" possibili ... -->
			</selections>
	   </product>
	   <!-- ... Più opzioni "product" possibili ... -->
   </products>
</root>

Formato multi Paese

<root>
   <products>
	   <product>
			<reference_partenaire>string</reference_partenaire>
			<manufacturers_name>string</manufacturers_name>
			<product_sex>char</product_sex>
			<product_quantity>int</product_quantity>
			<color_id>int</color_id>
			<product_style>int</product_style>
			<heel_height>float</heel_height>
			<country_origin>int</country_origin>
			<code_hs>int</code_hs>
			<languages>
				<language>
					<code>string</code>
					<product_name>string</product_name>
					<product_description>string</product_description>
					<code_idu>string</code_idu>
					<product_color>string</product_color>
					<product_price>float</product_price>
					<discount>
					   <startdate>timestamp</startdate>
					   <stopdate>timestamp</stopdate>
					   <price_discount>float</price_discount>
					   <rate>int</rate>
					   <sales />
					</discount>
				</language>
				<!-- ... Più opzioni "language" possibili ... -->
			</languages>
			<size_list>
				<size>
					<size_name>string</size_name>
					<size_quantity>int</size_quantity>
					<size_reference>string</size_reference>
					<ean>string</ean>
					<code_hs>int</code_hs>
					<languages>
						<language>
							<code>string</code>
							<product_price>float</product_price>
							<discount>
								<startdate>timestamp</startdate>
								<stopdate>timestamp</stopdate>
								<price_discount>float</price_discount>
								<rate>int</rate>
								<sales/>
							</discount>
						</language>
						<!-- ... Più opzioni "language" possibili ... -->
					</languages>
				</size>
				<!-- ... Più opzioni "size" possibili ... -->
			</size_list>
			<product_composition>int</product_composition>
			<voering_composition>int</voering_composition>
			<first_composition>int</first_composition>
			<zool_composition>int</zool_composition>
			<photos>
			   <url1>url</url1>
			   <url2>url</url2>
			   <url3>url</url3>
			   <url4>url</url4>
			   <url5>url</url5>
			   <url6>url</url6>
			   <url7>url</url7>
			   <url8>url</url8>
			</photos>
			<extra_infos>
				<info>
					<id>int</id>
					<value>float</value>
				</info>
				<!-- ... Più opzioni "info" possibili ... -->
			</extra_infos>
			 <selections>
				<selection>int</selection>
				<!-- ... Più opzioni "selection" possibili ... -->
			</selections>
	   </product>
	   <!-- ... Più opzioni "product" possibili ... -->
   </products>
</root>

Esempio di documenti

Lista dei codici d'errore prodotti

Code	Livello	Descrizione
1	Fatal	La referenza partner non è abbastanza lunga
2	Fatal	La referenza partner non è valida. Sono ammessi solo caratteri alfanumerici
3	Warning	Il nome del prodotto non è specificato
4	Fatal	La marca non è specificata
5	Fatal	Il genere non è valido. I valori possibili sono: H,F,M,K,G,B
6	Fatal	Il prezzo deve essere un numero
7	Fatal	Il prezzo deve essere positivo
8	Warning	Il prezzo ci sembra grande (>1000€)
9	Fatal	La quantità deve esere un numero intero
10	Fatal	La quantità deve essere positiva
11	Warning	Il colore xxx non esiste: il prodotto non sarà disponbile nei filtri colori
13	Fatal	La categoria xxx non esiste
14	Warning	La descrizione del prodotto è vuota
15	Warning	Il colore è vuoto
16	Warning	Il campo taglie è vuoto. Corrisponderà a una taglia unica
17	Warning	La composizione non è valida
18	Fatal	La foto 1 è obbligatoria
19	Warning	Il tasso di sconto della promozione deve essere compreso tra 0 e 100
20	Warning	La taglia xxx non esiste
200	Fatal	La taglia xxx non esiste per la marca xxx.
201	Fatal	Il codice EAN è obbligatorio
202	Fatal	Il codice EAN xxx sul riferimento xxx in taglia xxx è già utilizzato per la ref: xxx.
203	Warning	Il codice EAN è troppo corto o finisce per "000"
204	Warning	Il codice EAN xxx esiste in più esemplari nel flusso
205	Fatal	Riferimento al partner troppo lungo
23	Warning	La foto xxx è più piccola di 350x350. La qualità non sarà ottima
24	Warning	La foto xxx è più piccola di 350x350. Non è possibile caricarla sul sito
25	Fatal	Taglia xxx: Impossibile di regolare lo stock
26	Fatal	Stock non disponibile: il prodotto non sarà creato
27	Fatal	Impossibile di accedere alla foto 1 (url xxx)
28	Warning	Impossibili di accedere alla foto xxx (url xxx)
281	Fatal	Dimensioni della foto troppo grandi (xxxo)
30	Fatal	La quantità della misura xxx è troppo elevata (Quantità max: xxx)
31	Warning	Il tuo conto non è attivo sul sito xxx
32	Fatal	Non sono state trovate informazioni sul prodotto per questo Paese.
33	Fatal	Un prodotto del genere xxx non può appartenere alla categoria xxx
34	Fatal	La parola xxx è stata blacklistata e non dovrebbe più essere visibile nella descrizione del prodotto.
35	Fatal	Il nome del prodotto è troppo lungo, dovrebbe contenere solo il nome del modello. Errore/i di paese/i: xxx
341	Fatal	La parola xxx è stata blacklistata e non dovrebbe più comparire nella descrizione del prodotto.
36	Fatal	Impossibile inserire il prodotto: l'articolo ha un duplicato in taglia / colore.
38	Fatal	La taglia xxx può essere indicata una sola volta per il riferimento xxx
39	Warning	Il riferimento del partner è presente più volte nel flusso, i duplicati sono stati ignorati
42	Warning	La stagione non è valida.
43	Warning	L'informazione prodottoxxx corrisponde ad un prodotto tipo = xxx e non xxx.
44	Warning	La categoria xxx non corrisponde ad una tipologia di prodotto xxx ma bensì xxx
451	Fatal	Nessun prezzo per la taglia xxx nel paese xxx. (necessario per ottenere uno sconto)
452	Warning	Data di fine sconto oltrepassata per la taglia xxx del paese xxx.
453	Fatal	"classifica" (xxx) non valida per la dimensione xxx del paese xxx.
454	Fatal	"tasso" (xxx) > 85% per la dimensione xxx del paese xxx.
455	Warning	La taglia xxx ha un prezzo su un paese (xxx) non definito per il prodotto.
456	Warning	La taglia xxx ha un prezzo su xxx identico al prezzo globale su questo paese.