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


---

# 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 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/english-documentation/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.