Uvítanie > Webové služby > Export vrátení tovaru

Export vrátení tovaru

URL webovej služby : https://sws.spartoo.sk/mp/xml_export_returns.php

Táto webová služba umožňuje prevziať informácie o vráteniach tovaru vytvorených po určitom dátume, alebo prostredníctvom identifikátora vrátenia, alebo prostredníctvom identifikátora objednávky.
Vrátenie tovaru môžu byť filtrované podľa stavu.

Každé vrátenie obsahuje iba jeden produkt.

Zoznam parametrov


Parameter Popis
Partnerský predajca Musí obsahovať Váš unikátny identifikátor:
Dátum Dátum, od ktorého si želáte vyselektovať objednávky. Formát: timestamp
oID Identifikátor objednávky
rID Identifikátor objednávky
Stav Stav nadobudnutých vrátení. Ak nie je parameter zadaný, zobrazené budú všetky vrátenia.
> Pozrieť si zoznam možných stavov

Le paramètre partenaire est obligatoire et l’un des trois paramètres date, oID ou rID est obligatoire. Le paramètre statut est facultatif.

Obrátený formát XML


<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>
		<!-- ... Viacero možných tagov "return" ... -->
	</returns>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>


Zoznám chybových kódov webovej služby


Kód Popis
1 Bezchybné parametre
-1 Parameter partenaire nebol správne zaregistrovaný alebo je prázdny
-2 Parametre partnera neexistujú
-3 Chýba povinný parameter (dátum alebo oID/rID)
-428 Váš účet bol deaktivovaný. Odteraz nemáte možnosť zadávať požiadavky webservices
-429 Za túto hodinu ste dosiahli príliš veľký počet požiadaviek webservice

Popis políčok odpovede XML


Tag Popis
return_id Identifikátor vrátenia
return_date Dátum vytvorenia vrátenia
return_status_name Názov aktuálneho stavu vrátenia
return_status Identifikátor aktuálneho stavu vrátenia
return_reason Dôvod vrátenia
order Identifikátor objednávky
product Vrátený produkt
products_reference Referenčné označenie produktu partnerského predajcu
products_spartoo Referenčné označenie produktu na stránke Spartoo
products_name Názov modelu
products_manufacturers Názov značky
products_size Objednaná veľkosť
size_reference Referenčné označenie veľkosti produktu
products_color Farba produktu


Príklady vrátenia XML




Príklad odpovede web servis KO :

<root>
	<returns>
		<return>
			<return_id>EAJBCC</return_id>
			<return_date>	</return_date>
			<return_status_name><![CDATA[Čakáme na doručenie]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problém s veľkosťou]]></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>

Príklad odpovede web servis OK :

<root>
	<returns>
		<return>
			<return_id>EEAJBCC</return_id>
			<return_date>2013-04-22 17:56:36</return_date>
			<return_status_name><![CDATA[Čakáme na doručenie]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problém s veľkosťou]]></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>