Home > Webservices > Eksport zwrotów

Eksport zwrotów

URL Webservice : https://sws.spartoo.pl/mp/xml_export_returns.php

Ten webservice pozwala na pobranie informacji dotyczących zwrotów według daty ich utworzenia albo według numerów zwrotów lub numerów zamówień.
Można także szukać zwrotu używając filtru status.

Dany zwrot zawiera wyłącznie jeden produkt.

Lista parametrów


Parametr Opis
partner Rubryka musi zawierać Twój indywidualny identyfikator:
date Data, poczynając od której chcemy wyszukać zamówienia. Format: timestamp
oID Numer zamówienia
rID Numer zwrotu
statut Status zwrotów do pobrania. Jeżeli parametr nie zostanie określony, pobrane zostaną wszystkie zwroty.
> Zobacz listę statusów

Parametr firmy partnerskiej jest obowiązkowy wraz z jednym z trzech następujących parametrów o charakterze obowiązkowym: date, oID lub rID. Parametr: statut ma charakter opcjonalny.

Format XML zwrócony


<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>
		<!-- ... Różne tagi "return" możliwe ... -->
	</returns>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>


Lista kodów błędów webservice


Kod Opis
1 Nie ma błędu parametrów
-1 Parametr partenaire nie uzyskał statusu parametru lub jest pusty
-2 Parametr firmy partnerskiej nie istnieje
-3 Brak parametru obowiązkowego (date lub oID/rID )
-428 Twoje konto zostało dezaktywowane. Nie będziesz już mógł/mogła się do niego zalogować
-429 W ciągu ostatniej godziny wykonałeś/aś zbyt wiele połączeń z tym serwisem internetowym

Opis rubryk odpowiedzi XML


Balise Opis
return_id Numer zwrotu
return_date Data utworzenia zwrotu
return_status_name Nazwa statusu zwrotu
return_status Id bieżącego statusu zwrotu
return_reason Przyczyna zwrotu
order Numer zamówienia
product Zwrócony produkt
products_reference Numer referencyjny produktu u partnera
products_spartoo Numer referencyjny produktu w Spartoo
products_name Nazwa modelu
products_manufacturers Nazwa marki
products_size Zamówiony rozmiar
size_reference Numer referencyjny rozmiaru produktu
products_color Kolor produktu


Przykłady komunikatów XML




Przykład odpowiedzi na nieudane połączenie web service :

<root>
	<returns>
		<return>
			<return_id>EAJBCC</return_id>
			<return_date>	</return_date>
			<return_status_name><![CDATA[Oczekiwanie na przesyłkę]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problem dotyczący rozmiaru]]></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>

Przykład odpowiedzi na udane połączenie web service :

<root>
	<returns>
		<return>
			<return_id>EEAJBCC</return_id>
			<return_date>2013-04-22 17:56:36</return_date>
			<return_status_name><![CDATA[Oczekiwanie na przesyłkę]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problem dotyczący rozmiaru]]></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>