Die Meldung API version 0 has been sunset zeigt, dass dein System noch die alte DHL-Retoure-API nutzt. Diese wurde zusammen mit dem Plugin DHL Retoure Online zum 31.05.2026 abgeschaltet. Damit du wieder Retourenlabels erstellen kannst, musst du auf die Kernintegration umstellen.

Woran du das Problem erkennst

Beim Anmelden einer Retoure oder beim Erstellen eines Rücksendelabels erscheint eine Fehlermeldung mit "status":410 und "title":"API sunset".

So stellst du auf die Kernintegration um

1. Öffne in deinem PlentyONE System: Einrichtung » Aufträge » Versand » Dienstleister » DHL Versenden » Retoure Online – Einstellungen
2. Lege dort eine neue Konfiguration für DHL Retoure Online an. Bestehende Einstellungen aus dem alten Plugin werden nicht automatisch übernommen.
3. Prüfe, ob das alte Plugin DHL Retoure Online noch aktiv ist. Öffne dazu Daten & Plugins » Plugins » Plugin-Set-Übersicht (alte UI: Plugins » Plugin-Set-Übersicht).
4. Ist das Plugin noch aktiv, deaktiviere es in deinem Plugin-Set und stelle das Plugin-Set einmal bereit.

Solange das alte Plugin aktiv ist, stehen im Versandcenter beide Anmeldungen zur Auswahl. Nach der Deaktivierung und Bereitstellung verschwindet die alte Anmeldung.

Automatisierungen auf Flow umstellen

Ereignisaktionen für DHL Retoure Online funktionieren nicht mehr. Die neue Anbindung lässt sich nur per Flow automatisieren.

1. Öffne Automatisierung » Flow Studio und erstelle einen Flow mit der Flow-Aktion zum Anmelden einer Retoure bei DHL.
2. Führe den Flow einmal manuell an einem Testauftrag aus.
3. Stelle den Flow nach erfolgreichem Test auf Ereignisbasiert.
4. Setze die bisherigen Ereignisse unter Einrichtung » Aufträge » Ereignisse (Legacy) auf inaktiv.

Weiterführende Informationen im Handbuch: https://knowledge.plentyone.com/en-gb/manual/main/fulfilment/dhl-retoure-online.html