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

Field	Description
Name	Supplier name (required)
Email address (1)	Primary email for order notifications (required)
Additional email address (2)	Second email address that also receives notifications
Logo	Optional image/logo for the supplier
Description	Internal description
Dropshipping active (3)	Enables or disables this supplier for dropshipping
Minimum order value (4)	Minimum cart value for products of this supplier (see Minimum order value)

---

Configuring the export

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 (2)	Filename of the CSV (supports Twig variables)
Header template (3)	Column names/headings of the CSV (one per line)
Column template (3)	Twig template for the data columns (one per line)
Directory / file path (4)	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

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:

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

---

XML export configuration

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

Field	Description
Export as XML (1)	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 version="1.0" encoding="UTF-8"?><orders>

Body (repeated per order line item):

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

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