Servizio accoglienza > Webservices > Export dei resi

Export dei resi

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

Questo webservice permette di recuperare le informazioni dei resi sia creando un identificante di reso, sia tramite identificante di un ordine.
Il reso può essere filtrato per statut.

Ogni reso contiene che un solo prodotto.

Lista dei parametri



Parametro Descrizione
partenaire Deve contenere il vostro identificante unico :
date Data a partire dalla quale desideriamo selezionare gli ordini. Formato: timestamp
oID Identificazione dell'ordine
rID Identifificazione del reso
statut Statut dei resi a recuperare. se i parametri non sono forniti, questo deleziona tutti i resi.
> Voir la liste des statuts


Formato di XML in 


<root>
	<returns>
		<return>
			<return_id>string</return_id>
			<return_date>[DATE]</return_date>
			<return_status_name>string</return_status_name>
			<return_status>int</return_status>
			<return_reason>string</return_reason>
			<order>string</order>
			<product>
				<products_reference>string</products_reference>
				<products_name>string</products_name>
				<products_spartoo>int</products_spartoo>
				<products_manufacturers>string</products_manufacturers>
				<products_size>string</products_size>
				<products_color>string</products_color>
			</product>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
				</error>
			</errors>
		</return>
		<!-- ... Più opzioni "return" possibili ... -->
	</returns>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</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
-3 Manca un parametro obbligatorio ( date ou oID/rID )
-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 Descrzione
return_id Identificazione del reso
return_date Data creazione reso
return_status_name Nome dello statut aggiornao di reso
return_status Id dello statut aggiornao di reso<
return_reason Ragione di reso
order Identificazione ordine
product Prodotto reso
products_reference Referenza del prodotto del partenaire
products_spartoo Referenza del prodotto Spartoo
products_name Nome del modello
products_manufacturers Nome della marca
products_size Taglia ordinata
size_reference Riferimento del prodotto alla taglia
products_color Colore del prodotto


Esempi di reso XML




Esempio di risposta a una chiamata web service KO :

<root>
	<returns>
		<return>
			<return_id>EAJBCC</return_id>
			<return_date>	</return_date>
			<return_status_name><![CDATA[In attesa di ricevimento]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problema relativo alla misura]]></return_reason>
			<order>90D813EA1A2365A8</order>
			<product>
				<products_reference><![CDATA[ABCD]]></products_reference>
				<products_name><![CDATA[ALL STAR HI]]></products_name>
				<products_spartoo><![CDATA[123456]]></products_spartoo>
				<products_manufacturers><![CDATA[Converse]]></products_manufacturers>
				<products_size>42</products_size>
				<products_color><![CDATA[Blanc]]></products_color>
			</product>
			<errors>
				<error>
					<id>-3</id>
					<description>Il manque un paramètre obligatoire ( date ou oID/rID )</description>
				</error>
			</errors>
		</return>
	</returns>
	<statut>
		<id>3</id>
		<description>Refusé</description>
	</statut>
</root>

Esempio di una risposta al web service OK :

<root>
	<returns>
		<return>
			<return_id>EEAJBCC</return_id>
			<return_date>2013-04-22 17:56:36</return_date>
			<return_status_name><![CDATA[In attesa di ricevimento]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problema relativo alla misura]]></return_reason>
			<order>90D813EA1A2365A8</order>
			<product>
				<products_reference><![CDATA[ABCD]]></products_reference>
				<products_name><![CDATA[ALL STAR HI]]></products_name>
				<products_spartoo>123456</products_spartoo>
				<products_manufacturers><![CDATA[Converse]]></products_manufacturers>
				<products_size>42</products_size>
				<products_color><![CDATA[Blanc]]></products_color>
			</product>
		</return>
	</returns>
	<errors>
		<error>
			<id>1</id>
			<description>Pas d'erreur de paramètres</description>
		</error>
	</errors>
	<statut>
		<id>4</id>
		<description>Colis reçu, retour accepté</description>
	</statut>
</root>