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.
Inhalt
DHL Fehlermeldung: Unknown group profile
DHL Fehlermeldung: Invalid printer settings
DHL Fehlermeldung: Unexpected client error
DHL Fehlermeldung: Absenderadresse ist unvollständig
DHL Fehlermeldung: Abrechnungsnummer steht nicht zur Verfügung
DHL Fehlermeldung: Fehler beim Erstellen von Versand- oder Retourenetiketten
DHL Fehlermeldung: Authentication failed: User not found or password invalid
DHL Fehlermeldung: Die Kommunikation mit der DHL BCP API ist nicht möglich. Error: Unauthorized.
DHL Fehlermeldung: Unknown group profile
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.
DHL Fehlermeldung: Invalid printer settings
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.
Vertragsdaten können nicht abgerufen werden. DHL Fehlermeldung: Unexpected client error
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.
DHL Fehlermeldung: Absenderadresse ist unvollständig
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 Shop Administration auf Einstellungen → Erweiterungen → Versandetiketten allgemein und hinterlege dort die fehlenden Daten. Weitere Informationen zu den Einstellungsmöglichkeiten findest du hier.
DHL Fehlermeldung: Abrechnungsnummer steht nicht zur Verfügung
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.
DHL Fehlermeldung: Fehler beim Erstellen von Versand- oder Retourenetiketten
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 Shop Administration unter Erweiterungen → Einstellungen → Versandetiketten DHL über den Button Vertragsdaten abrufen, ob das Abrufen der Vertragsdaten grundsätzlich funktioniert.
Wenn das Abrufen der Vertragsdaten fehlschlägt, gehe wie folgt vor:
- Logge dich im DHL Geschäftskundenportal ein und navigiere zu Benutzer verwalten. Hier musst du ggf. neue Nutzungsbedingungen bestätigen.
- Öffne erneut die Erweiterungseinstellungen unter Erweiterungen → Einstellungen → Versandetiketten DHL und klicke oben auf Vertragsdaten abrufen.
- Prüfe, ob die Erstellung von Versandetiketten wieder funktioniert.
DHL Fehlermeldung: Authentication failed: User not found or password invalid
Sollte es beim Erstellen von Versand- oder Retourenetiketten zu dieser Fehlermeldung kommen, kann dies daran liegen, dass die Login Daten (Benutzername, Passwort) in der DHL Konfiguration nicht korrekt hinterlegt wurden. 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:
- Logge dich im DHL Geschäftskundenportal ein.
- Klicke auf deinen Benutzernamen oben rechts und dann auf Benutzer verwalten.
- Deine Benutzernamen werden in der Tabelle angezeigt:
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).
DHL Fehlermeldung: Create label to [name], parcel 1: Hard validation error occured. Das angegebene Produkt ist für das Land nicht verfügbar
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.
DHL Fehlermeldung: Die Kommunikation mit der DHL BCP API ist nicht möglich. Error: Unauthorized.
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.