In diesem Beitrag findest du einige bekannte Fehlermeldungen im Zusammenhang mit dem 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 bitte 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 Pickware-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 der Pickware 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 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 die hinterlegten Zugangsdaten nicht mehr gültig sind oder der hinterlegte DHL-Benutzer keine Rechte zum Versenden hat.

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, wenn die in der Bestellung hinterlegte E-Mail-Adresse länger ist als das von DHL für dieses Feld zugelassene Limit. In diesem Fall lehnt DHL die Erstellung des Versandetiketts 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. Kürze in diesem Fall die E-Mail-Adresse in der betroffenen Bestellung und erstelle das Versandetikett anschließend erneut. Ist die vollständige E-Mail-Adresse zwingend erforderlich, kann das Label alternativ direkt im DHL Express Portal erstellt werden.

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.

Erscheint Error: Gone oder schlagen DHL-Etiketten plötzlich alle fehl, obwohl du nichts an der Konfiguration geändert hast, 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.

Meldet DHL Bitte geben Sie die Art der Sendung an oder Die angegebene Art der Sendung ist nicht gültig, oft zusammen mit Bitte geben Sie die Beschreibung an, Bitte geben Sie den Warenwert an oder Bitte geben Sie die Versandkosten für die Zollabfertigung an, fehlen DHL die Zollangaben für die Sendung. Die Meldung zählt genau die Angaben auf, die zu den Exportdokumenten gehören.

Prüfe in diesem Fall die drei Stellen, an denen Pickware die Zollangaben für die Exportdokumente holt: die Versandart mit Exportdokumente erstellen, die Zollinformationen am Produkt und die allgemeinen Zollangaben unter Einstellungen → Erweiterungen → Versandetiketten allgemein. Wie du alle drei einrichtest, erfährst du in Wie erstelle ich Exportdokumente für Sendungen ins Nicht-EU-Ausland?

Wenn deine Versandetiketten trotz deaktivierter Premium Funktion als Premium Label angelegt wird, liegt dies daran, dass die meisten EU-Länder keine Economy-Produkte anbieten und in diesem Fall seitens DHL automatisch die Premium Funktion aktiviert wird.

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.