Início > Webservices > Exportar devoluções

Exportação das devoluções

URL do Webservice : https://sws.spartoo.pt/mp/xml_export_returns.php

Este webservice permite recuperar as informações das devoluções através de uma data, atarvés da identificação da devolução ou através da identificação da encomenda.
As devoluções podem ser filtradas por estatuto.

Cada devolução apenas contém um produto.

Lista dos parâmetros


Parâmetro Descrição
partenaire Deve conter a sua identificação:
date Data a partir da qual deseja selecionar as encomendas. Formato: timestamp
oID Identificação da encomenda
rID Identificação da devolução
statut Estatuto das devoluções a recuperar. Se o parâmetro não for indicado, serão selecionadas todas as devoluções.
> Ver a lista dos estatutos

O parâmetro do parceiro é obrigatório assim como um destes 3 parâmetros date, oID ou rID. O parâmetro do estatuto é facultativo.

Formato do XML devolvido


<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>
		<!-- ... Várias balizas "return" possíveis ... -->
	</returns>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>


Lista dos códigos de erros do webservice


Código Descrição
1 Sem erros nos parâmetros
-1 O parâmetro partenaire não passou no parâmetro ou está vazio
-2 O parâmetro do parceiro não existe
-3 Falta um parâmetro obrigatório ( date ou oID/rID )
-428 A sua conta foi desativada. Não pode mais efetuar chamadas ao webservice
-429 Efetuou demasiado chamadas para o Webservice nesta hora corrida

Descrição dos campos da resposta XML


Balise Descrição
return_id Identificação da devolução
return_date Data de criação da devolução
return_status_name Nome do estatuto atual da devolução
return_status Id do estatuto atual da devolução
return_reason Motivo da devolução
order Identificação da encomenda
product Produto devolvido
products_reference Referência do produto no parceiro
products_spartoo Referência do produto na Spartoo
products_name Nome do modelo
products_manufacturers Nome da marca
products_size Tamanho encomendado
size_reference Referência do produto com o tamanho encomendado
products_color Cor do produto


Exemplos de devolução XML




Exemplo de resposta a uma chamada web serviço KO :

<root>
	<returns>
		<return>
			<return_id>EAJBCC</return_id>
			<return_date>	</return_date>
			<return_status_name><![CDATA[A aguardar a receção]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problema de tamanho]]></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>

Exemplo de resposta a uma chamada web serviço OK :

<root>
	<returns>
		<return>
			<return_id>EEAJBCC</return_id>
			<return_date>2013-04-22 17:56:36</return_date>
			<return_status_name><![CDATA[A aguardar a receção]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problema de tamanho]]></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>