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