Recepție > Webservices > Export returnări

Export des retours

Adresa URL a serviciului Webservice : https://sws.spartoo.ro/mp/xml_export_returns.php

Acest serviciu webservice permite recuperarea informațiilor cu privire la returnare create după o anumită dată, fie prin intermediul unui id retur, fie prin id-ul comenzii.
Returnările pot fi filtrate în funcție de statut.

Fiecare retur conține un singur produs..

Liste des paramètres


Paramètre Description
partenaire Trebuie să conțină id-ul vostru unic :
date Date de la care doriți să selectați comenzile. Format : timestamp
oID ID-ul comenzii
rID ID-ul de returnare
statut Statutul returnărilor care trebuie recuperate.Dacă parametrul nu este furnizat, aceste va selecționa toate retunările.
> Vizualizați lista statutului

Parametrul partener este obligatoriu și unul ditre cei trei paramettri date, oID ou rID este obligatoriu. Parametrul statut este facultativ.

Formatul XML returnat


<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>
		<!-- ... Mai multe balize "return" posibile ... -->
	</returns>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>


Lista codurilor de eroare ale serviciului web


Cod Descriere
1 Nici o eroare de parametru
-1 Parametrul partenaire nu este trecut în parametru sau este gol
-2 Parametrul partenerului nu există
-3 Lipsește un parametru obligatoriu (data sau oID / rID)
-428 Contul dvs a fost dezactivat. Nu mai puteți efectua solicitări către serviciile web
-429 Ați efectuat prea multe solicitări către serviciile web peste limita la oră

Descrierea câmpurilor răspunsului XML


Balise Descriere
return_id Identificator returnare
return_date Data creării returnării
return_status_name Numele statutului actual returnare
return_status Id statut actual de returnare
return_reason Motiv returnare
order ID-ul comenzii
product Produs returnat
products_reference Referință produs partener
products_spartoo Referinta produs la Spartoo
products_name Nom du modèle
products_manufacturers Numele brandului
products_size Mărimea comandată
size_reference Referință produs la mărime
products_color Culoarea produsului


Exemple de returnări XML




Exemplu de răspuns la un apel de serviciu web KO :

<root>
	<returns>
		<return>
			<return_id>EAJBCC</return_id>
			<return_date>	</return_date>
			<return_status_name><![CDATA[În așteptare pentru recepționare]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problemă de mărime]]></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>

Exemplu de răspuns la un apel de serviciu web OK :

<root>
	<returns>
		<return>
			<return_id>EEAJBCC</return_id>
			<return_date>2013-04-22 17:56:36</return_date>
			<return_status_name><![CDATA[În așteptare pentru recepționare]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Problemă de mărime]]></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>