Damit du deinen Versandarten DHL Produkte zuordnen und automatisch entsprechende Etiketten erstellen kannst, musst du zunächst einige Einstellungen vornehmen.

Die neue DHL-API (REST) nutzt du mit einer DHL-Plugin-Version, die zu deiner Shopware-Version passt. Wenn dein Shop schon eine passende Version hat, musst du nichts tun.

Für Shopware 6.4 und älter gibt es kein Update des DHL-Plugins. Seit Juni 2026 lassen sich dort keine DHL-Etiketten mehr über Pickware erstellen.

Kannst du Shopware noch nicht aktualisieren, erstellst du DHL-Etiketten übergangsweise direkt im DHL Geschäftskundenportal. So gehst du vor:

Um in Pickware Versandetiketten für DHL zu erstellen, ist ein Zugang zum DHL Geschäftskundenportal erforderlich. Diesen kannst du ab einer Summe von 200 nationalen und/oder internationalen Paketen im Jahr schnell und einfach hier anfordern.

Du kannst direkt bei der Erstellung von DHL Versandetiketten auswählen, dass ein Retourenlabel mit angefügt werden soll. Dabei handelt es sich allerdings um die Beileg-Variante der DHL Retoure, welche eine eigene Abrechnungsnummer benötigt. Solltest du nicht im Besitz einer solchen Abrechnungsnummer sein, wende dich bitte an deinen Ansprechpartner bei DHL.

Pickware unterstützt ausschließlich die DHL Retoure Online. Die Variante DHL Retoure Selbstzahler ist nicht kompatibel und kann daher nicht für die automatische Erstellung von Retourenetiketten verwendet werden.

Wenn für eine Versandart oder ein Produkt dennoch DHL Retoure Selbstzahler hinterlegt wurde, führt dies beim Erstellen eines Versandetiketts zu einer Fehlermeldung. Stelle in diesem Fall sicher, dass die korrekte Retourenart DHL Retoure Online genutzt wird.

Die Beilegeretoure aktivierst du pro Versandart unter Versanddienstleister → Sendungskonfiguration → Beilegeretoure. Sie ist ein eigener DHL-Service, den DHL für dich freischalten muss. Die Beilegeretoure funktioniert auch beim Erstellen von Etiketten über die Mehrfachänderung.

Den Druck der Beilegeretoure kannst du nicht unterdrücken. Möchtest du ein Retourenetikett nur erzeugen, aber nicht drucken, nutze einen Flow mit der Aktion Retourenetikett erstellen.

Für Bestellungen mit DHL Paket International brauchst du kein eigenes Retourenprodukt. Erstellst du an einer solchen Bestellung ein Retourenetikett, verwendet Pickware automatisch DHL Retoure International.

Manche Marktplätze wie OTTO verlangen für jede Bestellung eine Retouren-Sendungsnummer. Mit der Beilegeretoure erzeugst du sie automatisch und gibst sie an den Marktplatz weiter:

Bevor du die Einstellungen für DHL vornimmst, stelle sicher, dass du zuvor die allgemeinen Einstellungen für alle Versanddienstleister vorgenommen hast. Du findest sie unter Einstellungen → Erweiterungen → Versandetiketten allgemein. Die Einstellungen gelten für alle genutzten Versanddienstleister. Alle Details findest du hier.

Unter Einstellungen → Erweiterungen → DHL findest du die Einstellungen speziell für den DHL Versand.

Bei DHL Paket International legst du in der Versandart im Feld Zustellart fest, wie DHL das Paket zustellt. Damit entscheidest du auch, ob ein Premium- oder ein Economy-Label erzeugt wird. Es gibt vier Zustellarten:

Bei DHL Warenpost International gibt es statt der Zustellart den Schalter Premium-Service.

Welche Zustellarten verfügbar sind, hängt vom Zielland ab. Ist die gewählte Zustellart dort nicht verfügbar, kann DHL eine andere verwenden. DHL arbeitet hierfür mit Ländergruppen, die unterschiedliche Regeln verwenden.

In Ländern wie der Schweiz bestimmt die Zustellart, welches Label DHL erzeugt:

In Ländern wie Österreich oder Dänemark sind Premium und Economy an die Art der Zustellung gebunden:

Wählst du für diese Länder Standard oder Economy, erzeugt DHL trotzdem ein Premium-Label, weil an die Haustür nur mit Premium zugestellt wird. Ein Economy-Label bekommst du nur mit der Zustellart Zustellung an die nächste Annahmestelle.

Für einige Länder (bspw. Luxemburg) stellt DHL grundsätzlich keine Economy-Variante zur Verfügung und es wird ausschließlich Premium angeboten. In solchen Fällen erzeugt DHL immer ein Premium-Label, unabhängig von der Zustellart.

Eine detaillierte Übersicht zu den verschiedenen DHL Ländergruppen und Tarifzonen findest du hier.

Mit dem Service Postal Delivered Duty Paid (PDDP) von DHL übernimmst du beim internationalen Versand die Einfuhrabgaben anstelle des Empfängers. PDDP gibt es nur mit dem Produkt DHL Paket International und nur für ausgewählte Zielländer.

Öffne dazu in der Shopware Admin unter Einstellungen → Shop → Versand die entsprechende Versandart, wähle das Produkt DHL Paket International und aktiviere die Optionen Übernahme der Einfuhrabgaben und Exportdokumente erstellen. Einen Incoterm wählst du dafür nicht: Bei DHL Paket International gibt es kein Incoterm-Feld, PDDP läuft allein über Übernahme der Einfuhrabgaben.

In der Versandart kannst du im Abschnitt Allgemein eine Kostenstelle hinterlegen. DHL druckt sie auf das Versandetikett, zum Beispiel um Pakete mehrerer Shops mit einem DHL-Vertrag zu unterscheiden. Erlaubt sind bis zu 50 Zeichen.

Beim Erstellen eines DHL-Versandetiketts gibst du im Feld Einlieferungsdatum an, an welchem Tag du das Paket an DHL übergibst. Ohne Angabe gilt der heutige Tag. Ein Datum in der Vergangenheit lässt sich nicht wählen.

Bei DHL Paket International findest du in der Versandart unter Exportdokumente die Option Papierlose Verzollung. Sie erscheint, sobald Exportdokumente erstellen aktiv ist. Pickware überträgt dann das Zolldokument oder die Handelsrechnung der Bestellung digital an DHL: in die Schweiz für die papierlose Verzollung und in die USA für die Verzollung.

Welchen Dokumenttyp Pickware dafür überträgt, wählst du im Abschnitt Dokumentenübertragung der Versandart. Wie du Dokumente an Bestellungen anhängst, steht in Wie erstelle ich Exportdokumente für Sendungen ins Nicht-EU-Ausland?

Sobald du deine korrekten Login-Daten für das DHL Geschäftskundenportal eingegeben hast, kannst du oben auf den Button Vertragsdaten abrufen klicken, damit deine Kundennummer sowie die Abrechnungsnummern der einzelnen DHL Produkte und die Retourenempfänger automatisch aus dem DHL Geschäftskundenportal übernommen werden. Alternativ findest du diese Daten aber auch im DHL Geschäftskundenportal über den Menüpunkt Vertragsdaten.

Hier findest du einen Teil der Einstellungsmöglichkeiten für das Feature DHL Wunschpaket. Wichtig ist, dass du deine Kundennummer (EKP) hier eintragen musst, wenn du die Wunschservices nutzen möchtest. Die genauen Einrichtungsschritte findest du hier weiter unten im Beitrag.

DHL bietet zusätzlich die Möglichkeit, Sendungen an Paketshops u. ä. zustellen zu lassen. Alle Details zur Konfiguration findest du hier.

Trage hier je Land die Receiver Id des Retourenempfängers ein. Du findest diese Information im DHL Geschäftskundenportal unter Paket & Waren → Retouren → Einstellungen.

Diese Daten werden benötigt, um Zahlungen per Nachnahme auf das richtige Konto zu leiten. In den Feldern Verwendungszweck bzw. Kundenreferenz kannst du den Platzhalter ####{{ customerReference }} verwenden, um die jeweilige Bestellnummer einzufügen.

Im Feld Etikettenformat legst du fest, in welchem Format DHL deine Versandetiketten und Beilegeretouren erstellt: DIN A4, Laserdruck 105 x 208 mm oder 105 x 148 mm auf einem DIN-A5-Bogen oder Thermodruck 103 x 199 mm oder 103 x 150 mm.

Ohne Auswahl gilt die Einstellung deines DHL Geschäftskundenportals (siehe unten), und die Etiketten werden immer mit dem Drucker für DIN-A5-Etiketten gedruckt. DIN A4 und die Thermoformate werden mit dem Drucker gedruckt, den du dem Format in der Versandkonfiguration von Pickware WMS zuweist.

Vergiss nicht, deine eingegebenen Daten über den blauen Button oben zu speichern, bevor du das Menü verlässt. Wenn der Button statt dem Wort "Speichern" ein weißes Häkchen anzeigt, heißt das, dass seit deiner letzten Eingabe alle Daten gespeichert wurden.

Im DHL Geschäftskundenportal unter Paket & Waren → Versenden → Einstellungen → Allgemeine Einstellungen findest du weitere Einstellungen für die Versandetiketten. Die Druckereinstellungen im Geschäftskundenportal bestimmen das Format der Versandetiketten nur, wenn du in der Shopware Admin kein Etikettenformat ausgewählt hast.

Standardmäßig sind folgende Druckeinstellungen für den Druck auf DIN A5 ausgewählt:

Die genaue Kennung des verwendeten Papierformats (xxx-xxx-xxx) befindet sich als kleine Zahl auf den DHL Versandetiketten. Für bestimmte Anwendungsgebiete eignen sich folgende Größeneinstellungen:

Mit der Versanderweiterung von DHL unterstützt auch den Versand eine Packstation, Postfiliale oder einen Paketshop.

Um deinen Kunden diese Option anzubieten, öffne deine DHL Versandart unter Einstellungen → Shop → Versand. Im Abschnitt Storefrontkonfiguration → Lieferoptionen kannst du festlegen, welche Lieferorte zur Verfügung stehen sollen.

Die Auswahl einer Packstation, Postfiliale oder eines Paketshops erscheint im Checkout nur, wenn der Kunde eine abweichende Lieferadresse anlegt. Wird sie trotzdem nicht angezeigt, prüfe die Lieferoptionen in der Versandart und teste den Checkout mit dem Shopware-Standard-Theme. So erkennst du, ob ein Konflikt mit deinem Theme die Anzeige verhindert.

Damit die Karte zur Suche der Packstationen usw. angezeigt werden kann, benötigst du einen Google Maps API Key. Diesen kannst du dann unter Einstellungen → Erweiterungen → Versandetiketten DHL im Bereich Wunschservices eintragen. Wie du an einen solchen API Key gelangst, wird hier beschrieben.

Beachte bitte auch, dass du eine Anpassung in deiner Datenschutzerklärung vornehmen musst, wenn du diesen Service anbieten möchtest. Im Checkout wird zunächst nur eine Platzhalterkarte angezeigt. Mit einem Klick auf die Schaltfläche in der Meldung stimmen die Kunden zu, dass ihre Daten an Google Maps weitergegeben werden, damit ihnen die tatsächliche Karte angezeigt wird.

Innerhalb der Meldung wird bereits auf die Datenschutzerklärung verlinkt. Von deiner Seite musst du daher lediglich innerhalb der Datenschutzerklärung einen entsprechenden Abschnitt ergänzen.

Den Inhalt der Datenschutzerklärung kannst du unter Inhalte → Erlebniswelten anpassen. Ausführliche Informationen zu den Gestaltungsmöglichkeiten für Layouts findest bei Shopware in der Dokumentation.

Der Service DHL Wunschpaket bietet deinen Kunden die Möglichkeit, für die Zustellung ihrer Sendung verschiedene Zusatzoptionen auszuwählen, wie die Zustellung an einem Wunschtag oder an einen Wunschnachbarn.

Mit unserer DHL Versand Erweiterung können diese Optionen bereits bei Bestellabschluss vom Kunden festgelegt werden, sofern du die entsprechenden Einstellungen in der Administration vorgenommen hast. Damit diese Services genutzt werden können, musst du deine Kundennummer (EKP) in den DHL Einstellungen in deiner Shopware Admin hinterlegen.

Gehe dazu auf Einstellungen → Shop → Versand und wähle deine DHL Versandart aus. Bitte beachte, dass die Wunschpaket Funktion nur für den nationalen Versand mit DHL Paket zur Verfügung steht. Im Abschnitt Storefrontkonfiguration → Wunschpaket kannst du festlegen, welche Wunschpaket-Optionen beim Checkout zur Verfügung stehen sollen.

Welche Tage jeweils für die Zustellung zur Auswahl stehen, wird von DHL vorgegeben. Du kannst jedoch eine interne Bearbeitungszeit festlegen, welche dann für die Vorschläge des Wunschtages berücksichtigt wird.

Weitere Einstellungen zur Beeinflussung des Wunschtages findest du unter Einstellungen → Erweiterungen → Versandetiketten DHL im Bereich Wunschservices. Wenn Bestellungen nach der unter Letzter Bestellzeitpunkt festgelegten Uhrzeit eingehen, werden sie wie Bestellungen für den nächsten Tag behandelt.

Im Feld Ausgeschlossene Liefertage schließt du Zustelltage aus, nicht Kommissioniertage. Ein Beispiel: Kommissionierst du samstags nicht und möchtest deshalb keine Zustellung am Montag anbieten, schließt du den Montag aus.

Du kannst die Wunschpaket Konfiguration des Kunden in den Bestellungsdetails im Bereich Zusatzfelder sehen.

Wenn du ein Versandetikett erzeugst, sind die entsprechenden Felder bereits gemäß der Angaben des Kunden vorausgefüllt und die Informationen werden anschließend auch auf das Versandetikett gedruckt. Lediglich der Ablageort ist aus datenschutzrechtlichen Gründen nur für den Paketzusteller sichtbar.

DHL führt täglich automatisiert einen Tagesabschluss durch, bei dem die erstellten Versand- und Retourenetiketten manifestiert und abgerechnet werden. Anschließend kann ein Versandetikett nicht mehr storniert bzw. gelöscht werden.

Die Uhrzeit für den täglichen automatischen Tagesabschluss ist standardmäßig 17:45 Uhr und kann im DHL Geschäftskundenportal über Paket & Waren → Versenden → Einstellungen → Versandbenachrichtigungen & Tagesabschluss im Tab Tagesabschluss angepasst werden.

Den Tagesabschluss kannst du auch selbst in der Shopware Admin erstellen. Öffne dazu Bestellungen → Versandetiketten, klicke auf Tagesabschlüsse und erstelle einen Tagesabschluss für DHL. Pickware übergibt dann alle heutigen DHL-Sendungen sofort an DHL und stellt das Tagesmanifest von DHL bereit. Danach lassen sich diese Etiketten nicht mehr stornieren.

Die Empfängeradresse für Retourenetiketten kann im DHL Geschäftskundenportal unter Paket & Waren → Retoure → Einstellungen angepasst werden.

Dort findest du eine Tabelle mit einem Eintrag pro Land. Über das Stift-Symbol kannst du die Daten anpassen und die gewünschte Adresse hinterlegen.

Dies ist aktuell nicht möglich, da der DHL-Webservice derzeit keinen Weg anbietet, das Logo zu übergeben und auf das Etikett zu drucken.

Wie ergänze ich einen Link zur Sendungsverfolgung in meinen E-Mail-Vorlagen?

Wie konfiguriere ich die Versandarten, damit automatisch die korrekten Produkte der Versanddienstleister ausgewählt werden?