> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/dhl-connector/fehlerbehebung-and-support/dhl-parcel-retoure.md). # DHL Parcel DE Retoure Ab Version 25.26 können Sie DHL Retoure Online und internationale Retouren direkt in Business Central beauftragen. Retouren sind eigene Belege; Sendungsnummer, Versandetikett, Paketbestand und Verkaufsbeleg der ursprünglichen Sendung werden nicht verändert. ## Einrichtung Öffnen Sie **DHL Retoureneinrichtung** über die Suche oder aus der DHL-Konfiguration. Wählen Sie zuerst **Sandbox** oder **Live**. Tragen Sie den DHL-API-Schlüssel und das API-Secret einer Developer-Portal-App ein, die für **DHL Parcel DE Returns** freigeschaltet ist. Ein erfolgreicher OAuth-Test allein reicht nicht: **Retourenverbindung testen** prüft zusätzlich den Zugriff auf die Retourenstandorte. API-Schlüssel, API-Secret und Passwort liegen im mandantenspezifischen isolierten Speicher, getrennt nach Konfiguration und Sandbox/Live. Gespeicherte Werte erscheinen maskiert. Ein leeres Überschreibungsfeld verwendet die vorhandenen Parcel-App-Zugänge; diese müssen ebenfalls für Retoure freigeschaltet sein. Für Sandbox verwendet ein leeres Benutzer-/Passwortfeld `user-valid` beziehungsweise das von DHL dokumentierte Sandbox-Passwort. Für Live werden ohne separate Retourenzugangsdaten die vorhandenen Parcel-Benutzerdaten verwendet. Benutzername, Passwort und Empfänger-ID sind bearbeitbar. **Retourenstandorte** ruft die verfügbaren Empfänger-IDs ab. Nur Empfänger mit Abrechnungsnummer werden unterstützt. Der Standort muss zum Land passen, aus dem der Kunde die Retoure absendet. DHL Retoure Selbstzahler ist nicht Bestandteil dieser API. ## Retoure erstellen Öffnen Sie **DHL Retouren** und legen Sie einen Beleg an. Alternativ wählen Sie **DHL Retoure erstellen** auf der Paketkarte, in den Auftragspaketen oder bei Paketen einer gebuchten Verkaufslieferung. Die App übernimmt die Empfängeradresse als Retourenabsender und trennt eine erkennbare Hausnummer von der Straße. Prüfen Sie die übernommenen Daten, insbesondere den vollständigen Vor- und Nachnamen, die Straße, Hausnummer und Empfänger-ID. Auch Retouren ohne ursprüngliches DHL-Paket sind möglich. Wählen Sie über die Empfänger-ID den DHL-Standort. Für Retouren aus Deutschland stehen PDF, QR-Code oder beide Dokumente zur Verfügung. Internationale Retouren verwenden PDF; für Frankreich sind zusätzlich die unten beschriebenen ZPL-Thermoetiketten verfügbar. GoGreen Plus ist nur für deutsche Retouren mit entsprechend freigeschaltetem Empfänger verfügbar. Retouren aus Dänemark benötigen ein Sendungsgewicht. Unterstützte Währungen sind EUR, GBP und CHF. Für Retouren aus der Schweiz, Großbritannien und Norwegen erfassen Sie 1 bis 20 **Retourenzollpositionen** mit Beschreibung, ganzer Stückzahl, Einzelgewicht und Einzelwert. Bei Bedarf ergänzen Sie HS-Code und dreistelligen ISO-Ursprungscode. Die API erhält das Gewicht und den Wert je verpackter Position als Menge mal Einzelwert. Die von DHL gelieferten internationalen PDF-Dokumente enthalten die erforderlichen Zollformulare. Drucken Sie diese vollständig aus und beachten Sie die länderspezifischen DHL-Anweisungen. Wählen Sie **Retourenetikett erstellen**. Bei Live bestätigt der Benutzer die Beauftragung. Laden Sie anschließend das **Retouren-PDF** oder die **Mobile Retoure** herunter. Die mobile Retoure enthält den ursprünglichen QR-Code zusammen mit der kopierbaren RET-Nummer. Wenn Sie nur das PNG weitergeben, müssen Sie dem Kunden die RET-Nummer zusätzlich als Text übermitteln. Die RET-Nummer ist außerdem neben dem QR-Code auf der Retourenkarte sichtbar. ## Fehler und Wiederherstellung Erfolgreich übermittelte Retouren sind unveränderbar und können nicht nochmals aus demselben Beleg beauftragt werden. Eingabe-/Berechtigungsfehler können korrigiert werden. Bei Timeout, Serverfehler oder unterbrochener Sitzung ist die Annahme bei DHL unklar. Die App sperrt deshalb erneute Einreichungen. Prüfen Sie den Auftrag im DHL-Geschäftskundenportal. **Gespeicherte Dokumente wiederherstellen** verarbeitet eine vorhandene Bestätigung erneut, ohne eine neue Retoure zu erzeugen. Liegt keine verwendbare Bestätigung vor, klären Sie den DHL-Status, bevor Sie einen weiteren Beleg erstellen. Die Retoure-API bietet keine Stornierung. Laut DHL werden Retouren bei Paketabgabe berechnet; die Etiketterstellung allein ist kostenlos. ## Referenzen und Erweiterungen [DHL Parcel DE Returns – offizielle API-Dokumentation](https://developer.dhl.com/api-reference/dhl-parcel-de-returns-post-parcel-germany) Die Integrationsereignisse `OnBeforeSendReturnRequest` und `OnAfterCreateReturn` stehen für Kundenerweiterungen einschließlich Fresco zur Verfügung. Fremderweiterungen müssen die DHL-Spezifikation einhalten und dürfen bei unklarem Ergebnis keine automatische erneute Beauftragung auslösen. ## QR-Gültigkeit und Thermoetiketten (API 1.1.0) Im **DHL Retouren-Setup** legen Sie das Dokumentformat, Druckmedium, die Zebra-Auflösung und die QR-Gültigkeit für neue Belege fest. Neue mobile Retouren verwenden standardmäßig **30 Tage**; möglich sind **7 bis 180 Tage**. Auf der Retourenkarte können Sie die Werte vor der Beauftragung ändern. Bestehende Belege behalten ihre gespeicherten Einstellungen, auch wenn Sie anschließend das Setup ändern. Mobile Retouren mit einstellbarer Gültigkeit benötigen **PDF/A4** und einen deutschen Retourenabsender. Die angezeigte Dauer ist die an DHL übermittelte Dauer. Die API bestätigt keinen exakten Ablaufzeitpunkt; die App zeigt deshalb kein daraus abgeleitetes Ablaufdatum an. Wählen Sie die Dauer vor der Beauftragung. Nachträgliche Änderungen sind bei übermittelten Belegen gesperrt. Für Zebra-Drucker wählen Sie **ZPL (Zebra)**. Die App wählt dabei ein Etikett ohne QR-Code und das Rollenformat **103 × 150 mm**. Die Standardauflösung ist **300 dpi**; für ein entsprechendes Druckermodell sind auch **203 dpi** wählbar. Laden Sie das Ergebnis über **Retouren-ZPL herunterladen** herunter und senden Sie die Datei über Ihre bestehende ZPL-Drucklösung unverändert an den Drucker. Druckerauflösung und Etikettenmaß müssen den gespeicherten Werten entsprechen. | Druckmedium | Zulässiges Absenderland | | --------------------------------- | ----------------------- | | 103 × 150 mm, Faltband oder Rolle | Deutschland, Frankreich | | 103 × 199 mm, Faltband oder Rolle | Deutschland | Für andere Länder bleibt der vorhandene internationale PDF-Flow erhalten. PDF-Etiketten ohne QR können auch auf den unterstützten Thermomedien erzeugt werden. ZPL wird getrennt von PDF gespeichert; vorhandene Dokumente bleiben beim Upgrade erhalten. QR-Codes werden weiterhin als originales PNG ausgegeben. Ein Dymo verarbeitet nicht automatisch eine Zebra-ZPL-Datei. Für einen Dymo-Test können Sie stattdessen ein PDF im passenden Thermoformat erzeugen und über dessen Druckertreiber drucken. Ein solcher PDF-Test bestätigt nicht die korrekte ZPL-Ausgabe an einem Zebra-Drucker. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.solutioo.de/dhl-connector/fehlerbehebung-and-support/dhl-parcel-retoure.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.