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>

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