In den letzten Monaten haben wir unter anderem an der Erneuerung unserer DHL Integration bzw. des Plugins gearbeitet. Dies beinhaltet zum einen die Umstellung auf die DHL REST API, zum anderen die Überführung des Assistenten in den Menübaum.

Warum der Technologiewechsel (REST API)?

DHL macht den Schritt zur neuen Technologie und wir gehen mit! Die vorher verwendete Technologie (DHL SOAP-Schnittstelle) hat DHL bereits abgekündigt und die Abschaltung der Version 1 erfolgt Mitte 2024.
Mit dem frühen Wechsel zu REST ermöglichen wir euch eine längere “Testphase”, da die effektive Abschaltung der alten Schnittstelle mit der Version 3, auf der wir laufen, noch einige Zeit in der Zukunft ist. Aber mit dem Umstieg stehen euch neue Funktionen zur Verfügung, die nur über REST möglich sind und zukünftige Features werden von DHL nur noch für REST ausgerollt werden. Wir möchten euch also die bestmögliche Lösung für die Zusammenarbeit mit DHL anbieten.

Neben den Vorteilen für euch kommen für uns als Integrator noch Flexibilität, Performance und Skalierbarkeit hinzu.

Warum wandern die Einstellungen?

Generell gehen wir den Schritt von den Assistenten zum Menübaum, wie hier beschrieben.

Neben der Tour führen wir auch weitere Features ein, die mit der REST API möglich sind, wie z.B. das Importieren von Abrechnungsnummern mit dem (GKP) Buchungstext.

Wir planen, eine bessere Verständlichkeit und leichteres Arbeiten mit den Einstellungen ohne einen plötzlichen Cut /Unterschied zum bekannten Assistenten zu schaffen

Wo finde ich die Einstellungen?

Die neuen Menüs sind unter Einrichtung → Aufträge → Versand → Dienstleister → DHL Versenden zu finden.

• Grundeinstellungen

  • Erfassung der Zugangsdaten zum Geschäftskundenportal, Abrechnungsnummern und Absenderadressen

• Versandeinstellungen

  • Konfiguration der Grundeinstellung zu Versandprofil und -Region, sowie spezifischen Services

• Migration der Versandeinstellungen

  • Wechsel zwischen Verwendung von REST oder SOAP

Was bedeutet es für euch?

In der nächsten Zeit werdet ihr ein Menü zu DHL im plenty-Backend sehen, mit dem ihr den Wechsel zur REST API aber auch wieder zurück zur SOAP API durchführen könnt.

Die Einstellungen, die ihr bereits mit dem Assistenten vorgenommen habt, werden in den Menübaum übernommen, wenn ihr das “Migrationsmenü” benutzt.
Wichtig: Es ist nicht möglich, REST und SOAP gleichzeitig zu verwenden, beispielsweise durch verschiedene Plugin-Sets.

Beachte: Die Daten aus dem Assistenten werden übernommen, bei einem Wechsel von REST zurück zu SOAP werden die alten Daten wiederhergestellt, Änderungen die im Menübaum vorgenommen wurden, werden wieder gelöscht.

Wann muss/sollte ich auf REST wechseln?

Aktuell könnt ihr weiterhin mit dem bestehenden Plugin arbeiten. DHL hat, wie oben erwähnt, die SOAP API abgekündigt und die erste Stufe tritt Mitte 2024 in Kraft. Ein Wechsel zu REST ist derzeit nicht notwendig. Wir behalten uns vor, unsere SOAP Implementierung mit entsprechender Vorlaufzeit ebenfalls abzukündigen.

Kann ich den Wechsel vorher testen?

Sehr gerne, damit ist uns und euch geholfen. In der Anfangsphase mit Absprache haben wir die Möglichkeit, die bestehenden Einstellungen zu prüfen, um Unstimmigkeiten durch den Wechsel angehen zu können.

In unseren Tests versuchen wir alle Fälle abzudecken, aber es ist leider immer möglich, dass wir bestimmte Einstellungskonstellationen nicht besitzen / kennen und Fehler bei der Migration der Daten auftreten.

Der Wechsel zwischen den beiden APIs ist möglich und wir empfehlen, diese bei euch zu testen und nicht auf den letzten möglichen Tag zu warten.