Wie bearbeite ich das Rechnungsformular in Shopware 5?

**In Shopware 5 bearbeitest du das Rechnungsformular meist nicht unter „Formulare“, sondern in der PDF-Belegerstellung oder direkt im Dokument-Template. Für einfache Layout-Änderungen reicht das Backend, für echte Struktur- oder Variablen-Anpassungen musst du die Rechnungsvorlage `index.tpl` im Theme anpassen.** ([docs.shopware.com](https://docs.shopware.com/de/shopware-5-de/einstellungen/belege-dokumente)) ## Der richtige Ort in Shopware 5 Die häufigste Verwechslung ist: Das Rechnungsdokument ist **kein normales Formular** aus dem Formular-Manager. Rechnungen laufen in Shopware 5 über die **PDF-Belegerstellung** unter **Einstellungen / Grundeinstellungen / Shopeinstellungen / PDF-Belegerstellung**. Dort kannst du ein vorhandenes Rechnungsdokument öffnen und Inhalte, Elemente, Abstände, Seitenaufteilung und das verwendete Template anpassen. ([docs.shopware.com](https://docs.shopware.com/de/shopware-5-de/einstellungen/belege-dokumente)) Wenn du nur Texte, Footer, Logo, Positionen oder einzelne Blöcke ändern willst, ist das der erste und schnellste Weg. Die Doku beschreibt dafür die Bereiche **Details**, **Elemente** und **Template**. ([docs.shopware.com](https://docs.shopware.com/de/shopware-5-de/einstellungen/belege-dokumente)) ## Wann das Backend reicht – und wann nicht Das Backend reicht für: - Logo austauschen - Footer-/Header-Texte ändern - Abstände und Seitenlayout anpassen - einzelne Dokumentelemente bearbeiten - Vorschau testen ([docs.shopware.com](https://docs.shopware.com/de/shopware-5-de/einstellungen/belege-dokumente)) Das Backend reicht **nicht sauber**, wenn du: - die Reihenfolge oder Logik der Ausgabe ändern willst - neue Variablen einbauen willst - Artikel-Zusatzfelder oder Bestell-Freitextfelder anzeigen willst - die Tabellenstruktur der Rechnung umbauen willst Dann musst du ins Template. Genau das ist der Punkt, den viele Anleitungen zu oberflächlich erklären. Der eigentliche Hebel für Rechnungen ist fast immer die Datei **`themes/frontend/DEINTHEME/documents/index.tpl`**. ([docs.shopware.com](https://docs.shopware.com/en/shopware-5-en/settings/documents)) ## So bearbeitest du die Rechnungsvorlage richtig Lege die Anpassung **nicht** im Bare-/Standard-Theme an, weil Updates sie überschreiben können. Shopware empfiehlt ausdrücklich, ein eigenes Theme zu verwenden und dort die Dokumentdateien abzulegen. Für Rechnungen ist die zentrale Datei: ```smarty themes/frontend/DEINTHEME/documents/index.tpl ``` Andere Belege bauen teilweise darauf auf. Deshalb wirken Änderungen an `index.tpl` oft auch breiter, als man zuerst denkt. Genau das ist wichtig: Wenn du nur einen Lieferschein ändern willst, bearbeite nicht blind die Rechnungsdatei. ([docs.shopware.com](https://docs.shopware.com/en/shopware-5-en/settings/documents)) Praktisch heißt das: 1. Eigenes Theme verwenden 2. Dokument-Template dort anlegen oder erweitern 3. In den Shopeinstellungen sicherstellen, dass dieses Theme bzw. Dokument-Template aktiv ist 4. Rechnung im Backend neu generieren und prüfen ([docs.shopware.com](https://docs.shopware.com/en/shopware-5-en/settings/documents)) ## Welche Daten du in der Rechnung nutzen kannst Für die Rechnung stehen laut Doku unter anderem diese Variablen zur Verfügung: - `{$Document}` für Belegdaten - `{$Order}` für Bestelldaten - `{$User}` für Kundendaten - `{$position}` für Positionsdaten - `{$Containers}` für Dokumenteinstellungen ([docs.shopware.com](https://docs.shopware.com/en/shopware-5-en/settings/documents)) Der praktische Mehrwert daran: Du kannst nicht nur Text austauschen, sondern gezielt Bestell- oder Artikeldaten einblenden. Ein typischer Fall ist ein zusätzliches Attribut unter dem Artikelnamen oder ein Bestell-Freitextfeld auf der Rechnung. Genau dafür nennt die Shopware-Doku konkrete Beispiele. ([docs.shopware.com](https://docs.shopware.com/en/shopware-5-en/settings/documents)) ## Der wichtigste Unterschied in der Praxis Viele versuchen zuerst, die Rechnung komplett im Editor zusammenzuklicken. Das funktioniert nur für einfache Anpassungen. Sobald du sagst: - „unter dem Artikelnamen soll noch Hersteller X stehen“ - „eine Bestellnotiz soll auf die Rechnung“ - „die Tabelle soll anders aufgebaut sein“ - „nur auf Rechnungen, nicht auf Lieferscheinen“ … bist du im **Template-Bereich**, nicht mehr im normalen Editor. Das spart dir viel Zeit, weil du nicht an der falschen Stelle suchst. ([docs.shopware.com](https://docs.shopware.com/en/shopware-5-en/settings/documents)) ## Klare Empfehlung Wenn du nur optische Änderungen brauchst, bearbeite die Rechnung in der **PDF-Belegerstellung**. Wenn du Inhalt, Datenfelder oder Aufbau ändern willst, arbeite direkt mit `themes/frontend/DEINTHEME/documents/index.tpl` in einem eigenen Theme. Das ist in Shopware 5 der saubere und updatesichere Weg. ([docs.shopware.com](https://docs.shopware.com/de/shopware-5-de/einstellungen/belege-dokumente))