> 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/plugin-configuration.md).

# Plugin configuration

The global plugin configuration can be found in the Shopware administration under:\
**Settings > System > Plugins > Huebert Dropshipping > Configure**

***

## Test mode

Test mode allows you to safely test the plugin without sending real emails to suppliers.

| Setting                | Description                                                                                   |
| ---------------------- | --------------------------------------------------------------------------------------------- |
| **Test email address** | All dropshipping emails are sent to this address instead of the configured supplier addresses |
| **Activate test mode** | Enables test mode. All supplier and manufacturer emails are redirected to the test address    |

> **Note:** Enable test mode during initial setup to verify your configuration before real emails are sent.

***

## Trigger status (payment & order status)

Defines which **payment status** or **order status** triggers the sending of dropshipping emails. The trigger fires as soon as one of the configured statuses is set.

| Setting                                               | Description                                                                                                                                                                                                                                                                                    |
| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Trigger status (payment)**                          | Payment status that triggers email sending                                                                                                                                                                                                                                                     |
| **Trigger status (order)**                            | Order status that triggers email sending                                                                                                                                                                                                                                                       |
| **Payment and order status must or can be fulfilled** | How the payment and order status of this trigger are combined: **OR condition** *(default)* – the email is triggered as soon as one of the two statuses applies. **AND condition** – the email is only triggered once both the payment status and the order status apply to the current order. |

**Available payment statuses:**

* Disabled
* Authorized
* Cancelled
* Chargeback
* Failed
* In progress
* Open
* **Paid** *(default)*
* Partially paid
* Refunded
* Partially refunded
* Reminded

**Available order statuses:**

* Disabled *(default)*
* Open
* In progress
* Completed
* Cancelled

> **Tip:** In most cases, "Paid" is a sensible trigger for the payment status, as it ensures that the order is only forwarded to the supplier after payment has been received.

***

## Additional trigger status

You can configure a **second trigger status** to send emails on a further status transition. The additional trigger is **always combined with the first trigger via an OR condition**: the email is sent as soon as **trigger 1 or** the additional trigger fires.

| Setting                                               | Description                                                                                                                                                                                                                                     |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Activate additional trigger**                       | Enables or disables the additional trigger *(default: active)*. When disabled, the additional trigger is ignored entirely.                                                                                                                      |
| **Trigger status 2 (payment)**                        | Second payment status as trigger                                                                                                                                                                                                                |
| **Trigger status 2 (order)**                          | Second order status as trigger                                                                                                                                                                                                                  |
| **Payment and order status must or can be fulfilled** | How the payment and order status **within** the additional trigger are combined: **OR condition** *(default)* – fires as soon as one of the two statuses applies. **AND condition** – only fires once both statuses apply to the current order. |
| **Resend email on trigger**                           | Email is resent when the trigger status is set, even if an email was already sent for this order                                                                                                                                                |

> **Note on the AND condition:** Status changes are dispatched one at a time. With the AND condition the email is therefore only sent once the current status change makes **both** configured statuses of the order apply simultaneously (e.g. payment status "Paid" **and** order status "In progress").

***

## General email options

| Setting                           | Description                                                                   |
| --------------------------------- | ----------------------------------------------------------------------------- |
| **BCC email**                     | This address receives a blind copy (BCC) of all dropshipping emails           |
| **Send email on order placement** | Email is sent immediately after order placement, regardless of trigger status |
| **Add attachments**               | CSV or XML file is attached to the email *(default: active)*                  |
| **Email template**                | Select the email template to use                                              |
| **No email if in stock**          | Does not send an email if the product is still in stock                       |

### Email templates

The following templates are available:

| Template                                           | Description                               |
| -------------------------------------------------- | ----------------------------------------- |
| `Dropshipping Partner Delivery Note`               | Older version (V1)                        |
| `Dropshipping Partner Delivery Note v2`            | Current default version *(recommended)*   |
| `Dropshipping Partner Delivery Note mpXgastronomy` | Specifically for the mpXgastronomy plugin |

> For more details on email templates, see [Email templates](/dropshipping-bestellung-an-lieferanten-herstelle/english-documentation/email-templates.md).

***

## DHL shipping labels

> These features require the free extension **DHL Versand by Pickware**.

| Setting                            | Description                                                      |
| ---------------------------------- | ---------------------------------------------------------------- |
| **Activate DHL shipping labels**   | Enables automatic DHL label creation                             |
| **Send label as email attachment** | The DHL label is attached to the supplier email as a PDF         |
| **Reuse existing label**           | Does not create a new label if one already exists for this order |

> For more details on the DHL integration, see [DHL integration](/dropshipping-bestellung-an-lieferanten-herstelle/english-documentation/dhl-integration.md).
