Die meisten Fehler, die mit der DHL-Versand Integration entstehen, lassen sich bereits mit den Informationen aus der Fehlermeldung beheben. In diesem Beitrag findest du neben diesen Meldungen auch einige weitere Fehlermeldungen im Zusammenhang mit der Erweiterung DHL Versand sowie deren Lösung. In allen Fällen gilt: Sollte das Problem nach dem Ausführen der beschriebenen Schritte weiterhin bestehen, melde dich gerne bei unserem Support.

Wenn folgende Fehlermeldung erscheint, liegt dies daran, dass dem Benutzer im Geschäftskundenportal nicht das richtige Profil zugeordnet ist.

Fehler
​Die Sendung konnte aufgrund von Fehlern nicht erstellt werden: Die DHL BCP API hat mit einem Fehler geantwortet: Unknown group profile.

Um das Problem zu beheben, logge dich im DHL Geschäftskundenportal ein. Unter Paket & Waren → Versenden → Einstellungen → Nutzergruppen kannst du dem Benutzer das STANDARD_GRUPPENPROFIL zuweisen.

Die folgende Fehlermeldung weist auf ein Problem mit den Druckereinstellungen hin.

Fehler
​Die Sendung konnte aufgrund von Fehlern nicht erstellt werden: Die DHL BCP API hat mit einem Fehler geantwortet: invalid printer settings - please adjust your printer settings in the DHL business customer portal "Sending > Basic Settings > General" and save them in any case with occupied user

Um das Problem zu beheben, navigiere im DHL Geschäftskundenportal zu Paket & Waren → Versenden → Einstellungen → Allgemeine Einstellungen und deaktiviere dort die lokalen Druckereinstellungen.

Beim Erstellen von DHL-Versandetiketten kann folgende Fehlermeldung auftreten:

Error message parsing failed

Diese Fehlermeldung tritt auf, wenn dem DHL-Benutzer, der in der Konfiguration hinterlegt ist, im DHL Geschäftskundenportal kein Drucker oder ein falscher Drucker zugewiesen ist. Prüfe in diesem Fall im DHL Geschäftskundenportal die Druckerzuweisung dieses Benutzers und korrigiere sie gegebenenfalls. Anschließend können die Versandetiketten wieder erstellt werden.

Wenn beim Erstellen von Versand- oder Retourenetiketten die folgende Fehlermeldung erscheint, kann dies daran liegen, dass für den verwendeten DHL-Benutzer eine 2-Faktor-Authentifizierung (2FA) aktiviert ist.

Fehler
​Die Sendung konnte aufgrund von Fehlern nicht erstellt werden: Die DHL Parcel API hat mit einem Fehler geantwortet: DHL Authorisation Server: Access denied, direct grant with security profile enhanced not allowed.

Die DHL API unterstützt keine Authentifizierung mit aktivierter Zwei-Faktor-Authentifizierung (2FA). Ist 2FA im DHL Geschäftskundenportal aktiv, kann Pickware keine Verbindung zur API herstellen.

Die folgende Fehlermeldung weist darauf hin, dass sich die Nutzungsbedingungen im DHL Kundenkonto geändert haben und neu angenommen werden müssen.

Fehlermeldung: There occurred an unexpected error: Client error: `GET https://geschaeftskunden.dhl.de/customeradministration/api/v1/user` resulted in a `403 Forbidden` response

Logge dich dazu im DHL Geschäftskundenportal ein, klicke auf deinen Benutzernamen oben rechts und dann auf Benutzer verwalten. Im Anschluss öffnet sich ein Pop-up-Fenster, in dem du die neuen Nutzungsbedingungen akzeptieren kannst.

Die folgende Fehlermeldung weist darauf hin, dass die Absenderadresse unvollständig ist.

The sender address is missing the following property: Name, company or address addition.

Gehe in diesem Fall in deiner Shopware Admin auf Einstellungen → Erweiterungen → Versandetiketten allgemein und hinterlege dort die fehlenden Daten. Weitere Informationen zu den Einstellungsmöglichkeiten findest du hier.

Die folgende Fehlermeldung weist auf Probleme mit der hinterlegten Abrechnungsnummer hin.

Hard validation error occured. Die ausgewählte Abrechnungsnummer steht nicht zur Verfügung

In diesem Fall stimmt die hinterlegte Nummer unter Einstellungen → Erweiterungen → Versandetiketten DHL → Vertragsinformationen nicht mit der Nummer im DHL Geschäftskundenportal überein. Die korrekten Nummern findest du im DHL Geschäftskundenportal im Benutzermenü oben rechts unter Vertragsdaten. Relevant sind die letzten beiden Stellen der Abrechnungsnummern.

Sollte es beim Erstellen von Versand- oder Retourenetiketten zu einer Fehlermeldung kommen, kann dies daran liegen, dass die Vertragsdaten nicht korrekt aus dem DHL Geschäftskundenportal abgerufen werden können. Prüfe daher zunächst in deiner Shopware Admin unter Erweiterungen → Einstellungen → Versandetiketten DHL über den Button Vertragsdaten abrufen, ob das Abrufen der Vertragsdaten grundsätzlich funktioniert.

Wenn deine Vertragsdaten korrekt abgerufen werden können und du trotzdem keine Versandetiketten erstellen kannst, wende dich bitte an den Support.

Wenn das Abrufen der Vertragsdaten fehlschlägt, gehe wie folgt vor:

Sollte es beim Erstellen von Versand- oder Retourenetiketten zu dieser Fehlermeldung kommen, kann dies zwei Ursachen haben:

Hier solltest du beachten, dass der Benutzername exakt so (inkl. Groß- und Kleinschreibung) eingegeben werden muss, wie er im DHL Geschäftskundenportal unter Benutzer verwalten eingetragen ist.

Um zu überprüfen, wie dein Benutzername bei DHL hinterlegt ist, gehe wie folgt vor:

Die Einstellungen für den DHL Versand können bei Bedarf auch auf Verkaufskanalebene vorgenommen werden. Wenn dir die Fehlermeldung trotz Eingabe der korrekten Zugangsdaten weiterhin angezeigt wird, überprüfe daher auch die Einstellungen für die einzelnen Verkaufskanäle.

In der Regel werden die unter Alle Verkaufskanäle getroffenen Einstellungen für die anderen Verkaufskanäle vererbt, dies erkennst du an dem Symbol vor dem Feldnamen, wenn du einen Verkaufskanal ausgewählt hast. Es ist aber auch möglich, einzelne Felder davon auszunehmen, indem du auf das Symbol klickst. Hier siehst du beispielhaft ein nicht vererbtes Feld (Benutzername) und ein vererbtes Feld (Passwort).

Um die Produkte DHL Retoure Online und DHL Retoure International nutzen zu können, benötigst du:

Ein Vertrag über DHL Retoure Selbstzahler reicht in diesem Fall nicht aus! Wende dich daher an deinen Ansprechpartner bei DHL, um deinen Vertrag anzupassen.

Die DHL-Integration von Pickware setzt Shopware 6.5 oder neuer voraus. Hintergrund ist eine Umstellung der DHL-API, die sich mit älteren Shopware-Versionen nicht mehr nutzen lässt. Unter Shopware 6.4 kommt daher keine Verbindung zum DHL Geschäftskundenportal zustande und es erscheint folgende Meldung, obwohl die hinterlegten Zugangsdaten korrekt sind:

Die Zugangsdaten sind NICHT gültig!

Aktualisiere in diesem Fall deinen Shop auf Shopware 6.5 oder neuer. Welche Version dein Shop aktuell verwendet, erfährst du im Beitrag Welche Shopware Version hat mein Shop?. Erscheint die Meldung unter Shopware 6.5 oder neuer, prüfe die hinterlegten Zugangsdaten wie im Abschnitt DHL Fehlermeldung: Authentication failed: User not found or password invalid beschrieben.

Prüfe unter Shopware 6.5 oder neuer außerdem den Schalter Nutze den Testing-Webservice in der DHL-Konfiguration. Er muss zu den hinterlegten Zugangsdaten passen: Sind Live-Zugangsdaten hinterlegt, muss der Schalter deaktiviert sein. Ist er aktiviert, brauchst du die Zugangsdaten deines DHL-Entwickler-Portal-Accounts.

Die Fehlermeldung invalid_grant – Invalid user credentials bedeutet, dass DHL die hinterlegten Zugangsdaten nicht mehr annimmt. Prüfe, ob das Passwort im DHL Geschäftskundenportal geändert wurde und die neuen Zugangsdaten in Pickware hinterlegt sind. Eine Zwei-Faktor-Authentifizierung für den Benutzer funktioniert mit der DHL-API nicht.

Diese Fehlermeldung erscheint, wenn der hinterlegte DHL-Benutzer keine Rechte zum Versenden hat. Die Zugangsdaten können dabei korrekt sein.

Die Fehlermeldung No billing number configured for product … bedeutet, dass für das gewählte DHL-Produkt keine passende Abrechnungsnummer hinterlegt ist. Klicke in der DHL-Konfiguration auf Vertragsdaten abrufen, vergleiche die Abrechnungsnummer mit den Vertragsdaten im DHL Geschäftskundenportal und speichere die Einstellungen.

Die Fehlermeldung Could not connect to DHL OAuth bedeutet, dass dein Server keine Verbindung zu DHL aufbauen kann. Dein Server muss ausgehende Verbindungen zu api-eu.dhl.com auf Port 443 erlauben. Bitte deinen Hoster, Firewall und Proxy zu prüfen und die Verbindung freizugeben. Prüfe dabei auch, ob DHL-IP-Adressen blockiert sind.

Erscheint Error: Gone oder schlagen DHL-Etiketten plötzlich in allen Shops fehl, liegt meist eine Störung bei DHL vor. Den aktuellen Status der DHL-Schnittstellen siehst du unter status.api.dhl.com. Versuche es in diesem Fall später erneut.

Erscheint nach einem Update des DHL-Plugins die Fehlermeldung Column not found … supports_receiver_address_for_shipments, handelt es sich um einen Fehler, der in aktuellen Versionen des DHL-Plugins behoben ist. Aktualisiere das DHL-Plugin auf die aktuelle Version.

Diese Fehlermeldung erscheint, wenn du für eine Sendung außerhalb von Deutschland das DHL Produkt DHL Paket ausgewählt hast. Wähle stattdessen DHL Paket International aus und erstelle das Label erneut.

Diese Fehlermeldung erscheint, wenn du den Testing-Webservice in der DHL Konfiguration ausgewählt, aber nicht die korrekten Zugangsdaten hinterlegt hast. In diesem Fall musst du API-Key und API-Secret deines DHL-Entwickler-Portal-Accounts anstelle deiner regulären Zugangsdaten eingeben.

Diese Fehlermeldung erscheint, wenn eines der Felder name1, name2 oder name3 länger als 50 Zeichen ist. Die name-Felder werden automatisch wie folgt ausgefüllt:

Wenn eine Firma angegeben ist:

Wenn keine Firma angegeben ist:

Prüfe daher, ob beispielsweise die Kombination aus Firma und Abteilung oder Vorname und Nachname zu lang sein könnte und passe die Einträge entsprechend an. Ein Tool zum Zählen von Zeichen findest du beispielsweise hier.

Diese Fehlermeldung erscheint bei DHL Express, wenn die Versandbenachrichtigung aktiv ist und die E-Mail-Adresse in der Bestellung länger als 50 Zeichen ist. DHL Express lehnt das Versandetikett dann mit folgender Fehlermeldung ab:
The DHL Express API could not process the request:

Besonders häufig tritt dies bei Bestellungen über Marktplätze wie Amazon auf, da die dort übermittelten Käufer-E-Mail-Adressen (z. B. …@marketplace.amazon.com.de) sehr lang ausfallen können. Aktualisiere Pickware in diesem Fall auf die aktuelle Version. Dann erstellt Pickware das Etikett auch mit einer langen E-Mail-Adresse, nur die Versandbenachrichtigung von DHL Express entfällt für diese Sendung.

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 dieser Fehlermeldung. Stelle in diesem Fall sicher, dass die korrekte Retourenart DHL Retoure Online genutzt wird.

Wenn das Gewicht deiner Pakete nicht korrekt gerundet wird, kann dies an einer falschen Einstellung in deiner PHP Konfiguration liegen. Prüfe hierzu in deiner php.ini, ob für die serialize_precision der Wert -1 gesetzt ist und falls nicht, passe den Wert entsprechend an. Weitere Informationen findest du beispielsweise hier.

Wenn deine Versandetiketten bei DHL Paket International trotz der Zustellart Standard oder Economy als Premium Label angelegt werden, liegt dies daran, dass die meisten EU-Länder keine Economy-Produkte anbieten. DHL verwendet in diesem Fall automatisch Premium.

Diese Fehlermeldung kann erscheinen, wenn beim Erstellen eines Versandlabels die Option Label nur erzeugen, wenn Adresse leitcodierbar aktiviert ist.

DHL prüft bei aktivierter Leitcodierbarkeit, ob die Kombination aus Straße und Postleitzahl im System eindeutig hinterlegt ist. Einige Großkunden, wie etwa Universitäten oder Behörden, verwenden jedoch unterschiedliche Postleitzahlen für Post- und Straßenanschriften. Dadurch kann es passieren, dass die Adresse vom DHL-System nicht korrekt zugeordnet werden kann.

Eine Universität in Berlin nutzt einmal 10099 Berlin als allgemeine Postanschrift, aber auch 10117 Berlin für Straßenanschriften. In diesem Fall kann die Labelerstellung nur mit der korrekten Straßen-PLZ (10117 Berlin) erfolgreich abgeschlossen werden. Wenn die 10099 genutzt wird, erscheint die Fehlermeldung.

Verwende die passende Straßen-PLZ oder deaktiviere einfach die Option Label nur erzeugen, wenn Adresse leitcodierbar, um das Versandlabel trotzdem zu erstellen.

Ist beim Erstellen eines DHL-Etiketts die Option Label nur erzeugen, wenn Adresse leitcodierbar aktiviert, bricht DHL die Leitcodierung ab, wenn die Straße nicht gefunden wird. Pickware prüft die Adresse dabei nicht selbst, sondern gibt die Fehlermeldung von DHL weiter. Du hast zwei Möglichkeiten: