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>

💡 Conseils d'intégration pour les étiquettes de retour

  • label_link : L'URL fournie pour l'étiquette de retour ne doit pas dépasser 255 caractères (limite stricte de l'API). Si vous utilisez des paramètres d'URL ou d'authentification longs, veuillez raccourcir le lien au préalable.
  • label_file : Si vous soumettez directement le fichier de l'étiquette, vous devez transmettre le contenu binaire brut (raw binary content) du fichier (et non une chaîne encodée en Base64). Les formats acceptés sont le PDF (.pdf) et les formats d'images (.jpg, .jpeg, .png, .gif) pour une taille maximale de 10 Mo.



Saitoo - Assistant (mp)
Bonjour ! Comment puis-je vous aider aujourd'hui ?