Úvod > Webservis > Export vrácených zásilek

Export vrácení

URL Webservisu : https://sws.spartoo.cz/mp/xml_export_returns.php

Webservis dokáže získat informace o vrácení dle data, čísla vrácení nebo čísla objednávky.
Vrácení může být filtrováno dle statusu.

Každé vrácení obsahuje pouze jeden produkt.

Seznam parametrů


Parametr Popis
partenaire Musí obsahovat unikátní identifikátor partnera:
date Ke kterému datu si přejete vybrat objednávky. Formát: timestamp
oID Identifikátor objednávky
rID Identifikátor vrácení
statut Status vrácení. Pokud není zvolen parametr, budou vybrána všechna vrácení.
> Zobrazit seznam statusů

Parametr partnera je povinný a jeden z těch těchto třech dat - datum, oID (číslo objednávky) nebo rID (číslo vrácení). Parametr statusu je volitelný.

Formát XML zapsán obráceně


<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>
		<!-- ... Možné zadání více "return"  ... -->
	</returns>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>


Seznam kódů chyb webservice


Kód Popis
1 Žádná chyba v parametrech nenalezena
-1 Parametr partenaire není správný parametr nebo je prázdný
-2 Partnerský parametr neexistuje
-3 Chybí povinné údaje, parametr (datum nebo oID/rID)
-428 Váš účet byl deaktivován. Nemůžete již volat.
-429 Na tuto webovou službu jste volali příliš mnoho, limit je vyčerpán.

Popis pole odpovídající XML


Značení Popis
return_id Označení vrácení
return_date Datum vytvoření vrácení
return_status_name Aktuální status vrácení
return_status Id statusu vrácení
return_reason Důvod vrácení
order Označení objednávky
product Vrácený produkt
products_reference Reference produktu u partnera
products_spartoo Reference produktu na Spartoo
products_name Název modelu
products_manufacturers Název značky
products_size Objednaná velikost
size_reference Reference produktu k velikosti
products_color Barva produktu


Příklad vrácení XML




Příklad odpovědi web servisu KO :

<root>
	<returns>
		<return>
			<return_id>EAJBCC</return_id>
			<return_date>	</return_date>
			<return_status_name><![CDATA[Čeká na přijetí]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problém s velikostí]]></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>

Příklad odpovědi web servisu OK :

<root>
	<returns>
		<return>
			<return_id>EEAJBCC</return_id>
			<return_date>2013-04-22 17:56:36</return_date>
			<return_status_name><![CDATA[Čeká na přijetí]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problém s velikostí]]></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>