Αρχική σελίδα > Webservices > Εξαγωγή επιστροφών

Εξαγωγή επιστροφών

URL του Webservice : https://sws.spartoo.gr/mp/xml_export_returns.php

Αυτό το webservice επιτρέπει την ανάκτηση πληροφοριών για επιστροφές που είτε δημιουργήθηκαν μετά από μια συγκεκριμένη ημερομηνία είτε μέσω ενός αναγνωριστικού επιστροφής, είτε μέσω ενός αναγνωριστικού παραγγελίας.
Οι επιστροφές μπορούν να φιλτραριστούν ανά κατάσταση.

Κάθε επιστροφή περιέχει ένα μόνο προϊόν.

Λίστα παραμέτρων


Παράμετρος Περιγραφή
συνεργάτης Πρέπει να περιέχει το μοναδικό id σας :
date Ημερομηνία από την οποία επιθυμούμε να γίνει η επιλογή των παραγγελιών. Μορφή : timestamp
oID Id παραγγελίας
rID Id επιστροφής
statut Status επιστροφών σε εξέλιξη. Εάν η παράμετρος δεν παρέχεται, αυτή θα επιλέξει όλες τις επιστροφές.
> Δείτε τη λίστα των status


Μορφή 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>
		<!-- ... Περισσότερα tags "return" δυνατά ... -->
	</returns>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>


Λίστα των κωδικών σφαλμάτων του webservice


Κωδικός Περιγραφή
1 Δεν υπάρχει σφάλμα στις παραμέτρους
-1 Η παράμετρος partenaire δεν καταχωρήθηκε ως παράμετρος ή είναι κενή
-2 Η παράμετρος partenaire δεν υπάρχει
-3 Λείπει μια υποχρεωτική παράμετρος ( date ή oID/rID )
-428 Ο λογαριασμός σας έχει απενεργοποιηθεί. Δεν μπορείτε πλέον να πραγματοποιείτε κλήσεις στις υπηρεσίες web
-429 Έχετε κάνει πάρα πολλές κλήσεις προς αυτήν την υπηρεσία web, για την τρέχουσα ώρα

Περιγραφή των πεδίων της απάντησης σε μορφή XML


Balise Περιγραφή
return_id Id επιστροφής
return_date Ημερομηνία αιτήματος επιστροφής
return_status_name Όνομα τρέχουσας κατάστασης επιστροφής
return_status Id κατάστασης τρέχουσας επιστροφής
return_reason Αιτιολογία επιστροφής
order Id παραγγελίας
product Επιστρεφόμενο προϊόν
products_reference Όνομα προϊόντος στο συνεργάτη
products_spartoo Όνομα προϊόντος στο Spartoo
products_name Όνομα μοντέλου
products_manufacturers Όνομα της μάρκας
products_size Μέγεθος που έχει καταχωρηθεί
size_reference Αναφορά προϊόντος για το νούμερο
products_color Χρώμα προϊόντος


Παράδειγμα επιστροφής XML




Παράδειγμα απάντησης σε μια κλήση web service KO :

<root>
	<returns>
		<return>
			<return_id>EAJBCC</return_id>
			<return_date>	</return_date>
			<return_status_name><![CDATA[Σε αναμονή παραλαβής]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Πρόβλημα μεγέθους]]></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>

Παράδειγμα απάντησης σε μια κλήση web service OK :

<root>
	<returns>
		<return>
			<return_id>EEAJBCC</return_id>
			<return_date>2013-04-22 17:56:36</return_date>
			<return_status_name><![CDATA[Σε αναμονή παραλαβής]]></return_status_name>
			<return_status>2</return_status>
			<return_reason><![CDATA[Πρόβλημα μεγέθους]]></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>