# 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, lauft 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

Zusatzlich konnen 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**     | Fugt 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 fur die DHL-API verwendet.

***

## 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 enthalt.

**Was passiert, wenn das Etikett nicht erstellt werden kann?**\
Wenn die Etiketten-Erstellung fehlschlagt, 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hubyte.de/dropshipping-bestellung-an-lieferanten-herstelle/dhl-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.