Inicio > Webservices > Export de las devoluciones

Exportación de devoluciones

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

Este webservice permite recuperar las informaciones de las devoluciones bien creadas a partir de una fecha dada, bien a través de un identidicador de devolución , o bien a través de un identificador de pedido.
Las devoluciones pueden ser filtradas por statut.

Cada devolución contiene un solo producto.

Lista de parámetros


Parámetro Descripción
partenaire Debe de contener tu identificador único:
date Fecha a partir de la cual deseamos seleccionar los pedidos. Formato : timestamp
oID Identificador del pedido
rID Identificador de la devolución
statut Statut de las devoluciones a recuperar. Si el parámetro no ha sido introducido, seleccionará todas las devoluciones.
> Ver la lista de statuts

El parámetro partnenaire es obligatorio y también uno de los tres parámetros siguientes, date, oID o rID. El parámetro statut es facultativo.

Formato XML devuelto


<root>
	<returns>
		<return>
			<return_id>string</return_id>
			<return_date>[DATE]</return_date>
			<return_status_name>string</return_status_name>
			<return_status>int</return_status>
			<return_reason>string</return_reason>
			<order>string</order>
			<product>
				<products_reference>string</products_reference>
				<products_name>string</products_name>
				<products_spartoo>int</products_spartoo>
				<products_manufacturers>string</products_manufacturers>
				<products_size>string</products_size>
				<products_color>string</products_color>
			</product>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
				</error>
			</errors>
		</return>
		<!-- ... Varias etiquetas "return" posibles ... -->
	</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
-3 Falta un parámetro obligatorio (date o oID/rID)
-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

Descripción de campos de la respuesta XML


Balise Descripción
return_id Identificador de la devolución
return_date Fecha de la creación de la devolución
return_status_name Nombre del statut de la devolución
return_status Id del statut de la devolución
return_reason Razón de la devolución
order Identificador del pedido
product Producto devuelto
products_reference Referencia del producto del partner
products_spartoo Referencia del producto en Spartoo
products_name Nombre del modelo
products_manufacturers Nombre de la marca
products_size Talla pedida
size_reference Referencia del producto a la talla
products_color Color del producto


Ejemplo de devolución XML




Ejemplo de respuesta para una llamada servicio web KO :

<root>
	<returns>
		<return>
			<return_id>EAJBCC</return_id>
			<return_date>	</return_date>
			<return_status_name><![CDATA[Pendiente de recepción]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problema de talla]]></return_reason>
			<order>90D813EA1A2365A8</order>
			<product>
				<products_reference><![CDATA[ABCD]]></products_reference>
				<products_name><![CDATA[ALL STAR HI]]></products_name>
				<products_spartoo><![CDATA[123456]]></products_spartoo>
				<products_manufacturers><![CDATA[Converse]]></products_manufacturers>
				<products_size>42</products_size>
				<products_color><![CDATA[Blanc]]></products_color>
			</product>
			<errors>
				<error>
					<id>-3</id>
					<description>Il manque un paramètre obligatoire ( date ou oID/rID )</description>
				</error>
			</errors>
		</return>
	</returns>
	<statut>
		<id>3</id>
		<description>Refusé</description>
	</statut>
</root>

Ejemplo de respuesta para una llamada servicio web OK :

<root>
	<returns>
		<return>
			<return_id>EEAJBCC</return_id>
			<return_date>2013-04-22 17:56:36</return_date>
			<return_status_name><![CDATA[Pendiente de recepción]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problema de talla]]></return_reason>
			<order>90D813EA1A2365A8</order>
			<product>
				<products_reference><![CDATA[ABCD]]></products_reference>
				<products_name><![CDATA[ALL STAR HI]]></products_name>
				<products_spartoo>123456</products_spartoo>
				<products_manufacturers><![CDATA[Converse]]></products_manufacturers>
				<products_size>42</products_size>
				<products_color><![CDATA[Blanc]]></products_color>
			</product>
		</return>
	</returns>
	<errors>
		<error>
			<id>1</id>
			<description>Pas d'erreur de paramètres</description>
		</error>
	</errors>
	<statut>
		<id>4</id>
		<description>Colis reçu, retour accepté</description>
	</statut>
</root>