Aktuelle Beiträge Zum Blog
In einfachen Worten: Worum geht es auf dieser Seite?

Shopware baut die Erstellung von Rechnungen im Shop um. Der neue Weg ist noch ein Versuch. Mit der nächsten großen Version wird er zum Standard. Betreiber sollten ihn vorher in einer Kopie des Shops testen. Wichtig sind die Angaben zur eigenen Firma. Fehlt etwa der Ort, entsteht keine Rechnung. Wir zeigen, was Sie prüfen sollten. Lesen Sie weiter oder fragen Sie uns.

Seit Shopware 6.7.15.0 vom 1. Oktober 2026 steckt im Kern eine neu geschriebene Dokumentenerzeugung, vorerst hinter dem Funktionsschalter DOCUMENT_GENERATION_REWORK (Shopware Release Notes). Für Rechnungen ändert sich damit einiges: Ein Dokumenttyp erzeugt mehrere Formate in einem Lauf, ZUGFeRD ist kein eigener Dokumenttyp mehr, und die Firmenangaben ziehen aus der Dokumentvorlage in die Stammdaten je Verkaufskanal. Mit 6.8 wird die neue Erzeugung zum Standard, mit 6.9 entfällt der bisherige Weg (Shopware Release Notes). Dieser Beitrag zeigt, was Dokumente v2 für Ihre Rechnungen bedeutet, warum der Test in die Staging-Umgebung gehört und wie Sie Firmenangaben, Vorlagen und Plugins vorbereiten.

Was Shopware 6.7.15.0 an der Dokumentenerzeugung ändert

Shopware liefert mit 6.7.15.0 eine neue, zuschaltbare Umsetzung der Dokumentenerzeugung für Bestellungen aus (Shopware Release Notes). Sie ersetzt die bisherige Erzeugung, die Shopware mit 6.8 als veraltet kennzeichnen und mit 6.9 entfernen will (Shopware Release Notes). Eingeschaltet wird sie über den Funktionsschalter DOCUMENT_GENERATION_REWORK. Ohne ihn läuft der Shop vollständig auf dem bisherigen Weg (Shopware Release Notes). Wer nichts tut, merkt in 6.7 nichts vom Umbau.

Für die Einordnung ist das Etikett wichtig, das Shopware selbst vergibt: Die Release Notes führen v2 als experimentell. Klassen, die später zur öffentlichen Schnittstelle werden sollen, tragen den Vermerk @experimental und können sich laut Shopware mit jeder Version ändern (Shopware Release Notes). Erst mit 6.8 wird v2 zum Standard und die gekennzeichnete Oberfläche zur stabilen Schnittstelle (Shopware Release Notes). Der neue Weg ist damit zum Ausprobieren da, nicht für die Rechnungsstrecke im Jahresendgeschäft.

Zeitplan: 6.7 zum Einschalten, 6.8 als Standard mit der Möglichkeit zum Abschalten, 6.9 ohne die bisherige Umsetzung und ohne den Schalter.

Shopware, Release Notes 6.7.15.0 (eigene Übersetzung)

Die drei Phasen im Überblick

VersionNeue Erzeugung (v2)Bisheriger Weg (v1)Was Betreiber tun
6.7, aktuelle Reiheoptional, Schalter ab Werk ausStandardin der Staging-Umgebung einschalten und testen
6.8Standard, abschaltbarnoch vorhanden, als veraltet gekennzeichnetErweiterungen vorher auf v2 prüfen oder v2 bewusst abschalten
6.9einziger Wegentfernt, ebenso der Schalteralle Erweiterungen auf v2 umgestellt haben

Die Architekturentscheidung zur Umstellung beschreibt dieselben drei Phasen und ergänzt eine vierte: Nach 6.9 folgen Bereinigungen am Datenbankschema (Shopware ADR). Für Händler und Partner gibt Shopware dort eine knappe Empfehlung je Version. In 6.7 heißt sie: v2 einschalten und testen, ausdrücklich in der Staging-Umgebung (Shopware ADR). Vor dem Upgrade auf 6.8 soll jede Erweiterung mit Dokumentbezug auf v2 geprüft sein. Ist eine nicht so weit, lässt sich v2 abschalten, das Upgrade sicher durchführen und die Umstellung später nachholen (Shopware ADR). In 6.9 gibt es diese Wahl nicht mehr (Shopware ADR).

Experimentell heißt: erst testen, dann umschalten

Shopware hält fest, dass Händler jederzeit zurückschalten können (Shopware Release Notes). Das ist ein Sicherheitsnetz für den Test, aber kein Grund, echte Rechnungen über einen Weg laufen zu lassen, dessen Schnittstellen sich noch ändern dürfen.

Ein Dokumenttyp, vier Formate aus einem Lauf

Die größte Änderung betrifft das Verhältnis von Dokumenttyp und Dateiformat. Ein Dokumenttyp, also Rechnung, Stornorechnung, Lieferschein oder Gutschrift, kann in einem einzigen Erzeugungslauf mehrere Formate liefern: HTML, PDF, ZUGFeRD-XML und PDF mit eingebetteter ZUGFeRD-XML (Shopware Release Notes). Alle Formate eines Dokuments entstehen aus denselben Daten, tragen dieselbe Dokumentnummer und werden als eigene Dateien gespeichert (Shopware Release Notes). Welche Formate entstehen, legen Händler je Dokumenttyp fest (Shopware Release Notes).

Bisher war das anders gelöst. Das bisherige System koppelte Dokumenttyp und Dateiformat, sodass jede Kombination aus Typ und Format einen eigenen Renderer brauchte (Shopware-Dokumentation). Daraus folgt die zweite Neuerung: ZUGFeRD ist kein eigener Dokumenttyp mehr, sondern ein Dateiformat der Typen Rechnung, Stornorechnung und Gutschrift (Shopware Release Notes). Wer heute neben der PDF-Rechnung einen eigenen ZUGFeRD-Beleg erzeugt, bekommt in v2 eine einzige Rechnung mit zwei oder mehr Dateien.

HTML

Die Fassung für den Browser. Schaltet ein Shop auf den bisherigen Weg zurück, belegt sie dort den Platz der barrierefreien Fassung eines Dokuments (Shopware ADR).

PDF

Die gewohnte Rechnung zum Drucken und Versenden. Die bisherigen Oberflächen greifen standardmäßig zum PDF (Shopware ADR).

ZUGFeRD-XML

Der strukturierte Teil der E-Rechnung als eigene Datei, etwa für die Übergabe an Buchhaltung oder Warenwirtschaft.

PDF mit eingebetteter XML

Die hybride Form, die bisher als eigener ZUGFeRD-Typ lief. Weichen strukturierter Teil und Bildteil voneinander ab, sind die Daten des strukturierten Teils maßgebend (BMF).

Dass alle Formate aus einer Datengrundlage entstehen, passt zu dieser Rangfolge: PDF und XML einer Rechnung sollen nicht auseinanderlaufen. Dazu kommt eine zweite Festlegung. Jeder Erzeugungslauf hält die Bestellung in einer eigenen Bestellversion fest, ein Dokument zeigt also den Stand zum Zeitpunkt der Erzeugung (Shopware Release Notes). Die Dateinamen erhalten je Format einstellbare Namensteile. Ergäben zwei Formate mit derselben Dateiendung denselben Namen, lehnt Shopware die Einstellung schon beim Speichern ab (Shopware Release Notes).

Für den Versand an Kunden ist ein Detail wichtig, das im Test leicht untergeht: E-Mail-Anhänge und der Archiv-Download enthalten standardmäßig alle erzeugten Formate, die Mail-Aktionen im Flow Builder können gezielt einzelne Formate wählen (Shopware Release Notes). Wer für Rechnungen vier Formate einschaltet, verschickt ohne Anpassung also vier Anhänge. Die Mail-Flows gehören deshalb in jeden Testlauf.

Firmenangaben je Verkaufskanal und die fünf Pflichtfelder

Die Firmenangaben, die auf Dokumenten stehen, also Name, Anschrift, Steuer- und Bankdaten sowie das Logo, ziehen in eine neue Karte der Stammdaten, die im englischen Admin „Company information“ heißt (Shopware Release Notes). Gepflegt werden sie dort je Verkaufskanal, nicht mehr je Dokumenttyp (Shopware Release Notes). Im deutschen Admin heißt die Karte „Unternehmensinformationen“, und sie erscheint erst, wenn der Schalter eingeschaltet ist (Shopware-Quelltext). Bisher standen diese Angaben in den Dokumentvorlagen. Shopware liefert dafür globale Vorlagen für Lieferschein, Rechnung, Gutschrift und Stornorechnung, die sich je Verkaufskanal durch eigene Vorlagen überschreiben lassen (Shopware-Dokumentation).

Bestehende Werte übernimmt Shopware nicht in die neue Karte (Shopware Release Notes). Das klingt nach Datenverlust, ist aber keiner: Solange die Karte für einen Verkaufskanal leer ist, liest v2 die bisherigen Dokumenteinstellungen (Shopware Release Notes). Ein Shop, der den Schalter umlegt und sonst nichts ändert, druckt zunächst also dieselben Firmenangaben wie vorher. Ob die Erzeugung gelingt, hängt deshalb nicht an der fehlenden Übernahme, sondern daran, ob die Angaben dort, wo v2 sie liest, vollständig sind.

Neu ist die Prüfung: Fehlt der Name, die Straße, die Postleitzahl, der Ort oder das Land, bricht die Erzeugung mit einer klaren Fehlermeldung ab, statt still ein unvollständiges Dokument zu erzeugen (Shopware Release Notes). Im Quelltext ist das genau so angelegt. Name, Straße, Postleitzahl, Ort und Land sind Pflichtfelder der Firmenangaben, alle übrigen Felder sind optional (Shopware-Quelltext).

Wann die Erzeugung abbricht

Für die Praxis entscheidend ist, wann die bisherigen Einstellungen greifen und wann nicht. Im Quelltext von 6.7.15.0 nutzt v2 die neue Karte, sobald dort auch nur ein Feld einen Wert trägt. Nur wenn alle Felder leer sind, liest v2 die bisherige Dokumentvorlage (Shopware-Quelltext). Werte, die für alle Verkaufskanäle eingetragen sind, zählen dabei für jeden einzelnen Kanal mit (Shopware-Quelltext). Daraus ergeben sich drei typische Wege zum Abbruch:

  • Karte halb befüllt: Jemand trägt in der neuen Karte nur das Logo oder die E-Mail-Adresse ein. Ab diesem Moment liest v2 keine Angaben mehr aus der Dokumentvorlage, Name und Anschrift fehlen, die Erzeugung bricht ab.
  • Vorlage lückenhaft: Die Karte ist leer, aber in der bisherigen Vorlage des betroffenen Dokumenttyps fehlt ein Pflichtfeld, etwa der Ort in der Vorlage des Lieferscheins. Dann bricht v2 bei diesem Dokumenttyp ab, während die Rechnung durchläuft.
  • Land nicht gewählt: Das Land ist ein Auswahlfeld. Ohne gültige Auswahl bricht die Erzeugung ebenfalls ab (Shopware-Quelltext).
Karte vollständig befüllen, bevor der Test beginnt

Alle drei Fallen umgehen Sie am einfachsten, indem Sie die neue Karte für jeden Verkaufskanal vollständig befüllen, sobald der Schalter in der Staging-Umgebung umgelegt ist und bevor das erste Testdokument entsteht. Vorher zeigt der Admin die Karte nicht an (Shopware-Quelltext). Danach hängt das Ergebnis nicht mehr davon ab, was in welcher Dokumentvorlage steht.

Was v2 prüft und was das Umsatzsteuergesetz verlangt

Die neue Prüfung deckt die Absenderanschrift ab, nicht alle Pflichtangaben einer Rechnung. Eine Rechnung muss unter anderem den vollständigen Namen und die vollständige Anschrift des leistenden Unternehmers enthalten (§ 14 Abs. 4 UStG). Ebenso verlangt das Gesetz die Steuernummer oder die Umsatzsteuer-Identifikationsnummer (§ 14 Abs. 4 UStG). Diese beiden Felder sind in v2 optional (Shopware-Quelltext). Eine Rechnung ohne Steuernummer läuft also durch die Erzeugung, erfüllt die Pflichtangaben aber nicht.

AngabePrüft v2 vor der ErzeugungPflichtangabe nach § 14 Abs. 4 UStG
Name des leistenden Unternehmensja, Abbruch wenn leerja, vollständiger Name
Straße, Postleitzahl, Ort, Landja, Abbruch wenn ein Feld fehltja, vollständige Anschrift
Steuernummer oder USt-IdNr.nein, optionalja, eine der beiden
Bankverbindung, Logo, E-Mail, Telefonnein, optionalnicht unter den Angaben nach Absatz 4

Die Prüfung von v2 ersetzt also keine Kontrolle der Rechnungsinhalte, sie verhindert nur Dokumente ohne Absenderanschrift. Steuernummer und Umsatzsteuer-Identifikationsnummer gehören beim Einrichten der Karte mit auf die Liste.

Eigene Plugins, Apps und Vorlagen

Für Shops mit angepassten Rechnungen gibt es eine gute Nachricht: Überschreibungen der Twig-Vorlagen funktionieren weiter, denn v2 rendert dieselben Vorlagen unter @Framework/documents/*.html.twig (Shopware Release Notes). Erweiterungen, die nur das Aussehen eines Dokuments ändern, sind laut Shopware weitgehend nicht betroffen (Shopware ADR).

Anders sieht es bei Code aus, der in die Erzeugung eingreift. Die bisherigen Erweiterungspunkte, also die Tags document.renderer und document_type.renderer, die bisherigen Dokument-Ereignisse und Dekoratoren des bisherigen DocumentGenerator, ruft v2 nicht auf (Shopware Release Notes). Während der Übergangszeit dürfen beide Varianten nebeneinander registriert sein (Shopware Release Notes). Was v2 stattdessen anbietet:

  • Plugins registrieren Dokumenttypen, Datenlieferanten und Renderer als markierte Dienste: shopware.document_v2.type, shopware.document_v2.provider und shopware.document_v2.renderer (Shopware Release Notes).
  • Apps melden eigene Dokumenttypen über einen neuen Block <documents> im Manifest an. Ein Skript-Hook document-generation reichert die Daten an (Shopware Release Notes).
  • Grenze für Apps: Eigene Formate, Renderer oder typisierte Datenlieferanten bleiben Plugins vorbehalten (Shopware-Dokumentation).
  • Neue Ereignisse: document.generation.completed und document.generation.deleted melden erzeugte und gelöschte Dokumente samt Dokumentnummer und Bestellbezug und lassen sich im Flow Builder als Auslöser wählen (Shopware Release Notes).

Gerade die neuen Ereignisse sind für Anbindungen interessant, denn document.generation.completed wird für beide Wege ausgelöst, den bisherigen und v2 (Shopware Release Notes). Eine eigene Übergabe an Buchhaltung oder Warenwirtschaft lässt sich damit schon in 6.7 auf ein Ereignis setzen, das in beiden Zuständen des Schalters greift, etwa für die Anbindung an DATEV oder ein ERP. Welche Fragen bei dessen Auswahl zuerst kommen, beschreibt unser Beitrag zur ERP-Auswahl für Onlinehändler.

Eigener Code an der heutigen ZUGFeRD-Erzeugung

Das Ereignis zur erzeugten ZUGFeRD-Rechnung trägt im Quelltext von 6.7.15.0 den Vermerk, dass es mit 6.9.0 ersetzt wird; die XML entsteht dann im XML-Renderer von v2 ohne öffentliche Schnittstelle zum Zusammenbauen (Shopware-Quelltext). Was die heutige Standardrechnung in die XML schreibt, beschreibt unser Beitrag ZUGFeRD direkt aus Shopware.

Bestehende Dokumente und der Weg zurück

Ein Umstieg auf v2 erzeugt die Dokumente der Vergangenheit nicht neu. Die bisherigen ZUGFeRD-Typen, also die beiden Rechnungstypen und die vier Varianten für Storno und Gutschrift, zeigt die Oberfläche von v2 unverändert unter ihrem alten Namen und zum Herunterladen an (Shopware ADR). Ein Nachtragsverfahren ergänzt für alte Dokumente die Metadaten, die v2 braucht. Vorbereitet wird es in 6.7, gebraucht erst in 6.9 (Shopware ADR). Die eigentlichen Dateien fasst es laut Shopware nicht an (Shopware ADR).

Das ist für die Aufbewahrung wichtig. Rechnungen sind acht Jahre aufzubewahren (§ 14b UStG), und bei einer E-Rechnung muss zumindest der strukturierte Teil unversehrt in seiner ursprünglichen Form vorliegen (BMF). Laut Shopware bleiben bereits erzeugte Dokumente auch nach 6.9 ohne Neuerzeugung vollständig zugänglich (Shopware ADR).

Der Rückweg ist ebenfalls vorgesehen: In den Reihen 6.7 und 6.8 können Händler frei zwischen beiden Wegen wechseln (Shopware ADR). Eine Einschränkung nennt Shopware selbst. Die bisherigen Oberflächen zeigen höchstens zwei Formate je Dokument und greifen standardmäßig zum PDF (Shopware ADR). Ein in v2 ohne PDF erzeugtes Dokument ist nach dem Zurückschalten nur über eine ausdrückliche Anfrage nach dem Dateityp erreichbar (Shopware ADR). Wer testweise nur XML erzeugt, sollte das vor dem Zurückschalten wissen.

Für Kunden ändert sich am Download nichts. Sie laden Dokumente aus v2 über die bestehenden Wege im Shop und in der Store API, die Adressen bleiben gleich (Shopware Release Notes).

Testlauf in der Staging-Umgebung: Schritt für Schritt

Der Test gehört auf eine Kopie des Shops, eine Testumgebung (Staging), unabhängig davon, ob der Shop bei uns im Shopware-Hosting oder bei einem anderen Anbieter liegt. Shopware selbst empfiehlt für 6.7 genau diesen Weg (Shopware ADR). Ein vollständiger Testlauf folgt typischerweise dieser Reihenfolge:

  1. Staging aktualisieren: die Testumgebung auf den Stand des Livebetriebs bringen, mindestens 6.7.15.0, mit denselben Plugins und Apps.
  2. Erweiterungen erfassen: Plugins und Apps mit Dokumentbezug, eigene Twig-Überschreibungen und alle Flows mit Dokument- oder Mail-Aktionen auflisten.
  3. Schalter umlegen: DOCUMENT_GENERATION_REWORK nur in der Staging-Umgebung einschalten. Der Befehl feature:enable leert dabei den Cache (Shopware-Quelltext).
  4. Firmenangaben befüllen: in der Karte, die erst jetzt sichtbar ist, je Verkaufskanal alle fünf Pflichtfelder eintragen, dazu Steuernummer oder Umsatzsteuer-Identifikationsnummer, Bankverbindung und Logo.
  5. Formate festlegen: je Dokumenttyp entscheiden, welche Formate entstehen. Für Rechnungen an Geschäftskunden ist das in der Regel das PDF mit eingebetteter XML.
  6. Testbestellungen durchspielen: je Verkaufskanal Rechnung, Lieferschein, Stornorechnung und Gutschrift erzeugen, mit den Steuersätzen und Rabatten des Shops.
  7. Ergebnisse prüfen: Firmenangaben, Nummernkreise, Dateinamen, Mail-Anhänge und die XML mit dem Prüfwerkzeug Ihrer Buchhaltung kontrollieren.
  8. Zurückschalten und festhalten: den Schalter wieder ausschalten, Befunde dokumentieren und die Portierung der Erweiterungen planen.
Terminal
$ grep -rlE "document(_type)?\.renderer|DocumentGenerator" custom/plugins custom/static-plugins
$ bin/console feature:enable DOCUMENT_GENERATION_REWORK
[INFO] The cache was cleared.
[OK] The following features were enabled: DOCUMENT_GENERATION_REWORK
$ bin/console feature:disable DOCUMENT_GENERATION_REWORK
Die Kopie darf nichts Echtes auslösen

Eine Staging-Kopie enthält echte Kundendaten und häufig die Zugänge zu Buchhaltung, Warenwirtschaft und Zahlungsanbietern. Vor dem ersten Testdokument werden ausgehende Mails abgefangen und alle Anbindungen auf Testzugänge umgestellt oder abgeschaltet.

Zeitplan: E-Rechnungspflicht, Black Week und Shopware 6.8

Die Umstellung fällt in eine Phase, in der Rechnungen ohnehin im Mittelpunkt stehen. Seit dem 1. Januar 2025 müssen Unternehmen den Empfang von E-Rechnungen sicherstellen (BMF). Ausstellen müssen sie E-Rechnungen für Leistungen an andere Unternehmen im Inland (§ 14 Abs. 2 UStG), allerdings mit Übergangsfristen. Für Umsätze bis Ende 2026 dürfen alle Unternehmen noch Papierrechnungen oder, mit Zustimmung des Empfängers, andere elektronische Formate wie ein PDF übermitteln (§ 27 Abs. 38 UStG). Für Umsätze im Jahr 2027 gilt das nur noch, wenn der Gesamtumsatz im Vorjahr nicht mehr als 800.000 Euro betragen hat; für EDI-Verfahren gibt es eine eigene Übergangsregel (§ 27 Abs. 38 UStG).

Für viele B2B-Shops heißt das: Die E-Rechnung mit ZUGFeRD und XRechnung muss zum Jahreswechsel laufen, und zwar über den heute erprobten Weg. Seit 6.6.10.0 erstellt Shopware E-Rechnungen im ZUGFeRD-Format (Shopware-Dokumentation). Dieser Weg bleibt in 6.7 bestehen. Dokumente v2 gehört parallel in die Staging-Umgebung, nicht in den Livebetrieb zwischen Black Week und erstem Rechnungslauf im neuen Jahr.

Für 6.8 nennt Shopware bisher nur das Jahr: Die nächste Hauptversion ist für 2027 geplant (Shopware). Ein genaues Datum nennt die Meldung nicht. Was bis dahin ohnehin ansteht, beschreibt unser Beitrag zum Upgrade auf Shopware 6.8. Mit 6.8 ist v2 der Standard, und eine Erweiterung, die nur den bisherigen Weg kennt, funktioniert dann nur noch bei Händlern, die v2 ausdrücklich abschalten (Shopware ADR).

  1. Bis zur Black Week: Erweiterungen erfassen, Firmenangaben in der Staging-Umgebung befüllen, ersten Testlauf fahren. Im Livebetrieb nichts umstellen.
  2. Dezember: die Rechnungsstrecke für den Jahreswechsel auf dem bisherigen Weg absichern und Portierungen beauftragen.
  3. Erstes Halbjahr 2027: Plugins und Apps auf die Erweiterungspunkte von v2 umstellen und jede neue Version der Reihe 6.7 mit eingeschaltetem v2 gegenprüfen.
  4. Vor dem Upgrade auf 6.8: entscheiden, ob v2 mit dem Upgrade zum Standard wird oder vorübergehend abgeschaltet bleibt.
  5. Bis 6.9: alle Erweiterungen auf v2, denn danach lässt sich nicht mehr zurückschalten (Shopware ADR).
Abschalten in 6.8 ist ein vorgesehener Weg

Shopware beschreibt das Abschalten in 6.8 ausdrücklich als Möglichkeit: Ist eine Erweiterung mit Dokumentbezug nicht bereit, wird v2 abgeschaltet, das Upgrade durchgeführt und die Umstellung später nachgeholt (Shopware ADR).

Storno, Gutschrift und Anzahlung im B2B-Shop

In B2B-Shops hängen an der Rechnung oft weitere Belege. Bei v2 sind Stornorechnung und Gutschrift eigene Dokumenttypen, ZUGFeRD ist bei beiden ein Format (Shopware Release Notes). Welche Codes und Bezüge eine Korrektur in der XML braucht, beschreibt unser Beitrag zu ZUGFeRD-Stornorechnungen und -Gutschriften. Wie Anzahlung und Endrechnung über den Jahreswechsel zusammenspielen, zeigt der Beitrag zur Anzahlungsrechnung im B2B-Shop.

Eigenentwicklungen für solche Fälle sind genau die Erweiterungen, die beim Umstieg neu angefasst werden. Wer für B2B-E-Commerce jetzt eigene Belegarten plant, baut sie sinnvollerweise gleich gegen die Erweiterungspunkte von v2. Dieselbe Version bringt auch Neuerungen für den MCP-Server (Shopware Release Notes). Welche Rechte KI-Agenten dort bekommen, beschreibt unser Beitrag zu KI-Agenten im Shopware-Backend.

So begleiten wir die Umstellung

Als Shopware-Agentur prüfen wir v2 in einer Staging-Kopie Ihres Shops: Firmenangaben je Verkaufskanal, Formate je Dokumenttyp, Mail-Flows und die XML aus Testbestellungen. Erweiterungen mit Dokumentbezug portieren wir auf die neuen Erweiterungspunkte, für die Übergangszeit parallel registriert.

Testlauf auf Staging

Erfassung der Erweiterungen, befüllte Firmenangaben und Testbestellungen je Verkaufskanal, mit Befundliste statt Umschaltung im Livebetrieb.

Portierung von Erweiterungen

Eigene Dokumenttypen, Datenlieferanten und Renderer für v2, umgesetzt in unserer individuellen Programmierung und mit Tests abgesichert.

Begleitung bis 6.9

Neue Versionen prüfen wir im Rahmen der Shopware-Wartung auf Wunsch auch mit eingeschaltetem v2.

Der Aufwand hängt davon ab, wie viele Erweiterungen mit Dokumentbezug im Shop stecken. Eine belastbare Einschätzung ist nach der Erfassung möglich. Schildern Sie uns Ihren Stand über das Kontaktformular.

Quellen und Studien

Dieser Beitrag stützt sich auf die Release Notes zu Shopware 6.7.15.0, die Architekturentscheidung „Migration strategy from document generation v1 to v2“ samt Ergänzungen, die Entwicklerdokumentation zu Document (v2) und ihren Erweiterungspunkten, die Shopware-Dokumentation zu Dokumenteinstellungen und Bestellungen, den Quelltext von Shopware in der Version 6.7.15.0 auf GitHub, die Meldung von Shopware zur Roadmap von 6.8, die §§ 14, 14b und 27 UStG sowie die Fragen und Antworten des BMF zur E-Rechnung. Alle Angaben abgerufen am 2. November 2026. Die steuerliche Einordnung des Einzelfalls ersetzt der Beitrag nicht.

Nein. In 6.7 ist v2 optional, ohne den Schalter läuft der Shop vollständig auf dem bisherigen Weg (Shopware Release Notes). Shopware empfiehlt, v2 in 6.7 in der Staging-Umgebung zu testen (Shopware ADR). Im Livebetrieb bleibt vor Black Week und Jahreswechsel in der Regel besser alles, wie es ist.

Nein. Shopware übernimmt die Werte zwar nicht in die neue Karte, solange diese für einen Verkaufskanal leer ist, liest v2 aber die bisherigen Dokumenteinstellungen (Shopware Release Notes). Sobald Sie in der Karte ein Feld befüllen, nutzt v2 nur noch die Karte (Shopware-Quelltext).

In der Regel fehlt eine Pflichtangabe zur Firma: Name, Straße, Postleitzahl, Ort oder Land (Shopware Release Notes). Häufige Ursachen sind eine nur teilweise befüllte Karte der Firmenangaben oder eine lückenhafte Vorlage des betroffenen Dokumenttyps.

Überschreibungen der Twig-Vorlagen funktionieren weiter, weil v2 dieselben Vorlagen rendert (Shopware Release Notes). Plugins, die über die bisherigen Erweiterungspunkte eigene Formate, Typen oder Daten einspeisen, ruft v2 dagegen nicht auf (Shopware Release Notes). Sie müssen auf die neuen Erweiterungspunkte portiert werden.

Sie bleiben erhalten und abrufbar. Die bisherigen ZUGFeRD-Typen erscheinen in der Oberfläche von v2 unter ihrem alten Namen zum Herunterladen (Shopware ADR). Laut Shopware bleiben erzeugte Dokumente auch nach 6.9 ohne Neuerzeugung zugänglich (Shopware ADR).

Vorübergehend ja: In 6.8 ist v2 der Standard, lässt sich aber abschalten (Shopware Release Notes). Mit 6.9 entfallen der bisherige Weg und der Schalter (Shopware Release Notes). Die Portierung eigener Erweiterungen begleiten wir im Rahmen der Shopware-Wartung.