Mit Document V2 kannst du Rechnungen, Gutschriften, Stornorechnungen und Lieferscheine für deine Bestellungen erstellen und verwalten. In diesem Tutorial aktivierst du die Funktion, richtest deine Dokumente ein und erstellst deine erste Rechnung. Anschließend erfährst du, wie du Dokumente herunterlädst, versendest und weitere Funktionen nutzt.
Experimentelle Funktion: Document V2 befindet sich im experimentellen Status. Damit du die Funktion nutzen kannst, musst du sie zunächst über das Feature Flag DOCUMENT_GENERATION_REWORK aktivieren. Weitere Informationen findest du in der Entwickler-Dokumentation zu Document V2.
Für die Erstellung einer Rechnung benötigst du eine Bestellung. Wenn du eine Gutschrift oder Stornorechnung erstellen möchtest, muss bereits eine Rechnung vorhanden sein. Für eine Gutschrift benötigst du außerdem Gutschriftspositionen.
Die Aktivierung erfolgt über die technische Konfiguration deiner Shopware-Installation. Wenn du keinen Zugriff darauf hast, bitte die für deinen Shop zuständige technische Betreuung, das Flag zu aktivieren.
Shopware beschreibt die Aktivierung von Feature Flags über die Datei .env. Für das in der Document-V2-Dokumentation genannte Flag ergibt sich daraus folgender Eintrag:
DOCUMENT_GENERATION_REWORK=1Öffne die .env deiner Shopware-Installation, ergänze den Eintrag beziehungsweise ändere den vorhandenen Wert auf 1 und speichere die Datei. Die allgemeine Vorgehensweise ist unter Feature Flags aktivieren dokumentiert.
Prüfe zunächst deine Unternehmensdaten unter Einstellungen > Stammdaten > Unternehmensinformationen. Dort pflegst du die Unternehmensdaten selbst.
Öffne anschließend Einstellungen > Shop > Dokumente. Hier legst du fest, wie deine Dokumente aufgebaut sind und welche Inhalte sie anzeigen.
Du kannst folgende Einstellungen konfigurieren:
Kundenkonto: Anzeige der Dokumente im Kundenkonto.
Adressen: Unternehmens- und Rücksendeadresse.
Dateinamen: Präfix, Suffix und formatabhängige Zusätze.
Passe die Einstellungen an deine Anforderungen an. Prüfe das Ergebnis anschließend anhand der Vorschau eines Dokuments.
Wenn keine Dokumentnummer ausdrücklich übergeben wird, verwendet Document V2 den Nummernkreis des jeweiligen Dokumenttyps. Siehe dazu die Dokumenterstellung in der Entwickler-Dokumentation.
Welche Dateiformate du auswählen kannst, hängt vom Dokumenttyp ab:
| Dokumenttyp | Verfügbare Formate |
|---|---|
| Rechnung | PDF, HTML, ZUGFeRD XML, PDF mit eingebettetem ZUGFeRD |
| Gutschrift | PDF, HTML, ZUGFeRD XML, PDF mit eingebettetem ZUGFeRD |
| Stornorechnung | PDF, HTML, ZUGFeRD XML, PDF mit eingebettetem ZUGFeRD |
| Lieferschein | PDF, HTML |
Die Zuordnung ist in der Übersicht der Dokumenttypen und Formate beschrieben.
Anschließend kannst du das Dokument herunterladen oder per E-Mail versenden.
Öffne in der Bestellung den Bereich Dokumente und wähle die erstellte Rechnung aus.
Als gesendet markieren: Nutze diese Funktion, um das Dokument als „gesendet“ zu kennzeichnen.
Das Versenden per E-Mail und das Markieren als „gesendet“ stehen als separate Funktionen zur Verfügung.
Neben Rechnungen kannst du unter Bestellung > Dokumente auch Gutschriften, Stornorechnungen und Lieferscheine erstellen. Wähle dazu den jeweiligen Dokumenttyp aus, lege die verfügbaren Dateiformate fest und ergänze die Dokumentangaben. Prüfe das Dokument in der Vorschau, bevor du es generierst.
Beachte dabei die folgenden zusätzlichen Voraussetzungen:
| Dokumenttyp | Zusätzliche Voraussetzungen |
|---|---|
| Gutschrift | Eine vorhandene Rechnung und Gutschriftspositionen |
| Stornorechnung | Eine vorhandene Rechnung |
| Lieferschein | Ein Lieferdatum für die Erstellung |
Das erforderliche Lieferdatum für Lieferscheine ist ebenfalls in der Übersicht der Dokumenttypen beschrieben.
Im Dokumentbereich einer Bestellung kannst du vorhandene Dokumente in verschiedenen Formaten öffnen oder herunterladen, per E-Mail versenden, als „gesendet“ markieren und löschen.
Wenn du mehrere Dokumente gemeinsam herunterladen möchtest, kannst du sie gesammelt als ZIP-Archiv herunterladen.
Du kannst außerdem bestehende Dokumentdateien hochladen. Die maximale Dateigröße beträgt 50 MB pro Datei.
Wenn du Dokumente regelmäßig oder für mehrere Bestellungen benötigst, stehen dir weitere Möglichkeiten zur Verfügung.
Document V2 unterstützt die Dokumenterstellung über den Flow Builder. Außerdem können Dokumente automatisch in verschiedenen Formaten als E-Mail-Anhänge verwendet werden.
In der Mehrfachänderung von Bestellungen kannst du Dokumente für mehrere Bestellungen erstellen, herunterladen und löschen.
Bei der Dokumenterstellung unterstützt Document V2 sowohl das Überspringen bereits vorhandener Dokumente als auch eine erzwungene Neuerstellung. Wähle das Verhalten passend zu deinem Anwendungsfall.