Home > Webservices > Retouren exporteren

Export van de retouren

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

Deze webservice laat toe om informatie over de retouren op te vragen vanaf een bepaalde datum, op een retourreferentie of op een bestelreferentie.
Retourren kunnen gefilterd worden op status.

Elke retour bevat slechts één product.

Lijst met parameters


Parameter Omschrijving
partner Dient uw unieke ID te bevatten:
date Datum vanaf dewelke u bestellingen wenst te selecteren. Formaat: timestamp
oID Referentie van de bestelling
rID Refentie van de retour
statut Status van de op te halen retouren. Indien de parameter niet is opgegeven, zullen al de retours geselecteerd worden.
> Bekijk de lijst met statussen

De parameter partner is verplicht en een van de drie parameters date, oID of rID is verplicht. De parameter status is facultatief.

Formaat van de teruggestuurde XML data


<root>
	<returns>
		<return>
			<return_id>string</return_id>
			<return_date>[DATE]</return_date>
			<return_status_name>string</return_status_name>
			<return_status>int</return_status>
			<return_reason>string</return_reason>
			<order>string</order>
			<product>
				<products_reference>string</products_reference>
				<products_name>string</products_name>
				<products_spartoo>int</products_spartoo>
				<products_manufacturers>string</products_manufacturers>
				<products_size>string</products_size>
				<products_color>string</products_color>
			</product>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
				</error>
			</errors>
		</return>
		<!-- ... Meerdere afbakeningen "return" mogelijk ... -->
	</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
-3 Er ontbreekt een verplichte parameter (date of oID/rID )
-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

Omschrijving van de velden van het XML antwoord


Tag Omschrijving
return_id Retourreferentie
return_date Datum aanmaak retour
return_status_name Naam huidige status van de retour
return_status Id huidige status van de retour
return_reason Reden retour
order Referentie bestelling
product Geretourneerd product
products_reference Productreferentie partner
products_spartoo Productreferentie Spartoo
products_name Naam model
products_manufacturers Naam van het merk
products_size Bestelde maat
size_reference Référence du produit à la taille
products_color Kleur product


Voorbeelden van XML retour




Voorbeeld KO :

<root>
	<returns>
		<return>
			<return_id>EAJBCC</return_id>
			<return_date>	</return_date>
			<return_status_name><![CDATA[In afwachting van ontvangst]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Probleem met de maat]]></return_reason>
			<order>90D813EA1A2365A8</order>
			<product>
				<products_reference><![CDATA[ABCD]]></products_reference>
				<products_name><![CDATA[ALL STAR HI]]></products_name>
				<products_spartoo><![CDATA[123456]]></products_spartoo>
				<products_manufacturers><![CDATA[Converse]]></products_manufacturers>
				<products_size>42</products_size>
				<products_color><![CDATA[Blanc]]></products_color>
			</product>
			<errors>
				<error>
					<id>-3</id>
					<description>Il manque un paramètre obligatoire ( date ou oID/rID )</description>
				</error>
			</errors>
		</return>
	</returns>
	<statut>
		<id>3</id>
		<description>Refusé</description>
	</statut>
</root>

Voorbeeld OK :

<root>
	<returns>
		<return>
			<return_id>EEAJBCC</return_id>
			<return_date>2013-04-22 17:56:36</return_date>
			<return_status_name><![CDATA[In afwachting van ontvangst]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Probleem met de maat]]></return_reason>
			<order>90D813EA1A2365A8</order>
			<product>
				<products_reference><![CDATA[ABCD]]></products_reference>
				<products_name><![CDATA[ALL STAR HI]]></products_name>
				<products_spartoo>123456</products_spartoo>
				<products_manufacturers><![CDATA[Converse]]></products_manufacturers>
				<products_size>42</products_size>
				<products_color><![CDATA[Blanc]]></products_color>
			</product>
		</return>
	</returns>
	<errors>
		<error>
			<id>1</id>
			<description>Pas d'erreur de paramètres</description>
		</error>
	</errors>
	<statut>
		<id>4</id>
		<description>Colis reçu, retour accepté</description>
	</statut>
</root>