Home > Webservices > Export der Retouren

Export der Retouren

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

Dieser Webservice ermöglicht es, Informationen bezüglich der Retouren zu erhalten. Dies geschieht entweder mittels eines gegebenen Datums, einer Retouren-ID oder einer Bestellungs-ID.
Die Retouren können nach Status gefiltert werden.

Jede Retoure enthält nur ein Produkt.

Liste der Parameter

Die Parameter dieses Webservice müssen unbedingt per POST übertragen werden

Parameter Beschreibung
partenaire Muss Ihre Benutzeridentifizierung enthalten:
date Datum ab dem die Bestellungen ausgewählt werden sollen. Format: Zeitstempel
oID Bestellungs-ID
rID Retouren-ID
statut Status der Retouren die Sie einsehen möchten. Wenn der Parameter nicht vorliegt werden alle Retouren ausgewählt.
> Statusliste einsehen

Der Partnerparameter, sowie einer der drei folgenden Parameter sind obligatorisch: Datum, oID oder rID. Der Parameter Status ist optional.

Format der zurückgeschickten XML-Datei 


<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>
		<!-- ... Mehrere "return" Tags möglich ... -->
	</returns>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>


Liste der Fehlercodes des Webservice


Code Beschreibung
1 Kein Parameterfehler
-1 Der Parameter partenaire fehlt oder ist leer
-2 Der Partnerparameter existiert nicht
-3 Es fehlt ein obligatorischer Parameter ( date oder oID/rID )
-428 Ihr Kundenkonto wurde nun desaktiviert. Sie können nun keine weiteren Anfragen an den Webservice stellen.
-429 Sie haben innerhalb der zur Verfügung stehenden Zeit zu viele Anfragen an den Webservice gestellt.

Beschreibung der Felder der XML-Antwort


Tag Beschreibung
return_id Retouren-ID
return_date Erstellungsdatum der Retoure
return_status_name Name des aktuellen Status der Retoure
return_status ID des aktuellen Status der Retoure
return_reason Grund der Retoure
order Bestellungs-ID
product zurückgeschicktes Produkt
products_reference Produktreferenz des Partners
products_spartoo Spartoo Produktreferenz
products_name Name des Modells
products_manufacturers Markenname
products_size bestellte Größe
size_reference Referenz des Produktes in Bezug auf die Größe
products_color Farbe des Produktes


Beispiele XML-Antwort




Beispielantwort auf einen KO-Aufruf eines Webdienstes :

<root>
	<returns>
		<return>
			<return_id>EAJBCC</return_id>
			<return_date>	</return_date>
			<return_status_name><![CDATA[Warten auf Eingang]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problem mit der Größe]]></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>

Beispielantwort auf einen KO-Aufruf eines Webdienstes :

<root>
	<returns>
		<return>
			<return_id>EEAJBCC</return_id>
			<return_date>2013-04-22 17:56:36</return_date>
			<return_status_name><![CDATA[Warten auf Eingang]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problem mit der Größe]]></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>