DHL Retouren
Anleitung zur Erstellung von DHL-Retourenlabels über die DHL Returns API v1.
Überblick
DHL Retourenlabels werden über eine separate API (DHL Returns v1) erstellt — nicht über die reguläre Shipping API. Der Ablauf unterscheidet sich daher von der normalen Label-Erstellung:
- Retourenlabels erhalten eine eigene Sendungsnummer (unabhängig vom Versandlabel)
- Der "Absender" bei Retouren ist der Kunde (der zurücksendet)
- Der "Empfänger" ist Ihr Unternehmen (konfiguriert über Receiver ID)
- Optional wird ein QR-Code generiert (für papierloses Retournieren an DHL-Standorten)
Retourenlabel erstellen
Automatisch bei Label-Erstellung
Wenn in der DHL Setup die Option Include Return Label aktiviert ist, wird bei jeder Versandlabel-Erstellung automatisch ein Retourenlabel miterstellt.
Manuell aus der Versandlabel-Liste
- Öffnen Sie die Versandlabels-Liste
- Wählen Sie ein bestehendes Versandlabel
- Klicken Sie Retourenlabel erstellen
Manuell über den Label-Dialog
- Öffnen Sie den Label-Dialog (Create Label)
- Aktivieren Sie den Schalter Include Return Label
- Erstellen Sie das Label wie gewohnt
Einstellungen
DHL Setup — Retouren-Konfiguration
| Feld | Beschreibung |
|---|---|
| Include Return Label | Automatisch Retourenlabel bei jeder Versandlabel-Erstellung miterstellen |
| Retoure Receiver ID | DHL-Empfänger-ID für Retouren. Wenn leer, wird der ISO-3-Ländercode des Absenders verwendet. |
| Retoure Doc Format | Dokumentformat für Retourenlabels (PDF oder ZPL2) |
| Retoure Label Print Format | Druckformat für Retourenlabels (kann vom Versandformat abweichen) |
| Print DHL Logo (Return) | DHL-Logo auf Retourenlabels drucken |
Getrennte Formate
Versand- und Retourenlabels können unterschiedliche Formate verwenden. Typisches Szenario: ZPL2 auf dem Thermodrucker für den schnellen Packvorgang, PDF auf dem Laserdrucker für Retouren-Beilagen im Paket.
API-Response
Bei erfolgreicher Erstellung liefert die DHL Returns API:
| Feld | Beschreibung |
|---|---|
| Shipment No. | Eindeutige Sendungsnummer des Retourenlabels |
| Label (Base64) | Das Retourenlabel als PDF/ZPL (Base64-kodiert) |
| QR Label (Base64) | QR-Code-Label für papierloses Retournieren |
| QR Link | URL zum QR-Code (für E-Mail an Kunden) |
| Routing Code | DHL-Routing-Code für die interne Weiterleitung |
QR-Code-Retoure (papierlos)
DHL bietet eine papierlose Retoure über QR-Codes:
- Der Kunde erhält den QR-Link (z.B. per E-Mail)
- An einem DHL-Standort (Filiale, Packstation) wird der QR-Code gescannt
- Das Label wird vor Ort gedruckt — der Kunde benötigt keinen eigenen Drucker
Der QR-Link kann über das merchantCENTRAL Activity Log oder direkt aus dem Shipment Label-Record abgerufen werden.
Internationale Retouren
Für internationale Retourensendungen können Zolldaten angegeben werden. Die Customs-Informationen des Originallabels werden (wenn vorhanden) automatisch in den Retouren-Request übernommen.
Fehlerbehandlung
| Fehler | Ursache | Lösung |
|---|---|---|
| HTTP 400 Receiver ID invalid | Ungültige oder fehlende Receiver ID | Receiver ID im Setup prüfen oder ISO-3-Ländercode des Absenders korrekt konfigurieren |
| HTTP 401 | Authentifizierung fehlgeschlagen | API Key prüfen (Returns API verwendet denselben Key wie Shipping) |
| Weight must be positive | Gewicht nicht angegeben | Gewicht am Label oder Standard-Gewicht im Setup setzen |