Récupération des commandes

Attention, pour la récupération des commandes, une deuxième version de notre API est disponible.

Lengow met à votre disposition dans la solution, une api ainsi que des webservices pour gérer notamment vos commandes.

Dans un premier temps, renseignez l'ip utilisé pour appeler notre webservice ici

Ensuite, appelez l'url de récupération du flux XML suivante : http://api.lengow.com/#DATE_FROM#/#DATE_TO#/#ID_CLIENT#/#ID_FLUX#/commands/#STATE#/

Paramètres :

#DATE# : Date au format Y-m-d (2009-01-01)

#ID_FLUX# : Id Flux (“orders” pour l'ensemble des flux)

#STATE# : Statut des commandes (all, new, processing, toship, cancel)

Vous trouverez ici une explication sur la structure du fichier XML renvoyé par notre API.

1. Informations globales

Information sur la génération du flux commandes

<statistics ip="127.0.0.1" server="Oxalide" timeGenerated="2012-06-01 01:06:20.120000">

Nombre de commandes retournées par l'API. Ce nombre contient toutes les marketplaces si vous n'avez pas spécifié un idFlux dans votre url d'appel.

<countCommandes>51</countCommandes>

Nombre de commandes par Marketplace

<countCommandesAmazon>7</countCommandesAmazon>
<countCommandesPixplace>7</countCommandesPixplace>
<countCommandesFnac>10</countCommandesFnac>
<countCommandesCdiscount>27</countCommandesCdiscount>

2. Informations de commandes

Noeud principal comprenant toutes les commandes

<commandes>...</commandes>

Chaque commande est encapsulé dans un noeud <commande>…</commande>

Voici le détail des informations contenu dans ce noeud :

2.1 Informations Générales

Nom de la marketplace d'ou provient la commande

Les valeurs possible : Amazon, eBay, Play.com, PixPlace, Rueducommerce, Fnac.com, PriceMinister, GreenRepublic, Cdiscount, LaRedoute, Frenchplace, Brandalley, Discounteo (correspond à Villatech), LeChouchou

<marketplace>Amazon</marketplace>

L'idFlux concernant votre commande afin de déterminer de quel flux celle ci provient quand vous avez plusieurs flux pour une même marketplace.

<idFlux>10393</idFlux>

Statut de la commande

Voici un listing des différents statuts possibles par place de marché.

En rouge le statut qui correspond à “en attente d'expédition” et que vous devez prendre en compte pour déclencher un import dans votre système de gestion de commande)

Les valeurs possibles :

  • Amazon : new, canceled, accept, accepted
  • eBay : new, ToShip, Shipped,
  • Play.com : accepted
  • PixPlace : accepted
  • Rueducommerce : new, processing, restocking, shipped, cancelled
  • Fnac.com : ToAccept, Refunded, ToShip, NotReceived, Received, Shipped, Refused, Cancelled
  • PriceMinister : new, acceptsale, refusesale, CLOSED (correspond à expédié)
  • GreenRepublic : new, pending_payment, processing, complete, canceled
  • Cdiscount : CancelledByCustomer, WaitingForSellerAcceptation, AcceptedBySeller, PaymentInProgress,WaitingForShipmentAcceptationShipped, RefusedBySeller, AutomaticCancellation, PaymentRefused, ShipmentRefusedBySeller, ValidatedFianet, RefusedNoShipment
  • La Redoute : Created, Accepted, Refused, To shipTo cancel, Shipped, Cancelled, To refund, Refunded, Not refunded
  • Frenchplace : new, accepted, refused, canceled
  • Brandalley : processingacceptedrefused
  • LeChouChou : newprocessingaccept, refuse
  • Discounteo (également appelé Villatech) : processingshippedrefuse
<status>accepted</status>

Numéro de la commande

Pour RDC, vous aurez un morid ainsi qu'un refid, pour les autres marketplace, ces valeurs sont identique au numéro de commande principal. Pour Ebay, il faut utiliser le com_id qui correspond au numéro de commande Ebay (qui est composé du numéro de commande + le numéro de transaction). Les 2 noeuds suivants contiennent le numéro de transaction.

<com_id>402-4482545-1480351</com_id>
<com_mrid>402-4482545-1480351</com_mrid>
<com_refid>402-4482545-1480351</com_refid>

Numéro externe

Id de la commande dans votre solution e-commerce : Prestashop, Magento …

<com_external_id>9690</com_external_id>

Date et heure de la commande et de son paiement

<com_payement_date>2012-01-01</com_payement_date>
<com_payement_heure>10:53:53</com_payement_heure>
<com_purchase_date>2012-01-01</com_purchase_date>
<com_purchase_heure>10:53:53</com_purchase_heure>

Statut du paiement (seulement pour les marketplaces eBay et Play.com)

<com_payment_status></com_payment_status>

Voir la liste des valeurs eBay disponibles

Statut du checkout de la commande (uniquement valable pour eBay)

<com_checkout_payment></com_checkout_payment>

Voir la liste des valeurs eBay disponibles

Type de paiement (spécifique aux marketplaces eBay et Cdiscount)

Les valeurs possibles pour eBay : None, PayPal, PersonalCheck, VisaMC, MoneyXferAccepted, MoneyXferAcceptedInCheckout, MOCC, COD, CCAccepted, PaymentSeeDescription, Other

Les valeurs possibles pour Cdiscount : Paiement 3X

<com_type_payment></com_type_payment>

2.2 Informations Client

Ces informations peuvent être vides à certains états pour certaines marketplace :

  • Cdiscount : récupération à partir de l'état WaitingForShipmentAcceptation
  • LaRedoute : récupération à partir de l'état ToShip (passage de Accepted à ToShip fait par La Redoute automatiquement lors de la génération de la facture)
  • PriceMinister : pas d'adresse de livraison lors du choix du mode SoColissimo

Certaines marketplace nous retourne un Prénom/Nom dans le même champ, c'est pourquoi toute l'information peut se retrouver seulement dans le champ “<com_fact_nom>”.

<com_fact_societe>Ma société</com_fact_societe>
<com_fact_civilite>Mr</com_fact_civilite>
<com_fact_nom>Dupont</com_fact_nom>
<com_fact_prenom>Jean</com_fact_prenom>
<com_fact_email>j.dupont@monmail.com</com_fact_email>
<com_fact_adresse>13 rue de martin</com_fact_adresse>
<com_fact_adresse_2></com_fact_adresse_2>
<com_fact_adresse_complement>Appt 12</com_fact_adresse_complement>
<com_fact_cp>44000</com_fact_cp>
<com_fact_ville>Nantes</com_fact_ville>
<com_fact_pays>FR</com_fact_pays>
<com_fact_telephone_home>0102030405</com_fact_telephone_home>
<com_fact_telephone_office></com_fact_telephone_office>
<com_fact_pays_iso>FR</com_fact_pays_iso>

Pour eBay, nous fournissons également une adresse complète puisque celle-ci nous est retournée de cette façon.

<com_fact_full>13 rue de martin Appt 12 44000 Nantes</com_fact_full>

2.3 Informations Livraison

Concernant les adresse de livraison, comme pour les informations client, nous ne les recevons pas directement pour les marketplaces Cdiscount, La Redoute et Priceminister (SoColissimo)

</liv_fact_societe>
<liv_fact_civilite>Mr</liv_fact_civilite>
<liv_fact_nom>Dupond</liv_fact_nom>
<liv_fact_prenom>David</liv_fact_prenom>
<liv_fact_email>d.dupond@monmail.com</liv_fact_email>
<liv_fact_adresse>22 chemin des eaux vives</liv_fact_adresse>
<liv_fact_adresse_2></liv_fact_adresse_2>
<liv_fact_adresse_complement>Au fond de la cours</liv_fact_adresse_complement>
<liv_fact_cp>73100</liv_fact_cp>
<liv_fact_ville>Aix les bains</liv_fact_ville>
<liv_fact_pays>FR</liv_fact_pays>
<liv_fact_telephone_home>0102030406</liv_fact_telephone_home>
<liv_fact_telephone_office></liv_fact_telephone_office>
<liv_fact_pays_iso>FR</liv_fact_pays_iso>
<liv_fact_full>22 chemin des eaux vives Au fond de la cours 73100 Aix les bains</liv_fact_full>

2.4 Informations diverses

Champ pseudo acheteur (spécifique à la marketplace eBay)

<com_pseudo></com_pseudo>

Montant de la commande en TTC

<com_montant_commande>130.9</com_montant_commande>

Inclus également le montant de l'écotaxe (contenu dans le noeud XML <com_montant_tax>)

Taxe

<com_montant_tax>0.00</com_montant_tax>

Nombre d'article dans la commande

<com_nb_article>1</com_nb_article>

Frais de port de la commande et méthode d'envoi (standard/tracking/suivi)

La méthode n'est pas indiqué pour toutes les marketplaces

<com_shipping>0.0</com_shipping>
<com_shipping_description>Standard</com_shipping_description>

Commentaire sur la commande

<com_commentaires></com_commentaires>

Commission prélevée par la marketplace (certaines marketplaces ne renvoient rien)

<com_commission>0.0</com_commission>

Frais de traitement pour certaines marketplace (Paiement 3 fois par exemple)

<com_frais_traitement>2.35</com_frais_traitement>

Numéro de tracking colis

<com_tracking_colis></com_tracking_colis>

IP de la commande (spécifique à la marketplace GreenRepublic)

<com_ip></com_ip>

Type de livraison

<com_type_livraison></com_type_livraison>

Code ISO du pays

<com_fact_pays_iso>FR</com_fact_pays_iso>

2.4 Informations produits

Dans le noeud “<panier>…</panier>” vous trouverez les informations des produits commandés

<nb_orders>1</nb_orders>

Le noeud “<produits>…</produits>” liste lui tous les articles de la commande, chaque article étant englobé dans un noeud “<produit>…</produit>”

Id du produit dans votre Catalogue Lengow

<id>F486D684</id>

Nom du produit

<titre>Mon produit</titre>

Catégorie du produit

<category>Accueil > Catégorie 1 > Sous catégorie 3</category>

URL directe vers le produit et URL de sa photo

<url_produit>http://www.monsite.com/monproduit.html</url_produit>
<url_image>http://images.monsite.com/monproduit.jpg</url_image>

Id du produit renvoyé par la marketplace

<sku>XD4684654</sku>

Quantité commandée

<qt>1</qt>

Marque du produit (seulement renvoyé par la marketplace RDC)

<marque></marque>

EAN du produit (seulement renvoyé par la marketplace CDiscount)

<ean></ean>

Prix TTC du produit * Quantité

<prix>13.9</prix>

Prix TTC unitaire du produit

<prix_unitaire>13.9</prix_unitaire>

Etat du produit (uniquement disponible pour LaRedoute actuellement)

<state>Cancelled</state

Vous permet de savoir si le produit a été annulé. Dans ce cas vous ne devez pas le prendre en compte lors de l'intégration de la commande. Les valeurs à exclure sont Refused ou Cancelled

Identifiant de la ligne produit (uniquement disponible pour LaRedoute actuellement)

<lineid></lineid

Permet d'identifier la ligne produit à prendre en compte lors de la demande de remboursement partiel d'une commande LaRedoute via notre Webservice

Ecotaxe du produit

<taxe></taxe>

Contient le montant d'écotaxe du produit renvoyé par la place de marché