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>