> 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/english-documentation/dhl-integration.md).

# DHL integration

The Huebert Dropshipping Plugin can automatically create **DHL shipping labels** and attach them to the supplier email.

> **Requirement:** This feature requires the **Pickware DHL** plugin to be installed in your Shopware instance.

***

## How it works

When the DHL integration is enabled, the following process runs:

1. Order reaches the trigger status
2. Plugin automatically creates a DHL shipping label for the order
3. The label is attached as a PDF to the supplier email (optional)
4. The label can be saved as a file or stored directly in the order

***

## Global DHL settings

In the plugin settings under **Settings > Plugins > Huebert Dropshipping**:

| Setting                            | Description                                                                          |
| ---------------------------------- | ------------------------------------------------------------------------------------ |
| **Activate DHL shipping labels**   | Enables global DHL label creation                                                    |
| **Send label as email attachment** | The created DHL label is attached to the supplier email                              |
| **Reuse existing label**           | If a label already exists for this order, it is reused instead of creating a new one |

***

## DHL settings per supplier

In addition, DHL can be enabled or disabled **per supplier**:

| Setting                       | Description                                           |
| ----------------------------- | ----------------------------------------------------- |
| **Create DHL shipping label** | Enables label creation for this specific supplier     |
| **Send label in email**       | Attaches the label to the email sent to this supplier |

***

## DHL – Separate house number

For the DHL integration, the house number must be transmitted in a separate field, apart from the street name. The plugin adds an additional **"House number"** field to the address fields in the Shopware storefront.

The field is automatically shown on the order address form and is used for the DHL API.

> **Note:** The labels, placeholders and hint texts of this field (e.g. "Street Number" or "Missing street number from Shipping Address") are customizable text snippets. You can find the full list under [Text snippets](/dropshipping-bestellung-an-lieferanten-herstelle/english-documentation/text-snippets.md).

***

## Label in the order

After creation, DHL label references are stored in the order. You can view the created labels in the order overview.

***

## Frequently asked questions

**Is a separate label created for each line item?**\
No, one label is created per order (or per supplier), covering all line items for that supplier.

**What happens if the label cannot be created?**\
If label creation fails, the email is still sent — but without the DHL label as an attachment.

**Can I disable label creation for individual suppliers?**\
Yes, via the DHL settings on the supplier detail page.

**What does "Reuse existing label" mean?**\
When this option is active and a DHL label already exists for an order, that label is used. No new label is created. This prevents multiple label generations when an email is resent.