• 3. Paramètres de requêtes (filtres)

Vous pouvez ajouter des paramètres de filtres (des variables) à vos requêtes directement dans l'URL de votre appel ou en utilisant l'onglet Paramètres (postman). 

"account_id" est un paramètre obligatoire. Utilisez-le pour toute demande/action que vous envoyez à l'API 
Ces paramètres de requête vous aideront à affiner vos résultats, par exemple, en ajoutant le "&marketplace_order_id". ou à obtenir toutes les commandes d'un marché spécifique.

/orders/?Account_id=1 &marketplace_order_id=123456789   

• 4.  Changer la monnaie

Par défaut, tous les champs de montant sont renvoyés dans la devise de votre compte Lengow. 

Si vous souhaitez modifier la devise, vous pouvez utiliser le paramètre set_currency. 

La valeur doit être spécifiée sous forme de trois caractères  (ISO 4217) 
Exemple:  /orders/?account_id=1&set_currency=USD 

 

Exemple de réponse API

Voici un exemple de réponse API :

{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"marketplace": "amazon_uk",
"account_id": 1,
"marketplace_country_iso2": "GB",
"marketplace_order_id": "order1",
"merchant_order_id": null,
"marketplace_status": "Shipped",
"lengow_status": "shipped",
"workflow_rank": 6,
"marketplace_order_date": "2019-03-22T17:54:34.369000Z",
"total_order": 809.2900000000001,
"total_tax": "134.45",
"shipping": 2.6,
"discount": 0,
"commission": "-56.47",
"processing_fee": null,
"currency": {
"iso_a3": "EUR",
"symbol": "€",
"name": "Euro"
},
"original_currency": {
"iso_a3": "GBP",
"symbol": "£",
"name": "British Pound"
},
"original_total_order": 701.25,
"original_total_tax": "116.50",
"original_shipping": 2.25,
"original_discount": 0,
"original_commission": "-48.93",
"original_processing_fee": null, 
"comments": null,
"invoice_number": null,
"invoice_url": null,
"payments": [
{
"id": 1,
"checkout": null,
"status": null,
"type": "Other: Standard",
"settled_at": null,
"payment_terms": null,
"channel_order_marketplace": 1
}
],
"packages": [
{
"cart": [
{
"id": 1,
"marketplace_order_line_id": "line1",
"marketplace_product_id": "product1",
"merchant_product_id": {
"field": "ID_PRODUCT",
"id": "Product1"
},
"feed_id": 1,
"marketplace_package_id": null,
"marketplace_status": "Shipped",
"lengow_status": "shipped",
"title": "Product TEST",
"category": null,
"url_product": null,
"url_image": null,
"order_line_meta": {
},
"amount": "806.69",
"tax": "134.45",
"discount": null,
"shipping": "2.60",
"original_amount": "699.00",
"original_tax": "116.50",
"original_discount": null,
"original_shipping": "2.25",
"quantity": 1,
"created_at": null,
"updated_at": null
}
],
"delivery": {
"id": 1,
"type": "delivery",
"first_line": "1 Rue de la Paix",
"zipcode": "44",
"city": "Nantes",
"company": null,
"civility": null,
"first_name": null,
"last_name": null,
"second_line": null,
"complement": null,
"phone_home": null,
"phone_office": null,
"phone_mobile": null,
"full_address": null,
"full_name": "Dupont",
"email": "test@lengow.amazon.co.uk",
"metas": null,
"state_region": "",
"common_country_iso_a2": "GB",
"trackings": [
{
"number": null,
"method": "Standard",
"carrier": null,
"url": null,
"is_delivered_by_marketplace": true,
"parcel_weight": null,
"shipped_at": null,
"relay": {
"name": null,
"id": null
},
"marketplace_order_line_ids": [
"line1"
]
}
]
}
}
],
"billing_address": {
"id": 2,
"type": "billing",
"first_line": null,
"zipcode": "44",
"city": "Nantes",
"company": null,
"civility": null,
"first_name": null,
"last_name": null,
"second_line": null,
"complement": null,
"phone_home": null,
"phone_office": null,
"phone_mobile": null,
"full_address": null,
"full_name": "Dupont",
"email": "test@lengow.amazon.co.uk",
"metas": null,
"state_region": "",
"common_country_iso_a2": "GB"
},
"contact_address": null,
"imported_at": "2019-03-22T20:05:35.196060Z",
"updated_at": "2019-03-25T11:48:09.071000Z",
"order_meta": {
"checksum": "fffffffggghghhgu"
},
"anonymized": false
}
]
}

Dans cet exemple de réponse, vous trouverez plusieurs éléments envoyés par la marketplace, tous classés dans différents objets avec plusieurs paramètres/variables. 

Tous les détails de la commande envoyée par la marketplace tels que marketplace_order_id, marketplace_status (statut de la commande), total_order, marketplace_order_date vous aideront à agir sur votre commande. 

Dans cet exemple vous voyez tous les produits de la commande et ceux qui font partie de la commande. Il peut n'y avoir qu'un seul produit (dans le cas où le client commande un seul produit), ou plusieurs dans le cas où le client commande plus d'un produit. 

Liste des paramètres acceptés

GET /orders/?account_id=1&marketplace=amazon_uk,darty

Retrouvez ci-dessous la liste des paramètres/filtres possibles que vous pouvez ajouter à vos requêtes pour le endpoint /orders de notre API :

• account_id:  identifiant de votre compte Lengow. obligatoire. Utilisez-le pour toute demande ou action.
• marketplace_order_date_from:  Obligatoire. Par défaut, défini sur le jour actuel - 7 jours.
• marketplace: nom de la marketplace, peut être multiple mais séparez-les par une virgule Exemple: "amazon_uk", ou "amazon_uk,darty"  
• marketplace_order_id: ID de la commande
• merchant_order_id
• lengow_status: Le statut Lengow. Séparer par une virgule si multiples. Exemples : "shipped", "shipped, waiting_shipment"
• marketplace_status
• lengow_line_status: Liste les commandes comportant au moins une ligne au statut demandé. Exemple : "lengow_line_status=refunded"
• marketplace_order_date_to:  Par défaut défini sur le jour actuel 
• order_type: Exemple: "is_business", "is_business, is_express"
• imported_from
• imported_to
• updated_from
• updated_to
• set_currency