Sprejem > Web storitve > Posodobitev vračila

Posodobitev vračila

URL Webservice-a : https://sws.spartoo.si/mp/xml_maj_returns.php

Ta spletna storitev se uporablja za posodabljanje vračil.

Če morate stranki posredovati etiketo za vračilo, sta na voljo dva načina:
  • Etiketo na strežniku gostite vi: navedite argument label_link , ki vsebuje povezavo do etikete
  • Želite, da etikete gostimo na naših strežnikih: navedite argument label_file , ki vsebuje datoteko etikete
Ko je vračilo odposlano ali je določena časovna omejitev, lahko določite argument statut za
  • bodisi sprejem vračila ( statut 4 )
  • bodisi zavrnitev vračila ( statut 3 )


> Glej seznam statusov vračil

Seznam nastavitev

Nastavitve te spletne storitve je potrebno prenesti v POST

Nastavitev Opis
partenaire Mora vsebovati vaš edinstven ID :
rID Posodobitev ID za vračilo
statut (neobvezno) Nov status vračila N ( 3 ali 4 )
label_link (neobvezno) Povezava do etikete za vračilo
label_file (neobvezno) Datoteka etikete za vračilo


Format izvoženega 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>


Seznam kod za napake spletnih storitev


Koda Opis
1 Ni napak v nastavitvah
-1 Nastavitev partenaire ni bila zaznana kot nastavitev ali pa je prazna
-2 Partnerske nastavitve ne obstajajo
-5 Manjka parameter rID / oID ali parameter stanja
-6 Naročila ali vračila ni bilo mogoče najti, preverite parameter oID / rID ali parameter partnerja.
-7 Problem v časovnici vračila
  • Status 4 velja samo, če je vrnitev v statusu 2 ali 3
  • Status 3 velja samo, če je naročilo v statusu 2
-9 Novo stanje je enako trenutnemu stanju
-22 Napaka pri prejemu datoteke
-23 Neznana napaka pri prejemu datoteke
-24 Povezava z etiketo je predolga
-25 Navedena povezava je enaka trenutni povezavi
-428 Vaš račun je deaktiviran. Ne morete več naročati spletnih storitev
-429 V tekoči uri ste to spletno storitev prevečkrat naročili

Primer vračila XML


Primer odgovora na spletno povpraševanje 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>

Primer odgovora na spletno povpraševanje 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 ?