Servizio accoglienza > Webservices > Import dei prodotti

Aggiornamento dei prodotti

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

Questo webservice serve per aggiornare lo stock dei prodotti su Spartoo.
Per ogni prodotto inviato, il webservice invierà un codice per indicare se tutto è andato bene o no.

Questo webservice serve per aggiornare lo stock dei prodotti. Può essere utilizzato per inserire la totalità dei prodotti del catalogo o solo alcuni.

Questo webservice funziona in modalità "Aggiornamento" et non in modalità "Cancellazione". Questo vuol dire che i prodotti che non sono inviati nel XLM non saranno cancellati.
Per eliminare un prodotto dal sito, bisognerà mettere lo stock a 0.

Lista dei parametri

I parametri di questo webservice devono essere obbligatoriamente essere passati in POST

Parametri Description
partner Deve contenere il vostro codice di accesso unico:
xml Catena di carattere XML contenente la lista degli elementi da aggiornare


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. 

<catalogue>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
					<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>
					<!-- ... Più opzioni "languages" possibili ... -->
				</size>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
				</size>
			</size_list>
		</product>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
				</size>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
				</size>
			</size_list>
		</product>
	</products>
</catalogue>


Descrzione dei campi del XML d'entrata


Balise Descrizione Obbligatoria
reference_partenaire Identificativo prodotto del venditore. E’ il sku che identifica un prodotto di una marca con il colore preciso
L'identificativo del prodotto può contenere solo dei caratteri alfanumerici oltre che i caratteri - (trattino alto) _ (trattino basso) e . (punto). 		Sì
product_quantity Stock totale di un prodotto
Ignorare se uno o più etichette size_quantity sono selezionate per il prodotto.
Per i prodotti di taglia unica è necessaria obbligatoriamente una balise product_quantity se la balise product_quantity non è stata registrata. 		No
taglia Lista delle taglie e dei loro stock.
Facoltativo per i prodotti senza taglia ( Borse / Accessori ). Obbligatori in caso contrario. 		Sì / Non
size_quantity Per ogni taglia, deve essere precisato lo stock.
Per disattivare uno stock, bisogna mettere lo stock a 0.
Quando lo stock è a 0, il prodotto è disattivato e non appare più su Spartoo.		 Sì
size_reference Rifermimento del prodotto alla taglia. Sì
product_price Prix pour la taille Non
discount Consente di applicare una promozione sul prodotto.
Il cambo rate du champ discount riguarda la riduzione del prezzo in percentuale rispetto al campo. product_price.
Il campo price_discount du champ discount riguarda il prezzo scontato del prodotto. La percentuale di riduzione visualizzata sarà calcolata.
Se entrambi i campi sono presenti, il campo price_discount è prioritario sul campo.rate.
Se lo sconto è immediato, non c'è bisogno di specificare il campo. startdate. Se il campo stopdate non è specificato, la promozione avrà una durata predefinita di un mese. Se il tag sales è specificato, la promozione sarà una promozione in saldo. Altrimenti, sarà una promozione classica. Indicare questo parametro consente ai prodotti di essere presenti nella pagina dei saldi durante i periodi di sconto. 		No


Exemple de paramètre xml

<catalogue>
	<products>
		<product>
			<reference_partenaire>98</reference_partenaire>
			<size_list>
				<size>
					<size_reference>98_38</size_reference>
					<size_quantity>5</size_quantity>
					<languages>
						<language>
							<code>FR</code>
							<product_price>100.00</product_price>
							<discount>
								<startdate>1199170800</startdate>
								<stopdate>1204354800</stopdate>
								<price_discount>90.00</price_discount>
								<rate>10</rate>
								<sales/>
							</discount>
						</language>
						<!-- ... Più opzioni "language" possibili ... -->
					</languages>
					<!-- ... Più opzioni "languages" possibili ... -->
				</size>
				<size>
					<size_reference>98_39</size_reference>
					<size_quantity>7</size_quantity>
				</size>
			</size_list>
		</product>
		<product>
			<reference_partenaire>158_tailor</reference_partenaire>
			<size_list>
				<size>
					<size_reference>158_37</size_reference>
					<size_quantity>2</size_quantity>
				</size>
				<size>
					<size_reference>158_36</size_reference>
					<size_quantity>0</size_quantity>
				</size>
			</size_list>
		</product>
	</products>
</catalogue>

Formato di XML in 


<catalogue>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<errors>int</errors>
				</size>
			</size_list>
		</product>
		<!-- ... Più opzioni "product" possibili ... -->
	</products>
</catalogue>


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
-13 Il prametro products_size_reference non è parametrato o è vuoto
-15 Errore di sintassi XML, verificare il file XML
-18 Lo stock è identico a quello in database, dunque non è stato aggiornato
-20 Impossibile aggiornare lo stock. La taglia non è più valida per questo prodotto quindi lo stock per questo prodotto e per questa taglia è a 0.
-31 Questa referenza di taglia non esiste
-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



Esempi di reso XML


Esempio di risposta a una chiamata web service KO :

<catalogue>
	<products></products>
	<errors>-1</errors>
</catalogue>

Esempio di una risposta al web service OK :

<catalogue>
	<products>
		<product>
			<reference_partenaire>EEAJBCC</reference_partenaire>
			<size_list>
				<size>
					<size_reference>EEAJBCC_38</size_reference>
					<errors>1</errors>
				</size>
			</size_list>
		</product>
		<product>
			<reference_partenaire>KJHGFDS</reference_partenaire>
			<size_list>
				<size>
					<size_reference></size_reference>
					<errors>-13</errors>
				</size>
			</size_list>
		</product>
	</products>
</catalogue>