Servizio accoglienza > Webservices > Aggiornamento di un reso

Aggiornamento dei resi

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

Questo webservice serve ad aggiornare lo stato di un reso.

Se devi fornire un'etichetta di reso al cliente, hai due metodi a tua disposizione:
  • L'etichetta è in vostro possesso: specifica l'argomento label_link contenente il link che rimanda all'etichetta
  • Desideri che l'eetichetta sia sui nostri servers: specifica l'argomento label_file contenente il file dell'etichetta
Una volta spedito il reso, o decisa la tempistica, potrai specificare l'argomento statut per
  • sia accettare il reso (statut 4)
  • sia rifiutare il reso (statut 3)


> Vedi la lista degli stati dei resi

Lista dei parametri

I parametri di questo webservice devono essere obbligatoriamente passati in POST

Parametro Descrizione
partenaire Deve contenere unicamente il tuo codice identificativo:
rID Identificativo del reso da aggiornare
statut (facoltativo) Nuovo stato del reso (3 o 4)
label_link (facoltativo) Link verso l'etichetta del reso
label_file (facoltativo) Documento dell'etichetta del reso


Formato di XML in 


<root>
	<returns>
		<return>
			<partenaire>string</partenaire>
			<rID>int</rID>
			<label_link>url</label_link>
			<label_file>url</label_file>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
				</error>
			</errors>
		<return>
	</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
-5 Manca il parametro rID/oID o il parametro statut
-6 L'ordine o il reso non sono stati trovati, verificare il parametro oID / rID o il parametro partnair.
-7 Problema dalla cronologia di reso
  • Lo statut 4 si applica solo in statut 2 ou 3
  • Lo statut 3 si applica solo in statut 2
-9 Il livello status é identico allo stato attuale
-22 Errore al momento della ricezione del documento
-23 Errore sconosciuto alla ricezione del documento
-24 Il link dell'etichetta è troppo lungo
-25 Il link fornito è identico al link attuale
-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 :

<root>
	<returns>
		<return>
			<partenaire>1EC51BF31B486658</partenaire>
			<rID>	</rID>
			<label_link>http://www.spartoo.fr/pj.php?file_id_crypt=...</label_link>
			<errors>
				<error>
					<id>-6</id>
					<description>
						La commande ou le retour n’ont pas été trouvés, vérifiez le paramètre oID / rID ou le paramètre partenaire.
					</description>
				</error>
			</errors>
		</return>
	</returns>
	<statut>
		<id>6</id>
		<description>retour refusé</description>
	</statut>
</root>

Esempio di una risposta al web service OK :

<root>
	<returns>
		<return>
			<partenaire>1EC51BF31B486658</partenaire>
			<rID>8883777</rID>
			<label_link>http://www.spartoo.fr/pj.php?file_id_crypt=...</label_link>
			<errors>
				<error>
					<id>1</id>
					<description>Pas d'erreur de paramètres</description>
				</error>
			</errors>
		</return>
	</returns>
	<statut>
		<id>4</id>
		<description>retour accepté</description>
	</statut>
</root>