In this article, we explain how you can customize your documents for supplier orders. Basically, you can export your supplier orders as a PDF document or as a CSV file from the Shopware Admin, or send them automatically by email.
Email sending for supplier orders
Under Settings → Extensions → Pickware ERP you can set BCC recipients for the supplier order email in the Supplier orders section.
Customizing the CSV file
Under Settings → Extensions → Pickware ERP you can select which columns should be included in the CSV file and in what order, in the Supplier orders section. Please note that these settings only apply to the email sending of supplier orders.
Editing the template for the PDF document
Configuration settings in the Shopware Admin
Under Settings → Documents → pickware_erp_supplier_order you'll find the settings for the PDF template of the supplier orders. There you can add your company logo and contact details, and set the orientation of the PDF file.
You can also create the document configuration for supplier orders per sales channel. Under Settings → Documents you can configure a separate supplier order document (pickware_erp_supplier_order) for each sales channel with its own logo, billing address, and business information. In the VAT ID and Tax number fields, you can enter the respective tax information for the sales channel — fields that are left empty will not be shown on the document. If you then link a supplier order to the corresponding sales channel, this information will automatically be used on the order document.
In the Business address field, you can enter your company address. This appears at the top right, above the destination address, on the document. To make sure the line breaks are placed in the right spot, you need to enter them in the following format:
Leerzeichen Bindestrich Leerzeichen Straße 12 Leerzeichen Bindestrich Leerzeichen 12345 Ort
The address will then be displayed on the document as follows:
Adjusting the warehouse address
The corresponding warehouse address is displayed on the supplier order. You can adjust the warehouse address via Lagerhaltung (Inventory Management) → Lager und Lagerplätze (Warehouses and Bin Locations) by selecting the respective warehouse and entering your warehouse's address in the Übersicht (Overview) tab under the Adresse (Address) section.
Customizing the template file
In addition, you can make further customizations to the PDF template for supplier orders.
Note that, unlike the Shopware standard, the Pickware templates consist of only a single block, which means that the entire block must be overwritten. You can find more information on this here on the Shopware website.
It doesn't matter which theme you overwrite the file in, since there is no connection here to customer orders or sales channels. Shopware loads the plugins and themes in the order of their installation date, and the respective twig files within them. So you can use any theme you like, or if needed create your own theme just for this purpose — the only requirement is that it is Active.
If you decide to create your own theme, you can create it using the Shopware CLI:
bin/console theme:create DeinTheme
bin/console plugin:install --activate DeinTheme
In the desired theme, you can then create the template file supplier-order.html.twigin the following directory:
/custom/plugins/DeinTheme/src/Resources/views/documents/supplier-order.html.twig
You can use the following code as a template for your customization:
// supplier-order.html.twig{% sw_extends '@PickwareErpStarter/documents/supplier-order.html.twig' %}{% block document_body %}// Original Inhalt{% endblock %}You can find our template for copying the content in the plugin folder under
PickwareErpStarter/vendor/pickware/erp-bundle/src/Resources/views/documents/supplier-order.html.twig
To learn how to use the template to set an individual text per supplier in the supplier email, see here.
Background image for documents
Under Background image in the document settings, you can add an image that will be displayed across the full page of the supplier order document. This lets you, for example, apply your corporate design to the document.
To do this, select an image from the media already uploaded to Shopware.
Be sure to keep the following in mind:
The image is stretched across the entire page area. Therefore, use an image with an A4 portrait aspect ratio (210 × 297 mm). For good display quality, a resolution of at least 1240 × 1754 pixels (150 DPI) is recommended, ideally 2480 × 3508 pixels (300 DPI).
The image must not be fully opaque, otherwise the text on the document will no longer be readable. Therefore, use an image with a transparent or very light background.