PostNords Delivery Options API

Die Delivery Options API von PostNord stellt einfach zu verwendende Versandoptionen für die Produkte von PostNord bereit. Jede von der Delivery Options API bereitgestellte Versandoption enthält die Informationen, die erforderlich sind, um die beste Option auszuwählen, die sowohl den Präferenzen des Absenders als auch des Empfängers entspricht. Zu diesen Informationen gehören:

• Wann der Empfänger das Paket erhält – Lieferzeit.
• Wohin das Paket geliefert wird, z. B. an eine Paketbox oder einen Service Point.

Auftragsbearbeitung

Die von der Delivery Options API von PostNord bereitgestellte Lieferzeit basiert unter anderem auf dem Auftragsbearbeitungsprozess des Absenders. Die Auftragsbearbeitung kann sich zwischen den einzelnen Lagern des Absenders unterscheiden.

Voraussetzungen

Um eine Lieferzeit von PostNord zu erhalten, muss der Absender eines der folgenden Felder zur Auftragsbearbeitung angeben (der Name in Klammern entspricht der Bezeichnung in der Delivery Options API von PostNord):

• timeoflatestorder (timeOfLatestOrder): Die späteste Uhrzeit des Tages, zu der eine Bestellung aufgegeben werden kann, damit sie noch am selben Tag versendet wird. Dieses Feld kann als Annahmeschluss oder Stoppzeit betrachtet werden.
  Geeignet für: Absender mit einer einzigen Abholung pro Tag.
   
• handovertime (handOverTime): Datum und Uhrzeit, zu der die Bestellung an PostNord übergeben wird. Der Absender muss die Kommissionier- und Verpackungszeit berücksichtigen, damit die Bestellung garantiert zum angegebenen handOverTime an PostNord übergeben wird.
  Geeignet für: Absender mit mehreren täglichen Abholungen, die die nächste Abholzeit dynamisch übermitteln können. Außerdem kann ein Datum und eine Uhrzeit bis zu 14 Tage in der Zukunft angegeben werden.
   
• readyforpickupdaysinterval (daysUntilOrderIsReady): Wenn der Absender seinen Auftragsbearbeitungsprozess nicht genau angeben kann, kann daysUntilOrderIsReady verwendet werden, um einen Zeitraum anzugeben, wie lange die Bearbeitung der Bestellung dauert, bis sie zur Abholung bereit ist. daysUntilOrderIsReady eignet sich auch für Zeiten mit hohem Bestellaufkommen, wie beispielsweise Black Friday.

Im Artikel Carrier ETA (voraussichtliche Lieferzeit) finden Sie Beispiele dafür, wie Carrier ETA-Funktionen verwendet werden können, wenn Sie die Texte erstellen, die in Ihrer Delivery Checkout angezeigt werden. Beachten Sie, dass die advanced conditions in der Konfiguration aktiviert sein müssen, an der Sie arbeiten.

Übermitteln Sie im Aufruf GET /delivery-checkouts den Parameter für die Auftragsbearbeitung mit dem gewünschten Wert.

Es ist auch möglich, Standardwerte für alle verfügbaren Auftragsbearbeitungsarten festzulegen. Dies erfolgt auf der Seite zur Bearbeitung der Delivery Checkout im Abschnitt für Parameter. Klicken Sie auf den Pfeil links neben dem Parameter, für den Sie einen Standardwert festlegen möchten: timeoflatestorder, handovertime oder readyforpickupdaysinterval (entspricht daysuntilorderis ready). Anschließend können Sie unterhalb der Parametertabelle Standardwerte für diesen Parameter festlegen. Denken Sie daran, auf Speichern zu klicken, um den Standardwert zu übernehmen.

Customer key

Der Customer key ist eine eindeutige Kundenkennung, die von nShift im Format „nshift-sendingCompanyName“ generiert wird, wobei sendingCompanyName der Name des Absenders ist. Dieser generische Customer key reicht aus, um die verschiedenen in der Delivery Options API verfügbaren Auftragsbearbeitungsarten zu nutzen.

Kontaktinformationen

Bei allgemeinen Fragen zur Delivery Options API wenden Sie sich bitte an PostNord Customer Integration: kundintegration@postnord.com