Handbuch Zahlungsinformation auf PDF Beleg.

Von der Installation bis zum fertigen Beleg: Text je Zahlungsart anlegen, Platzhalter und Vorlagen nutzen, Belegarten und Bereiche festlegen, PayPal Rechnungskauf einbinden und den Textblock an das Layout der Rechnung anpassen.

Systemvoraussetzungen

Shopware 6.6 oder 6.7. Das Plugin erweitert das Belegtemplate von Shopware und braucht keinen Theme-Build. Damit Bankdaten als Platzhalter verfügbar sind, sollten sie in den Belegeinstellungen von Shopware gepflegt sein.

Wichtig: Der Text erscheint auf Belegen, die nach dem Speichern erstellt werden. Bereits erzeugte PDF-Belege bleiben unverändert, bis sie neu erstellt werden.

Installation

Am einfachsten über die Plugin Suite: Plugin auswählen, installieren und aktivieren, Updates kommen anschließend mit einem Klick. Alternativ das ZIP im Shopware-Admin unter Erweiterungen, Meine Erweiterungen, Erweiterung hochladen einspielen und danach installieren und aktivieren. Ein SSH-Zugang ist nicht erforderlich.

Plugin öffnen

Das Plugin liegt im Admin im Menü unter Stone & Water, Zahlungsinformation auf PDF Beleg. Unter dem Kopfbereich stehen zwei Tabs: Zahlungsarten mit den Texten und Einstellungen mit Position und Darstellung auf dem Beleg.

Übersicht der Zahlungsarten

Die Liste zeigt alle Zahlungsarten mit dem Status des Textes: Eigener Text, Vererbt aus einem übergeordneten Bereich oder Kein Text. Oben wählst du Verkaufskanal und Sprache, das Suchfeld filtert nach dem Namen.

Über den Schalter "Inaktive Zahlungsarten anzeigen" erscheinen auch Zahlungsarten, die in Shopware deaktiviert sind. Kennzeichnungen zeigen, wenn eine Zahlungsart nicht im gewählten Verkaufskanal hinterlegt ist oder es sich um PayPal Rechnungskauf handelt. Die Spalte "Auf Rechnung anzeigen" schaltet die Ausgabe direkt aus der Liste heraus ein oder aus.

Text anlegen

Mit "Bearbeiten" öffnet sich das Fenster der Zahlungsart. Im Feld Text schreibst du den Hinweis, der auf dem Beleg direkt unter der gewählten Zahlungsart erscheint. Formatierungen wie Fett, Listen und Zeilenumbrüche werden übernommen. Mit "Speichern" ist der Text sofort für neue Belege aktiv.

Der Schalter Auf Beleg anzeigen legt fest, ob der Text für die gewählte Belegart ausgegeben wird. Ausgeschaltet bleibt der Text gespeichert und erscheint wieder, sobald du ihn einschaltest.

Vorlagen einfügen

Über "Vorlage einfügen" stehen zwei fertige Texte bereit: Überweisung mit Rechnungsbetrag, Zahlungsfrist, Bankverbindung und Kunden- und Bestellnummer als Verwendungszweck sowie PayPal Rechnungskauf (Ratepay) mit dem Hinweis auf die Abtretung an Ratepay und den Bankdaten der Zahlung. Die Vorlage landet im Text und lässt sich danach frei anpassen.

Platzhalter verwenden

Platzhalter stehen in geschweiften Klammern, etwa {orderNumber}. Ein Klick in der Platzhalter-Liste fügt ihn an der Cursorposition ein. Beim Erstellen des Belegs ersetzt Shopware ihn durch den Wert der jeweiligen Bestellung. Die Liste ist in Gruppen eingeteilt und beim Öffnen eingeklappt.

Zahlungsziel mit Datum: {dueDate:14} setzt das Belegdatum plus 14 Tage ein, die Zahl lässt sich frei ändern, etwa {dueDate:30}. {paymentDueDate} übernimmt dagegen das Zahlungsziel aus den Belegeinstellungen von Shopware.
Zusatzfelder: {orderCustomField:name} und {transactionCustomField:name} lesen ein Zusatzfeld der Bestellung bzw. der Zahlung. Statt name den technischen Namen des Feldes eintragen.

Vorschau

Die Vorschau im Bearbeiten-Fenster zeigt den Text so, wie er auf dem Beleg erscheint, mit der aktuellen Darstellung aus den Einstellungen. Ohne Angabe wird die neueste Bestellung mit dieser Zahlungsart verwendet. Im Feld "Bestellnummer für Vorschau" kannst du gezielt eine andere Bestellung wählen. Gibt es noch keine Bestellung mit der Zahlungsart, arbeitet die Vorschau mit Beispieldaten.

Rechnung, Lieferschein, Gutschrift, Storno

Im Bearbeiten-Fenster gibt es je Belegart einen Tab: Rechnung, Lieferschein, Gutschrift und Stornorechnung. Die Rechnung ist die Grundlage. Die übrigen Belegarten übernehmen ihren Text, bis du dort einen eigenen anlegst; angepasste Tabs sind gekennzeichnet.

Für Lieferschein, Gutschrift und Stornorechnung ist der Schalter "Auf Beleg anzeigen" zunächst aus. So erscheint etwa die Bankverbindung nicht ungewollt auf dem Lieferschein.

Verkaufskanal und Sprache

Oben im Bearbeiten-Fenster wählst du, für welchen Verkaufskanal und welche Sprache du den Text bearbeitest. Die Grundlage ist "Alle Verkaufskanäle" und "Alle Sprachen". Jeder andere Bereich übernimmt deren Text, bis du mit "Text für diesen Bereich anpassen" einen eigenen festlegst. "Wieder übernehmen" kehrt zum übergeordneten Text zurück.

Verkaufskanäle und Sprachen mit eigenen Werten sind in der Auswahl gekennzeichnet. Wechselst du den Bereich mit ungespeicherten Änderungen, fragt das Plugin vorher nach.

Position im Beleg

Unter Einstellungen, Allgemein legst du fest, wo der Text steht: direkt unter der Zeile "Gewählte Zahlungsart", nach der Versandart vor dem Zusatztext oder nach dem gesamten Block, auch nach dem Zusatztext. Der Zusatztext ist der Shopware-Textbaustein document.paymentShippingInfo.additionalInfo, gepflegt unter Einstellungen, Textbausteine.

Abstände und Darstellung

Unter Abstände stellst du Außen- und Innenabstand des Textblocks je Seite in Pixel ein. Unter Darstellung legst du Hintergrund- und Schriftfarbe, Rahmenbreite, Rahmenfarbe, Eckenradius, Schriftgröße, Zeilenhöhe und Ausrichtung fest. Leere Farben und der Wert 0 bei Schriftgröße und Zeilenhöhe übernehmen die Werte des Belegs.

Eigenes CSS

Für Fälle, die die Einstellungen nicht abdecken, gibt es eigene CSS-Regeln. Sie werden im Kopf des Belegs eingefügt. Der Textblock trägt die Klasse staw-payment-info.

PayPal Rechnungskauf

Bei PayPal Rechnungskauf überweist der Kunde an Ratepay. Die Bankdaten, der Verwendungszweck und die Fälligkeit stehen in der Zahlung der Bestellung und lassen sich über die Platzhalter der Gruppe PayPal Rechnungskauf einsetzen. Die Vorlage "PayPal Rechnungskauf" enthält bereits den Hinweis auf die Abtretung an Ratepay.

PayPal fügt bei Rechnungskauf selbst einen Hinweis- und Bankdatenblock in den Beleg ein. Ist "Standardblock von PayPal Rechnungskauf ausblenden" aktiv, entfällt dieser Block, sobald ein eigener Text ausgegeben wird. Ohne eigenen Text bleibt der Standardblock von PayPal stehen.

Hinweis: PayPal stellt die Zahlungsdaten erst nach Abschluss der Zahlung bereit. Fehlen sie noch, zeigt die Vorschau einen entsprechenden Hinweis.

Problemlösung

Text erscheint nicht: Prüfe den Hauptschalter "Zahlungsinformation ausgeben", den Schalter "Auf Beleg anzeigen" für die Belegart und ob ein Text im passenden Verkaufskanal und in der Sprache der Bestellung hinterlegt oder vererbt ist. Danach den Beleg neu erstellen.
Platzhalter bleibt leer: Der Wert fehlt in der Bestellung oder in den Belegeinstellungen, etwa eine nicht gepflegte IBAN. Bei PayPal Rechnungskauf liefert PayPal die Daten erst nach Abschluss der Zahlung.
Bankdaten doppelt bei PayPal Rechnungskauf: "Standardblock von PayPal Rechnungskauf ausblenden" einschalten. Er greift, sobald für die Zahlungsart ein eigener Text ausgegeben wird.

Support

Fragen und Wünsche gern direkt an uns - der Support kommt vom Entwickler, nicht aus einer Warteschleife. Über die Plugin Suite im Admin lässt sich auch ein Feature anfragen.

Alle Einstellungen

Jede Einstellung des Plugins mit Standardwert und Erklärung, in derselben Reihenfolge wie im Administrationsbereich. Die Texte stammen direkt aus dem Plugin (Version 1.1.6). Einstellungen gelten für den gewählten Verkaufskanal, ohne eigenen Wert wird der Wert von "Alle Verkaufskanäle" übernommen.

Allgemein

Zahlungsinformation ausgebenStandard: an

Schaltet die Ausgabe auf allen Belegen ein oder aus.

Position im BelegStandard: Direkt unter der Zahlungsart

Direkt unter der Zeile "Gewählte Zahlungsart", nach der Versandart vor dem Zusatztext oder nach dem gesamten Block, auch nach dem Zusatztext.

Standardblock von PayPal Rechnungskauf ausblendenStandard: an

Blendet den Hinweis- und Bankdatenblock aus, den PayPal bei Rechnungskauf selbst einfügt, wenn ein eigener Text ausgegeben wird.

Abstände

Außenabstand (margin)Standard: oben 4, rechts 0, unten 8, links 0

Abstand des Textblocks zu den umliegenden Inhalten, in Pixel.

Innenabstand (padding)Standard: 0 auf allen Seiten

Abstand zwischen Rand und Text, in Pixel - wirkt vor allem mit Hintergrundfarbe oder Rahmen.

Darstellung

HintergrundfarbeStandard: leer (transparent)

Leer lassen für transparent.

SchriftfarbeStandard: leer

Leer lassen für die Schriftfarbe des Belegs.

RahmenbreiteStandard: 0

Wert in Pixel, 0 ohne Rahmen.

RahmenfarbeStandard: #d1d5db

Farbe des Rahmens.

EckenradiusStandard: 0

Wert in Pixel.

SchriftgrößeStandard: 0

Wert in Punkt, 0 übernimmt die Schriftgröße des Belegs.

ZeilenhöheStandard: 0

Faktor, zum Beispiel 1.4 - 0 übernimmt die Zeilenhöhe des Belegs.

AusrichtungStandard: Linksbündig

Ausrichtung des Textes im Block: linksbündig, zentriert, rechtsbündig oder Blocksatz.

Eigenes CSS

CSS-RegelnStandard: leer

Wird im Kopf des Belegs eingefügt. Der Textblock trägt die Klasse staw-payment-info.

Bearbeiten-Fenster je Zahlungsart

Bereich (Verkaufskanal und Sprache)Standard: Alle Verkaufskanäle, Alle Sprachen

Legt fest, für welchen Verkaufskanal und welche Sprache du den Text bearbeitest. Ohne eigenen Wert wird der übergeordnete Bereich übernommen.

BelegartStandard: Rechnung

Tabs für Rechnung, Lieferschein, Gutschrift und Stornorechnung. Die übrigen Belegarten übernehmen den Text der Rechnung, bis dort ein eigener angelegt wird.

Auf Beleg anzeigenStandard: an bei der Rechnung, aus bei den übrigen Belegarten

Schaltet die Ausgabe des Textes auf der gewählten Belegart für den gewählten Bereich ein oder aus. Der Text bleibt dabei gespeichert.

TextStandard: leer

Erscheint auf dem PDF-Beleg direkt unter der gewählten Zahlungsart. Formatierungen und Platzhalter werden übernommen.

Bestellnummer für VorschauStandard: leer (neueste Bestellung)

Optional. Ohne Bestellnummer wird die neueste Bestellung mit dieser Zahlungsart verwendet.

Alle Platzhalter

Alle Platzhalter in derselben Gruppierung wie im Bearbeiten-Fenster.

Bestellung

Bestellnummer{orderNumber}
Bestelldatum{orderDate}
Gesamtbetrag (brutto){amountTotal}
Gesamtbetrag (netto){amountNet}
Steuerbetrag{amountTax}
Versandkosten{shippingTotal}
Währung{currency}
Zahlungsart{paymentMethod}

Kunde

Kundennummer{customerNumber}
Vorname{customerFirstName}
Nachname{customerLastName}
Firma{customerCompany}
E-Mail{customerEmail}

Beleg

Belegnummer{documentNumber}
Belegdatum{documentDate}
Rechnungsnummer{invoiceNumber}
Belegdatum plus Tage{dueDate:14}
Zahlungsziel (Belegeinstellung){paymentDueDate}

Shop und Bank (Belegeinstellungen)

Firmenname{companyName}
Bank{bankName}
IBAN{bankIban}
BIC{bankBic}

PayPal Rechnungskauf (Ratepay)

Kontoinhaber{puiAccountHolder}
Bank{puiBankName}
IBAN{puiIban}
BIC{puiBic}
Verwendungszweck{puiReference}
Fälligkeitsdatum{puiDueDate}

Weitere

Zusatzfeld der Bestellung{orderCustomField:name}
Zusatzfeld der Zahlung{transactionCustomField:name}

Verfügbarkeit

Direkt über Stone & Water

Ab sofort möglich

Monatlich9,99 €
Bester PreisJährlich101,90 €15 % günstiger

Alle Preise netto zzgl. USt.

Die Plugin Suite installiert und aktualisiert es mit einem Klick. Rechnung, Updates und Support kommen direkt von uns - ohne Umweg über einen Marktplatz.

Mit der Plugin Suite holen+49 2555 9997342

Shopware Store

In Vorbereitung

Das Plugin wird im offiziellen Shopware Community Store gelistet. Installation und automatische Updates laufen dann über den Plugin Manager im Backend, die Abrechnung über deinen Shopware-Account. Sobald verfügbar, verlinken wir es hier.