Händler-Bestellung

Die Händler-Bestellung ist die Resource, die dazu genutzt wird, eine Bestellung innerhalb des Marktplatzes zu verwalten. Es ist möglich, sie aufzurufen und zu bearbeiten. Wie Sie im Normalfall eine Bestellung verwalten, wird in nachfolgender Grafik dargestellt:


Status der Händler-Bestellung

StatusCode(Üblicherweise) angestoßen von
Bezahlung autorisiert60Applikation
Bestätigt80Händler
Storniert2000Händler ODER Applikation
Bearbeitet85Händler
Abgeschlossen110Applikation


Händler-Bestellung aufrufen

Muss mit einem Händler-Token gemacht werden:

  
  GET {{api_url}}/v1/merchant_order/?status=60

Die Antwort wird Folgendes enthalten:

 
   {
  "meta": {
      "limit": 20,
      "next": null,
      "offset": 0,
      "previous": null,
      "total_count": 1
  },
  "objects": [
      {
          "amount": "810.00",
          "amount_vat_included": "972.00",
          "amount_vat_included_before_discount": "972.00",
          "app_discount_amount": "0.00000",
          "app_discount_amount_on_items_vat_included": "0.00",
          "app_discount_amount_on_shipping_vat_included": "0.00",
          "app_discount_amount_vat_included": "0.00",
          "application": {
              "id": 75,
              "name": "test",
              "namespace": "test",
              "pk": 757,
              "resource_uri": "https://api.sandbox.iceberg.technology/v1/application/75/"
        },
          "attributes": {},
          "auto_cancelling_date": null,
          "billing_address": {
              "address": "77 rue de la boetie",
              "address2": "",
              "city": "paris",
              "country": {
                  "code": "FR",
                  "id": 72,
                  "name": "France"
              },
              "first_name": "pavoit",
              "fiscal_number": null,
              "id": 35760,
              "last_name": "sebastien",
              "name": "My address",
              "phone": "012345678",
              "resource_uri": "https://api.sandbox.iceberg.technology/v1/address/35760/",
              "state": null,
              "status": "10",
              "zipcode": "75008"
          },
          "created_on": "2017-03-23T15:36:03+01:00",
          "currency": {
              "code": "EUR",
              "pk": "EUR",
              "resource_uri": "https://api.sandbox.iceberg.technology/v1/currency/EUR/"
          },
          "customer_invoices": [
              {
                  "id": 1004,
                  "pk": 1004,
                  "resource_uri": "https://api.sandbox.iceberg.technology/v1/customer_invoice/1004/"
              }
          ],
          "debug": false,
          "discount_amount": "0.00000",
          "discount_amount_vat_included": "0.00",
          "eco_tax": "0.00",
          "eco_tax_vat_included": "0.00",
          "entered_discount_codes": [],
          "external_id": null,
          "external_manager": null,
          "external_manager_id": null,
          "external_manager_status": null,
          "extra_data": null,
          "id": 34865,
          "incident_status": "pending_merchant",
          "items": [
              {
                  "amount": "800.000000",
                  "amount_vat_included": "960.00",
                  "bundled": false,
                  "color": "",
                  "currency": {
                      "code": "EUR",
                      "pk": "EUR",
                      "resource_uri": "https://api.sandbox.iceberg.technology/v1/currency/EUR/"
                  },
                "discount_amount_financed_by_application_with_tax": "0.00",
                  "discount_amount_vat_included": "0.00",
                  "discounts": [],
                  "external_id": null,
                  "gift": false,
                  "gtin": "",
                  "id": 78103,
                  "item_image_url": "",
                  "item_type": "product",
                  "name": "Veste",
                  "offer_absolute_url": "",
                  "offer_external_id": null,
                  "offer_id": 1522879,
                  "previous_price": 0,
                  "previous_price_without_vat": 0,
                  "price": "800.000000",
                  "product": {
                      "id": 2778359,
                      "pk": 2778359,
                      "resource_uri": "https://api.sandbox.iceberg.technology/v1/product/2778359/"
                  },
                  "product_id": 2778359,
                  "product_offer": {
                      "id": 1522879,
                      "pk": 1522879,
                      "resource_uri": "https://api.sandbox.iceberg.technology/v1/productoffer/1522879/",
                      "stock": 99
                  },
                  "quantity": 1,
                  "resource_uri": "https://api.sandbox.iceberg.technology/v1/order_item/78103/",
                  "shipping": "0.00",
                  "shipping_speed": "standard",
                  "size": "",
                  "sku": "sebsku5",
                  "status": "120",
                  "status_localized": "Return in progress",
                  "variation": "",
                  "variation_external_id": "",
                  "variation_kind": "",
                  "variation_sku": "",
                  "variation_stock": null,
                  "vat": "160.000000"
              }
          ],
          "items_count": 1,
          "last_modified": "2017-10-08T21:08:49.633753+02:00",
          "merchant": {
              "id": 8600,
              "name": "Marchand Sandbox 2",
              "resource_uri": "https://api.sandbox.iceberg.technology/v1/merchant/8600/",
              "slug": "marchand_sandbox_2"
          },
          "merchant_comment": "",
          "order": {
              "cart_id": 89639,
              "created_on": "2017-03-23T15:36:03+01:00",
              "external_id": null,
              "id": 26596,
              "id_number": "170323V1265964",
              "last_updated": "2017-05-11T17:22:53+02:00",
              "payment": {
                  "collected_amount": "1037.20",
                  "external_id": null,
                  "id": 34604,
                  "payment_backend": "external",
                  "remaining_to_collect": "0.00",
                  "status": "100",
                  "status_localized": "Partially Refunded"
              },
              "resource_uri": "https://api.sandbox.iceberg.technology/v1/order/26596/",
              "shipping_speed": "standard",
              "status": "120",
              "status_localized": "Return in progress"
          },
          "price": "800.00",
          "price_vat_included": "960.00",
          "received": null,
          "refunded_amount": "0.00",
          "resource_uri": "https://api.sandbox.iceberg.technology/v1/merchant_order/34865/",
          "shipping": "10.00",
          "shipping_address": {
              "address": "77 rue de la boetie",
              "address2": "",
              "city": "paris",
              "country": {
                  "code": "FR",
                  "id": 72,
                  "name": "France"
              },
              "first_name": "pavoit",
              "fiscal_number": null,
              "id": 35760,
              "last_name": "sebastien",
              "name": "My address",
              "phone": "0123456789",
              "resource_uri": "https://api.sandbox.iceberg.technology/v1/address/35760/",
              "state": null,
              "status": "10",
              "zipcode": "75008"
          },
          "shipping_vat_included": "12.00",
          "starred": false,
          "status": "120",
          "status_localized": "Return in progress",
          "user": {
              "display_name": "pavoit sebastien",
              "email": "",
              "first_name": "pavoit",
              "id": 27541,
              "last_name": "sebastien",
              "resource_uri": "https://api.sandbox.iceberg.technology/v1/user/27541/",
              "username": "pavoit_sebastien"
          },
          "vat": "162.00",
          "vat_on_eco_tax": "0.00",
          "vat_on_products": "160.00",
          "vat_on_shipping": "2.00",
          "vat_rate_on_shipping": "20.00"
      }
  ]
  }

was (für jeden zurückgegebenen Artikel) bedeutet:

  • id: Die ID/Kennung der Händler-Bestellung
  • status: Der Status der Händler-Bestellung
  • external_id: Die externe ID/Kennung der Händler-Bestellung

Hauptfilter:

  • status
  • external_id


Einen Artikel der Händler-Bestellung stornieren

  
  POST {{api_url}}/v1/order_item/{{ITEM_ID}}/cancel/

mit einem leeren Quelltext.


Eine Händler-Bestellung stornieren

  
  POST {{api_url}}/v1/merchant_order/{{MERCHANT_ORDER_ID}}/cancel/

mit einem leeren Quelltext.


Eine Händler-Bestellung bestätigen

  
  POST {{api_url}}/v1/merchant_order/{{MERCHANT_ORDER_ID}}/confirm/

mit einem leeren Quelltext.

Hinweis :

So bestätigen Sie Teile einer Händler-Bestellung:
Stornieren Sie die betroffenen Artikel bevor Sie die restliche Händler-Bestellung im Anschluss bestätigen.


Eine Händler-Bestellung als „bearbeitet“ markieren

  
  POST {{api_url}}/v1/merchant_order/{{MERCHANT_ORDER_ID}}/process/

mit einem leeren Quelltext.


Einen Artikel der Bestellung bearbeiten

  
  POST {{api_url}}/v1/order_item/{{ITEM_ID}}/process/

mit einem leeren Quelltext.

Hinweis :

Bearbeitungsschritte sind nur innerhalb einer Bestellung markierende Vorgänge. Sie stoßen die Initialisierung von Sendungen an. Sendungen beinhalten die Informationen zum Tracking und Versand der Produkte (weitere Informationen dazu finden Sie unter „Paketverfolgung„).


Die Status-Historie der Händler-Bestellung auflisten

  
  GET {{api_url}}/v1/merchant_order/{{MERCHANT_ORDER_ID}}/logs/


Die Versandadresse abfragen

Die Versandadresse ist ein Attribut der Händler-Bestellung, welche unterhalb beschrieben wird.

In Sonderfällen verwendet der Marktplatz das Options-Attribut shipping_option resource, um die Adresse für ein „Click and Collect“-Angebot zu speichern. Um diese Information abzurufen, nutzen Sie bitte den folgenden API-Call:

  
  GET {{api_url}}/v1/merchant_order/{{MERCHANT_ORDER_ID}}/shipping_options/

Das Options-Attribut von dem bereitgestellten Produkt beinhaltet ergänzende und hilfreiche Informationen. So bitten Sie den Marktplatz-Operator die Produkt-Struktur für Sie freizuschalten:

  
  ...
  "options": {
  "address1": "60 rue du stade",
  "address2": "  ",
  "addressName": "Domicile",
  "carrierName": null,
  "carrierPickupPointId": null,
  "city": "ORLEANS",
  "company": null,
  "country": "France",
  "countryCode": "FR",
  "email": "[email protected]",
  "firstName": "emely",
  "lastName": "Myname",
  "phone": "123456789",
  ...

Hinweis :

Die Schlüssel der Felder und ihrer Werte folgen keinem Standard.