Recepție > Webservices > Actualizare returnare

Actualizarea unei returnări

Adresa URL a serviciului Webservice : https://sws.spartoo.ro/mp/xml_maj_returns.php

Acest serviciu web este utilizat pentru a actualiza o returnare.

Dacă trebuie să furnizați clientului o etichetă de returnare, există două metode disponibile:
  • Sunteți în posesia etichetei : precizați argumentul label_link include link-ul către etichetă
  • Doriți să găzduim eticheta pe serverele noastre : precizați argumentul label_file care conține fișierul cu etichete
Odată ce returnarea a fost expediată sau limita de timp, puteți specifica argumentul statut pentru
  • pentru acceptarea returnării ( statutul 4 )
  • pentru refuzul returnării ( statutul 3 )


>Consultați lista statuturilor de returnare

Lista parametrilor

Parametrii acestui serviciu web trebuie trecuți la POST

Parametru Descriere
partener Trebuie să conțină identificatorul unic :
rID ID-ul returnare pentru a actualiza
statut (opțional) Noul statut de returnare ( 3 sau 4 )
label_link (opțional) Link către eticheta de retur
label_file (opțional) Fișierul etichetă de returnare


Formatul XML returnat


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


Lista codurilor de eroare ale serviciului web


Cod Descriere
1 Nici o eroare de parametru
-1 Parametrul partenaire nu este trecut în parametru sau este gol
-2 Parametrul partenerului nu există
-5 Lipsește parametrul rID / oID sau parametrul statut
-6 Comanda sau returnarea nu a fost găsită, verificați parametrul oID / rID sau parametrul partener.
-7 Problemă în cronologia returnării
  • Statutul 4 se aplică numai dacă returnarea se află în statutul 2 sau 3
  • Statutul 3 se aplică numai dacă comanda se află în statutul 2
-9 Noul statut este identic cu statutul actual
-22 Eroare la primirea fișierului
-23 Eroare necunoscută la primirea fișierului
-24 Link-ul etichetei este prea lung
-25 Linkul furnizat este identic cu linkul actual
-428 Contul dvs a fost dezactivat. Nu mai puteți efectua solicitări către serviciile web
-429 Ați efectuat prea multe solicitări către serviciile web peste limita la oră

Exemple de returnări XML


Exemplu de răspuns la un apel de serviciu web 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>

Exemplu de răspuns la un apel de serviciu web 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>