GetOrders : Récupération de commandes
La méthode GetOrders renvoie toutes les commandes correspondantes au filtre définit par vos paramètres d’entrées.
À noter : La réponse est limitée aux 200 commandes les plus récentes (remarque : l’ordre dans la réponse n’est pas nécessairement respecté), il peut donc être nécessaire de parcourir les autres pages de résultat pour récupérer l’intégralité des commandes souhaitées.
La récupération des commandes est l’une des requêtes les plus courantes. Cette méthode n’a pas de paramètre obligatoire : sans précision, toutes les commandes sont renvoyées en retour.
Il est cependant recommandé de définir les paramètres de filtre par date (de vente ou de paiement) que cette méthode propose afin de ne récupérer par exemple que les commandes qui ont été payées dans une période donnée. Il faut noter que les filtres sur date ne prennent en compte que la date, et pas l’heure qui pourrait être précisée.
La réponse d’un GetOrders se compose d’une liste de lignes de commande (une commande pouvant contenir plusieurs lignes de commandes).
Les informations particulièrement importantes sont :
- OrderID : identifiant Neteven de la commande
- OrderLineID : identifiant Neteven de la ligne de commande
- ShippingAddress : informations nécessaires à la livraison
Les identifiants Neteven (commande et ligne de commande) sont importants car c’est grâce à eux que vous pourrez mettre à jour les informations relatives à ces ventes (notamment la confirmation d’expédition).
Il est à noter que certaines informations (notamment celles concernant les adresses) possèdent des restrictions liées aux places de marché concernées, citons par exemple :
- Pixmania : date de paiement non horodatée + civilité non renseignée
- eBay : concaténation du nom et prénom de l’acheteur dans un champ unique
- PriceMinister : mail générique pour tous les clients
Paramètres d'entrée :
Résultats de la méthode : Liste d’éléments MarketPlaceOrder
Description du type de donnée MarketPlaceAddress :
Extrait d’un script PHP5 : Exécution d’une requête GetOrders pour afficher le SKU des produits commandés
