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

Εισαγωγή προϊόντων

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

Αυτό το webservice εξυπηρετεί στο να δημιουργούνται και να ενημερώνονται τα προϊόντα στο site του Spartoo.
Για κάθε προϊόν που στέλνετε, το webservice θα στέλνει ένα κωδικό σφάλματος ο οποίος θα δείχνει εάν όλα έχουν καταχωρηθεί σωστά ή όχι. Ορισμένα σφάλματα μπορεί να προκαλέσουν αποκλεισμό (fatal), κάποια άλλα όχι (warning).

Αυτό το webservice λειτουργεί στο πνεύμα "Ενημέρωση" και όχι στο πνεύμα "Διαγραφή". Αυτό σημαίνει ότι τα προϊόντα που δεν στέλνονται με την XML δε θα διαγράφονται.
Για να αποσύρετε ένα προϊόν από το site, πρέπει να καταχωρήσετε στο stock του το 0.

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

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

Παράμετρος	Περιγραφή
συνεργάτης	Πρέπει να περιέχεται το μοναδικό id σας :
xml	Αλυσίδα χαρακτήρων XML που περιέχει τη λίστα των προϊόντων για δημιουργία ή ενημέρωση

/> Προαιρετικές παράμετροι που μπορούν να περαστούν σε POST

Παράμετρος	Περιγραφή
απαραίτητη_περιγραφή	Επιλογή σε 1 εάν θέλετε να αναγκάσετε να ενημερώσετε τις περιγραφές προϊόντων: διαγράψτε τις υπάρχουσες περιγραφές, επεξεργαστείτε την περιγραφή ενός προϊόντος με μηδενικό απόθεμα κ.λπ.
απαραίτητη_αντικατάσταση	Επιλογή σε 1 εάν θέλετε να καταργήσετε από τον κατάλογο λάθη του αποθεματικού. Προσέξτε να στείλετε τον υπόλοιπο κατάλογο χωρίς αντικατάσταση αμέσως μετά

Μορφή παραμέτρου xml

Τα πεδία κειμένου πρέπει να προστατεύονται από τα tags CDATA εάν περιέχουν ειδικούς χαρακτήρες που θα ακύρωναν την XML.

Μορφή για μία χώρα

<root>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<product_name>string</product_name>
			<manufacturers_name>string</manufacturers_name>
			<product_sex>char</product_sex>
			<product_price>float</product_price>
			<product_quantity>int</product_quantity>
			<color_id>int</color_id>
			<product_style>int</product_style>
			<product_description>string</product_description>
			<product_color>string</product_color>
			<heel_height>float</heel_height>
			<country_origin>int</country_origin>
			<code_hs>int</code_hs>
			<size_list>
				<size>
					<size_name>string</size_name>
					<size_quantity>int</size_quantity>
					<size_reference>string</size_reference>
					<ean>string</ean>
					<code_hs>int</code_hs>
					<product_price>float</product_price>
					<discount>
						<startdate>timestamp</startdate>
						<stopdate>timestamp</stopdate>
						<price_discount>float</price_discount>
						<rate>int</rate>
						<sales/>
					</discount>
				</size>
				<!-- ... Περισσότερα tags "size" δυνατά ... -->
			</size_list>
			<product_composition>int</product_composition>
			<voering_composition>int</voering_composition>
			<first_composition>int</first_composition>
			<zool_composition>int</zool_composition>
			<photos>
				<url1>url</url1>
				<url2>url</url2>
				<url3>url</url3>
				<url4>url</url4>
				<url5>url</url5>
				<url6>url</url6>
				<url7>url</url7>
				<url8>url</url8>
			</photos>
			<discount>
				<startdate>timestamp</startdate>
				<stopdate>timestamp</stopdate>
				<price_discount>float</price_discount>
				<rate>int</rate>
				<sales>0/1</sales>
			</discount>
			<extra_infos>
				<info>
					<id>int</id>
					<value>float</value>
				</info>
				<!-- ... Περισσότερα tags "info" δυνατά ... -->
			</extra_infos>
			<selections>
				<selection>int</selection>
				<!-- ... Περισσότερα tags "selection" δυνατά ... -->
			</selections>
		</product>
		<!-- ... Περισσότερα tags "product" δυνατά ... -->
	</products>
</root>

Μορφή για πολλές χώρες

<root>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<manufacturers_name>string</manufacturers_name>
			<product_sex>char</product_sex>
			<product_quantity>int</product_quantity>
			<color_id>int</color_id>
			<product_style>int</product_style>
			<heel_height>float</heel_height>
			<country_origin>int</country_origin>
			<code_hs>int</code_hs>
			<languages>
				<language>
					<code>string</code>
					<product_name>string</product_name>
					<product_description>string</product_description>
					<product_color>string</product_color>
					<product_price>float</product_price>
					<discount>
						<startdate>timestamp</startdate>
						<stopdate>timestamp</stopdate>
						<price_discount>float</price_discount>
						<rate>int</rate>
						<sales />
					</discount>
				</language>
				<!-- ... Περισσότερα tags "language" δυνατά ... -->
			</languages>
			<size_list>
				<size>
					<size_name>string</size_name>
					<size_quantity>int</size_quantity>
					<size_reference>string</size_reference>
					<ean>string</ean>
					<code_hs>int</code_hs>
					<languages>
						<language>
							<code>string</code>
							<product_price>float</product_price>
							<discount>
								<startdate>timestamp</startdate>
								<stopdate>timestamp</stopdate>
								<price_discount>float</price_discount>
								<rate>int</rate>
								<sales/>
							</discount>
						</language>
						<!-- ... Περισσότερα tags "language" δυνατά ... -->
					</languages>
				</size>
				<!-- ... Περισσότερα tags "size" δυνατά ... -->
			</size_list>
			<product_composition>int</product_composition>
			<voering_composition>int</voering_composition>
			<first_composition>int</first_composition>
			<zool_composition>int</zool_composition>
			<photos>
				<url1>url</url1>
				<url2>url</url2>
				<url3>url</url3>
				<url4>url</url4>
				<url5>url</url5>
				<url6>url</url6>
				<url7>url</url7>
				<url8>url</url8>
			</photos>
			<extra_infos>
				<info>
					<id>int</id>
					<value>float</value>
				</info>
				<!-- ... Περισσότερα tags "info" δυνατά ... -->
			</extra_infos>
			 <selections>
				<selection>int</selection>
				<!-- ... Περισσότερα tags "selection" δυνατά ... -->
			</selections>
		</product>
		<!-- ... Περισσότερα tags "product" δυνατά ... -->
	</products>
</root>

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

Tag	Περιγραφή	Υποχρεωτική
reference_partenaire	Id προϊόντος συνεργάτη. Είναι το sku που ταυτοποιεί ένα προϊόν μιας μάρκας σε ένα συγκεριμένο χρώμα Το Id προϊόντος δεν μπορεί να περιέχει παρά μόνο αλφαριθμητικούς χαρακτήρες καθώς και τους χαρακτήρες - (παύλα) _ (κάτω παύλα) και . (τελεία).	Ναι
product_name	Όνομα μοντέλου Δεν πρέπει να περιέχει την κατηγορία, το χρώμα ή τη μάρκα του προϊόντος Δεν πρέπει να περιέχει χαρακτήρες ή tags html	Όχι
manufacturers_name	Όνομα της μάρκας του προϊόντος	Ναι
product_sex	Φύλο που απευθύνεται το προϊόν > Δείτε τις πιθανές τιμές	Ναι
product_price	Τιμή του προϊόντος σε ευρώ (δεν είναι υποχρεωτικό για τις τιμές μεγέθους)	ΝαιΌχι
color_id	Χρώμα που αντιστοιχεί στα φίλτρα των μενού Εάν αυτό δεν έχει προσδιοριστεί, το προϊόν δε θα εμφανιστεί εάν ο πελάτης χρησιμοποιήσει ένα φίλτρο χρώματος > Δείτε τις δυνατές τιμές	Όχι
product_style	Κατηγορία προϊόντος >Δείτε τις δυνατές τιμές	Ναι
product_description	Περιγραφή του προϊόντος. Εμφανίζεται στη σελίδα προϊόντος.	Όχι
product_color	Ελεύθερο πεδίο κειμένου για το χρώμα. Εμφανίζεται στη σελίδα προϊόντος.	Όχι
size	Λίστα μεγεθών και το stock τους. Προαιρετικό για τα προϊόντα που δεν έχουν μεγέθη ( Τσάντες / Αξεσουάρ ). Υποχρεωτικό εάν όχι.	Ναι / Όχι
size_name	Μέγεθος >Δείτε τις δυνατές τιμές	Ναι
size_quantity	Stock προϊόντος για αυτό το μέγεθος	Ναι
size_reference	Αντιστοιχία προϊόντος με βάση το μέγεθος. Αυτό το πεδίο εξυπηρετεί αποκλειστικά στο να ενημερωθούν οι εξαγωγές των παραγγελιών ή των επιστροφών. Μια καλή πρακτική είναι να διαχειριστείτε αυτήν την πληροφορία συνδυάζοντας τα πεδία reference_partenaire και size_name με τη βοήθεια μιας κάτω παύλας "_".	Όχι
ean	EAN προϊόντος στο μέγεθος	Όχι
φωτογραφίες	Λίστα με φωτογραφίες και το url τους. Είναι υποχρεωτική τουλάχιστον μια φωτογραφία. Σας προτείνουμε να έχετε τουλάχιστον 3 φωτογραφίες. Μπορούμε να καταχωρήσουμε maximum 8 φωτογραφίες. Η φωτογραφία θα ''κατέβει'' μόνο μια φορά, στη συνέχεια θα παραμείνει στους servers μας, αφότου τις προσαρμόσουμε στις διαστάσεις του Spartoo. Οι φωτογραφίες πρέπει να είναι σε μορφή jpg, τετράγωνες και τουλάχιστον 350x350 pixels. Eάν είναι μεγαλύτερες ή ίσες με 800x800 pixels, θα υπάρξει η δυνατότητα zoom στο σάϊτ.	Ναι
url1, url2 ... url8	Links για τις φωτογραφίες Πρέπει να μας δώσετε ένα link για κάθε φωτογραφία. Το όνομα του αρχείου πρέπει να περιλαμβάνει αποκλειστικά χαρακτήρες με γράμματα και νούμερα καθώς και με χαρακτήρες "-" (παύλα), "_" (κάτω παύλα) και"." (τελεία). Τα κενά, τα γράμματα με τόνους (π.χ έ, ά και ή) δεν επιτρέπονται.	Ναι
heel_height	Ύψος τακουνιού σε εκατοστά (cm). Αποκλειστικά για τα γυναικεία παπούτσια. Πρέπει να είναι πολλαπλάσιο του 0,5.	No
product_composition	Σύνθεση στελέχους του προϊόντος. Αποκλειστικά για τα παπούτσια > Δείτε τις δυνατές τιμές	Όχι
voering_composition	Σύνθεση της επένδυσης του προϊόντος. Αποκλειστικά για τα παπούτσια. > Δείτε τις δυνατές τιμές	Όχι
first_composition	Σύνθεση της εσωτερικής σόλας του προϊόντος. Αποκλειστικά για τα παπούτσια > Δείτε τις δυνατές τιμές	Όχι
zool_composition	Σύνθεση της εσωτερικής σόλας του προϊόντος. Αποκλειστικά για τα παπούτσια > Δείτε τις δυνατές τιμές	Όχι
discount	Επιτρέπει να τοποθετήσετε προσφορά στο προϊόν. Το πεδίο rate στο πεδίο discount αφορά το ποσοστό μείωσης της τιμής αναφορικά με το πεδίο product_price. Το πεδίο price_discount στο πεδίο discount αφορά τη μείωση σε καθορισμένη τιμή. Το ποσοστό της έκπτωσης που εμφανίζεται θα έχει υπολογιστεί. Εάν έχουν συμπληρωθεί και τα δύο πεδία, το πεδίο price_discount προηγείται του πεδίου rate. Εάν η προσφορά είναι άμεση, δεν χρειάζεται να προσδιορίσετε το πεδίο startdate. Εάν το tag sales έχει καθοριστεί, η προσφορά θα είναι προσφορά εκπτώσεων. Εάν όχι, θα είναι μια κλασική προσφορά. Η χρήση αυτής της παραμέτρου επιτρέπει στα προϊόντα να παρουσιάζονται στην σελίδα των εκπτώσεων κατά τη διάρκεια των εκπτώσεων.	Όχι
extra_infos	Επιτρέπει την εφαρμογή μιας προώθησης στο προϊόν ή σε ένα μέγεθος. Κάθε πληροφορία αποτελείται από ένα id ( > Δείτε τις τιμές ) και μια ψηφιακή τιμή.	Όχι
selections	Επιτρέπει να προσδιοριστούν τα πλαίσια χρήσεων ενός προϊόντος, μέσω μίας λίστα με τα id. Το σύνολο του διαθέσιμου πλαισίου βρίσκεται εδώ.	Όχι

Παράδειγμα παραμέτρου xml

<root>
	<products>
		<product>
			<reference_partenaire>98</reference_partenaire>
			<product_name><![CDATA[ALL STAR HI]]></product_name>
			<manufacturers_name><![CDATA[Converse]]></manufacturers_name>
			<product_sex>M</product_sex>
			<product_price>64.99</product_price>
			<product_quantity>5</product_quantity>
			<color_id>8</color_id>
			<product_style>10010</product_style>
			<product_description><![CDATA[Μυθικό ανάμεσα στα μυθικά, το Chuck Taylor All Star της Converse είναι ακαταμάχητο. 
Εδώ βλέπουμε μια έκδοση με ψηλό, υφασμάτινο, μονόχρωμο, κλασσικό στέλεχος, που είναι πάντα στη μόδα και διαχρονικό ! 
]]></product_description>
			<product_color><![CDATA[ Κόκκινο]]></product_color>
			<country_origin>73</country_origin>
			<code_hs>64059090</code_hs>
			<size_list>
			 <size>
				<size_name>38</size_name>
				<size_quantity>4</size_quantity>
				<size_reference>98_38</size_reference>
				<ean>123456789011></ean>
			 </size>
			 <size>
				<size_name>39</size_name>
				<size_quantity>1</size_quantity>
				<size_reference>98_39</size_reference>
				<ean>123456789012></ean>
			 </size>
			</size_list>
			<product_composition>4</product_composition>
			<photos>
				<url1>https://imgext.spartoo.com/photos/98/98/98_350_A.jpg</url1>
				<url2>https://imgext.spartoo.com/photos/98/98/98_350_B.jpg</url2>
				<url3>https://imgext.spartoo.com/photos/98/98/98_350_C.jpg</url3>
				<url4>https://imgext.spartoo.com/photos/98/98/98_350_D.jpg</url4>
				<url5>https://imgext.spartoo.com/photos/98/98/98_350_E.jpg</url5>
				<url6>https://imgext.spartoo.com/photos/98/98/98_350_F.jpg</url6>
				<url7>https://imgext.spartoo.com/photos/98/98/98_350_G.jpg</url7>
				<url8>https://imgext.spartoo.com/photos/98/98/98_350_H.jpg</url8>
			</photos>
			<discount>
				<startdate>1199170800</startdate>
				<stopdate>1204354800</stopdate>
				<rate>20</rate>
			</discount>
		</product>
	</products>
</root>

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

<root>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<status>string</status>
			<action>string</action>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
					<level>string</level>
				</error>
				<!-- ... Περισσότερα tags "error" δυνατά ... -->
			</errors>
		</product>
		<!-- ... Περισσότερα tags "product" δυνατά ... -->
	</products>
	<errors>int</errors>
</root>

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

Κωδικός	Περιγραφή
1	Δεν υπάρχει σφάλμα στις παραμέτρους
-1	Η παράμετρος partenaire δεν καταχωρήθηκε ως παράμετρος ή είναι κενή
-2	Η παράμετρος partenaire δεν υπάρχει
-11	Η παράμετρος xml δεν καταχωρήθηκε ως παράμετρος ή είναι κενή
-15	Σφάλμα σύνταξης XML, ελέγξτε το αρχείο XML
-428	Ο λογαριασμός σας έχει απενεργοποιηθεί. Δεν μπορείτε πλέον να πραγματοποιείτε κλήσεις στις υπηρεσίες web
-429	Έχετε κάνει πάρα πολλές κλήσεις προς αυτήν την υπηρεσία web, για την τρέχουσα ώρα

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

Tag	Περιγραφή
reference_partenaire	Id προϊόντος συνεργάτη
status	OK αν το προϊόν έχει εισαχθεί στη βάση δεδομένων KO αν το προϊόν δε μπόρεσε να εισαχθεί
action	Λίστα πιθανών ενεργειών : created : το προϊόν δημιουργήθηκε. not created : το προϊόν δε δημιουργήθηκε. Σημείωση : ένα προϊόν μπορεί να έχει status 'OK' αλλά να μην έχει δημιουργηθεί μετά από ορισμένα 'Warning'. updated : το προϊόν ενημερώθηκε. not updated : το προϊόν δεν ενημερώθηκε. Σημείωση : ένα προϊόν μπορεί να έχει status 'OK' αλλά να μην έχει ενημερωθεί μετά από ορισμένα 'Warning'.
errors	Λίστα σφαλμάτων επεξεργασίας : id : κωδικός σφάλματος προϊόντος level : επίπεδο σφάλματος Warning : δεν εμποδίζεται η ενσωμάτωση του προϊόντος Fatal : μπλοκάρισμα ενσωμάτωσης προϊόντος περιγραφή : γραπτή περιγραφή σφάλματος

Λίστες κωδικών σφαλμάτων προϊόντων

Κωδικός	Επίπεδο	Περιγραφή
1	Fatal	Το όνομα του συνεργάτη δεν είναι αρκετά μεγάλο
2	Fatal	Το όνομα του συνεργάτη δεν είναι έγκυρο, θα πρέπει να περιέχει μόνο αλφαριθμητικούς χαρακτήρες
3	Warning	Το όνομα του προϊόντος δεν έχει οριστεί
4	Fatal	Η μάρκα δεν έχει οριστεί
5	Fatal	Το είδος δεν είναι έγκυρο, τα μόνα έγκυρα στοιχεία είναι : H, F, M, B
6	Fatal	Η τιμή θα πρέπει να είναι αριθμός
7	Fatal	Η τιμή πρέπει να είναι θετική
8	Warning	Η τιμή είναι πολύ υψηλή
81	Fatal	Η τιμή δεν μπορεί να είναι υψηλότερη από 180€
9	Fatal	Η ποσότητα πρέπει να είναι ακέραιος αριθμός
10	Fatal	Η ποσότητα πρέπει να είναι θετική
11	Warning	Το χρώμα xxx δεν υπάρχει : το προϊόν δεν θα είναι διαθέσιμο μέσω των φίλτρων χρώματος
13	Fatal	Η κατηγορία xxx δεν υπάρχει
14	Warning	Η περιγραφή του προϊόντος είναι κενή
15	Warning	Το χρώμα εμφάνισης είναι κενό
16	Warning	Δεν υπάρχει λίστα μεγεθών : χρήση του μεγέθους unique
17	Warning	Η σύνθεση έχει οριστεί, αλλά δεν είναι έγκυρη
18	Fatal	Η φωτογραφία 1 είναι υποχρεωτική
19	Warning	Το ποσοστό της έκπτωσης θα πρέπει να είναι ανάμεσα στο 0 και 100, διαφορετικά δεν θα καταχωρηθεί η έκπτωση
20	Warning	Το μέγεθος xxx δεν υπάρχει
201	Fatal	Ο κωδικός EAN είναι υποχρεωτικός
202	Fatal	Ο κωδικός EAN xxx στην αναφορά xxx στο μέγεθος xxx χρησιμοποιείται ήδη.
205	Fatal	Αναφορά συνεργάτη πολύ μεγάλη
23	Warning	Η φωτογραφία xxx είναι πιο μικρή από 350x350 : η ποιότητά της θα είναι κακή στο site
24	Warning	Η φωτογραφία xxx είναι πιο μικρή από 350x350 : δεν θα αναρτηθεί στο site
25	Fatal	Μέγεθος xxx : Αδύνατο να ρυθμιστεί το stock
26	Fatal	Κανένα απόθεμα : το προϊόν δεν θα δημιουργηθεί
27	Fatal	Αδύνατο να ανοίξουμε το αρχείο της φωτογραφίας photo 1 ( url xxx )
28	Warning	Αδύνατο να ανοίξουμε το αρχείο της φωτογραφίας xxx ( url xxx )
30	Fatal	Η ποσότητα του μεγέθους xxx είναι πολύ μεγάλη (Μέγιστη ποσότητα : xxx)
33	Fatal	Ένα προϊόν του είδους xxx δεν μπορεί να ανήκει στην κατηγορία xxx
34	Fatal	Η λέξη xxx είναι στην μαύρη λίστα και δεν μπορεί να χρησιμοποιηθεί στον τίτλο του προιόντος.
35	Fatal	Το όνομα του προϊόντος είναι πολύ μεγάλο, θα πρέπει να περιέχει μόνο το όνομα του μοντέλου. Σφάλμα(-τα) χώρας(-ών): xxx
341	Fatal	Η λέξη xxx είναι στην μαύρη λίστα και δεν μπορεί να χρησιμοποιηθεί στον τίτλο του προιόντος.
36	Fatal	Αδύνατη η εισαγωγή του προϊόντος : το προϊόν υπάρχει ήδη στο μέγεθος/χρώμα.
37	Fatal	Αυτό το προϊόν δεν περιέχει καμία πληροφορία γλώσσας για έναν ενεργό ιστότοπο.
38	Fatal	Το μέγεθος xxx μπορεί να οριστεί μόνο μία φορά για την αναφορά xxx
39	Warning	Η αναφορά συνεργάτη υπάρχει πολλές φορές στη ροή, τα διπλότυπα έχουν αγνοηθεί
451	Fatal	Δεν υπάρχει τιμή για το μέγεθος xxx στη χώρα xxx. (απαιτείται για έκπτωση)
452	Warning	Υπέρβαση της ημερομηνίας λήξης της έκπτωσης για το μέγεθος xxx της χώρας xxx.
453	Fatal	"Σφάλμα" (xxx) άκυρο για το μέγεθος xxx της χώρας xxx.
454	Fatal	"Σφάλμα" (xxx) > 85% για το μέγεθος xxx της χώρας xxx.
455	Warning	Το μέγεθος xxx σε μια τιμή χώρας (xxx) δεν ορίζεται για το προϊόν.
456	Warning	Το μέγεθος xxx της τιμής xxx είναι πανομοιότυπη με τη συνολική τιμή σε αυτή τη χώρα.

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

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

<root>
	<products></products>
	<errors>-1</errors>
</root>

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

<root>
	<products>
		<product>
		<reference_partenaire>EEAJBCC</reference_partenaire>
		<status>KO</status>
		<action>not created</action>
		<errors>
			<error>
				<id>14</id>
				<description>Η περιγραφή του προϊόντος είναι κενή</description>
				<level>warning</level>
			</error>
			<error>
				<id>4</id>
				<description>Η μάρκα δεν έχει οριστεί</description>
				<level>fatal</level>
			</error>
		</errors>
		</product>
		<product>
			<reference_partenaire>KJHGFDS</reference_partenaire>
			<status>OK</status>
			<action>created</action>
		</product>
	</products>
	<errors>1</errors>
</root>

Παράδειγμα αρχείου XSD

Παράδειγμα αρχείου XSD Multi pays