Αρχική σελίδα > Webservices > Ενημέρωση μιας επιστροφής

Ενημέρωση μιας επιστροφής

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

Αυτό το webservice εξυπηρετεί στο να ενημερώνεται το status μιας επιστροφής.

Εάν πρέπει να αποστείλετε μια ετικέτα επιστροφής στον πελάτη, δύο μέθοδοι είναι διαθέσιμες :

Η ετικέτα βρίσκεται στο λογαριασμό σας : καθορίστε το σημείο label_link που περιέχει το σύνδεσμο με την ετικέτα
Επιθυμείτε η ετικέτα να παραμείνει στους διακομιστές μας : καθορίστε το σημείο label_file που περιέχει το αρχείο της ετικέτας

Μόλις αποσταλεί η επιστροφή μία φορά, ή εάν παρέλθει ο προκαθορισμένος χρόνος, μπορείτε να καθορίσετε το σημείο κατάσταση για

να δεχτείτε την επιστροφή ( status 4 )
ή να αρνηθείτε την επιστροφή ( status 3 )

> Δείτε τη λίστα με την κατάσταση των επιστροφών

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

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

Παράμετρος	Περιγραφή
συνεργάτης	Πρέπει να περιέχει το μοναδικό id σας :
rID	Το Id της επιστροφής πρέπει να ενημερωθεί
statut	(προαιρετικό) Νέο status επιστροφής ( 3 ή 4 )
label_link	(προαιρετικό) Σύνδεσμος για την ετικέτα επιστροφής
label_file	(προαιρετικό) Αρχείο ετικέτας επιστροφής

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

<root>
	<returns>
		<return>
			<partenaire>string</partenaire>
			<rID>int</rID>
			<label_link>url</label_link>
			<label_file>url</label_file>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
				</error>
			</errors>
		<return>
	</returns>
	<statut>
		<id>int</id>
		<description>string</description>
	</statut>
</root>

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

Κωδικός	Περιγραφή
1	Δεν υπάρχει σφάλμα στις παραμέτρους
-1	Η παράμετρος partenaire δεν καταχωρήθηκε ως παράμετρος ή είναι κενή
-2	Η παράμετρος partenaire δεν υπάρχει
-5	Λείπει η παράμετρος rID/oID ή η παράμετρος status
-6	Η παραγγελία ή η επιστροφή δεν βρέθηκαν, ελέγξτε την παράμετρο oID / rID ή την παράμετρο συνεργάτη.
-7	Πρόβλημα στο χρόνο επιστροφής Το status 4 ισχύει μόνο αν η επιστροφή βρίσκεται σε status 2 ή 3 Το status 3 ισχύει μόνο αν η επιστροφή βρίσκεται σε status 2
-9	Το νέο status είναι ίδιο με το παρόν status
-22	Σφάλμα κατά τη λήψη του αρχείου
-23	Άγνωστο σφάλμα κατά τη λήψη του αρχείου
-24	Ο σύνδεσμος της ετικέτας είναι πολύ μεγάλος
-25	Ο παρεχόμενος σύνδεσμος είναι ταυτόσημος με τον παρόντα σύνδεσμο
-428	Ο λογαριασμός σας έχει απενεργοποιηθεί. Δεν μπορείτε πλέον να πραγματοποιείτε κλήσεις στις υπηρεσίες web
-429	Έχετε κάνει πάρα πολλές κλήσεις προς αυτήν την υπηρεσία web, για την τρέχουσα ώρα

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

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

<root>
	<returns>
		<return>
			<partenaire>1EC51BF31B486658</partenaire>
			<rID>	</rID>
			<label_link>http://www.spartoo.fr/pj.php?file_id_crypt=...</label_link>
			<errors>
				<error>
					<id>-6</id>
					<description>
						La commande ou le retour n’ont pas été trouvés, vérifiez le paramètre oID / rID ou le paramètre partenaire.
					</description>
				</error>
			</errors>
		</return>
	</returns>
	<statut>
		<id>6</id>
		<description>retour refusé</description>
	</statut>
</root>

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

<root>
	<returns>
		<return>
			<partenaire>1EC51BF31B486658</partenaire>
			<rID>8883777</rID>
			<label_link>http://www.spartoo.fr/pj.php?file_id_crypt=...</label_link>
			<errors>
				<error>
					<id>1</id>
					<description>Pas d'erreur de paramètres</description>
				</error>
			</errors>
		</return>
	</returns>
	<statut>
		<id>4</id>
		<description>retour accepté</description>
	</statut>
</root>