Accueil > Webservices > Mise à jour d'un retour

Mise à jour d'un retour

URL du Webservice : https://sws.spartoo.com/mp/xml_maj_returns.php

Ce webservice sert à mettre à jour un retour.

Si vous devez fournir une étiquette de retour au client, deux méthodes sont à votre disposition :
  • L'étiquette est hébergée chez vous : spécifiez l'argument label_link contenant le lien vers l'étiquette
  • Vous souhaitez que nous hébergions l'étiquette sur nos serveurs : spécifiez l'argument label_file contenant le fichier de l'étiquette
Une fois le retour expédié, ou le délai imparti, vous pouvez spécifier l'argument statut pour
  • soit accepter le retour ( statut 4 )
  • soit refuser le retour ( statut 3 )


> Voir la liste des statuts des retours

Liste des paramètres

Les paramètres de ce webservice doivent être obligatoirement passés en POST

Paramètre Description
partenaire Doit contenir votre identifiant unique :
rID Identifiant du retour à mettre à jour
statut (optionnel) Nouveau statut du retour ( 3 ou 4 )
label_link (optionnel) Lien vers l'étiquette de retour
label_file (optionnel) Fichier de l'étiquette de retour


Format du XML retourné


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


Liste des codes d'erreurs du webservice


Code Description
1 Pas d'erreur de paramètres
-1 Le paramètre partenaire n’est pas passé en paramètre ou est vide
-2 Le paramètre partenaire n’existe pas
-5 Il manque le paramètre rID/oID ou le paramètre statut
-6 La commande ou le retour n’ont pas été trouvés, vérifiez le paramètre oID / rID ou le paramètre partenaire.
-7 Problème dans la chronologie du retour
  • Le statut 4 ne s’applique que si le retour est en statut 2 ou 3
  • Le statut 3 ne s’applique que si la commande est en statut 2
-9 Le nouveau statut est identique au statut actuel
-22 Erreur lors de la réception du fichier
-23 Erreur inconnue lors de la réception du fichier
-24 Le lien de l'étiquette est trop long
-25 Le lien fourni est identique au lien actuel
-428 Votre compte a été désactivé. Vous ne pouvez plus faire d'appels aux webservices
-429 Vous avez fait trop d'appel a ce webservice pour cette heure glissante

Exemples de retour XML


Exemple de réponse à un appel 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>

Exemple de réponse à un appel 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>