Home > Webservices > Aktualizacja zwrotu

Aktualizacja zwrotu

URL Webservice : https://sws.spartoo.pl/mp/xml_maj_returns.php

Ten webservice służy do aktualizacji zwrotów.

Jeśli musisz udostępnić etykietę zwrotną klientowi, dwie metody są do Twojej dyspozycji:
  • Etykieta jest hostowana u Ciebie: sprecyzuj argument label_link zawierający link do etykiety
  • Chcesz, abyśmy my hostowali etykietę na naszych serwerach: sprecyzuj argument label_file zawierający plik z etykietą
Jak zwrot zostanie wysłany, lub upłynie przewidziany termin, możesz sprecyzować argument statut aby
  • albo zatwierdzić zwrot ( statut 4 )
  • albo odrzucić zwrot ( statut 3 )


> Zobacz listę statutów zwrotu

Liste des paramètres

Parametry tego webservice muszą obowiązkowo muszą być w POST

Parametr Opis
partner Rubryka musi zawierać Twój indywidualny identyfikator:
rID Numer zwrotu wymagającego aktualizacji
statut (opcjonalnie) Nowy status zwrotu ( 3 lub 4 )
label_link (optionnel) Link do etykiety zwrotu
label_file (opcjonalniel) Plik etykiety zwrotu


Format XML zwrócony


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


Lista kodów błędów webservice


Kod Opis
1 Nie ma błędu parametrów
-1 Parametr partenaire nie uzyskał statusu parametru lub jest pusty
-2 Parametr firmy partnerskiej nie istnieje
-5 Brak parametru rID/oID lub parametru status
-6 Zamówienie lub zwrot nie zostały znalezione, proszę sprawdzić parametr oID / rID lub parametr firmy partnerskiej.
-7 Problem dotyczący chronologii zwrotu
  • Status 4 występuje wyłącznie, gdy zwrot ma status 2 lub 3
  • Status 3 występuje wyłącznie, gdy zwrot ma status 2
-9 Nowy status jest identyczny z dotychczasowmy
-22 Błąd podczas pobierania pliku
-23 Niezidentyfikowany błąd podczas pobierania pliku
-24 Link etykiety jest zbyt długi
-25 Podany link jest identyczny z aktualnym
-428 Twoje konto zostało dezaktywowane. Nie będziesz już mógł/mogła się do niego zalogować
-429 W ciągu ostatniej godziny wykonałeś/aś zbyt wiele połączeń z tym serwisem internetowym

Przykłady komunikatów XML


Przykład odpowiedzi na nieudane połączenie web service :

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

Przykład odpowiedzi na udane połączenie web service :

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