Accueil > Webservices > Acquitement des produits

Acquittement des produits

URL du Webservice : https://sws.spartoo.com/mp/xml_check_status_products.php

Ce webservice permet de récupérer le statut d'un ou plusieurs produits sur le site.
Dans le cas où le produit n'est pas en ligne, il permet d'en connaître la raison.
Il est possible de connaître le détail du statut du produit à la taille, il faut alors avoir fourni le champ size_reference dans le webservice d'import des produits.

Liste des paramètres

Les paramètres de ce webservice doivent être obligatoirement passés en POST

Paramètre	Description
partenaire	Doit contenir votre identifiant unique :
xml	Chaîne de caractère XML contenant la liste des éléments des informations permettant de réaliser le bon de livraison

Format du paramètre xml

Les champs texte doivent être protégés par des balises CDATA s'ils contiennent des caractères spéciaux qui rendrait le XML invalide.

<root>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<products_size_reference>string</products_size_reference>
		</product>
		<!-- ... Plusieurs balises "<product>" possibles ... -->
	</products>
</root>

Description des champs du XML d'entrée

Balise	Description	Obligatoire
reference_partenaire	Identifiant produit du marchand Correspond au champ reference_partenaire du webservice d'import des produit	Obligatoire
products_size_reference	Référence du produit à la taille. Correspond au champ size_reference du webservice d'import des produit	Facultatif

Exemple de paramètre xml

<root>
	<products>
		<product>
			<reference_partenaire>SKU_PARENT</reference_partenaire>
			<products_size_reference>SKU</products_size_reference>
		</product>
		<product>
			<reference_partenaire>SKU_PARENT 2</reference_partenaire>
		</product>
	</products>
</root>

Format du XML retourné

<root>
	<errors>int</errors>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_reference>string</size_reference>
			<status>string</status>
			<description>string</description>
		</product>
		<!-- ... Plusieurs balises "<product>" possibles ... -->
	</products>
</root>

Liste des codes d'erreurs du webservice

Code	Description
1	Pas d'erreur de paramètres
-1	Le paramètre partenaire n’est pas passé en paramètre ou est vide
-2	Le paramètre partenaire n’existe pas
-11	Le paramètre xml n’est pas passé en paramètre ou est vide
-15	Erreur de syntaxe XML, vérifiez votre fichier XML
-428	Votre compte a été désactivé. Vous ne pouvez plus faire d'appels aux webservices
-429	Vous avez fait trop d'appel a ce webservice pour cette heure glissante

Description des champs de la réponse XML

Balise	Description
reference_partenaire	Identifiant produit du marchand
size_reference	Référence du produit à la taille
status	Liste des status : OK : Le produit est présent sur le site OS : Le produit n'est plus en stock EC : Le produit est crée dans notre système, mais n'est pas sur le site KO : Le produit n'est pas crée dans notre système
description	Description texte

Exemples de retour XML

<root>
	<errors>1</errors>
	<products>
		<product>
			<reference_partenaire>SKU_PARENT</reference_partenaire>
			<size_reference>SKU</size_reference>
			<status>KO</status>
			<description>Cette référence de taille n'existe pas pour ce produit</description>
		</product>
		<product>
			<reference_partenaire>SKU_PARENT 2</reference_partenaire>
			<status>OS</status>
			<description>Ce produit n'est plus en ligne parce qu'il n'a plus de stock</description>
		</product>
	</products>
</root>