GET /orders/

Dies ist der Haupteingang unserer API! Dieser Endpunkt liefert Ihnen eine Liste aller Ihrer Bestellungen. Ergänzen Sie diese GET-Anfrage mit Parametern/Filtern um genau das zu bekommen, wonach Sie suchen. 

• Schauen Sie sich unsere Anwendungsfälle an, um alle Anfragetypen zu finden, die Sie senden können.
• Gehen Sie zu einem typischen GET-Bestell-API-Antwort
  
  

Konventionen

Finden Sie unten einige Konventionspunkte, die Sie kennen sollten, bevor Sie eine Anfrage an die Lengow API stellen.

• 1. Pagination

Der Bestell-Endpunkt unterstützt Pagination. Wenn weggelassen, ist der Standardwert für die Seite 1.
Die API kann anzeigen maximal 100 Ergebnisse pro Seite mit dem Parameter page_size. 

Beispiel: 
/orders/?account_id=1 → Seite 1 - implizit (standardmäßig)
/orders/?account_id=1&page=5&page_size=50 → Seite 5 - explizit (5 Seiten mit max 50 Ergebnissen pro Seite)

• 2. Sortierung

Sie können die Sortierung der Ergebnisse mit dem Sortierungsparameter steuern. Um die Sortierung umzukehren, können Sie Ihr Feld mit -Liste der unterstützten Sortierungsfelder hier voranstellen.  

Die Standard-Sortierung ist:Marktplatz-Bestelldatum des Marktplatzes-importiert_am
Beispiel:  /orders/?account_id=1&Sortierung=Marktplatz,-aktualisiert_am

• 3. Abfrageparameter (Filterung)

Sie können Abfrageparameter mit Ihren Anfragen senden, indem Sie das URL-Feld und den Params-Tab verwenden.
account_id ist ein obligatorischer Parameter. Verwenden Sie ihn für jede Anfrage/Aktion, die Sie an die API senden
Diese Abfrageparameter helfen Ihnen, zum Beispiel eine spezifische Bestellung zu erhalten, indem Sie den "&marketplace_order_id" hinzufügen oder alle Bestellungen von einem spezifischen Marktplatz erhalten.Beispiel: /orders/?account_id=1&Marktplatz=menlook 

• 4.  Änderung der Währung

Standardmäßig werden alle Betragsfelder in der Währung Ihres Kontos zurückgegeben.

Wenn Sie die Währung ändern möchten, können Sie den set_currency-Parameter verwenden. Der Wert muss als drei Zeichen (ISO 4217) angegeben werden.
Beispiel:  /orders/?account_id=1&set_currency=USD  

Typische GET-Bestell-API-Antwort

Beispiel für eine API-Antwort:

{
"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": "Versendet",
"lengow_status": "versendet",
"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": "Britisches Pfund"
},
"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": "Andere: 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": "Versendet",
"lengow_status": "versendet",
"title": "Produkt TEST",
"category": null,
"url_product": nu:l,
"url_image": null,
"order_line_meta": {
},
"Betrag": "806.69",
"Steuer": "134.45",
"Rabatt": null,
"Versand": "2.60",
"ursprünglicher_Betrag": "699.00",
"ursprüngliche_Steuer": "116.50",
"ursprünglicher_Rabatt": null,
"ursprünglicher_Versand": "2.25",
"Menge": 1,
"erstellt_am": null,
"aktualisiert_am": null
}
],
"Lieferung": {
"id": 1,
"Typ": "Lieferung",
"erste_Zeile": "1 Rue de la Paix",
"Postleitzahl": "44",
"Stadt": "Nantes",
"Firma": null,
"Anrede": null,
"Vorname": null,
"Nachname": null,
"zweite_Zeile": null,
"Ergänzung": null,
"Telefon_Zuhause": null,
"Telefon_Büro": null,
"Handy": null,
"vollständige_Adresse": null,
"vollständiger_Name": "Dupont",
"E-Mail": "test@lengow.amazon.co.uk",
"Metas": null,
"Bundesland_Region": "",
"allgemeiner_Ländercode_iso_a2": "GB",
"Sendungsverfolgungen": [
{
"Nummer": null,
"Methode": "Standard",
"Spediteur": null,
"url": null,
"wird_vom_Marktplatz_geliefert": true,
"Paketgewicht": null,
"versendet_am": null,
"Relais": {
"Name": null,
"id": null
},
"Marktplatz_Bestellzeilen-IDs": [
"Zeile1"
]
}
]
}
}
],
"Rechnungsadresse": {
"id": 2,
"Typ": "Rechnung",
"erste_Zeile": null,
"Postleitzahl": "44",
"Stadt": "Nantes",
"Firma": null,
"Anrede": null,
"Vorname": null,
"Nachname": null,
"zweite_Zeile": null,
"Ergänzung": null,
"Telefon_Zuhause": null,
"Telefon_Büro": null,
"Handy": null,
"vollständige_Adresse": null,
"vollständiger_Name": "Dupont",
"E-Mail": "test@lengow.amazon.co.uk",
"Metas": null,
"Bundesland_Region": "",
"allgemeiner_Ländercode_iso_a2": "GB"
},
"Kontaktadresse": null,
"importiert_am": "2019-03-22T20:05:35.196060Z",
"aktualisiert_am": "2019-03-25T11:48:09.071000Z",
"Bestellmeta": {
"Prüfsumme": "fffffffggghghhgu"
},
"anonymisiert": false
}
]
}

In der Antwort finden Sie mehrere Elemente, die vom Marktplatz gesendet wurden, alle in verschiedenen Objekten mit mehreren Variablen klassifiziert.

Alle Details der vom Marktplatz gesendeten Bestellung, wie die Marktplatz-Bestell-ID, Marktplatz-Status (Status der Bestellung), Gesamtbestellung, Marktplatz-Bestelldatum helfen Ihnen, Maßnahmen für Ihre Bestellung zu ergreifen.

Alle Bestellartikel, die Teil der Bestellung sind. Es kann nur ein Artikel sein (falls der Kunde nur 1 Artikel bestellt), oder mehr, falls der Kunde mehr als einen Artikel innerhalb der gleichen Kundenbestellung bestellt.

Liste der unterstützten Parameter

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

Finden Sie unten die Liste der möglichen Parameter, die Sie Ihren Anfragen für diesen Endpunkt hinzufügen können, um Ergebnisse zu filtern:

• Konto-ID: ID Ihres Lengow-Kontos. Obligatorischer Filter. Verwenden Sie ihn für jede Anfrage oder Aktion
• Marktplatz: Name des Marktplatzes, kann mehrere sein, aber trennen Sie sie mit Komma. Beispiel: "amazon_uk", oder "amazon_uk,darty"  
• Marktplatz-Bestell-ID: ID der Bestellung
• Händler-Bestell-ID
• Lengow-Status: Der Lengow-Status, kann ein oder mehrere Status sein, aber trennen Sie sie mit Komma. Beispiel: "versendet", "versendet, Warte auf Versand"
• Marktplatz-Status
• Lengow-Zeilenstatus: Um Bestellungen mit mindestens einer Bestellzeile im angeforderten Status zu erhalten. Beispiel: "lengow_line_status=erstattet"
• Marktplatz-Bestelldatum_von:  Obligatorisch. Standardmäßig auf aktueller Tag - 7 Tage eingestellt. 
• Marktplatz-Bestelldatum_bis:  Standardmäßig auf den aktuellen Tag eingestellt.
• order_type: Beispiel: "is_business", "is_business, is_express"
• imported_from
• imported_to
• updated_from
• updated_to
• set_currency

Alle Aktionen bei Bestellungen abrufen

{
"id": 123456789,
"marketplace_order_id": "306-1234567-1234567",
"account_id": 1,
"marketplace": "amazon_de",
"action_type": "ship",
"processed": true,
"queued": false,
"tracking_number": "05348000966072J",
"tracking_url": null,
"carrier": "DPD",
"custom_carrier": null,
"line": "39751459711155",
"declared_value": null,
"currency_code": null,
"invoice_number": null,
"shipping_method": "DPD",
"shipping_date": "2020-10-28T14:35:07+01:00",
"shipping_service_id": null,
"shipping_service_offer_id": null,
"created_at": "2020-10-28T13:35:07.301140Z",
"updated_at": "2020-10-28T13:38:19.909097Z",
"weight": null,
"weight_unit": null,
"comment": null,
"delay": null,
"reason": null,
"charges": null,
"errors": "Die Sendungsverfolgungs-ID 05348000966072J für DPD entspricht nicht dem erwarteten Format des Spediteurs. Bitte überprüfen Sie, ob Sie die Sendungsverfolgungs-ID und den Namen des Spediteurs korrekt eingegeben haben.",
"delivery_date": null,
"delivery_experience": null,
"return_tracking_number": null,
"refund_price": null,
"refund_shipping_price": null,
"refund_mode": null,
"refund_reason": null,
"refund_quantity": null,
"refund_shipping": null,
"refund_shipping_taxes": null,
"refund_taxes": null,
"carrier_name": null,
"carrier_pickup": null,
"package_dimension_length": null,
"package_dimension_width": null,
"package_dimension_height": null,
"package_dimension_unit": null,
"from_address_name": null,
"from_address_line": null,
"from_address_city": null,
"from_address_state_province": null,
"from_address_postal_code": null,
"from_address_country_code": null,
"from_address_mail": null,
"from_address_phone": null,
"pickup_id": null,
"refund_id": null,
"return_carrier": null
},

Eine Aktion bei einer Bestellung erstellen

POST /orders/actions/
Mit diesem Endpunkt können Sie Aktionen bei Ihren Bestellungen durchführen.

• Hier können Sie eine Bestellung versenden, stornieren oder erstatten, wenn diese Aktionen vom Marktplatz akzeptiert werden.