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>