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>

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