Paketverfolgung

Jede Händler-Bestellung kreiert eine Sendungs-Resource, sobald sie verschickt wurde. Diese Resource wird dazu verwendet, Informationen bezüglich der Sendungsverfolgung bereitzustellen.


Sendung

Wird eine Händler-Bestellung als „bearbeitet“ markiert, wird eine Standard-Sendung erstellt. Diese Sendungs-Resource wird in nachfolgendem Call beschrieben:

  
  GET {{api_url}}/v1/parcel/schema/

Um die Sendung einer Händler-Bestellung abzurufen:

  
  GET {{api_url}}/v1/parcel/?merchant_order={{MERCHANT_ORDER_ID}}

Um die Sendung einer Händler-Bestellung zu bearbeiten und die Tracking Nummer hinzuzufügen:

  
  PATCH {{api_url}}/v1/parcel/{{PARCEL_ID}}/

mit dem Quelltext:

  
  {
    "tracking_number": "my tracking number"
  }

Hinweis :

Es ist möglich, auch andere Informationen über die Sendung mit diesem Call zu aktualisieren. Dazu müssen Sie diese einfach im Quelltext hinzufügen.

Um eine Sendung zu verschicken:

  
  POST {{api_url}}/v1/parcel/{{PARCEL_ID}}/ship/

mit einem leeren Quelltext.


Die Versandoptionen einer Händler-Bestellung auflisten

Verwenden Sie folgenden Call, um das/die Transportunternehmen und Versandoptionen abzurufen:

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


Eine neue Sendung erstellen

Sendungserstellung:

  
  POST {{api_url}}/v1/parcel/

mit dem Quelltext:

  
  {
    "application": "/v1/application/{{APPLICATION_ID}}/",
    "carrier": "/v1/carrier/{{CARRIER_ID}}/",
    "merchant_order": "/v1/merchant_order/{{MERCHANT_ORDER_ID}}/",
    "order_shipping_choice": "/v1/order_shipping_choice/{{ORDER_SHIPPING_CHOICE_ID}}/",
    "tracking_number": "my-tracking-number"
  }

was bedeutet:

  • MERCHANT_ORDER_ID: Die ID der Händler-Bestellung
  • ORDER_SHIPPING_CHOICE_ID: Die ID der Versandoption in der entsprechenden Sektion aufgerufen


Einen Artikel zu einer Sendung hinzufügen: Sendungsauftrag erstellen

Es ist möglich, einen Artikel mit folgender Anfrage einer Sendung hinzuzufügen:

  
  POST {{api_url}}/v1/parcel_assignment/

mit dem Quelltext:

  
  {
    "parcel": "/v1/parcel/{{PARCEL_ID}}/",
    "order_item": "/v1/order_item/{{ORDER_ITEM_ID}}/",
    "quantity": 1
  }


Einen Artikel aus einer Sendung entfernen: Sendungsauftrag löschen

Es ist möglich, einen Artikel mit folgender Anfrage aus einer Sendung zu entfernen:

  
  DELETE {{api_url}}/v1/parcel_assignment/{PARCEL_ASSIGNMENT_ID}

mit einem leeren Quelltext.


Eine Sendung löschen

Es ist möglich, eine Sendung mit folgender Anfrage zu löschen:

  
  DELETE {{api_url}}/v1/parcel/{PARCEL_ID}

mit einem leeren Quelltext.

Hinweis :

Es ist nicht möglich, eine Sendung zu löschen, wenn diese bereits als „versendet“ markiert wurde.