Inicio > Webservices > Actualización de una devolución

Puesta al día de una devolución

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

Este servicio web sirve para actualizar una devolución.

Si debes proporcionar una etiqueta de devolución al cliente, dos métodos posibles:

Si la etiqueta permanece en vuestra posesión: se debe especificar "label_link" conteniendo el enlace hacia la etiqueta
Si deseas que nosotros tengamos la etiqueta en nuestro servidor: se debe especificar "label_file" conteniendo el fichero de la etiqueta

Una vez que la devolución sea enviada, O el plazo concedido, se debe especificar "statut" para una de estas opciones:

aceptar la devolución ( estatus 4 )
rechazar la devolución ( estatus 3 )

> Ver la lista de los estatus de devoluciones

Liste des parámetros

Los parámetros de este webservice deben pasar obligatoriamente en POST

Parámetro	Description
partner	Debe contener tu identificador único:
rID	Identificador de devolución actualizado
statut	Nuevo estado de la devolución ( 3 o 4 )

Formato XML devuelto

<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 de los códigos de error de la webservice

Código	Descripción
1	Sin error de parámetros
-1	El parámetro partenaire no ha pasado a parámetro o está vacio
-2	El parámetro partenaire no existe
-5	Falta el parámetro partner rID/oID o el parámetro statut
-6	El pedido o la devolución no ha sido encontrados, verifica el parámetro oID / rID o el parámetro partenaire.
-7	Problema en la cronología de la devolución El estado 4 no se aplica si la devolución está en el estado 2 o 3 El estado 3 no se aplica si la devolución está en el estado 2
-9	El nuevo statut es identico al statut actual
-22	Error en la recepción del fichero
-23	Error desconocido en la recepción del fichero
-24	El enlace de la etiqueta es demasiado largo
-25	El enlace proporcionado es idéntico al enlace actual
-428	Tu cuenta ha sido desactivada. Ya no puede realizar llamadas a servicios web
-429	Has realizado demasiadas llamadas a este servicio web durante esta hora

Ejemplo de devolución XML

Ejemplo de respuesta para una llamada servicio web 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>

Ejemplo de respuesta para una llamada servicio web 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 ?