Einleitung

Das Plugin MND Shopware Artikel-Aufschläge (MndAddChargeManager) ermöglicht es Aufschläge pro Artikel zu definieren. Typische Anwendungsmöglichkeiten sind beispielsweise:

• Sperrgutzuschlag
• Flaschenpfand
• Dosenpfand
• Batteriepfand

Besondere Merkmale des Plugins

• ERP kompatibel: Aufschläge sind eigenständige Artikel im Warenkorb! Artikelnummern können frei definiert werden.
• Aufschläge werden Pro Artikel-Menge berechnet. D.h. bei Bestellmenge 10 = 10x Aufschlag einberechnet.
• Für Aufschläge kann ein eigener MwSt. Satz definiert werden.
• Texte für Aufschläge können frei definiert werden, inkl. Infotext.
• Definition beliebig vieler Aufschläge im Shopware Backend.
• Es können einem Artikel mehrere Aufschläge zugewiesen werden.
• Aufschläge können auf ein oder mehrere Lieferländer eingeschränkt werden
• Daten der Auschläge können in Shopware Produktexporte integriert werden.
• Es können abweichende Preise für Kundengruppen definiert werden

Aufschläge werden im Shopware Shop bei Artikeln dargestellt und im Bestellprozess automatisch mit einberechnet.

Screenshots

Anzeige auf der Artikeldetailseite:

Anzeige im Artikellisting:

Anzeige im Warenkorb:

Installation

Die Installation erfolgt wie gewohnt über den Shopware Plugin Manager.

Weiterführende Informationen zum Installationsvorgang in Shopware:

Plugin-Installation: http://community.shopware.com/Lizenzierung-und-Installation-von-lizenzpflichtigen-Plugins_detail_1340.html
Plugin-Manager: http://community.shopware.com/Plugin-Manager-ab-Shopware-5_detail_1856.html)

Nutzung

Konfigurationsmaske im Backend aufrufen

Im Hauptmenü den Untermenüpunkt "Aufschläge" wählen:

Aufschläge anlegen/bearbeiten

Klicken Sie auf "Hinzufügen" um einen neuen Aufschlag zu erstellen oder einen vorhandenen zu bearbeiten/löschen.

Ein Aufschlag kann mehreren Artikeln im Shop zugeordnet werden und auf bestimmte Lieferländer eingeschränkt werden.

Anlegen eines Aufschlages

Folgende Felder sind für die Konfiguration eines Aufschlages relevant:

Kundengruppen Ausnahmen hinzufügen

Bei der Konfiguration eines Aufschlags können Ausnahmen für Kundengruppen hinzugefügt werden.

In der Liste stehen alle in Shopware eingestellten Kundengruppen. Eine Kundengruppe kann als Ausnahme aktiviert werden und der eingegebene

Preis kann als Netto- oder Bruttopreis deklariert werden.

Beispiel für eine Kundengruppe Ausnahme:

Für Shopkunden beträgt der Aufschlag 1,00 € Brutto.

Für Händler und Entwickler bleibt jedoch der Standard-Wert.

Zuweisen von Artikeln

Ein Artikel kann entweder anhand des Namens oder der Artikelnummer mit einem Aufschlag versehen werden.

Artikel wurde erfolgreich zur Aufschlagsgruppe hinzugefügt.

Aufschlag auf Lieferländer einschränken

Ein Aufschlag kann einem oder mehreren Lieferländern zugeordnet werden. Nur bei übereinstimmendem Lieferland wird der Aufschlag berechnet.

Bei Länderspezifischen Aufschlägen empfehlen wir den angezeigten Namen entsprechend der Einschränkung zu wählen, z.B. "Zoll-Zuschlag bei Lieferungen in die Schweiz". 

Aufschlag wurde für das Lieferland, in diesem Fall "Schweiz", eingeschränkt.

Zuweisen mehrerer Aufschläge pro Artikel

Es ist möglich einem Artikel mehrere Aufschläge zuzuweisen.

Ab zwei Aufschlägen muss ggf. das Shopware Template so angepasst werden, dass mehr Platz verfügbar ist.

Template Anpassungen

Verwendung in den Shopware-Produktexporten (product feeds)

Für die Templates der Produktexporte wird die Variable $sArticle durch Aufschlaginformationen ergänzt:

$sArticle.mnd_addcharge

Diese Variable enthält ein JSON Objekt mit Aufschlagsinformationen.

In diesem JSON Objekt sind folgende Infos enthalten:

Beispiele für Integration in Export-Template

Aufschlagsinformationen als Text ausgeben

Zunächst erweitern wir den Export um eine Spalte in der alle Aufschläge als Fliesstext aufgezählt werden.

[...]
Aufschläge{#S#}
[...]

[...]
{assign var=addChargeData value=$sArticle.mnd_addcharge|unescape:'html'|json_decode:1}
{assign var="output" value=null}
{foreach $addChargeData AS $data}{append 'output' "zzgl. {$data.price|format:"number"} {$sCurrency.currency} {$data.display_name}"}{/foreach}
{", "|implode:$output}{#S#}
[...]

Ergebnis:

zzgl. 0,25 EUR Test Zuschlag, zzgl. 3,21 EUR Zweiter Test Zuschlag

Erklärung:

Die ersten drei Zeilen bereiten die Daten für die Ausgabe vor und erzeugen selbst keinen Text im Produktexport:

{assign var=addChargeData value=$sArticle.mnd_addcharge|unescape:'html'|json_decode:1}

Zunächst wandeln wir den JSON-String in ein Array um. Mithilfe dem Arrays können die Werte einzeln besser verarbeitet werden. (Diese Zeile führt zu keiner Ausgabe im Export)

{assign var="output" value=null}

Wir erstellen eine Variable, die wir mit unseren Daten befühlen wollen. (Diese Zeile führt ebenfalls noch nicht zu einer Ausgabe)

{foreach $addChargeData AS $data}{append 'output' "zzgl. {$data.price|format:"number"} {$sCurrency.currency} {$data.display_name}"}{/foreach}

Nun wird jeder Aufschlag herangezogen und in das Array "output" gespeichert.

{$data.price|format:"number"} 

Hiermit werden die Preise entsprechend der ausgewählten Einstellungen formatiert

{", "|implode:$output}

Zuletzt werden alle Einzelteile verbunden mit einem Komma ausgegeben

Preis von Aufschlägen zu Artikelpreis hinzuaddieren

[...]
Preis inkl Aufschläge{#S#}
{/strip}{#L#}

[...]
{assign var=addChargeData value=$sArticle.mnd_addcharge|unescape:'html'|json_decode:1}
{assign var="priceIncl" value=$sArticle.price}
{foreach $addChargeData AS $data}{assign var="priceIncl" value=$priceIncl+$data.price}{/foreach}
{$priceIncl}

Ergebnis:

123.41

Zunächst wandeln wir den JSON-String in ein Array um. Mithilfe dem Arrays können die Werte einzeln besser verarbeitet werden.

{assign var="priceIncl" value=$sArticle.price}

Wir erstellen eine Variable, dieser Variable geben wir den Preis des Artikels mit.

{foreach $addChargeData AS $data}{assign var="priceIncl" value=$priceIncl+$data.price}{/foreach}

Nun wird jeder Aufschlag herangezogen und dem Artikelpreis hinzuaddiert

{$priceIncl}

Zuletzt wird der Preis ohne Formatierung ausgegeben.

Deinstallation

Das Plugin wird auch über den Plugin Manager deinstalliert.