Home > Webservices > Eksporter returanmodninger

Eksport af returprodukter

URL til Webservices : https://sws.spartoo.dk/mp/xml_export_returns.php

Denne webservice gør det muligt at hente informationer om returanmodninger, der er afgivet efter en hvis dato ud fra et Bestillingsid.
. Returanmodningerne kan filtreres efter status

Hver retur indeholder kun et produkt.

Liste over parametre



Parameter Beskrivelse
partenaire Skal indeholde dit unikke forhandler ID:
date Den dato du ønsker at se bestillinger fra. Format: timestamp
oID Bestillings ID
rID Retur ID
statut Status for returanmodning, der skal filtreres på. Hvis der ikke vælges en parameter bliver alle returanmodninger valgt.
> Se listen over statusser /td>

Parameteren forhandler er obligatorisk sammen med en af følgende tre parametre: dato, oID eller rID. Parameteren status er valgfri.

Det returnerede XML-format


<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>
		<!-- ... Flere muligheder for "return"-kode ... -->
	</returns>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>


Liste over fejlkoder hos webservices


Kode (kategori, materiale) Beskrivelse
1 Ingen fejlparametrer
-1 Parameteren partenaire er ikke blevet registreret eller er tom
-2 Forhandlerens parametre eksisterer ikke
-3 Der mangler en obligatorisk parameter (date eller oID/rID )
-428 Din konto er deaktiveret. Du kan ikke længere benytte webservices
-429 Du har overskredet brugen af denne webservice inden for den seneste time

Beskrivelse af svarfelterne i XML


Kode Beskrivelse
return_id Retur ID
return_date Dato for oprettelse af returanmodningen
return_status_name Navn på returens nuværende status
return_status ID for returens nuværende status
return_reason Årsag til returen
order Bestillings ID
product Det returnerede produkt
products_reference Forhandlerens produktid
products_spartoo Spartoos produktid
products_name Modelnavn
products_manufacturers Mærke
products_size Størrelse
size_reference Verenummer for den angivne størrelse
products_color Farve


Eksempel på retur-XML




Prøvesvar på et opkald til webservicen KO :

<root>
	<returns>
		<return>
			<return_id>EAJBCC</return_id>
			<return_date>	</return_date>
			<return_status_name><![CDATA[Afventer modtagelse]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problem med størrelse]]></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>

Prøvesvar på et opkald til webservicen OK :

<root>
	<returns>
		<return>
			<return_id>EEAJBCC</return_id>
			<return_date>2013-04-22 17:56:36</return_date>
			<return_status_name><![CDATA[Afventer modtagelse]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problem med størrelse]]></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>