DHL Label erstellen
Anleitung zur Erstellung von DHL-Versandlabels über die merchantCENTRAL-Plattform.
Label-Erstellung starten
Aus einer gebuchten Verkaufslieferung
- Öffnen Sie die gebuchte Verkaufslieferung (Posted Sales Shipment)
- Klicken Sie auf Label erstellen (Action in der Aktionsleiste)
- Der Label-Dialog öffnet sich mit vorausgefüllten Daten
Aus der Versandlabel-Liste
- Öffnen Sie Versandlabels (Shipment Labels)
- Klicken Sie auf Neu → DHL
- Füllen Sie die erforderlichen Felder manuell aus
Über die DHL Dashboard-Seite
- Öffnen Sie das DHL Dashboard
- Verwenden Sie die Quick-Action Label erstellen
Schnellerstellung ohne Dialog
Label erstellen (1-Klick)
Auf der Verkaufsauftrag-Karte und in der Verkaufsauftrag-Liste steht die Aktion Label erstellen (1-Klick) zur Verfügung.
- Erzeugt das Label sofort ohne den Dialog zu öffnen.
- Verwendet den Standard-Anbieter in der Reihenfolge: Versandpartner des Auftrags → MC-Default-Provider → einziger aktiver Provider.
- Das Produkt wird automatisch aufgelöst, die Shipping Rules werden angewendet.
Labels erstellen (Batch)
In der Verkaufsauftrag-Liste verarbeitet die Aktion Labels erstellen (Batch) alle markierten Aufträge in einem Lauf.
- Sammelverarbeitung mit Fortschrittsdialog.
- Abschließende Zusammenfassung (erstellt / übersprungen / fehlgeschlagen).
- Fehlertolerant pro Auftrag: Ein fehlerhafter Auftrag stoppt den Lauf nicht.
Plattformweit
Die Aktionen Label erstellen (1-Klick) und Labels erstellen (Batch) sind Hub-Funktionen und stehen für alle Shipment-Connectors zur Verfügung (DHL, DHL Express, DPD, GLS, UPS, Rhenus, Hermes).
Label-Dialog
Der Label-Dialog zeigt alle relevanten Felder für die Sendungserstellung.
Empfängeradresse
Wird automatisch aus der Lieferadresse des Verkaufsauftrags übernommen.
| Feld | Beschreibung |
|---|---|
| Name | Empfängername |
| Street / House No. | Straße und Hausnummer |
| Post Code / City | PLZ und Ort |
| Country Code | Ländercode (ISO alpha-2) |
| Contact Name | Ansprechpartner |
| E-Mail-Adresse (für Benachrichtigungen) | |
| Phone | Telefonnummer |
Sendungsdaten
| Feld | Beschreibung |
|---|---|
| Weight (g) | Gewicht der Sendung in Gramm. Wird aus dem Auftrag berechnet oder aus dem Standard-Gewicht übernommen. |
| Reference No. | Referenznummer (erscheint auf dem Label, z.B. Auftragsnummer) |
| Product | DHL-Produkt — wird automatisch vom Contract Resolver bestimmt |
| Profile | Verwendetes DHL-Profil (Standard oder manuell gewählt) |
Empfängertyp
| Typ | Beschreibung |
|---|---|
| Contact Address | Normale Hausanschrift (Standard) |
| Packstation | DHL Packstation — erfordert Locker ID und Postnummer |
| Filiale | DHL Filiale — erfordert Retail ID und optional Postnummer |
Vorab-Validierung (Aktion „Prüfen")
Im Dialog Versandlabel erstellen steht die Aktion Prüfen zur Verfügung. Sie führt DHLs Vorab-Validierung aus (validate=true) und zeigt etwaige Probleme im Klartext an.
- Es wird kein Label erstellt und es entstehen keine Kosten.
- Validiert genau die im Dialog eingegebene Adresse, das Gewicht und die Maße.
- Funktioniert für Verkaufsaufträge und gebuchte Lieferungen.
So lassen sich Adress-, Gewichts- oder Maßfehler erkennen, bevor ein kostenpflichtiges Label erzeugt wird.
Plattformweit
Die Vorab-Validierung ist eine Hub-Funktion und steht für alle Shipment-Connectors zur Verfügung (DHL, DHL Express, DPD, GLS, UPS, Rhenus, Hermes).
Zusatzleistungen (VAS)
Über den Tab Services im Label-Dialog können Value Added Services konfiguriert werden:
- Wunschzustellung (Nachbar, Ablageort, Wunschtag)
- Altersprüfung (A16 / A18)
- Persönliche Übergabe
- Empfängerunterschrift
- Nachnahme (COD)
- Höherversicherung
- GoGreen Plus (klimaneutraler Versand)
→ Details: Zusatzleistungen
Wunschtag (Preferred Day)
Der Wunschtag muss 2–6 Werktage in der Zukunft liegen. Sonntage werden abgelehnt.
Shipping Rules
Über Shipping Rules können VAS und das Produkt automatisch zugewiesen werden — z.B. Altersprüfung ab einem bestimmten Warenwert oder Versicherung bei internationalen Sendungen. Die Regeln werden bei der Label-Erstellung automatisch ausgewertet.
Shipping Rules — Bedingungen und Aktionen
- Bedingung „Artikelkategorie": wertet alle Artikelzeilen des Verkaufsauftrags aus. Die Regel greift, wenn eine Zeile mit Operator und Wert passt.
- Aktion „Set Product": überschreibt den Shipping-Agent-Service-Code, den der Contract Resolver zur Produkt-/Abrechnungsnummer-Auflösung nutzt. Leere Werte werden ignoriert.
- Shipping Rules laufen immer bei der Label-Erstellung — auch wenn noch kein VAS-Datensatz existiert. Dadurch greift die Zero-Config-Automatik auch bei einfachen Sendungen ohne manuell gewählte Services zuverlässig.
Automatische Vertragsauflösung
Der Contract Resolver bestimmt automatisch:
- Produkt: Über Vertragspositionen nach Zone/Gewicht aufgelöst
- Abrechnungsnummer: EKP + Verfahrenscode + Participation aus den Vertragspositionen
- Zone: Domestic / EU / International (aus dem Zielland abgeleitet)
Sie müssen keine Abrechnungsnummer manuell eingeben — der Resolver wählt die passende Vertragsposition anhand der konfigurierten Profile.
Zero-Config-Vorbelegung
- Das Produkt wird über Vertragspositionen nach Zone/Gewicht aufgelöst.
- Die Maße lösen bei Bedarf ein Auto-Upsize des Produkts aus.
- Shipping Rules setzen Produkt und VAS automatisch.
→ Details: Profile & Abrechnung
Nach der Erstellung
Nach erfolgreicher Label-Erstellung:
- Das Label-PDF (oder ZPL) wird automatisch als Anhang gespeichert
- Die Sendungsnummer wird im Shipment Label-Record eingetragen
- Ein Retourenlabel wird optional miterstellt (wenn in Setup aktiviert)
- Der Tracking-Eintrag wird automatisch angelegt
- Das Label kann über den Print Service direkt an einen Drucker gesendet werden
Sendungsverfolgung auf der gebuchten Lieferung
Tracking-Updates werden auf die gebuchte Verkaufslieferung zurückgeschrieben. Im neuen Inforegister Sendungsverfolgung (FastTab „Delivery Tracking") sehen Sie:
- Zustellstatus
- Sendungsnummer
- Tracking-URL
- Letzte Tracking-Aktualisierung
- Zustelldatum
So sieht der Sachbearbeiter den Zustellstatus direkt auf der gebuchten Lieferung, ohne das Label öffnen zu müssen.
Plattformweit
Die Status-Rückschreibung auf die gebuchte Lieferung ist eine Hub-Funktion und gilt für alle Shipment-Connectors (DHL, DHL Express, DPD, GLS, UPS, Rhenus, Hermes).
Label erneut drucken
- Öffnen Sie die Versandlabels-Liste
- Wählen Sie das gewünschte Label
- Klicken Sie Label drucken (Action) oder Download
Label stornieren
- Öffnen Sie das Label in der Versandlabels-Liste
- Klicken Sie Stornieren
- Die Stornierung wird an die DHL API gesendet (DELETE-Request)
Stornierungsfrist
Labels können nur storniert werden, solange sie noch nicht für den Versand verwendet wurden. Nach dem Tagesabschluss (Manifest) ist eine Stornierung in der Regel nicht mehr möglich.
Fehlerbehandlung
Kryptische DHL-API-Fehler werden in konkrete Handlungshinweise übersetzt und im Fehlerdialog im Klartext angezeigt — u.a. zu:
- Abrechnungsnummer / EKP (14 Stellen: EKP + Verfahren + Teilnahme)
- Service nicht gebucht (GKP)
- Profilname
- Retoure-Aktivierung
- Adresse / Leitcodierung
- Gewicht
- Paketmaße
- Nachnahme / IBAN
| Fehler | Ursache | Lösung |
|---|---|---|
| No contract line found | Keine passende Vertragsposition für Zielland/Produkt | Vertragspositionen im Profil prüfen (Zone/Produkt) |
| Weight exceeds maximum | Sendung zu schwer für das gewählte Produkt | Max-Gewicht in der Vertragsposition prüfen oder anderes Produkt wählen |
| HTTP 400 | Ungültige Sendungsdaten | Adressfelder prüfen (PLZ-Format, Ländercode); Fehlerdialog für Klartext-Hinweis lesen |
| HTTP 401 | Bearer-Token serverseitig widerrufen/abgelaufen | Wird automatisch erneuert und der Request einmal wiederholt — kein manueller Eingriff nötig |
KPI-Dashboard
Das DHL Dashboard zeigt zusätzlich folgende Kennzahlen:
- Retourenquote (Monat)
- Zustellquote (zugestellt / getrackte Sendungen)