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>

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