> For the complete documentation index, see [llms.txt](https://docs.hubyte.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hubyte.de/dropshipping-bestellung-an-lieferanten-herstelle/dhl-integration.md).

# DHL-Integration

Das Huebert Dropshipping Plugin kann automatisch **DHL-Versandetiketten** erstellen und diese als Anhang an die Lieferanten-E-Mail senden.

> **Voraussetzung:** Diese Funktion erfordert das **Pickware DHL**-Plugin in Ihrer Shopware-Installation.

***

## Funktionsweise

Wenn die DHL-Integration aktiviert ist, läuft folgender Prozess ab:

1. Bestellung erreicht den Trigger-Status
2. Plugin erstellt automatisch ein DHL-Versandetikett für die Bestellung
3. Das Etikett wird als PDF der Lieferanten-E-Mail angehängt (optional)
4. Das Etikett kann als Datei gespeichert oder direkt in der Bestellung hinterlegt werden

***

## Globale DHL-Einstellungen

In den Plugin-Einstellungen unter **Einstellungen > Plugins > Huebert Dropshipping**:

| Einstellung                             | Beschreibung                                                                                                  |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **DHL-Versandetiketten aktivieren**     | Schaltet die globale DHL-Etiketten-Erstellung ein                                                             |
| **Etikett als E-Mail-Anhang senden**    | Das erstellte DHL-Etikett wird der Lieferanten-E-Mail beigefügt                                               |
| **Vorhandenes Etikett wiederverwenden** | Wenn bereits ein Etikett für diese Bestellung existiert, wird es wiederverwendet statt ein neues zu erstellen |

***

## DHL-Einstellungen pro Lieferant

Zusätzlich können Sie DHL **pro Lieferant** aktivieren oder deaktivieren:

| Einstellung                      | Beschreibung                                                           |
| -------------------------------- | ---------------------------------------------------------------------- |
| **DHL-Versandetikett erstellen** | Aktiviert die Etiketten-Erstellung für diesen spezifischen Lieferanten |
| **Etikett in E-Mail senden**     | Fügt das Etikett der E-Mail an diesen Lieferanten hinzu                |

***

## DHL - Separate Hausnummer

Für die DHL-Integration muss die Hausnummer in einem separaten Feld übertragen werden, getrennt vom Straßennamen. Das Plugin fügt dafür ein zusätzliches Feld **"Hausnummer"** zu den Adressfeldern in der Shopware-Storefront hinzu.

Das Feld wird automatisch bei der Bestelladresse angezeigt und für die DHL-API verwendet.

> **Hinweis:** Die Beschriftungen, Platzhalter und Hinweistexte dieses Felds (z. B. "Hausnummer" oder "In der Lieferadresse fehlt die Hausnummer") sind anpassbare Textbausteine. Die vollständige Liste finden Sie unter [Textbausteine](/dropshipping-bestellung-an-lieferanten-herstelle/text-snippets.md).

***

## Etikett in der Bestellung

Nach der Erstellung werden DHL-Etiketten-Referenzen in der Bestellung gespeichert. Sie können die erstellten Etiketten in der Bestellübersicht einsehen.

***

## Häufige Fragen

**Wird für jede Bestellposition ein eigenes Etikett erstellt?**\
Nein, es wird ein Etikett pro Bestellung (bzw. pro Lieferant) erstellt, das alle Positionen des jeweiligen Lieferanten enthält.

**Was passiert, wenn das Etikett nicht erstellt werden kann?**\
Wenn die Etiketten-Erstellung fehlschlägt, wird die E-Mail trotzdem gesendet - allerdings ohne DHL-Etikett als Anhang.

**Kann ich die Etiketten-Erstellung für einzelne Lieferanten deaktivieren?**\
Ja, über die DHL-Einstellungen in der Lieferanten-Detailseite.

**Was bedeutet "Vorhandenes Etikett wiederverwenden"?**\
Wenn diese Option aktiviert ist und für eine Bestellung bereits ein DHL-Etikett existiert, wird dieses verwendet. Es wird kein neues Etikett erstellt. Dies verhindert mehrfache Generierung der Etiketten bei erneuter E-Mail-Versendung.