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>

💡 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 Marketplace
Bonjour ! Comment puis-je vous aider aujourd'hui ?