Accueil > Webservices > Bon de livraison

Récupération du Bon de Livraison

URL du Webservice : http://sws.spartoo.com/mp/xml_export_bl.php

Ce webservice sert à récupérer le bon de livraison qui doit être dans les colis de vos commandes Spartoo.

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.

Format de l'argument XML

<root>
	<order_id>string</order_id>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<product_quantity>int</product_quantity>
		</product>
	</products>
</root>

Description des champs du XML d'entrée

Balise Description Obligatoire
order_id Identifiant de la commande Oui
reference_partenaire Identifiant produit du marchand
L'identifiant du produit ne peut contenir que des caractères alphanumérique ainsi que les caractères - (tiret) _ (tiret bas) et . (point). 		Oui
product_quantity Quantité du produit dans le colis Oui


Exemple de paramètre xml

<root>
	<order_id>3FF75E96C3434E92</order_id>
	<products>
		<product>
			<reference_partenaire>39870-42</reference_partenaire>
			<product_quantity>1</product_quantity>
		</product>
	</products>
</root>

Format du XML retourné

<root>
	<bl>
		<order_id>string</order_id>
		<pdf>string</pdf>
	</bl>
	<errors>int</errors>
</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
-5 Il manque le paramètre rID/oID ou le paramètre statut
-6 La commande ou le retour n’ont pas été trouvés, vérifiez le paramètre oID / rID ou le paramètre partenaire.
-11 Le paramètre xml n’est pas passé en paramètre ou est vide
-12 Le paramètre reference_partenaire 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
order_id Identifiant de la commande
pdf Bon de Livraison au format PDF encodé
errors Code d'erreur


Exemples de retour XML

Exemple de réponse à un appel web service KO
<root>
	<errors>int</errors>
</root>
Exemple de réponse à un appel web service OK
<root>
	<errors>1</errors>
	<bl>
		<order_id>25CF31A736506CE8</order_id>
		<pdf>string PDF encode</pdf>
	</bl>
</root>