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

Εξαγωγή παραγγελιών

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

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

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

Οι παράμετροι αυτού του webservice πρέπει υποχρεωτικά να περαστούν σε POST

Παράμετρος	Περιγραφή
partenaire	Πρέπει να περιέχεται το μοναδικό id σας :
date	Ημερομηνία από την οποία επιθυμούμε να επιλέξουμε παραγγελίες. Μορφή : AAAA-MM-JJ:hh:mm:ss (παράδειγμα : 2011-11-27:03:00:00)
oID	Id παραγγελίας
statut	Status παραγγελιών προς επιλογή. Εάν η παράμετρος δεν έχει συμπληρωθεί, θα επιλεγούν όλες οι παραγγελίες. > Δείτε την λίστα των statuts

Η παράμετρος του συνεργάτη είναι υποχρεωτική και μια από τις δύο παραμέτρους date ή oID είναι υποχρεωτική. Η παράμετρος statut είναι προαιρετική.

Μορφή XML που επιστρέφεται

<root>
	<orders>
		<order>
			<orders_id>string</orders_id>
			<customers>
				<customers_firstname>string</customers_firstname>
				<customers_lastname>string</customers_lastname>
				<customers_company>string</customers_company>
				<customers_street_address>string</customers_street_address>
				<customers_suburb>string</customers_suburb>
				<customers_city>string</customers_city>
				<customers_postcode>string</customers_postcode>
				<customers_state>string</customers_state>
				<customers_country>string</customers_country>
				<customers_email_address>string</customers_email_address>
				<customers_telephone>string</customers_telephone>
			</customers>
			<delivery>
				<delivery_firstname>string</delivery_firstname>
				<delivery_lastname>string</delivery_lastname>
				<!-- ... Η ετικέτα "relay_info" αφορά μόνο παραγγελίες που θα παραδοθούν μέσω κάποιου σημείου διανομής. ... -->
				<relay_info>
					<relay_id>int</relay_id>
					<relay_type>string</relay_type>
					<relay_name>string</relay_name>
					<relay_address>string</relay_address>
					<relay_city>string</relay_city>
					<relay_postcode>string</relay_postcode>
					<relay_country_iso>string</relay_country_iso>
				</relay_info>
				<!-- ... Οι παρακάτω ετικέτες "delivery_*" ισχύουν μόνο για παραγγελίες που πρόκειται να παραδοθούν εκτός σημείου διανομής. ... -->
				<delivery_company>string</delivery_companyy>
				<delivery_suburb>string</delivery_suburb>
				<delivery_street_address>string</delivery_street_address>
				<delivery_city>string</delivery_city>
				<delivery_postcode>string</delivery_postcode>
				<delivery_state>string</delivery_state>
				<delivery_country>string</delivery_country>
			</delivery>
			<payment_method>string</payment_method>
			<payment_price>float</payment_price>
			<shipping_price>float</shipping_price>
			<shipping_name>string</shipping_name>
			<order_total>float</order_total>
			<orders_status_name>string</orders_status_name>
			<orders_status_id>int</orders_status_id>
			<date_purchased>[DATE]</date_purchased>
			<last_modified>[DATE]</last_modified>
			<products>
				<product>
					<products_reference>string</products_reference>
					<products_name>string</products_name>
					<products_qty>int</products_qty>
					<products_spartoo>int</products_spartoo>
					<products_manufacturers>string</products_manufacturers>
					<products_size>string</products_size>
					<products_size_reference>string</products_size_reference>
					<products_color>string</products_color>
					<products_price_unit>float</products_price_unit>
					<products_price_unit_with_reduce>float</products_price_unit_with_reduce>
					<products_final_price>float</products_final_price>
				</product>
				<!-- ... Περισσότερα tags "product" δυνατά ... -->
			</products>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
				</error>
			</errors>
		</order>
		<!-- ... Περισσότερα tags "order" δυνατά ... -->
	</orders>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>

Κατηγορίες ετικετών

Εάν μια παραγγελία αποσταλεί μέσω ενός σημείου διανομής, προσθέστε την ετικέτα relay_info και διαγράψτε τις ετικέτες delivery_* , εκτός του ονοματεπώνυμου.
Εάν πρόκειται για παραγγελία που δεν αφορά κέντρο διανομής , διαγραφή της ετικέτας relay_info και τοποθέτηση των ετικετών delivery_*.

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

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

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

Ετικέτα	Περιγραφή
orders_id	Id παραγγελίας
customers	Πληροφορίες πελάτη για την απόδειξη
delivery	Πληροφορίες πελάτη για την αποστολή
customers_firstname / delivery_firstname	Όνομα πελάτη
customers_lastname / delivery_lastname	Επίθετο πελάτη
customers_company / delivery_company	Όνομα εταιρίας
customers_street_address / delivery_street_address	Διεύθυνση πελάτη
customers_suburb / delivery_suburb	Συμπλήρωμα διεύθυνσης πελάτη
customers_city / delivery_city	Πόλη πελάτη
customers_postcode / delivery_postcode	Ταχυδρομικός κώδικας πελάτη
customers_country / delivery_country	Χώρα πελάτη
customers_telephone	Τηλέφωνο πελάτη
relay_info	Πληροφορίες για το σημείο παραλαβής
relay_id	Id σημείου παραλαβής
relay_type	Τύπος σημείου παραλαβής
relay_name	Όνομα σημείου παραλαβής
relay_address	Διεύθυνση σημείου παραλαβής
relay_city	Πόλη σημείου παραλαβής
relay_postcode	Ταχυδρομικός κώδικας σημείου παραλαβής
relay_country	Χώρα σημείου παραλαβής
payment_method	Τρόπος πληρωμής
payment_price	κόστος πληρωμής ( συνήθως, πάντα 0 )
order_total	Σύνολο της παραγγελίας
orders_status_name	Όνομα της κατάστασης της τρέχουσας παραγγελίας
orders_status_id	Id της κατάστασης της τρέχουσας παραγγελίας
date_purchased	Ημερομηνία της παραγγελίας
last_modified	Ημερομηνία της τελευταίας τροποποίησης της παραγγελίας
products	Λίστα των προϊόντων
products_reference	Όνομα του προϊόντος στον συνεργάτη
products_spartoo	Όνομα του προϊόντος στο Spartoo
products_name	Όνομα του μοντέλου
products_qty	Ποσότητα στην παραγγελία
products_manufacturers	Όνομα της μάρκας
products_size	Μέγεθος στην παραγγελία
products_color	Χρώμα προϊόντος
products_price_unit	Τιμή προϊόντος
products_price_unit_with_reduce	Τιμή με την έκπτωση
products_final_price	products_price_unit_with_reduce x products_qty

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

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

<root>
	<orders>
		<order>
			<orders_id>90D813EA1A2365A8</orders_id>
			<customers>	</customers>
			<delivery>
				<delivery_firstname><![CDATA[Robert]]></delivery_firstname>
				<delivery_lastname><![CDATA[Durand]]></delivery_lastname>
				<relay_info>
					<relay_id>1505</relay_id>
					<relay_type><![CDATA[kiala]]></relay_type>
					<relay_name><![CDATA[(NP)LE PAPYRUS]]></relay_name>
					<relay_address><![CDATA[Boulevard Gambetta]]></relay_address>
					<relay_city><![CDATA[Grenoble]]></relay_city>
					<relay_postcode><![CDATA[38000]]></relay_postcode>
					<relay_country_iso><![CDATA[FR]]></relay_country_iso>
				</relay_info>
				<delivery_company><![CDATA[Spartoo]]></delivery_company>
				<delivery_suburb><![CDATA[16 rue Henri Barbusse]]></delivery_suburb>
				<delivery_street_address><![CDATA[16 rue Henri Barbusse]]></delivery_street_address>
				<delivery_city><![CDATA[Grenoble]]></delivery_city>
				<delivery_postcode><![CDATA[38100]]></delivery_postcode>
				<delivery_state></delivery_state>
				<delivery_country><![CDATA[France]]></delivery_country>
			</delivery>
			<payment_method><![CDATA[Paiement par carte bancaire]]></payment_method>
			<payment_price>0</payment_price>
			<order_total>120.0000</order_total>
			<orders_status_name><![CDATA[Commande Vérifiée]]></orders_status_name>
			<orders_status_id>11</orders_status_id>
			<date_purchased>2013-02-12 14:00:00</date_purchased>
			<last_modified>2013-02-12 14:00:00</last_modified>
			<products>
				<product>
					<products_reference><![CDATA[ABCD]]></products_reference>
					<products_name><![CDATA[ALL STAR HI]]></products_name>
					<products_qty>2</products_qty>
					<products_spartoo>123456</products_spartoo>
					<products_manufacturers><![CDATA[Converse]]></products_manufacturers>
					<products_size>42</products_size>
					<products_size_reference><![CDATA[AAAAAA]]></products_size_reference>
					<products_color><![CDATA[Blanc]]></products_color>
					<products_price_unit>60.00</products_price_unit>
					<products_price_unit_with_reduce>200.00</products_price_unit_with_reduce>
					<products_final_price>120.00</products_final_price>
				</product>
			</products>
			<errors>
				<error>
					<id>-1</id>
					<description>Le paramètre partenaire n'est passé ou est vide</description>
				</error>
			</errors>
		</order>
	</orders>
	<statut>
		<id>41</id>
		<description>Annulation commande</description>
	</statut>
</root>

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

<root>
	<orders>
		<order>
			<orders_id>90D813EA1A2365A8</orders_id>
			<customers>
				<customers_firstname><![CDATA[Robert]]></customers_firstname>
				<customers_lastname><![CDATA[Durand]]></customers_lastname>
				<customers_company><![CDATA[Spartoo]]></customers_company>
				<customers_street_address><![CDATA[16 rue Henri Barbusse]]></customers_street_address>
				<customers_suburb><![CDATA[2eme Etage]]></customers_suburb>
				<customers_city><![CDATA[Grenoble]]></customers_city>
				<customers_postcode><![CDATA[38100]]></customers_postcode>
				<customers_state></customers_state>
				<customers_country><![CDATA[France]]></customers_country>
				<customers_telephone><![CDATA[0612345678]]></customers_telephone>
			</customers>
			<delivery>
				<delivery_firstname><![CDATA[Robert]]></delivery_firstname>
				<delivery_lastname><![CDATA[Durand]]></delivery_lastname>
				<relay_info>
					<relay_id>1505</relay_id>
					<relay_type><![CDATA[kiala]]></relay_type>
					<relay_name><![CDATA[(NP)LE PAPYRUS]]></relay_name>
					<relay_address><![CDATA[Boulevard Gambetta]]></relay_address>
					<relay_city><![CDATA[Grenoble]]></relay_city>
					<relay_postcode><![CDATA[38000]]></relay_postcode>
					<relay_country_iso><![CDATA[FR]]></relay_country_iso>
				</relay_info>
				<delivery_company><![CDATA[Spartoo]]></delivery_company>
				<delivery_suburb><![CDATA[16 rue Henri Barbusse]]></delivery_suburb>
				<delivery_street_address><![CDATA[16 rue Henri Barbusse]]> </delivery_street_address>
				<delivery_city><![CDATA[Grenoble]]></delivery_city>
				<delivery_postcode><![CDATA[38100]]></delivery_postcode>
				<delivery_state></delivery_state>
				<delivery_country><![CDATA[France]]></delivery_country>
			</delivery>
			<payment_method><![CDATA[Paiement par carte bancaire]]></payment_method>
			<payment_price>0</payment_price>
			<order_total>120.0000</order_total>
			<orders_status_name><![CDATA[Commande Vérifiée]]></orders_status_name>
			<orders_status_id>11<orders_status_id>
			<date_purchased>2013-02-12 14:00:00</date_purchased>
			<last_modified>2013-02-12 14:00:00</last_modified>
			<products>
				<product>
					<products_reference>ABCD</products_reference>
					<products_name><![CDATA[ALL STAR HI]]></products_name>
					<products_qty>2</products_qty>
					<products_spartoo>123456</products_spartoo>
					<products_manufacturers><![CDATA[Converse]]></products_manufacturers>
					<products_size>42></products_size>
					<products_size_reference><![CDATA[AAAAAA]]></products_size_reference>
					<products_color><![CDATA[Blanc]]></products_color>
					<products_price_unit>60.00</products_price_unit>
					<products_price_unit_with_reduce>200.00</products_price_unit_with_reduce>
					<products_final_price>120.00</products_final_price>
				</product>
			</products>
			<errors>
				<error>
					<id>1</id>
					<description>Pas d'erreur de paramètres</description>
				</error>
			</errors>
		</order>
	</orders>
	<statut>
		<id>11</id>
		<description>Commande vérifiée</description>
	</statut>
</root>