Αρχική σελίδα > 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>

💡 Conseils d'intégration pour les étiquettes de retour

  • label_link : L'URL fournie pour l'étiquette de retour ne doit pas dépasser 255 caractères (limite stricte de l'API). Si vous utilisez des paramètres d'URL ou d'authentification longs, veuillez raccourcir le lien au préalable.
  • label_file : Si vous soumettez directement le fichier de l'étiquette, vous devez transmettre le contenu binaire brut (raw binary content) du fichier (et non une chaîne encodée en Base64). Les formats acceptés sont le PDF (.pdf) et les formats d'images (.jpg, .jpeg, .png, .gif) pour une taille maximale de 10 Mo.



Saitoo - Assistant (mp)
Bonjour ! Comment puis-je vous aider aujourd'hui ?