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


---

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