> 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/email-templates.md).

# E-Mail-Vorlagen

Das Plugin liefert mehrere E-Mail-Vorlagen mit, die Sie in der Shopware-Administration anpassen können.

***

## Vorhandene Vorlagen

Nach der Plugin-Installation stehen folgende E-Mail-Vorlagen zur Verfügung:

### 1. Dropshipping Partner Delivery Note v2 (empfohlen)

* **Technischer Name:** `huebert_dropshipping_sw6_dropshipping_partner_v2`
* **Verwendung:** Standard-Vorlage für Lieferantenbenachrichtigungen
* **Auswahl in Plugin-Konfiguration:** "Dropshipping Partner Delivery Note v2"

### 2. Dropshipping Partner Delivery Note (alt)

* **Technischer Name:** `huebert_dropshipping_sw6_dropshipping_partner`
* **Verwendung:** Ältere Version, für Kompatibilitat mit bestehenden Anpassungen

### 3. Dropshipping Partner Delivery Note mpXgastronomy

* **Technischer Name:** `huebert_dropshipping_sw6_dropshipping_partner_mpx`
* **Verwendung:** Speziell für Shops, die das mpXgastronomy-Plugin verwenden

### 4. Dropshipping Customer Delivery Status Note

* **Technischer Name:** `huebert_dropshipping_sw6_dropshipping_delivery_status`
* **Verwendung:** Kundenseitige Benachrichtigung über den Lieferstatus

***

## Vorlagen anpassen

Die Vorlagen können in der Administration unter:\
**Einstellungen > Inhalte > E-Mail-Templates**

gesucht und bearbeitet werden. Suchen Sie nach dem technischen Namen oder nach "Dropshipping".

***

## Verfügbare Template-Variablen

In allen Dropshipping-E-Mail-Vorlagen stehen folgende Variablen zur Verfügung:

### Bestelldaten (`order`)

| Variable                      | Beschreibung                 | Beispiel              |
| ----------------------------- | ---------------------------- | --------------------- |
| `order.orderNumber`           | Bestellnummer                | `10042`               |
| `order.orderDate`             | Bestelldatum                 | `2024-03-15 14:30:00` |
| `order.price.netPrice`        | Netto-Gesamtpreis            | `84.03`               |
| `order.price.totalPrice`      | Brutto-Gesamtpreis           | `100.00`              |
| `order.price.calculatedTaxes` | Steuer-Informationen (Array) | -                     |
| `order.lineItems`             | Alle Bestellpositionen       | -                     |

### Kundendaten (`customer`)

| Variable                  | Beschreibung   |
| ------------------------- | -------------- |
| `customer.firstName`      | Vorname        |
| `customer.lastName`       | Nachname       |
| `customer.email`          | E-Mail-Adresse |
| `customer.customerNumber` | Kundennummer   |

### Lieferschein-Daten (`deliveryNote`)

Das `deliveryNote`-Objekt enthält die für diesen Lieferanten relevanten Positionen. Über `deliveryNote.items` kann mit einer Schleife auf jede Position zugegriffen werden.

#### Produktdaten pro Position (`item`)

| Variable                         | Beschreibung                            | Beispiel            |
| -------------------------------- | --------------------------------------- | ------------------- |
| `item.label`                     | Produktname                             | `"T-Shirt Blau XL"` |
| `item.quantity`                  | Menge                                   | `2`                 |
| `item.productNumber`             | Shopware-Produktnummer                  | `"SW10042"`         |
| `item.productManufacturerNumber` | Herstellernummer                        | `"MNR-001"`         |
| `item.variant`                   | Varianteninformationen (Array)          | –                   |
| `item.purchaseNetPrice`          | Einkaufspreis (netto)                   | `84.03`             |
| `item.supplier.translated.name`  | Lieferantenname                         | `"Lieferant GmbH"`  |
| `item.cover.url`                 | URL des Produktvorschaubilds (optional) | –                   |

#### Produkt-Vorschaubild (Cover) in der E-Mail

Da das Cover-Bild nicht bei jedem Produkt vorhanden ist, sollte vor der Ausgabe eine Prüfung erfolgen:

```twig
{% for item in deliveryNote.items %}
  {% if item.cover is defined and item.cover is not null %}
    <img src="{{ item.cover.url }}" width="75" height="auto" />
  {% endif %}
{% endfor %}
```

> Informationen zur Verwendung des Lieferantennamens im Storefront (Produktseite, Warenkorb, Checkout, Dokumente) finden Sie unter [Lieferant im Storefront verwenden](/dropshipping-bestellung-an-lieferanten-herstelle/supplier-in-storefront.md).

***

## Bestellbestätigungs-E-Mail: Zusätzliche Variablen

Die folgenden Variablen stehen in der **Standard-Shopware-Bestellbestätigungsmail** zur Verfügung und können dort für eigene Anpassungen genutzt werden.

### Separates Hausnummernfeld (DHL-Integration)

Wenn das DHL-Plugin ein separates Hausnummernfeld verwendet, kann dieses in der Bestellbestätigung wie folgt ausgegeben werden:

**Lieferadresse:**

```twig
{% if shippingOrderAddress.customFields and shippingOrderAddress.customFields.dhl_address_street_number %}
  {{ shippingOrderAddress.customFields.dhl_address_street_number }}
{% endif %}
```

**Rechnungsadresse:**

```twig
{% if billingAddress.customFields and billingAddress.customFields.dhl_address_street_number %}
  {{ billingAddress.customFields.dhl_address_street_number }}
{% endif %}
```

### Herstellernummer und Menge einer Bestellposition

Über den Index `n` (0-basiert) kann auf einzelne Positionen der Bestellung zugegriffen werden:

| Variable                                                              | Beschreibung                  |
| --------------------------------------------------------------------- | ----------------------------- |
| `{{ order.lineItems.at(n).payload.manufacturerNumber\|default('') }}` | Herstellernummer der Position |
| `{{ order.lineItems.at(n).quantity }}`                                | Bestellmenge der Position     |

Beispiel für die erste Bestellposition (Index `0`):

```twig
{{ order.lineItems.at(0).payload.manufacturerNumber|default('') }}
{{ order.lineItems.at(0).quantity }}
```

***

## Beispiel: Einfache E-Mail-Vorlage

### Betreff

```twig
Neue Dropshipping-Bestellung #{{ order.orderNumber }}
```

### HTML-Inhalt

```html
Sehr geehrte Damen und Herren,<br><br>nachfolgend bekommen Sie den Lieferschein für die Bestellung {{ order.orderNumber}}. Bitte bestätigen Sie den Versand per E-Mail.<br>
<br>
<table style="border: 1px solid black; border-spacing: 15px;">
    <tr>
        <th>Produkt-Nummer</th>
        <th>Produkt-Hersteller-Nummer</th>
        <th>Bezeichnung</th>
        <th>Menge</th>
    </tr>
    {% if deliveryNote is defined and deliveryNote.items is defined %}
    {% for item in deliveryNote.items %}
    <tr>
        <td>{{ item.productNumber }}</td>
        <td>{{ item.productManufacturerNumber }}</td>
        <td>{{ item.label }}
        {% if item.variant|length > 0 %}
        <br> - {{ item.variant|join(" - ") }}
        {% endif %}
        </td>
        <td>{{ item.quantity }}</td>
    </tr>
    {% endfor %}
    {% endif %}
</table>
<br>
Lieferanschrift:<br>
   {% if order.deliveries is defined %}
{% for item in order.deliveries %}
{{ item.shippingOrderAddress.title }} {{ item.shippingOrderAddress.firstName }} {{ item.shippingOrderAddress.lastName }}<br>
{{ item.shippingOrderAddress.street }} {% if streetNumberActivated and item.shippingOrderAddress.customFields and item.shippingOrderAddress.customFields.dhl_address_street_number %}{{ item.shippingOrderAddress.customFields.dhl_address_street_number }}{% endif %}<br>
{{ item.shippingOrderAddress.zipcode }} {{ item.shippingOrderAddress.city }}<br>
{{ item.shippingOrderAddress.country.name }}<br>
<br>
{% endfor %}
{% endif %}
Versandmethode: {{ order.deliveries|first.shippingMethod.name }}<br>
Zahlungsmethode: {{ order.transactions|first.paymentMethod.name }}
```

***

## Vorlage auswählen

In den **Plugin-Einstellungen** können Sie festlegen, welche Vorlage für alle Lieferantenbenachrichtigungen verwendet werden soll:

**Einstellungen > Plugins > Huebert Dropshipping > E-Mail-Vorlage**

Wählen Sie die gewünschte Vorlage aus der Dropdown-Liste.

***

## Mehrsprachigkeit

Die E-Mail-Vorlagen können für jede Sprache separat angepasst werden. Shopware sendet automatisch die E-Mail in der Sprache des Verkaufskanals der Bestellung.

***

## Wichtige Hinweise

* Ändern Sie immer zuerst die Vorlage im Testmodus, um die Ausgabe zu prüfen
* Der **Testmodus** in den Plugin-Einstellungen sendet alle E-Mails an eine Testadresse
* Die Vorlage "v2" ist die empfohlene aktuelle Version
* Bei Updates des Plugins sollten angepasste Vorlagen auf neue Variablen geprüft werden
