Shopware Knowledgebase

Shopware Labs

Der Bereich Shopware Labs ist die Plattform für alle Entwickler. Hier findet man technische Dokumentationen und zahlreiche Tipps und Tricks rund um das Thema Programmieren. In dieser Rubrik stellen außerdem die Entwickler der shopware AG neue und experimentelle Lösungsansätze vor. Neue Funktionen, die in dieser Rubrik bereitgestellt werden, sind teilweise auch für zukünftige Releases geplant. Die Funktionen können dann ohne Programmierkenntnisse zukünftig direkt im Shopware Backend konfiguriert werden oder werden über Plugins bereitgestellt. Informationen über neue, geplante Funktionen finden Sie in unserer Roadmap.

Bitte beachten Sie, dass die hier bereitgestellten Lösungsansätze nicht offiziell supportet werden und nur eingebaut werden sollten, sofern Sie über das entsprechende, technische Wissen verfügen.

PDF-Belegerstellung - Variablen / Struktur

0 Kommentare
ab Version:3.0.5 bis Version:3.0.5.1

Vorwort

Die durch Shopware erzeugten PDF-Belege, wie Rechnung oder Lieferschein, basieren ebenfalls auf Smarty. Daher lassen sich die Belege komplett individualisieren. Falls die Möglichen in der Shopware Administration nicht ausreichen sollten, so kann die TPL-Datei auch direkt auf dem Server erweitert und verändert werden.

Standard Speicherort der Dateien: /templates/0/de/forms/documents/

Templatedateien

base.tpl

Grundgerüst der Belege. Die weiteren Templatedateien werden inkludiert.

content.tpl

Ausgabe der Bestellpositionen für eine Rechnung

content_1.tpl

Ausgabe der Bestellpositionen für eine Lieferschein

content_2.tpl

Ausgabe der Bestellpositionen für eine Gutschrift

content_3.tpl

Ausgabe der Bestellpositionen für eine Stornierung

content_under.tpl

Wird direkt unter den Bestellpositionen geladen und beinhaltet:

  • Gesamtkosten Netto
  • Mehwertsteuer
  • Gesamtkosten
  • Hinweis zur umsatzsteuerbefreiten Lieferung
  • Gewählte Zahlungsart
  • Umrechnungsfaktor Währung

footer.tpl

Beinhaltet Fußzeile, Ausgabe der Versandart, Kommentar, Gutscheincode + Text

header.tpl

Beinhaltet den gesamten Belegkopf.

  • Ausgabe der Rechnungs- und Lieferadresse
  • Kundennummer, Rechnungsnummer, Belegnummer, Datum, Liefertermin, UmsatzsteuerID
  • Überschrift: Lieferschein Nr., Gutschrift Nr., Sornierung, Rechnungs Nr.
  • Ausgabe der Seitenanzahl der Belege

Übersicht der verfügbaren Variablen

Rechnungsadresse

Variable Erklärung Ausgabe (Beispiel)
{$sUserData.billingaddress.company} Firma shopware AG
{$sUserData.billingaddress.department} Abteilung Verkauf
{$sUserData.billingaddress.salutation} Anrede mr
{$sUserData.billingaddress.customernumber} Kundennummer 20001
{$sUserData.billingaddress.firstname} Vorname Max
{$sUserData.billingaddress.lastname} Nachname Mustermann
{$sUserData.billingaddress.street} Straße Hauptstraße
{$sUserData.billingaddress.streetnumber} Hausnummer 36
{$sUserData.billingaddress.zipcode} PLZ 48624
{$sUserData.billingaddress.city} Ort Schöppingen
{$sUserData.billingaddress.phone} Telefon 02555-997500
{$sUserData.billingaddress.fax} Fax 02555-9975099
{$sUserData.billingaddress.countryID} ID des Landes 2
{$sUserData.billingaddress.text1} Freitext Feld 1-6 möglich
{$sUserData.billingaddress.ustid} Umsatzsteuer-ID DE123456789

Lieferadresse

Variable Erklärung Ausgabe (Beispiel)
{$sUserData.billingaddress.company} Firma shopware AG
{$sUserData.billingaddress.department} Abteilung Verkauf
{$sUserData.shippingaddress.salutation} Anrede mr
{$sUserData.shippingaddress.firstname} Vorname Max
{$sUserData.shippingaddress.lastname} Nachname Mustermann
{$sUserData.shippingaddress.street} Straße Hauptstraße
{$sUserData.shippingaddress.streetnumber} Hausnummer 36
{$sUserData.shippingaddress.zipcode} PLZ 48624
{$sUserData.shippingaddress.city} Ort Schöppingen
{$sUserData.shippingaddress.phone} Telefon 02555-997500
{$sUserData.shippingaddress.fax} Fax 02555-9975099
{$sUserData.shippingaddress.countryID} ID des Landes 2
{$sUserData.shippingaddress.text1} Freitext Feld 1-6 möglich

Sonstige Daten

Variable Erklärung Ausgabe (Beispiel)
{$sUserData.additional.country.id} ID des Landes (Datenbank) 2
{$sUserData.additional.country.countryname} Land Deutschland
{$sUserData.additional.country.countryiso} ISO-Code DE
{$sUserData.additional.country.countryarea} Zone deutschland
{$sUserData.additional.country.countryen} auf Englisch GERMANY

Variable Erklärung Ausgabe (Beispiel)
{$sUserData.additional.user.id} ID des Kunden (Datenbank) 354
{$sUserData.additional.user.email} eMail-Adresse info@shopware.de
{$sUserData.additional.user.paymentID} ID der Zahlungsart (Datenbank) 5
{$sUserData.additional.user.firstlogin} erster Login 2010-07-23
{$sUserData.additional.user.newsletter} Newsletter abonniert 1 = ja
{$sUserData.additional.user.affiliate} Zuordnung Partnerprogramm XXX

Variable Erklärung Ausgabe (Beispiel)
{$sUserData.additional.payment.name} Bezeichnung (intern) prepayment
{$sUserData.additional.payment.description} Bezeichnung Vorkasse
{$sUserData.additional.payment.template} genutztes Template (intern) prepayment.tpl
{$sUserData.additional.payment.additionaldescription} Text zur Zahlungsart Sie zahlen einfach...
{$sUserData.additional.payment.embediframe} Zahlung in iFrame (intern) 1 = ja

Variable Erklärung Ausgabe (Beispiel)
{$sUserData.additional.countryShipping.id} Lieferland ID 2
{$sUserData.additional.countryShipping.countryname} Lieferland Deutschland
{$sUserData.additional.countryShipping.countryiso} Lieferland ISO DE
{$sUserData.additional.countryShipping.countryarea} Lieferzone deutschland

Artikeldaten

Variable Erklärung Ausgabe (Beispiel)
{$sBillingData.id} Bestell-ID (intern) 75
{$sBillingData.net} Netto-Bestellung 1=ja
{$sBillingData.taxfree} Umsatzsteuerbefreit 1=ja
{$sBillingData.ordernumber} Bestellnummer 10021
{$sBillingData.paymentID} Zahlungsarten-ID 5
{$sBillingData.userID} Kunden-ID 1
{$sBillingData.datum} Bestelldatum 07.09.2010

Die Artikelpositionen werden in einer foreach-Schleife ausgelesen:

 
{foreach item=Entry key=kEntry from=$Details}
...
{/foreach}
 

Der Zugriff auf die Artikelnummer und den Artikelnamen erfolgt dann in der Schleife wie folgt:

 
{$Entry.articleordernumber} - {$Entry.name}
 

Weitere mögliche Variablen können Sie aus dem folgenden Array [details] entnehmen:

 
    [sBillingData] => Array
        (
            [id] => 75
            [net] => 0
            [taxfree] => 0
            [ordernumber] => 10021
            [paymentID] => 5
            [userID] => 1
            [invoice_amount] => 513.00
            [invoice_shipping] => 13.00
            [invoice_shipping_net] => 10.92
            [datum] => 07.09.2010
            [status] => 0
            [comment] => 
            [dispatchID] => 9
            [sDispatch] => Array
                (
                )
 
            [netto] => 
            [netto2] => 
            [invoice_amount_netto] => 431.09
            [invoice_amount2] => 500
            [tax] => Array
                (
                    [19] => 81.91
                )
 
            [voucher] => -469.00
            [details] => Array
                (
                    [1] => Array
                        (
                            [1] => Array
                                (
                                    [id] => 115
                                    [orderID] => 75
                                    [ordernumber] => 10021
                                    [articleID] => 75
                                    [articleordernumber] => SW2018
                                    [price] => 20.00
                                    [quantity] => 1
                                    [name] => Artikel mit Bundle-Funktion
                                    [status] => 0
                                    [shipped] => 0
                                    [shippedgroup] => 0
                                    [releasedate] => 0000-00-00
                                    [modus] => 0
                                    [esdarticle] => 0
                                    [taxID] => 1
                                    [config] => 
                                    [od_attr1] => 
                                    [od_attr2] => 
                                    [od_attr3] => 
                                    [od_attr4] => 
                                    [od_attr5] => 
                                    [od_attr6] => 
                                    [attr1] => 
                                    [attr2] => 
                                    [attr3] => 
                                    [attr4] => 
                                    [attr5] => 
                                    [attr6] => 
                                    [attr7] => 
                                    [attr8] => 
                                    [attr9] => 
                                    [attr10] => 
                                    [attr11] => 
                                    [attr12] => 
                                    [attr13] => 
                                    [attr14] => 
                                    [attr15] => 
                                    [attr16] => 
                                    [attr17] => 0000-00-00
                                    [attr18] => 
                                    [attr19] => 
                                    [attr20] => 
                                    [tax] => 19
                                    [netto] => 16.81
                                    [amount_netto] => 16.81
                                    [amount] => 20.00
                                )
 
                             [2] => Array
                                (
                                    [quantity] => 1
                                    [netto] => 10.92
                                    [tax] => 19
                                    [price] => 13.00
                                    [amount] => 13.00
                                    [amount_netto] => 10.92
                                    [articleordernumber] => 
                                    [name] => Versandkosten
                                )
 
                        )
 
                )
 
            [pages] => 1
            [payment] => Vorkasse
        )
 

Artikel-PDF erstellen

Artikel bewerten

Waren diese Informationen hilfreich? Ja Nein


Kommentare:

Artikel kommentieren


Die mit einem * markierten Felder sind Pflichtfelder.

Weitere interessante Artikel:

Bezeichnung:
Rating:
Klicks:
Datum:

Bestell-Nr.: SW1398

Lieferzeit ca. 5 Tage

€ 1,00

Preise inkl. gesetzlicher
MwSt. zzgl. Versandkosten*

€ 1,00

Preise inkl. gesetzlicher
MwSt. + Versandkosten*

Kategorien: