# Lieferantenverwaltung

Das Plugin bietet eine eigene Lieferantenverwaltung, mit der Sie Lieferanten unabhangig von den Shopware-Herstellern anlegen und konfigurieren konnen.

Den Bereich finden Sie in der Shopware-Administration unter:\
**Katalog > Dropshipping Lieferanten**

***

## Lieferant anlegen

Klicken Sie oben rechts auf **"Lieferant hinzufugen"**, um einen neuen Lieferanten zu erstellen.

### Grunddaten

| Feld                           | Beschreibung                                                                                                                                                        |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**                       | Bezeichnung des Lieferanten (pflichtfeld)                                                                                                                           |
| **E-Mail-Adresse**             | Haupt-E-Mail des Lieferanten fur Bestellbenachrichtigungen (pflichtfeld)                                                                                            |
| **Zusatzliche E-Mail-Adresse** | Zweite E-Mail-Adresse, die ebenfalls benachrichtigt wird                                                                                                            |
| **Logo**                       | Optionales Bild/Logo des Lieferanten                                                                                                                                |
| **Beschreibung**               | Interne Beschreibung des Lieferanten                                                                                                                                |
| **Dropshipping aktiv**         | Aktiviert oder deaktiviert den Lieferanten fur das Dropshipping                                                                                                     |
| **Mindestbestellwert**         | Mindestbestellwert fur diesen Lieferanten (siehe [Mindestbestellwert](https://docs.hubyte.de/dropshipping-bestellung-an-lieferanten-herstelle/minimum-order-value)) |

***

## CSV-Export konfigurieren

Im Bereich **CSV-Einstellungen** konfigurieren Sie, wie die Bestelldaten als CSV-Datei aufbereitet werden.

| Feld                      | Beschreibung                                               |
| ------------------------- | ---------------------------------------------------------- |
| **CSV als Anhang senden** | Fugt die CSV-Datei der E-Mail als Anhang hinzu             |
| **Trennzeichen**          | Feldtrenner: Semikolon (`;`), Komma (`,`) oder Pipe (`\|`) |
| **Dateiname**             | Dateiname der CSV-Datei (unterstutzt Twig-Variablen)       |
| **Kopfzeile**             | Spaltennamen der CSV-Datei (eine pro Zeile)                |
| **Spalten**               | Twig-Vorlage fur die Datenspalten (eine pro Zeile)         |
| **Dateipfad**             | Speicherort auf dem Server (ab `files/`)                   |
| **Datei speichern**       | Speichert die CSV-Datei zusatzlich auf dem Server          |

### Beispiel: Dateiname mit Variablen

```twig
ORDER_{{ order.orderNumber }}_{{ order.orderDate|date('d-m-Y') }}
```

Ergebnis: `ORDER_10042_15-03-2024.csv`

### Standard-CSV-Vorlage

**Kopfzeile:**

```
OrderNumber
OrderDate
NetPrice
TotalPrice
Tax
ProductName
ManufacturerNumber
Quantity
```

**Spalten:**

```twig
{{ order.orderNumber }}
{{ order.orderDate|date }}
{{ order.price.netPrice }}
{{ order.price.totalPrice }}
{{ order.price.calculatedTaxes.at(0).tax }}
{{ order.lineItems.at(n).label }}
{{ order.lineItems.at(n).payload.manufacturerNumber|default('') }}
{{ order.lineItems.at(n).quantity }}
```

> Alle verfugbaren Variablen finden Sie unter [CSV- & XML-Export](https://docs.hubyte.de/dropshipping-bestellung-an-lieferanten-herstelle/csv-xml-export).

***

## XML-Export konfigurieren

Alternativ zur CSV-Datei kann der Export als **XML-Datei** erfolgen.

| Feld                    | Beschreibung                                        |
| ----------------------- | --------------------------------------------------- |
| **Als XML exportieren** | Wechselt vom CSV- zum XML-Format                    |
| **XML-Header**          | Wird einmalig am Anfang der XML-Datei ausgegeben    |
| **XML-Body**            | Wird fur jede Bestellposition wiederholt ausgegeben |
| **XML-Footer**          | Wird einmalig am Ende der XML-Datei ausgegeben      |
| **Dateipfad**           | Speicherort auf dem Server                          |
| **Datei speichern**     | Speichert die XML-Datei auf dem Server              |

### Standard-XML-Vorlage

**Header:**

```xml
<?xml version="1.0" encoding="UTF-8"?><orders>
```

**Body (wird pro Bestellposition wiederholt):**

```xml
<order>
  <number>{{ order.orderNumber }}</number>
  <date>{{ order.orderDate|date }}</date>
  <price>{{ order.price.netPrice }}</price>
  <total_price>{{ order.price.totalPrice }}</total_price>
  <tax>{{ order.price.calculatedTaxes.at(0).tax }}</tax>
  <item_name>{{ order.lineItems.at(n).label }}</item_name>
</order>
```

**Footer:**

```xml
</orders>
```

> Das Platzhalter `lineItems.at(n)` wird automatisch durch den jeweiligen Index der Bestellposition ersetzt.

***

## DHL-Einstellungen (pro Lieferant)

Zusatzlich zu den globalen DHL-Einstellungen kann DHL auch pro Lieferant aktiviert werden.

| Feld                             | Beschreibung                                                 |
| -------------------------------- | ------------------------------------------------------------ |
| **DHL-Versandetikett erstellen** | Aktiviert die DHL-Etikettenerstellung fur diesen Lieferanten |
| **Etikett in E-Mail senden**     | Fugt das DHL-Etikett der Lieferanten-E-Mail hinzu            |

***

## Standardwerte laden

Auf der Lieferanten-Detailseite gibt es die Moglichkeit, **Standard-Vorlagen** fur CSV und XML zu laden. Dies fult die entsprechenden Felder mit den oben gezeigten Beispielen aus und ist besonders hilfreich bei der Ersteinrichtung.