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
Aus der Verkaufsreklamation
Der übliche Weg, wenn ein Kunde eine Retoure anfordert und Sie dafür eine Verkaufsreklamation anlegen:
- Öffnen Sie die Verkaufsreklamation.
- Wählen Sie auf der Registerkarte Start die Aktion Retourenetikett erstellen.
Absender ist der Kunde: Verwendet wird seine Verkaufsadresse. Ist auf der Reklamation ein Lieferadresscode des Kunden angegeben, gilt stattdessen diese abweichende Adresse des Kunden. Die Lieferadressfelder der Reklamation selbst bleiben unberücksichtigt – Business Central trägt dort bei Reklamationen Ihre eigene Lager- bzw. Firmenadresse ein, also den Empfänger der Retoure. Das Gewicht ergibt sich aus der Menge zu empfangen der Artikelzeilen. Welcher Versanddienstleister die Retoure übernimmt, bestimmt der Zustellercode der Reklamation. Ist keiner gesetzt oder unterstützt dessen Anbieter keine Retourenetiketten, gilt der Anbieter aus dem Feld Standard-Versanddienstleistercode der merchantCENTRAL-Einrichtung, sonst der einzige aktive Anbieter mit Retourenunterstützung. Kommen danach noch mehrere Anbieter in Frage, wählen Sie den Anbieter aus einer Liste aus.
Das Etikett behält die Nummer der Verkaufsreklamation. Sie sehen es in der FactBox Retourenetiketten der Reklamation, und DHL erhält die Reklamationsnummer als Sendungsreferenz, sodass sie auch im DHL-Geschäftskundenportal erscheint. Wird die Rücksendung gebucht, steht die Sendungsnummer als Retouren-Sendungsnr. auf der gebuchten Rücksendung.
Zweites Etikett
Hat die Reklamation bereits ein Retourenetikett, fragt merchantCENTRAL vor einem zweiten nach: Jedes Etikett ist eine eigene Sendung, die DHL berechnet.
Wenn die Retoure zugestellt wird
Das Tracking verfolgt Retourenetiketten wie jede andere Sendung. Was geschieht, sobald DHL das Retourenpaket als bei Ihnen zugestellt meldet, legen Sie in der merchantCENTRAL-Einrichtung im Inforegister Standardwerte für Versandetiketten im Feld Bei Retourenzustellung fest:
| Wert | Wirkung |
|---|---|
| Keine Aktion | Nur der Zustellstatus am Etikett ändert sich. Das ist die Vorbelegung. |
| Benachrichtigen | Die Verkaufsreklamation zeigt Retoure zugestellt am, und das Dashboard zählt „zugestellte Retouren, noch nicht vereinnahmt“, bis Ware auf die Reklamation eingegangen ist. |
| Wareneingang anlegen | Wie Benachrichtigen, zusätzlich wird der Wareneingang der Reklamation angelegt, wenn ihr Lagerort einen verlangt. Die Reklamation muss dafür freigegeben sein. |
Die Arbeit erledigt ein Aufgabenwarteschlangenposten, der beim Einschalten angelegt wird. Was nicht verarbeitet werden konnte, steht in der Liste Zugestellte Retouren und lässt sich dort wiederholen.
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 Empfänger-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) |
| DHL-Logo drucken (Retoure) | 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 |
|---|---|
| Sendungsnr. | 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 |