Home > Webservices > Een retour updaten

Status van een retour vernieuwen

URL van de Webservice : https://sws.spartoo.be/mp/xml_maj_returns.php

Deze webservice laat toe de status van een retour te vernieuwen. Er zijn slechts twee mogelijkheden: ofwel de retour aanvaarden (status 4), ofwel de retour weigeren (status 3)

> Bekijk de lijst met de statussen van de retouren

Lijst met parameters

De parameters van deze webservice dient u verplicht in te geven als POST

Parameter	Omschrijving
Partner	Dient uw unieke ID te bevatten:
rID	Referentie te vernieuwen retour
statut	(optioneel) Nieuwe status retour (3 of 4)
label_link	(optioneel) Link naar het retouretiket
label_file	(optionnel) Bestand van het retouretiket

Formaat van de teruggestuurde XML data

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

Lijst met de foutcodes van de webservice

Code	Omschrijving
1	Geen fouten in de parameters
-1	De parameter partenaire werd niet als parameter aangemaakt of is leeg
-2	De partner parameter bestaat niet
-5	De parameter rID/oID of de parameter status ontbreken
-6	De bestelling of de retour werden niet gevonden, gelieve de parameter oID/rID of de parameter partner na te kijken.
-7	Probleem volgorde retour Statut 4 geldt enkel indien de retour in status 2 of 3 staat Statut 3 geldt enkel indien de retour in status 2 staat
-9	De nieuwe status is dezelfde als de huidige
-22	Fout bij ontvangst van het bestand
-23	Onbekende fout bij ontvangst van het bestand
-24	De link van het etiket is te lang
-25	De gegeven link is identiek aan de huidige link
-428	Uw account is gedeactiveerd. U kunt niet langer gebruik maken van de webservices
-429	U heeft te veel gebruik gemaakt van deze webservice voor dit uur

Voorbeelden van XML retour

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

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