Uvítanie > Webové služby > Aktualizácia vrátenia tovaru

Aktualizácia vrátenia tovaru

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

Táto webová služba slúži na aktualizáciu vrátenia produktov.

Ak musíte poskytnúť zákazníkovi štítok pre vrátenie, máte na výber medzi dvoma metódami:
  • Štítok máte u seba a poskytujete Vy: špecifikujte argument label_link obsahujúci odkaz na štítok
  • Želáte si, aby sme štítok mali u seba my a poskytovali ho na našich serveroch: špecifikujte argument label_file obsahujúci súbor so štítkom
Akonáhle je vrátený tovar vyexpedovaný alebo je lehota stanovená, môžete špecifikovať argument stav pre
  • buď prijatie vrátenia (stav 4)
  • buď odmietnutie vrátenia (stav 3)


> Pozrieť si zoznam stavov vrátenia

Zoznam parametrov

Parametre tejto webovej služby musia povinne prejsť cez POST

Parameter Popis
partner Musí obsahovať Váš unikátny identifikátor:
rID Aktualizovaný identifikátor vrátenia
stav (voliteľné) Nový stav vrátenia (3 alebo 4)
label_link (voliteľné) Okaz na štítok pre vrátenie
label_file (voliteľné) Súbor so štítkami pre vrátenie


Obrátený formát XML


<root>
	<returns>
		<return>
			<partenaire>string</partenaire>
			<rID>int</rID>
			<label_link>url</label_link>
			<label_file>url</label_file>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
				</error>
			</errors>
		<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ú
-5 Cýba parameter rID/oID alebo parameter stavu
-6 Objednávka alebo vrátenie neboli nájdené, overte parameter oID / rID alebo partnerský parameter.
-7 Problém v chronológii vrátenia
  • Stav 4 sa aplikuje jedine v prípade, že je vrátenie v stave 2 alebo 3
  • Stav 3 sa aplikuje jedine v prípade, že je vrátenie v stave 2
-9 Nový stav je identický s aktuálnym stavom
-22 Chyba pri preberaní prílohy
-23 Neznáma chyba pri preberaní prílohy
-24 Odkaz na štítok pre vrátenie je príliš dlhý
-25 Poskytnutý odkaz je rovnaký ako predchádzajúci
-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

Príklady vrátenia XML


Príklad odpovede web servis KO :

<root>
	<returns>
		<return>
			<partenaire>1EC51BF31B486658</partenaire>
			<rID>	</rID>
			<label_link>http://www.spartoo.fr/pj.php?file_id_crypt=...</label_link>
			<errors>
				<error>
					<id>-6</id>
					<description>
						La commande ou le retour n’ont pas été trouvés, vérifiez le paramètre oID / rID ou le paramètre partenaire.
					</description>
				</error>
			</errors>
		</return>
	</returns>
	<statut>
		<id>6</id>
		<description>retour refusé</description>
	</statut>
</root>

Príklad odpovede web servis OK :

<root>
	<returns>
		<return>
			<partenaire>1EC51BF31B486658</partenaire>
			<rID>8883777</rID>
			<label_link>http://www.spartoo.fr/pj.php?file_id_crypt=...</label_link>
			<errors>
				<error>
					<id>1</id>
					<description>Pas d'erreur de paramètres</description>
				</error>
			</errors>
		</return>
	</returns>
	<statut>
		<id>4</id>
		<description>retour accepté</description>
	</statut>
</root>