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>

💡 Conseils d'intégration pour les étiquettes de retour

  • label_link : L'URL fournie pour l'étiquette de retour ne doit pas dépasser 255 caractères (limite stricte de l'API). Si vous utilisez des paramètres d'URL ou d'authentification longs, veuillez raccourcir le lien au préalable.
  • label_file : Si vous soumettez directement le fichier de l'étiquette, vous devez transmettre le contenu binaire brut (raw binary content) du fichier (et non une chaîne encodée en Base64). Les formats acceptés sont le PDF (.pdf) et les formats d'images (.jpg, .jpeg, .png, .gif) pour une taille maximale de 10 Mo.



Saitoo - Assistant (mp)
Bonjour ! Comment puis-je vous aider aujourd'hui ?