Home > Webservices > Een retour updaten

Status van een retour vernieuwen

URL van de Webservice : https://sws.spartoo.nl/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 partenaire 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>