Servizio accoglienza > Webservices > Import dei prodotti

Importo dei prodotti

URL del Webservice : https://sws.spartoo.it/mp/xml_import_products.php

Lista dei parametri

I parametri di questo webservice devono passare in POST

Parametro	Descrizione
partenaire	Deve contenere il vostro identificante unico:
xml	Catena di carattere XML contenente la lista degli elementi da creare o aggiornare

Parametri opzionali che possono essere passati in POST

Parametro	Descrizione
force_description	Da mettere a à 1 se si desidera forzare l'aggiornamento delle descrizioni dei prodotti: sopprimere le descrizioni esistenti, editare la descrizione di un prodotto di stock vuoto, etc.
force_overwrite	Mettere a 1 se si desidera rimuovere dal catalogo gli errori di stock. A

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

Descrzione dei campi del XML d'entrata

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

Exemple de paramètre xml

<root>
	<products>
		<product>
			<reference_partenaire>98</reference_partenaire>
			<product_name><![CDATA[ALL STAR HI]]></product_name>
			<manufacturers_name><![CDATA[Converse]]></manufacturers_name>
			<product_sex>M</product_sex>
			<product_price>64.99</product_price>
			<product_quantity>5</product_quantity>
			<color_id>8</color_id>
			<product_style>10010</product_style>
			<product_description><![CDATA[Mitiche tra i miti, la Chuck Taylor All Star della Converse é sempre alla moda. 
Qui in versione alta con un gambale in tessuto ed una stampa classica, si classifica senza tempo e di tendenza!]]></product_description>
			<product_color><![CDATA[Rosso]]></product_color>
			<country_origin>73</country_origin>
			<code_hs>64059090</code_hs>
			<size_list>
			 <size>
				<size_name>38</size_name>
				<size_quantity>4</size_quantity>
				<size_reference>98_38</size_reference>
				<ean>123456789011></ean>
			 </size>
			 <size>
				<size_name>39</size_name>
				<size_quantity>1</size_quantity>
				<size_reference>98_39</size_reference>
				<ean>123456789012></ean>
			 </size>
			</size_list>
			<product_composition>4</product_composition>
			<photos>
				<url1>https://imgext.spartoo.com/photos/98/98/98_350_A.jpg</url1>
				<url2>https://imgext.spartoo.com/photos/98/98/98_350_B.jpg</url2>
				<url3>https://imgext.spartoo.com/photos/98/98/98_350_C.jpg</url3>
				<url4>https://imgext.spartoo.com/photos/98/98/98_350_D.jpg</url4>
				<url5>https://imgext.spartoo.com/photos/98/98/98_350_E.jpg</url5>
				<url6>https://imgext.spartoo.com/photos/98/98/98_350_F.jpg</url6>
				<url7>https://imgext.spartoo.com/photos/98/98/98_350_G.jpg</url7>
				<url8>https://imgext.spartoo.com/photos/98/98/98_350_H.jpg</url8>
			</photos>
			<discount>
				<startdate>1199170800</startdate>
				<stopdate>1204354800</stopdate>
				<rate>20</rate>
			</discount>
		</product>
	</products>
</root>

Formato di XML in

<root>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<status>string</status>
			<action>string</action>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
					<level>string</level>
				</error>
				<!-- ... Più opzioni "error" possibili ... -->
			</errors>
		</product>
		<!-- ... Più opzioni "product" possibili ... -->
	</products>
	<errors>int</errors>
</root>

Lista dei codici d'errore del webservice

Codice	Descrizione
1	Nessun errore di parametro
-1	Il prametro partenaire non è parametrato o è vuoto
-2	Il parametro partenaire non esiste
-11	Il prametro xml non è parametrato o è vuoto
-15	Errore di sintassi XML, verificare il file XML
-428	Il vostro conto non é più attivo, non potete quindi più fare chiamate Webservice
-429	Avete effettuato troppe chiamate a questo webservice nell' ultima ora

Descrizione dei campi della risposta XML

Balise	Descrizione
reference_partenaire	Identificazione prodotti partner
status	OK se il prodotto é inserito nel database KO se il prodotto non può essere inserito
action	Lista delle possibili azioni : created : il prodotto è stato creato. not created : il prodotto non è stato creato. Nota : un prodotto può avere uno stato 'OK' ma non essere stato creato in seguito a diversi 'Warning'. updated : il prodotto è stato aggiornato. not updated : il prodotto non è stato aggiornato: Nota: un prodotto può avere uno stato 'OK' ma non essere stato aggiornato in seguito a diversi 'Warning'.
errors	Lista degli errori di trattamento: id : codice errore prodotto level : livello dell'errore Warning: non impedisce l'integrazione del prodotto Fatal : blocca l'integrazione del prodotto descrizione: descrizione testo dell'errore

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€)
81	Fatal	Il prezzo non può essere superiore ai 180€
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
201	Fatal	Il codice EAN è obbligatorio
202	Fatal	Il codice EAN xxx sul riferimento xxx in taglia xxx è già utilizzato per la ref: xxx.
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)
30	Fatal	La quantità della misura xxx è troppo elevata (Quantità max: xxx)
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.
37	Fatal	Questo prodotto non contiene nessuna informazione di lingua per un sito attivo.
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
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.

Esempi di reso XML

Esempio di risposta a una chiamata web service KO :

<root>
	<products></products>
	<errors>-1</errors>
</root>

Esempio di una risposta al web service OK :

<root>
	<products>
		<product>
		<reference_partenaire>EEAJBCC</reference_partenaire>
		<status>KO</status>
		<action>not created</action>
		<errors>
			<error>
				<id>14</id>
				<description>La descrizione del prodotto è vuota</description>
				<level>warning</level>
			</error>
			<error>
				<id>4</id>
				<description>La marca non è specificata</description>
				<level>fatal</level>
			</error>
		</errors>
		</product>
		<product>
			<reference_partenaire>KJHGFDS</reference_partenaire>
			<status>OK</status>
			<action>created</action>
		</product>
	</products>
	<errors>1</errors>
</root>

File XSD

File XSD Multi Paese