Diese Dokumentation bezieht sich auf eine ältere Software-Version. Die aktuelle Dokumentation finden Sie hier: Artikel-Aufschläge (MndAddChargeManager) |
URL im Shopware Store | http://store.shopware.com/mnd1715201401548/mnd-artikel-aufschlaege-pfand-sperrgut-flaschenpfand-dosenpfand-batteriepfand-etc..html |
---|---|
Shopware Kompatibilität | 5.0.0+ |
Datum | Änderung | |
---|---|---|
20.05.2016 | Erste öffentliche Version der Dokumentation für Version 1.0.0 | |
27.06.2016 | Aktualisierung der Dokumentation für Version 1.1.0
| |
25.08.2016 | Aktualisierung der Dokumentation für Version 1.2.0
| |
01.09.2016 | Aktualisierung der Dokumentation für Version 1.2.1 und folgende
| |
16.02.2017 | Aktualisierung der Dokumentation für Version 2.0
| |
28.04.2017 | Aktualisierung der Dokumentation für Version 2.1
|
Das Plugin MND Shopware Artikel-Aufschläge (MndAddChargeManager) ermöglicht es Aufschläge pro Artikel zu definieren. Typische Anwendungsmöglichkeiten sind beispielsweise:
Aufschläge werden im Shopware Shop bei Artikeln dargestellt und im Bestellprozess automatisch mit einberechnet.
Anzeige auf der Artikeldetailseite:
Anzeige im Artikellisting:
Anzeige im Warenkorb:
Der Zuschlag wird als Warenkorb-Position angezeigt. Zusätzlich wird eine Info beim Artikel angezeigt, damit der Bezug zum Aufschlag erkennbar ist. Natürlich können Sie die Templates entsprechend Ihres Wunsch-Verhaltens anpassen. |
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)
Im Hauptmenü den Untermenüpunkt "Aufschläge" wählen:
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.
|
Folgende Felder sind für die Konfiguration eines Aufschlages relevant:
Feld | Beschreibung | ||
---|---|---|---|
Interner Name | Name des Aufschlages, der im Backend genutzt wird. | ||
Name | Name des Aufschlages, der im Shop sichtbar ist. | ||
Aufschlag Art.-Nr. | Shop-Artikelnummer des Aufschlages, wie sie in der Bestellung gesprichert werden soll (und bspw. dann auch an ERP/Warenwirtschaftssystem übergeben wird).
| ||
Beschreibung | Kurzbeschreibung des Aufschlages. Wird auf der Artikelseite im Shop unterhalb der Aufschlag-Kosten angezeigt. | ||
Preis Typ | Hier können Sie einstellen, ob Sie den Preis des Aufschlages in Brutto (inkl. MwSt.) / Netto (exkl. MwSt.) eingeben. | ||
Preis | Preis des Aufschlages (Dezimaltrenner ist Punkt!) | ||
Steuer | Einstellen der Steuerkonfiguration, wie sie für den Aufschlag verwendet werden soll. |
Bei der Konfiguration eines Aufschlags können Ausnahmen für Kundengruppen definiert werden.
In der Liste stehen alle in Shopware eingestellten Kundengruppen. Durch Doppelklick auf eine Zeile können Sie die Ausnahme-Konfiguration definieren.
Um für eine Kundengruppe eine Ausnahme festzulegen, müssen Sie zunächst das Feld "Ausnahme" auf aktiv setzen. Wenn das Feld "Ausnahme" inaktiv ist, wird die Standard-Einstellung genutzt.
Danach können Sie wahlweise einen abweichenden Preis festlegen, oder "Keine Berechnung" aktivieren.
Sobald "keine Berechnung" aktiv ist, wird für dieser Aufschlag für die Kundengruppe nicht mehr berechnet (und auch im Frontend nicht mehr angezeigt).
Für Shopkunden wurde wird kein Aufschlag angezeigt.
Für Händler jedoch ein abweichender Preis von 0,20 EUR inkl. MwSt.
Ein Artikel kann entweder anhand des Namens oder der Artikelnummer mit einem Aufschlag versehen werden.
Die Zuweisung von Aufschlägen zu Artikeln kann derzeit nur über das Aufschlags-Fenster bearbeitet werden. |
Artikel wurde erfolgreich zur Aufschlagsgruppe hinzugefügt.
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.
Wenn Sie Aufschläge und Zuordnungen angepasst haben, sollten Sie zur Sicherheit den Shopware Cache (Frontend und HTTP-Proxy) leeren. |
Es ist möglich einem Artikel mehrere Aufschläge zuzuweisen.
In Verbindung mit einer Länder-Einschränkungen können Sie erreichen, dass andere Aufschläge für unterschiedliche Liefer-Länder berechnet werden. |
Ab zwei Aufschlägen muss ggf. das Shopware Template so angepasst werden, dass mehr Platz verfügbar ist.
Gerne unterstützen wir Sie bei bei einer individuellen Anpassung. |
Für Template-Anpassungen konnte in den letzten Versionen der Shopware Artikel-Modus genutzt werden um einen Aufschlagsartikel zu erkennen (modus==500). Ab Version 2.0 funktioniert dies nicht mehr. Der Artikel-Modus entspricht nun einem Shopware-Rabatt-Artikel (== 4). Ein Aufschlagsartikel kann nun über das Feld mnd_addcharge_modus (== 500) erkannt werden. |
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:
Variable | Beschreibung | Beispiel | Type | |
---|---|---|---|---|
name | Der "Interne Name" des Aufschlages. | dosenpfand_1 | string | |
display_name | Der Name der im Frontend für den Endkunden sichtbar ist. | Mehrweg Dosenpfand | string | |
description | Die Beschreibung des Aufschlages.
| Das in Deutschland übliche Dosenpfand | string | |
price | Der Bruttopreis des Aufschlages in der für den Export eingestellten Währung | 0.25 | float | |
tax | Der Steuersatz des Aufschlages | 19.00 | float |
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 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.
Das Plugin wird auch über den Plugin Manager deinstalliert.
Die angelegten Aufschlagskonfigurationen werden dabei nicht entfernt. Diese sind in folgenden Tabellen gespeichert, welche bei Bedarf manuell in der Datenbank gelöscht werden können:
|