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 |
Inhaltsverzeichnis
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
Kommentare:
Artikel kommentieren
Weitere interessante Artikel:
Bestell-Nr.: SW1398
Lieferzeit ca. 5 Tage
Preise inkl. gesetzlicher
MwSt. zzgl. Versandkosten*
Preise inkl. gesetzlicher
MwSt. + Versandkosten*
Kategorien: