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

Ανανέωση στοκ των προϊόντων

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

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

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

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

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

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

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


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


Τα πεδία κειμένου πρέπει να προστατεύονται από τα tags CDATA εάν περιέχουν ειδικούς χαρακτήρες που θα ακύρωναν την XML. 
<catalogue>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
					<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>
					<!-- ... Περισσότερα tags "languages" δυνατά ... -->
				</size>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
				</size>
			</size_list>
		</product>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
				</size>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
				</size>
			</size_list>
		</product>
	</products>
</catalogue>


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


Balise Περιγραφή Υποχρεωτικό
reference_partenaire Αναγνωριστικό προϊόντος του συνεργάτη. Είναι ο κωδικός που αναγνωρίζει ένα προϊόν μάρκας σε ένα συγκεκριμένο χρώμα
Το αναγνωριστικό προϊόντος μπορεί να περιέχει μόνο αλφαριθμητικούς χαρακτήρες καθώς και τους χαρακτήρες - (παύλα) _ (κάτω παύλα) και . (τελεία). 		Ναι
product_quantity Συνολικό απόθεμα ενός προϊόντος
Αγνοήστε αν ένα ή πολλά tag size_quantity αναγνωριστούν για το προϊόν.
Για τα προϊόντα που έχουν ένα μέγεθος χρειάζεται ένα tag product_quantity εάν το tag size_quantity δεν έχει ενημερωθεί. 		Όχι
μέγεθος Λίστα μεγεθών και το απόθεμά τους
Προαιρετικό για τα προϊόντα χωρίς μέγεθος ( Τσάντες / Αξεσουάρ ). Διαφορετικά, υποχρεωτικό. 		Ναι / Όχι
size_quantity Για κάθε μέγεθος πρέπει να προσδιορίζεται το απόθεμα
Για να απενεργοποιήστε ένα προϊόν, πρέπει να βάλετε το απόθεμα (στοκ) στο 0.
Όταν το στοκ είναι στο 0, το προϊόν απενεργοποιείται και δεν εμφανίζεται πλέον στο Spartoo. 		Ναι
size_reference Κωδικός προϊόντος στο μέγεθος. Ναι
product_price Τιμή για το μέγεθος Όχι
discount Σας επιτρέπει να εφαρμόσετε μια προσφορά στο προϊόν.
Le champ rate du champ discount αφορά τη μείωση της τιμής ως ποσοστό του πεδίου product_price.
Le champ price_discount du champ discount αφορά την μειωμένη τιμή του προϊόντος. Το ποσοστό έκπτωσης που εμφανίζεται υπολογίζεται.
Εάν υπάρχουν και τα δύο πεδία, το πεδίο price_discount έχει προτεραιότητα έναντι του πεδίου rate.
Εάν η έκπτωση είναι άμεση, δεν χρειάζεται να καθορίσετε το πεδίο startdate. Εάν το πεδίο stopdate δεν καθορίζεται, η προεπιλεγμένη διάρκεια της προσφοράς θα είναι ένας μήνας. Εάν η baliseπωλήσεις καθορίζεται, η προσφορά θα είναι προσφορά πώλησης. Διαφορετικά, θα είναι μια κλασική προσφορά. Ο καθορισμός αυτής της παραμέτρου επιτρέπει την εμφάνιση προϊόντων στη σελίδα πωλήσεων κατά τη διάρκεια περιόδων πωλήσεων.		 Non


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

<catalogue>
	<products>
		<product>
			<reference_partenaire>98</reference_partenaire>
			<size_list>
				<size>
					<size_reference>98_38</size_reference>
					<size_quantity>5</size_quantity>
					<languages>
						<language>
							<code>FR</code>
							<product_price>100.00</product_price>
							<discount>
								<startdate>1199170800</startdate>
								<stopdate>1204354800</stopdate>
								<price_discount>90.00</price_discount>
								<rate>10</rate>
								<sales/>
							</discount>
						</language>
						<!-- ... Περισσότερα tags "language" δυνατά ... -->
					</languages>
					<!-- ... Περισσότερα tags "languages" δυνατά ... -->
				</size>
				<size>
					<size_reference>98_39</size_reference>
					<size_quantity>7</size_quantity>
				</size>
			</size_list>
		</product>
		<product>
			<reference_partenaire>158_tailor</reference_partenaire>
			<size_list>
				<size>
					<size_reference>158_37</size_reference>
					<size_quantity>2</size_quantity>
				</size>
				<size>
					<size_reference>158_36</size_reference>
					<size_quantity>0</size_quantity>
				</size>
			</size_list>
		</product>
	</products>
</catalogue>

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


<catalogue>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<errors>int</errors>
				</size>
			</size_list>
		</product>
		<!-- ... Περισσότερα tags "product" δυνατά ... -->
	</products>
</catalogue>


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


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



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


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

<catalogue>
	<products></products>
	<errors>-1</errors>
</catalogue>

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

<catalogue>
	<products>
		<product>
			<reference_partenaire>EEAJBCC</reference_partenaire>
			<size_list>
				<size>
					<size_reference>EEAJBCC_38</size_reference>
					<errors>1</errors>
				</size>
			</size_list>
		</product>
		<product>
			<reference_partenaire>KJHGFDS</reference_partenaire>
			<size_list>
				<size>
					<size_reference></size_reference>
					<errors>-13</errors>
				</size>
			</size_list>
		</product>
	</products>
</catalogue>