Főoldal > Webszervíz > Egy visszaküldés frissítése

Egy visszaküldés frissítése

Webszervíz URL-je : https://sws.spartoo.hu/mp/xml_maj_returns.php

Ez a webszervíz egy visszaküldés státuszának frissítésére szolgál.

Amennyiben visszaküldési címkét kell biztosítania az ügyfél számára, úgy két lehetőség áll rendelkezésére:

A címke Önnél tárolódik: adja meg a label_link argumentumot, mely tartalmazza a címke hivatkozási linkjét
Kívánja, hogy a mi szerverünkön tároljuk a címkét: adja meg a label_file argumentumot, mely tartalmazza a címkefájlt

Amikor a visszaküldés elindult, vagy túllépett a határidőn, frissítheti az argumentum státuszát a következők szerint:

vagy visszaküldés elfogadása ( 4-es státusz )
vagy visszaküldés elutasítása ( 3-as státusz )

> Visszaküldések státusz listájának megtekintése

Paraméterek listája

Ennek a webszervíznek a paraméterei kötelezően POST-on keresztül kell mennie

Paraméter	Leírás
partenaire	Tartalmaznia kell az Ön egyedi azonosítóját :
rID	A frissítendő visszaküldési azonosító
statut	(opcionális) Visszaküldés új státusza ( 3 vagy 4 )
label_link	(opcionális) Link a visszaküldési címkéhez
label_file	(optionnel) Visszaküldési címke fájlja

Visszaküldött XML formátuma

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

Webszervíz hibakódjainak listája

Kód	Leírás
1	Nincs paraméter hiba
-1	A partenaire paraméter nem ment át a paramétereken vagy üres
-2	A partner paraméter nem létezik
-5	Hiányzik az rID/oID paraméter vagy a státusz paraméter
-6	A rendelés vagy a visszaküldés nem található, ellenőrizze az oID / rID paramétert vagy a partner paramétert.
-7	Probléma a visszküldés kronológiájában A 4-es státusz csak akkor applikálódik, ha a visszaküldés 2-es vgy 3-as státuszban van A 3-as státusz csak akkor applikálódik, ha a rendelés 2-es státuszban van
-9	Az új státusz megegyezik az aktuális státusszal
-22	Hiba történt a fájl fogadásakor
-23	Ismeretlen hiba történt a fájl fogadásakor
-24	A címke linkje túl hosszú
-25	A megadott link megyezik az aktuális linkkel
-428	Fiókja deaktiválásra került. A webservices már nem áll rendelkezésére.
-429	Túl sokszor lépett kapcsolatba a webservice-szel az elmúlt egy órában.

Visszaküldött XML példái

Mintaválasz egy webszolgáltatás hívásra 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>

Mintaválasz egy webszolgáltatás hívásra 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>