Úvod > Webservis > Aktualizace vrácení zboží

Modifikace vrácení

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

Webservice slouží ke změně statusu vrácení.

Pokud zasíláte zákazníkovi vracecí štítek, vybízí se dva způsoby:
  • Vracecí štítek je uložen u vás: upřesněte odkaz, který přesměruje na vracecí štítek
  • Pokud chcete uložit štítek u nás, upřesněte soubor, kde bude vracecí štítek uložen
    • Jakmile je vám balík s vráceným zboží doručen, musíte v systému změnit status vrácení a to buď:
    • přijmout vrácení (status 4)
    • odmítnout vrácení (status 3)


    >Zobrazit všechny statusy vrácení

    Seznam parametrů

    Parametry webservisu musí být povinně předány přes POST

    Parametr Popis
    partner Musí obsahovat váš unikátní identifikátor:
    rID Identifikace vrácení aktualizováno
    statut Nový status vrácení (3 nebo 4)
    label_link (nepovinné) Odkaz pro stažení vracecího štítku
    label_file (optionnel) Dokument stahovacího štítku


    Formát XML zapsán obráceně


    <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>


    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
    -5 Chybí parametr rID/oID (číslo objednávky nebo číslo vrácení) nebo parametr statusu
    -6 Objednávka nebo vrácení nebylo nalezeno, ověřte správnost parametru oID / rID (číslo objednávky nebo číslo vrácení).
    -7 Problém v chronologii vrácení
    • Status 4 se nedá použít na vrácení, které je ve statusu 2 nebo 3
    • Status 3 se nedá použít, pokud je objednávka ve statusu 2
    -9 Nový status je stejný jako status aktuální
    -22 Chyba při přijetí dokumentu
    -23 Neznámá chyba při přijetí dokumentu
    -24 Odkaz pro vracecí štítek je příliš dlouhý
    -25 Zadaný odkaz je stejný jako ten předchozí
    -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.

    Příklad vrácení XML


    Příklad odpovědi web servisu 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>

    Příklad odpovědi web servisu 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 ?