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

# Supplier management

The plugin provides a dedicated supplier management module where you can create and configure suppliers independently of Shopware's built-in manufacturers.

You can find this section in the Shopware administration under:\
**Catalogues > Suppliers**

***

## Creating a supplier

Click the **"Add supplier"** button in the top right to create a new supplier.

### Basic configuration

<figure><img src="/files/rHydy214TJrxQJfY7KKs" alt=""><figcaption></figcaption></figure>

| Field                                                                | Description                                                                                                                                                                  |
| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**                                                             | Supplier name (required)                                                                                                                                                     |
| **Email address** <mark style="color:red;">**(1)**</mark>            | Primary email for order notifications (required)                                                                                                                             |
| **Additional email address** <mark style="color:red;">**(2)**</mark> | Second email address that also receives notifications                                                                                                                        |
| **Logo**                                                             | Optional image/logo for the supplier                                                                                                                                         |
| **Description**                                                      | Internal description                                                                                                                                                         |
| **Dropshipping active** <mark style="color:red;">**(3)**</mark>      | Enables or disables this supplier for dropshipping                                                                                                                           |
| **Minimum order value** <mark style="color:red;">**(4)**</mark>      | Minimum cart value for products of this supplier (see [Minimum order value](/dropshipping-bestellung-an-lieferanten-herstelle/english-documentation/minimum-order-value.md)) |

***

## Configuring the export

<figure><img src="/files/8mMEmuzVqUqAg8IkVaUu" alt=""><figcaption></figcaption></figure>

### CSV export configuration

In the **CSV settings** section, configure how order data is formatted as a CSV file.

| Field                                                             | Description                                                               |
| ----------------------------------------------------------------- | ------------------------------------------------------------------------- |
| **Send CSV as attachment**                                        | Attaches the CSV file to the email                                        |
| **Delimiter**                                                     | Field separator: semicolon (`;`), comma (`,`), or pipe (`\|`)             |
| **Filename** <mark style="color:red;">**(2)**</mark>              | Filename of the CSV (supports Twig variables)                             |
| **Header template** <mark style="color:red;">**(3)**</mark>       | Column names/headings of the CSV (one per line)                           |
| **Column template** <mark style="color:red;">**(3)**</mark>       | Twig template for the data columns (one per line)                         |
| **Directory / file path** <mark style="color:red;">**(4)**</mark> | Storage location on the server (starting from `files/`). Must be enabled. |
| **Save file**                                                     | Additionally saves the CSV file on the server                             |

#### Example: Filename with variables

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

Result: `ORDER_10042_15-03-2024.csv`

#### Default CSV template

**Header:**

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

**Columns:**

```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 }}
```

> All available variables are listed under [CSV & XML export](/dropshipping-bestellung-an-lieferanten-herstelle/english-documentation/csv-xml-export.md).

***

### XML export configuration

As an alternative to CSV, the export can also be delivered as an **XML file**.

| Field                                                     | Description                                   |
| --------------------------------------------------------- | --------------------------------------------- |
| **Export as XML** <mark style="color:red;">**(1)**</mark> | Switches from CSV to XML format               |
| **XML header**                                            | Output once at the beginning of the XML file  |
| **XML body**                                              | Repeated for each order line item             |
| **XML footer**                                            | Output once at the end of the XML file        |
| **File path**                                             | Storage location on the server                |
| **Save file**                                             | Additionally saves the XML file on the server |

#### Default XML template

**Header:**

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

**Body (repeated per order line item):**

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

> The placeholder `lineItems.at(n)` is automatically replaced by the respective line item index.

***

## DHL settings (per supplier)

In addition to the global DHL settings, DHL can also be enabled or disabled per supplier.

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

***

## Loading default values

On the supplier detail page, you can load **default templates** for CSV and XML. This fills the corresponding fields with the example templates shown above and is especially helpful during initial setup.