Főoldal > Webszervíz > Visszaküldések exportja

Visszaküldések exportja

Webszervíz URL-je : https://sws.spartoo.hu/mp/xml_export_returns.php

Ez a webszervíz lehetőséget lehetőséget nyújt szert tenni a visszaküldések információira, vagy létrehozni egy adott dátum után, akár a visszaküldés azonosítójával, akár a rendelés azonosítójával.
A visszaküldések szűrve lehetnek státusz szerint.

Minden visszaküldés csak egy terméket tartalmaz.

Paraméterek listája


Paraméter Leírás
partenaire Tartalmaznia kell az Ön egyedi azonosítóját :
date A dátum, amikortól szeretnénk a rendeléseket kiválasztani. Formátum : timestamp
oID Rendelés azonosítója
rID Visszaküldés azonosítója
statut A megszerezni kívánt visszaküldések státusza. Ha a paraméter nem jelenik meg, minden visszaküldés ki lesz választva.
> Státuszok listájának megtekintése

A partner paraméter kötelező és még egy a három közül: dátum, oID vagy rID szintén kötelező. A státusz paraméter fakultatív.

Visszaküldött XML formátuma


<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>
		<!-- ... Több "return" jelzés lehetséges ... -->
	</returns>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>


Webszervíz hibakódjainak listája


Kód Leírás
1 Nincs paraméter hiba
-1 A partenaire paraméter nem ment át a paramétereken vagy üres
-2 A partner paraméter nem létezik
-3 Egy kötelező paraméter hiányzik ( dátum vagy oID/rID )
-428 Fiókja deaktiválásra került. A webservices már nem áll rendelkezésére.
-429 Túl sokszor lépett kapcsolatba a webservice-szel az elmúlt egy órában.

XML válasz mezőinek leírása


Jelzés Leírás
return_id Visszaküldés azonosítója
return_date Visszaküldés létrehozásának dátuma
return_status_name A visszaküldés jelenlegi státuszának neve
return_status A visszaküldés jelenlegi státuszának azonosítója
return_reason Visszaküldés oka
order A rendelés azonosítója
product Visszaküldött termék
products_reference Termék referencia a partnernél
products_spartoo Termék referencia a Spartoo-nál
products_name Modell neve
products_manufacturers Márka neve
products_size Rendelt méret
size_reference Termék referencia méretre
products_color Termék színe


Visszaküldött XML példái




Mintaválasz egy webszolgáltatás hívásra KO :

<root>
	<returns>
		<return>
			<return_id>EAJBCC</return_id>
			<return_date>	</return_date>
			<return_status_name><![CDATA[Várakozás átvételre]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Hibás méret]]></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>

Mintaválasz egy webszolgáltatás hívásra OK :

<root>
	<returns>
		<return>
			<return_id>EEAJBCC</return_id>
			<return_date>2013-04-22 17:56:36</return_date>
			<return_status_name><![CDATA[Várakozás átvételre]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Hibás méret]]></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>