DHL Versenden 4.0 in JTL-Wawi einrichten — Migration von 3.0 und die häufigsten Fehler

Auf einen Blick

• ✓DHL Versenden 3.0 (SOAP/GKV v3) wird am 31.05.2026 abgeschaltet — ab JTL-Wawi 1.11 ist 4.0 die einzige funktionierende DHL-Schnittstelle. Wer die Umstellung einige Wochen vor dem Stichtag angeht, hat bei Problemen noch Puffer.
• ✓Die Umstellung erfordert ein neues Systembenutzer-Konto im DHL-Geschäftskundenportal — bestehende 3.0-Zugangsdaten lassen sich nicht konvertieren, nur übernehmen. Diesen Schritt vergessen die meisten Händler als erstes.
• ✓Drei Fehler begegnen unseren Kunden am häufigsten: NullReferenceException beim Etikettendruck, fehlender Firmenname auf dem Label (Bug WAWI-86030) und ungewollter Retourenetikett-Druck — alle drei haben konkrete Workarounds.

Wir begleiten regelmäßig Händler durch Versandschnittstellen-Umstellungen in JTL-Wawi. Die DHL-4.0-Migration ist technisch überschaubar, aber die Kombination aus Wawi-Update-Pflicht, neuem DHL-Portalbenutzer und teils noch offenen Bugs sorgt bei vielen für unnötigen Stress kurz vor dem Stichtag. Aus unserer Arbeit mit über 300 Händlern wissen wir: Wer die fünf Schritte in der richtigen Reihenfolge geht und die drei bekannten Fehlerquellen kennt, kommt deutlich schneller durch die Migration. Als JTL Service Partner Gold hat Vlarom E-Commerce Agentur direkten Draht zum JTL-Support — falls es doch einmal hakt, finden wir die Ursache schnell. Bei der Migration sehen wir fast immer das gleiche Muster: Das Referenzfeld ist leer oder zu kurz, und das allein verursacht die NullReferenceException in den meisten Fällen.

Nach der Umstellung auf DHL Versenden 4.0 sehen wir immer wieder dasselbe Muster. Inlandssendungen laufen sauber durch, doch sobald ein Paket in die EU oder ins Drittland soll, bricht der Versand ab. Genau dieses Problem diskutieren Händler im JTL-Forum. Wir haben die dort genannten Ursachen gegen die offizielle JTL-Dokumentation geprüft. Das sind die drei, die uns in der Praxis am häufigsten begegnen.

1

Falsches DHL-Produkt in der Versandart hinterlegt

Symptom: Inlandsversand mit DHL Paket klappt, EU-Sendungen bleiben hängen oder werden abgelehnt. Im JTL-Forum-Thread zum Thema bestätigt sich das als häufigste Ursache. Die Versandart ist noch mit dem reinen Inlandsprodukt DHL Paket verknüpft statt mit dem Auslandsprodukt.

Lösung: Unter Versand > Versandarten die betroffene Versandart öffnen und im Tab Versanddatenexport auf DHL Paket International umstellen (Economy, Premium oder Closest Droppoint, je nach Vertrag). Dazu gehört eine eigene, vom Inlandsprodukt getrennte Vertragsnummer im DHL-Geschäftskundenportal. Details zeigt der JTL-Guide zu DHL Versenden 4.0, die Symptome bestätigen sich im JTL-Forum.

2

Referenzfeld zu kurz oder leer

Symptom: Der Etikettendruck bricht gezielt bei internationalen Sendungen ab, während kurze Inlandsaufträge problemlos durchgehen. Laut offizieller JTL-Doku verlangt DHL Versenden 4.0 zwingend eine Referenznummer zwischen 8 und 35 Zeichen, unabhängig vom Zielland. Ein zu kurzes Feld wirkt sich bei Auslandssendungen zusätzlich auf die Zollformulardaten aus.

Lösung: Unter Versand > Versandarten im Tab Allgemein bei Kundenindiv. Referenznummer eine Variable mit mindestens 8 Zeichen hinterlegen, zum Beispiel die Auftragsnummer mit Präfix. Das ist derselbe Check, der auch die NullReferenceException aus Schritt 5 der Einrichtung verhindert. Bei EU-Zielen zeigt er sich nur an anderer Stelle im Ablauf.

3

Handelsstücklisten ohne TARIC-Code und Ursprungsland

Symptom: Einzelartikel gehen problemlos in die EU raus, Sets und Stücklisten-Artikel scheitern am Export, teils sogar bei Zielländern wie Polen oder Österreich, wo eigentlich gar keine Zollformulare nötig wären. Im JTL-Forum ist das als eigener Fall dokumentiert. Stücklistenkomponenten haben in JTL-Wawi technisch einen Preis von 0,00 EUR, DHL akzeptiert auf Exportdokumenten aber keine Positionen mit 0,00 EUR. Das Zolldokument zeigt dann nur die Stückliste selbst, ohne ihre Komponenten.

Lösung: In den Artikelstammdaten jeder Set-Komponente Ursprungsland und, wo vorhanden, den TARIC-Code (Zolltarifnummer) pflegen, laut JTL-Guide Pflichtfelder ab einem Warenwert von 1.000 €. Bricht der Versand trotzdem, hilft laut Forum-Thread zu den Handelsstücklisten übergangsweise eine zweite Versandart ohne automatische Exportdokumente für reine EU-Ziele. Parallel den aktuellen JTL-Wawi-Patch einspielen. DHL-4.0-Fixes kommen laut JTL überwiegend serverseitig, doch ein Client-Update auf den neuesten Stand schließt bekannte Nebeneffekte trotzdem aus.

Die folgenden Schritte basieren auf der offiziellen JTL-Dokumentation und Praxiserkenntnissen aus unserer Projektarbeit mit über 300 Händlern. Lies sie in dieser Reihenfolge durch bevor du anfängst — besonders Schritt 1 und 2 werden oft übersprungen und verursachen dann die Fehler in Schritt 5. Vlarom E-Commerce Agentur begleitet diese Umstellung täglich und kennt jeden dieser Stolperpunkte aus der Praxis.

DHL Versenden 4.0 JTL Wawi erfordert mindestens Version 1.11. Wer noch auf 1.10 läuft, sieht die 4.0-Option im Dropdown nicht. Den Stand findest du unter Hilfe > Über JTL-Wawi. Update außerhalb der Stoßzeiten planen, vorher Datenbankbackup anlegen. Die aktuelle Stable-Version JTL-Wawi 2.0 ist seit März 2026 freigegeben und unterstützt DHL 4.0 vollständig.

Im DHL-Geschäftskundenportal auf den Namen klicken, dann Benutzer verwalten aufrufen und Neuen Benutzer anlegen wählen. Als Benutzertyp Systembenutzer wählen — kein normaler Benutzer. Unter Berechtigungen Versenden und Retoure aktivieren. Das generierte Passwort sofort notieren, es wird einmalig angezeigt. Die Abrechnungsnummern für die Einrichtung stehen in der Übersicht der Vertragspositionen im Portal.

In JTL-Wawi unter Versand > JTL-ShippingLabels ein neues Konto anlegen und im Schnittstellen-Dropdown DHL Versenden 4.0 auswählen. Benutzername und Passwort des neuen Systembenutzers eintragen. Wichtig: Ein bestehendes 3.0-Konto lässt sich nicht umstellen — es muss immer ein neues Konto sein. Die Referenznummer muss zwischen 8 und 35 Zeichen lang sein. Kurze Auftragsnummern mit Präfix versehen, z.B. Auftrag-AUF001. Die vollständige Einrichtung zeigt der JTL-Guide zu DHL Versenden 4.0.

Unter Versand > Versandarten jede DHL-Versandart einzeln öffnen und im Tab Versanddatenexport auf Export mit JTL-ShippingLabels und DHL Versenden 4.0 umschalten. Etikettenkonfiguration prüfen: Produkttyp, Abrechnungsnummer und Druckerformat müssen zum neuen Konto passen. Unter Start > Drucker ein neues Druckprofil anlegen und Skalierung auf An Druckerrand anpassen (proportional) setzen. Die alte 3.0-Versandart vorerst parallel aktiv lassen bis der erste Testlauf erfolgreich war.

Einen Testauftrag in Versand > Lieferscheine öffnen und ein Etikett drucken. NullReferenceException: Referenzfeld auf mindestens 8 Zeichen prüfen, Option Fehlerbeleg drucken in den Versandart-Einstellungen deaktivieren. Fehlender Firmenname auf dem Etikett: Bug WAWI-86030, serverseitiger Fix durch JTL, Workaround ist der Firmenname direkt im Namensfeld der Lieferadresse. Unerwünschter Retourendruck: Im DHL-Portal die Option Zusammen mit Versandetikett drucken aktivieren, speichern, wieder deaktivieren, speichern — das setzt den Backend-Status zurück.