Récupération des commandes V2

Lengow met à votre disposition dans la solution, une api vous permettant de récupérer les commandes de vos différents flux.

Dans un premier temps, il vous faut renseigner l'ip utilisée pour interroger notre API ici

Vous devez ensuite appeler l'url de récupération du flux XML suivante :

http://api.lengow.com/V2/#DATE_FROM#/#DATE_TO#/#ID_CLIENT#/#ID_GROUP#/#ID_FLUX#/commands/#STATE#/#FORMAT#/

1. Paramètres :

#DATE_FROM# et#DATE_TO# : Date au format YYYY-mm-dd (ex: 2013-09-16)

#ID_CLIENT# : Votre ID Client sur Lengow

#ID_GROUP# : Votre ID Groupe. Pour tous les groupes, indiquez la valeur 0, Pour plusieurs groupes, séparez les par une virgule

#ID_FLUX# : L'ID du Flux pour lequel vous voulez récupérer les commandes. Renseignez “orders” pour l'ensemble des flux

#STATE#> : Statut des commandes. Valeurs possibles : all, new, processing, shipped, cancel

#FORMAT# : Format de sortie : newxml (nouvelle structure XML = API V2), oldxml (ancienne structure XML = API V1), json

Vous avez la possibilité de récupérer les informations au format XML ou JSON.

Vous trouverez ci-dessous, une explication sur la structure du XML renvoyé par notre API.

2. Informations globales

Information sur la génération du flux commandes

<statistics ip="127.0.0.1" timeGenerated="2013-09-16 12:00:00.120000">

Information sur le nombre de commandes retournées par l'API

Au niveau du noeud <orders_count>

  • Nombre total de commandes
<count_total>23</count_total>
  • Nombre de commandes par Marketplace
<count_by_marketplace>
	<laredoute>10</laredoute>
	<cdiscount>7</cdiscount>
	<rueducommerce>2</rueducommerce>
	<amazon>3</amazon>
	<brandalley>1</brandalley>
</count_by_marketplace>
  • Nombre de commandes par Status
<count_by_status>
	<cancel>2</cancel>
	<new>0</new>
	<shipped>21</shipped>
	<processing>0</processing>
</count_by_status>

2.1 Informations de commandes

Noeud principal comprenant toutes les commandes

<orders>...</orders>

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

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

2.2 Informations Générales

Nom de la marketplace d'ou provient la commande

Les valeurs possible : amazon, ebay, brandalley, monechelle, pixplace, rueducommerce, fnac, priceminister, cdiscount, laredoute, rakuten_de, spartoo, zalando, mistergooddeal, galeries_lafayette, darty, natdec, moncornerdeco, delamaison, atlasformen, auchan, boulanger, comptoiresante, gosport, home24, immochan_v2, macway, menlook, privalia, ricardo, thebeautyst, wish.

<marketplace><![CDATA[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.

Lorsque vous possédez plusieurs flux à destination d'un même compte marketplace, Lengow associe par défaut les commandes au flux le plus ancien (ayant l'identifiant le plus petit) et actif dans la solution.

Par exemple, je possède 3 flux id 75002, 76455, 76457 à destination du même compte Amazon ⇒ Mes commandes seront associées au flux ayant l'id le plus petit soit le flux id 75002.

<idFlux><![CDATA[26588]]></idFlux>

2.3 Informations de Statut

Statut de la commande

Vous avez 2 informations de statut dans le noeud <order_status> :

- Le statut de la marketplace

<marketplace><![CDATA[accepted]]></marketplace>

- Le statut homogénéisé de Lengow

<lengow><![CDATA[shipped]]></lengow>

Voici les différentes possibilités de statut pour chaque marketplace, avec, en rouge, le statut qui correspond à “en attente d'expédition” et que vous devez prendre (selon nous) en compte pour déclencher un import dans votre système de gestion de commande.

Les valeurs possibles des statuts marketplace :

  • Amazon : new, canceled, accept, accepted
  • eBay : new, ToShip, Shipped,
  • Play.com : accepted
  • PixPlace : accepted
  • Rueducommerce : new, processing, restocking, shipped, cancelled
  • Fnac.com : ToAccept, AcceptedRefunded, ToShip, NotReceived, Received, Shipped, Refused, Cancelled
  • Rakuten-PriceMinister : REQUESTED, REMINDED, ON_HOLD, COMMITTEDSHIPPED, CLOSED, CANCELLED, REFUSED
  • GreenRepublic : new, pending_payment, processing, complete, canceled
  • Cdiscount : CancelledByCustomer, WaitingForSellerAcceptation, AcceptedBySeller, PaymentInProgress,WaitingForShipmentAcceptationShipped, RefusedBySeller, AutomaticCancellation, PaymentRefused, ShipmentRefusedBySeller, ValidatedFianet, RefusedNoShipment
  • La Redoute : Created, Accepted, Refused, ToshipTocancel, Shipped, Cancelled, Torefund, Refunded, Notrefunded
  • Frenchplace : new, accepted, refused, canceled
  • Brandalley : processingacceptedrefused
  • LeChouChou : newprocessingacceptrefuse
  • Discounteo (également appelé Villatech) : processingshippedrefuse

Les valeurs possibles des statuts Lengow :

  • Nouvelle commande : new
  • Commande en attente d'expédition : processing
  • Commande expédiée : shipped
  • Commande annulée ou remboursée : cancel

2.4 Informations de Commande

Numéros de commande

Votre idCommande principal se trouve dans le noeud <order_id>. Il correspond au numéro attribué par la marketplace.

<order_id><![CDATA[123-1234567-1234567]]></order_id>

Numéro de commande complémentaire

Pour certaines marketplaces, des informations supplémentaires sont fournies. Vous retrouverez ces informations dans les noeuds suivants : <order_mrid> et <order_refid>

Pour RDC, vous aurez un morid ainsi qu'un refid.

Pour Ebay, les 2 noeuds contiennent le numéro de transaction.

Pour les autres marketplaces, ces valeurs sont identiques au numéro de commande principal.

<order_mrid><![CDATA[123-1234567-1234567]]></order_mrid>
<order_refid><![CDATA[123-1234567-1234567]]></order_refid>

id de commande externe

Si vous utilisez Prestashop, Magento ou une autre solution eCommerce, vous retrouverez l'id de commande de votre solution eCommerce ici :

<order_external_id><![CDATA[100034239]]></order_external_id>

Par défaut nous récupérons les identifiants des commandes Prestashop et Magento par le biais de nos modules. Si vous une utilisez une autre solution eCommerce et que vous souhaitez injecter vos identifiants internes de commandes au sein de Lengow pour les voir ensuite apparaître dans ce noeud XML, vous devez effectuer des appels à nos WebServices.

Date et heure

La date et l'heure de commande

<order_purchase_date><![CDATA[2013-08-21]]></order_purchase_date>
<order_purchase_heure><![CDATA[08:03:40]]></order_purchase_heure>

Ces informations nous sont transmises par les places de marché. C'est donc le fuseau horaire du pays où la commande a été passée qui s'applique.

Montant de la commande

Montant de la commande en TTC.

<order_amount><![CDATA[37.35]]></order_amount>

Taxe

Taxe appliquée à la commande.

Toutes les marketplaces ne fournissent pas cette information

<order_tax><![CDATA[0.00]]></order_tax>

Frais de port

Montant des frais de port totaux en TTC

<order_shipping><![CDATA[4.9]]></order_shipping>

Commission

Montant de la commision prélevée par la marketplace

Toutes les marketplaces ne fournissent pas cette information

<order_commission><![CDATA[0.0]]></order_commission>

Frais de traitement

Montant des éventuels frais de traitement liés à des paiement en plusieurs fois par exemple.

Toutes les marketplaces ne fournissent pas cette information

<order_processing_fee><![CDATA[0]]></order_processing_fee>

Devise

Devise de la commande.

Toutes les marketplaces ne fournissent pas cette information

<order_currency><![CDATA[EUR]]></order_currency>

2.5 Informations de paiement

Les informations relatives au paiement sont regroupées dans le noeud <order_payment>

Checkout

<payment_checkout><![CDATA[]]></payment_checkout>

Cette information est propre aux commandes eBay

Statut

Statut du paiement

<payment_status><![CDATA[]]></payment_status>

Type

Type de paiement utilisé par le client : CB, chèque, 3X sans frais …

Toutes les marketplaces ne fournissent pas cette information

<payment_type>Paiement 3X</payment_type>

Date et heure

Date et heure du paiement de la commande

Toutes les marketplaces ne fournissent pas cette information

<payment_date><![CDATA[2013-08-21]]></payment_date>
<payment_heure><![CDATA[08:03:40]]></payment_heure>

2.6 Informations Facture

Les informations relatives à la facture sont regroupées dans le noeud <order_invoice>

Numéro de facture

<invoice_number>AZ1223</invoice_number>

URL de facture

<invoice_url>https://solution.lengow.com/invoice/RDC/15042/245693915.pdf</invoice_url>

2.7 Informations Client

Ces informations, encapsulées dans <billing_address> 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)

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

<billing_address>
	<billing_society><![CDATA[Lengow]]></billing_society>
	<billing_civility><![CDATA[Mr]]></billing_civility>
	<billing_lastname><![CDATA[Dupont]]></billing_lastname>
	<billing_firstname><![CDATA[Jean]]></billing_firstname>
	<billing_email><![CDATA[d9kbsc9zrdsfsf24pdb14h@marketplace.amazon.fr]]></billing_email>
	<billing_address><![CDATA[51 place de la lune]]></billing_address>
	<billing_address_2><![CDATA[]]></billing_address_2>
	<billing_address_complement><![CDATA[]]></billing_address_complement>
	<billing_zipcode><![CDATA[44000]]></billing_zipcode>
	<billing_city><![CDATA[Nantes]]></billing_city>
	<billing_country><![CDATA[FR]]></billing_country>
	<billing_country_iso><![CDATA[]]></billing_country_iso>
	<billing_phone_home><![CDATA[0123456789]]></billing_phone_home>
	<billing_phone_office><![CDATA[]]></billing_phone_office>
	<billing_phone_mobile><![CDATA[0678987678]]></billing_phone_mobile>
	<billing_full_address><![CDATA[51 place de la lune 44000 Nantes FR]]></billing_full_address>
</billing_address>

2.8 Informations Livraison

Concernant les adresse de livraison, comme pour les informations client, nous ne les recevons pas directement pour les marketplaces Cdiscount, La Redoute

<delivery_address>
	<delivery_society><![CDATA[Lengow]]></delivery_society>
	<delivery_civility><![CDATA[Mr]]></delivery_civility>
	<delivery_lastname><![CDATA[Dupont]]></delivery_lastname>
	<delivery_firstname><![CDATA[Jean]]></delivery_firstname>
	<delivery_email><![CDATA[d9kbsc9zrdsfsf24pdb14h@marketplace.amazon.fr]]></delivery_email>
	<delivery_address><![CDATA[51 place de la lune]]></delivery_address>
	<delivery_address_2><![CDATA[]]></delivery_address_2>
	<delivery_address_complement><![CDATA[]]></delivery_address_complement>
	<delivery_zipcode><![CDATA[44000]]></delivery_zipcode>
	<delivery_city><![CDATA[Nantes]]></delivery_city>
	<delivery_country><![CDATA[FR]]></delivery_country>
	<delivery_country_iso><![CDATA[]]></delivery_country_iso>
	<delivery_phone_home><![CDATA[0123456789]]></delivery_phone_home>
	<delivery_phone_office><![CDATA[]]></delivery_phone_office>
	<delivery_phone_mobile><![CDATA[0678987678]]></delivery_phone_mobile>
	<delivery_full_address><![CDATA[51 place de la lune 44000 Nantes FR]]></delivery_full_address>
</delivery_address>

2.9 Informations d'expédition

Les informations de colis sont regroupées dans le noeud <tracking_informations>

Vous y retrouverez :

  • La méthode d'envoi : Tracking, Standard, Recommandé, Point relai …
  • Le transporteur : Libre ou défini par la marketplace
  • Le numéro de colis
  • L'url de tracking
  • La date d'expédition
  • Le numéro du point relai
  • Envoi géré par la marketplace (valeur "1" - Programme FBA d'Amazon par exemple) ou par le vendeur (valeur "0").

Ces informations seront bien entendu renseignées en fonction de ce que nous renvoie la place de marché.

<tracking_informations>
	<tracking_method><![CDATA[]]></tracking_method>
	<tracking_carrier><![CDATA[Standard]]></tracking_carrier>
	<tracking_number><![CDATA[005VGB14]]></tracking_number>
	<tracking_url><![CDATA[]]></tracking_url>
	<tracking_shipped_date><![CDATA[2013-08-22 16:18:12]]></tracking_shipped_date>
	<tracking_relay><![CDATA[]]></tracking_relay>
	<tracking_deliveringByMarketPlace><![CDATA[0]]></tracking_deliveringByMarketPlace>
</tracking_informations>

2.10 Informations diverses

Quelques informations supplémentaires concernant la commande.

Commentaire

Un commentaire peut être associé à la commande par le client, il sera renseigné au niveau de ce noeud.

<order_comments><![CDATA[]]></order_comments>

Identifiant Client

Certaines marketplaces fournissent l'identifiant interne à leur site pour le client qui a passé la commande.

Actuellement, seul eBay et Cdiscount renvoie une information de ce type.

<customer_id><![CDATA[]]></customer_id>

IP du Client

Certaines marketplace fournissent l'IP du client.

<order_ip><![CDATA[]]></order_ip>

Nombre d'articles

Nombre d'articles total dans la commande

Dans l'exemple, 3 peut signifier 2 produits A et 1 produit B

<order_items><![CDATA[3]]></order_items>

2.11 Informations produits

Le panier complet est englobé dans le noeud <cart> avec à l'intérieur le nombre de produits distincts puis la liste des produits encapsulée dans le noeud <products>

Nombre d'article distinct

Le nombre de produit différent dans votre panier.

Toujours dans notre exemple, nous avons ici 2 produits A et 1 produit B ce qui représente 2 produits différents

<cart_products>2</cart_products>

Vous avez ensuite le détail de votre panier avec chaque produit :

Identifiants produit

L'identifiant du produit dans le système Lengow.

<idLengow><![CDATA[10001]]></idLengow>

Lorsque le produit n'existe plus au sein de Lengow, ce noeud XML devient vide. Dans ce cas référez-vous à la valeur contenue dans le noeud XML <sku> pour pouvoir identifier le produit commandé.

L'identifiant retourné par la marketplace

<idMP><![CDATA[S9849GHD0]]></idMP>

Certaines places de marché affectent leurs propres identifiants aux produits. Toutes les marketplaces ne fournissent pas cette information

Votre identifiant produit transmis à la place de marché depuis Lengow.

<sku field="ID_PRODUCT"><![CDATA[BB0201]]></sku>

Un attribut “field” indique le champ matché dans lengow (information utilisée par Lengow lors des imports de commande vers Prestashop ou Magento)

L'EAN de votre produit renvoyé par la Marketplace

<ean><![CDATA[1234567890987]]></ean>

Seul Cdiscount actuellement renvoie cette information

Titre

Titre de votre produit

<title><![CDATA[Les blagues de totos]]></title>

Si le produit n'existe plus au sein de Lengow, ce noeud sera vide.

Catégorie

Catégorie du produit

<category><![CDATA[LIVRES]]></category>

Si le produit n'existe plus au sein de Lengow, ce noeud sera vide.

Marque

Marque du produit

<brand><![CDATA[TOTO]]></brand>

Actuellement, seul RDC renvoie cette information

Url

Url de votre produit sur votre site web

<url_product><![CDATA[http://www.site.com/monproduit.html]]></url_product>

Image

Image associé à votre produit

<url_image><![CDATA[http://medias.site.com/monproduit.jpg]]></url_image>

Id de ligne

Identifiant de ligne produit renvoyé par la Marketplace pour gérer les actions par ligne.

<order_lineid><![CDATA[]]></order_lineid>

Toutes les marketplaces ne fournissent pas cette information

Quantité

Quantité du produit dans la commande

<quantity><![CDATA[2]]></quantity>

Prix

Prix TTC du produit en tenant compte de la quantité commandée

<price><![CDATA[64.90]]></price>

Prix TTC unitaire du produit

<price_unit><![CDATA[32.45]]></price_unit>

Frais de port

Frais de port du produit

Selon les marketplace, les frais de port de chaque produit ne sont pas pris en compte, seul le plus grand frais de port de la commande est utilisé

<shipping_price><![CDATA[]]></shipping_price>

Taxe

Taxe appliquée sur l'article

Toutes les marketplaces ne fournissent pas cette information

<tax><![CDATA[]]></tax>

Statut

Etat de votre produit.

Les produits en cancel ou refused ne sont par exemple pas à prendre en compte

<status><![CDATA[]]></status>

3. Récupération d'une commande par son identifiant

Vous pouvez récupérer une commande en particulier en appelant l'URL suivante

http://api.lengow.com/V2/#ID_CLIENT#/#ID_FLUX#/orderid/#ID_COMMANDE#/

Avec comme paramètres :

  • #ID_CLIENT# : identifiant client
  • #ID_FLUX# : identifiant du flux avec la commande
  • #ID_COMMANDE# : identifiant de la commande

Le retour est structuré de la même manière que les requêtes faites sur une période de temps.