Home > Webservices > Opdater en retur

Opdatering af en retur

URL til Webservices : https://sws.spartoo.dk/mp/xml_maj_returns.php

Denne webservice gør det muligt at opdatere statussen på en retur.

Hvis du vil forsyne kunden med en returetikette, har du to muligheder:
  • Returetiketten sendes fra dig: specificere begrundelsen label_link contenant le lien vers l'étiquette
  • Du ønsker at vi sender returetiketten fra vores tjeneste: specificere begrundelsen label_file contenant le fichier de l'étiquette
Når returen er afsendt, eller indenfor den overholdte tidsfrist, kan du specificere begrundelsen statut pour
  • acceptere returen (status 4)
  • afvise returen (status 3)


> Se listen over returstatusser

Liste over parametre

Parametrene i denne webservice skal sendes via POST

Parameter Beskrivelse
partenaire Skal indeholde dit unikke forhandler ID:
rID ID for returen, der skal opdateres
statut Returens nye status (3 eller 4)


Det returnerede XML-format


<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>


Liste over fejlkoder hos webservices


Kode (kategori, materiale) Beskrivelse
1 Ingen fejlparametrer
-1 Parameteren partenaire er ikke blevet registreret eller er tom
-2 Forhandlerens parametre eksisterer ikke
-5 Parameteren oID / rID eller parameteren status mangler
-6 Ordren eller returen er ikke blevet fundet, tjek parameteren oID / rID eller parameteren forhandler.
-7 Problem med returens kronologi
  • Status 4 kan kun vælges, hvis returen har status 2 eller 3
  • Status 3 kan kun vælges, hvis bestillingen har status 2
-9 Den nye status er identisk med den aktuelle status
-22 Fejl ved modtagelse af fil
-23 Ukendt fejl under modtagelse af fil
-24 Linket for etiketten er for lang
-25 Linket er identisk med det nuværende link
-428 Din konto er deaktiveret. Du kan ikke længere benytte webservices
-429 Du har overskredet brugen af denne webservice inden for den seneste time

Eksempel på retur-XML


Prøvesvar på et opkald til webservicen 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>

Prøvesvar på et opkald til webservicen 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 ?