Sprejem > Web storitve > Izvoz vračil

Izvoz vračil

URL Webservice-a : https://sws.spartoo.si/mp/xml_export_returns.php

Ta spletna storitev omogoča pridobivanje informacij o vračilih, bodisi ustvarjenih po določenem datumu, bodisi prek identifikatorja vračila ali prek identifikatorja naročila.
Vrnitve je mogoče filtrirati po statusu.

Vsako vračilo vsebuje samo en izdelek.

Seznam nastavitev


Paramètre Opis
partenaire Mora vsebovati vaš edinstven ID :
date Datum, od katerega naprej želite izbrati naročila. Format : timestamp
oID ID naročila
rID ID vračila
statut Status vračil za izterjavo. Če nastavitev ni izbrana, boste izbrali vsa vračila.
> Glej seznam statusov

Nastavitev partnerja je obvezna. Ena od treh parametrov - datum, oID ali rID – je obvezna. Nastavitev statusa ni obvezna.

Format izvoženega XML


<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>
		<!-- ... Več možnih oznak "return" ... -->
	</returns>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>


Seznam kod za napake spletnih storitev


Koda Opis
1 Ni napak v nastavitvah
-1 Nastavitev partenaire ni bila zaznana kot nastavitev ali pa je prazna
-2 Partnerske nastavitve ne obstajajo
-3 Manjka obvezna nastavitev ( datum ali oID/rID )
-428 Vaš račun je deaktiviran. Ne morete več naročati spletnih storitev
-429 V tekoči uri ste to spletno storitev prevečkrat naročili

Opis polj odzivov XML


Oznaka Opis
return_id ID vračila
return_date Datum ustvarjenega vračila
return_status_name Ime trenutnega stanja vračila
return_status ID trenutnega stanja vračila
return_reason Razlog za vračilo
order ID naročila
product Vrnjen izdelek
products_reference Referenca izdelka pri partnerju
products_spartoo Referenca izdelka pri Spartoo
products_name Ime modela
products_manufacturers Ime blagovne znamke
products_size Naročena velikost
size_reference Referenca velikosti izdelka
products_color Barva izdelka


Primer vračila XML




Primer odgovora na spletno povpraševanje KO :

<root>
	<returns>
		<return>
			<return_id>EAJBCC</return_id>
			<return_date>	</return_date>
			<return_status_name><![CDATA[V čakanju prejema]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Težava z velikostjo]]></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>

Primer odgovora na spletno povpraševanje OK :

<root>
	<returns>
		<return>
			<return_id>EEAJBCC</return_id>
			<return_date>2013-04-22 17:56:36</return_date>
			<return_status_name><![CDATA[V čakanju prejema]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Težava z velikostjo]]></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>