Niedrigster Gesamtpreis gemäß Preisangabenverordnung (§11 PAngV) manuell und automatisch

Über die Erweiterung

Vorwort zur Rechtssicherheit

Durch Installation dieses Plugins erreichen Sie nicht automatisch Rechtssicherheit. Dieses Plugin ist ein Werkzeug, welches Ihnen dabei helfen soll die rechtlichen Anforderungen an Ihren Online-Shop umzusetzen. Ein ausführlicher Test durch Sie ist dabei unabdingbar. Hierzu können Sie das Plugin 30 Tage kostenfrei ausprobieren. Möglicherweise kann das Plugin nicht alles, was Sie benötigen. Sollten dies so sein, schreiben Sie uns Ihre Anforderungen in einem Support-Ticket im Shopware Account oder schreiben Sie eine E-Mail an support@mndnext.de.

Einleitung

Mit Inkrafttreten der angepassten Preisangabeverordnung (PAngV) §11 am 28.05.2022 müssen viele Shop-Betreiber bei Preisreduzierungen mit Streichpreisen bzw. allgemeine Rabattierungen über den geringsten Gesamtpreis der letzten 30 Tage informieren. ( Price indication regulation Guideline, EU Directive 98/6/EC ).

Zu rechtlichen Details können wir die ausführliche FAQ der IT-Recht-Kanzlei empfehlen: https://www.it-recht-kanzlei.de/faq-werbung-preisermaessigungen-gesamtpreis-preisangabenverordnung.html

Neue Infos

• 25.08.2022: Version 1.3.3 veröffentlicht
  - Änderung: Anpassung der Option "Niedrigsten Gesamtpreis anzeigen wenn Pseudopreis aktiv", jetzt muss der Pseudopreis zusätzlich höher als der Verkaufspreis sein.
• 21.07.2022: Version 1.3.2 veröffentlicht
  - Neu: Einstellung für die Möglichkeit den Preis aus der Preishistorie anzuzeigen, auch wenn nur ein Preis geloggt wurde
• 19.07.2022: Version 1.3.1 veröffentlicht
  - Neu: Preislog Dauer der Datenaufbewahrung kann jetzt selber bestimmt werden
• 13.06.2022: Version 1.3.0 veröffentlicht
  - Neu: Bearbeiten des Preislogs
  - Bugfix: Kein Logging der Preise für gelöschte Artikel (bei nicht gelöschten Preisen)
• 09.06.2022: Version 1.2.3 veröffentlicht
  - Bugfix: Fehler im Storefront bei Verwendung mit manchen Plugins
• 08.06.2022: Version 1.2.2 veröffentlicht
  - Bugfix: Cronjob Cleanup wurde nicht aufgerufen
  - Bugfix: Hohe Nutzung der CPU beim Preislogging-Worker
  
• 07.06.2022: Version 1.2.1 veröffentlicht
  - Bugfix: Pseudopreis nicht mehr durch 0 ersetzt, wenn es noch keine Log-Einträge gibt.
  - Bugfix: Plugin-Konfiguration wieder für jeden Subshop individuell möglich.
  - Bugfix: Verhindern, dass Log-Tabelle mit verwaisten Einträgen voll läuft. (wird im Update Prozess bereinigt)
  - Bugfix: API Logging funktioniert nun auch mit API Batch Modus korrekt.
  - Bugfix: Plugin hat Product-Stream Vorschau gestört.
  - Neu: Neuer Cronjob um Log-Tabelle zu bereinigen
  - Neu: Batchfähige Worker CLI Commands um Preis-Logging durch parallele Ausführungen beschleunigen zu können. Bitte beachten Sie die Zusatzanmerkungen für die Verwendung des Workers. (siehe Abschnitt "Performance")
  
• 20.05.2022: Version 1.2 veröffentlicht
  Erweitertes Preislogging und grundlegende Unterstützung der Advanced Promotion Suite (Rabatte auf Produktebene)
  Integration Cronjob um Preise zu loggen
  Neuer Button in Plugin Konfiguration um Preise manuell zu loggen
  Anzeige des günstigsten Preise im Warenkorb/Checkout
  Unterstützung für Subshops
  Fehlerkorrekturen
• 09.05.2022: Version 1.1 veröffentlicht:
  Automatische Ausgabe unterstützt nun Ausnahme des §11 Abs. 2 PAngV für schrittweise ansteigende Preisermäßigungen.
  Neue Darstellungsoptionen inkl. individuelle Einstellungen pro Artikel.
• 27.04.2022: Entgegen unserer ursprünglichen Ankündigung werden Shopware Preisgruppen unterstützt.

Was macht dieses Plugin?

• Dieses Plugin ermöglicht die Angabe des niedrigsten Gesamtpreises für Shopware Versionen 5.2.0 - 5.7.7, da für diese Versionen von Shopware keine Lösung bereitgestellt wird.
• Dieses Plugin erleichtert außerdem die Umsetzung für Shopware Versionen 5.2.0 und neuer (also auch 5.7.8+), da es einen Mechanismus zur automatischen Protokollierung des geringsten Gesamtpreises der letzten 30 Tage mit sich bringt.

Wichtig: beachten Sie den Abschnitt "Einschränkungen"!

Konfiguration

Manuelle Angabe des günstigsten Gesamtpreises

Im Shopware Backend finden Sie in der Artikelmaske einen neuen Reiter namens "Günstigster Preis (30 Tage)".

Dort können Sie für den Artikel – bei Variantenartikeln für jede Variante – den günstigsten Gesamtpreis pro Kundengruppe eingeben.

(Die Preiseingabe muss analog zur Preistabelle von Shopware entsprechend der Kundengruppen-Konfiguration "Bruttopreiseingabe" brutto oder netto erfolgen.)

Automatische Protokollierung und Ermittlung des günstigsten Gesamtpreises

Nach Installation kann die initiale Protokollierung durchgeführt werden, welche bei Änderungen des Artikelpreises den zuvor gespeicherten Preis für alle Kundengruppen protokolliert. Für die Ausgabe im Frontend wird dann anhand dieses 30-Tage Protokolls automatisch der geringste Gesamtpreis ermittelt und im Frontend ausgegeben.

Die Protokollierung berücksichtigt die Preisgruppe des Artikels! Falls für den Artikel eine Preisgruppe aktiv ist, wird für den geringsten Gesamtpreis der betreffende Preisgruppenrabatt auf den Preis der Kundengruppe angewendet!

Beispiel: 

Kundengruppe EK: 100,00 EUR. Preisgruppe für EK ab Menge1 mit 10% Rabatt = Gesamtpreis 90,00 EUR im Protokoll.

Seit Version 1.1.0 wird automatisch die Ausnahmeregelung des §11 Abs. 2 PAngV für schrittweise ansteigende Preisermäßigungen berücksichtigt.

Beispiel:

Preishistorie eines Artikels: 100,200,100,300,250,200,150 ergibt 300 als Referenzpreis.

Preisvererbung

Das Plugin unterstützt die Preisvererbung für Shopware: Ist für eine Kundengruppe kein eigener Preis gesetzt, sodass diese den Preis von EK erbt, so wird dieser Preis auch dauerhaft für die Kundengruppe protokolliert. Damit wird immer der Preis protokolliert, welcher der Kundengruppe tatsächlich angeboten wurde – auch wenn die Vererbung im Laufe der 30 Tage wechselt!

Manuelle Protokollierung des günstigsten Gesamtpreises

Analog zur automatischen Protokollierung des günstigsten Gesamtpreises kann über das Shopware Console Kommando der aktuell hinterlegte Preis für alle Artikel protokolliert werden:

bin/console mnd:regulationprice:sync

Ab Version 1.2.0 wird außerdem einen Cronjob integriert welcher das Logging in definierten Zeiträumen durchführt (dies ist notwendig um Preise zu loggen die durch die Advanced Promotion Suite geändert werden)

Dies kann alternativ oder zusätzlich zur automatischen Protokollierung genutzt werden und ist hilfreich für Preisaktualisierungen bei welchen die automatische Protokollierung nicht greift. (Siehe Details zur automatischen Protokollierung oben.)

Ausgabe im Frontend

Im Frontend wird der geringste Gesamtpreis an folgenden Stellen zusätzlich zum Artikelpreis und Pseudopreis ausgegeben:

• Artikel-Listing
• Artikeldetailseite
• Produktvergleich
• Merkzettel
• Slider (Topseller, Zubehör-Artikel, Ähnliche Artikel, Kunden haben sich ebenfalls angesehen)
• Einkaufswelten Elemente (Artikel, Artikel-Slider)
• Warenkorb (optional)
• Checkout (optional)

Ab Version 1.1.0 kann die Ausgabe mit folgenden Optionen gesteuert werden:

• Niedrigsten Gesamtpreis nicht anzeigen, aber Pseudopreis durch niedrigsten Gesamtpreis ersetzen
• Niedrigsten Gesamtpreis anzeigen und bestehenden Pseudopreis durch niedrigsten Gesamtpreis ersetzen
• Niedrigsten Gesamtpreis anzeigen wenn Pseudopreis aktiv und höher als VK
• Niedrigsten Gesamtpreis nie anzeigen
• Niedrigsten Gesamtpreis immer anzeigen

Das bedeutet, sobald die automatische Protokollierung aktiv ist wird auch entsprechend dieser Einstellung diese Zusatzangabe ausgegeben.

Dies soll Ihnen insbesondere zunächst ein Testen des Plugins und der Werte ermöglichen. Anfang Mai wollen wir ein Update veröffentlichen, welches eine feinere Steuerung der Ausgabe ermöglicht.

Stufenweise Preisanpassung

Laut Gesetzestext kann bei kontinuierlichen Preisreduzierungen über den Zeitraum der vergangenen 30 Tage der Streichpreis vom zuletzt geringsten Gesamtpreis abweichen. Seit Version 1.1.0 kann die automatische Preisermittlung des Plugins dies berücksichtigen, wenn Sie die passende Darstellungs-Strategie in der Plugin-Konfiguration ausgewählt haben.

Bekannte Einschränkungen

Automatische Protokollierung

Die automatische Protokollierung kann im Moment nur folgende Fälle an Preisänderungen erkennen:

• Manuelle Änderung in Artikel bzw. Artikelvariante Shopware Backend
• Änderung von Preisgruppen
• Preisaktualisierungen über Shopware API

Für andere Fälle, bei welchen für Preisänderungen nicht die Programmierschnittstellen von Shopware genutzt werden, insbesondere wenn Preise manuell in der Datenbank geändert werden, muss eine manuelle Protokollierung ausgeführt werden.

Die automatische Protokollierung kann damit momentan auch leider keine Preismanipulationen berücksichtigen, welche nicht über die Shopware Preistabelle und Preisgruppen ausgeführt werden. Dies betrifft beispielsweise Promotion Plugins. Wir stellen jedoch für Plugin-Hersteller einen Service bereit, über welchen das Protokoll programmatisch ergänzt bzw. aktualisiert werden kann.

Außerdem besteht die Möglichkeit für Entwickler die Protokoll-Tabelle in der Datenbank manuell zu befüllen.

Details zu beiden Szenarien finden Sie unter dem Abschnitt "Hinweise für Entwickler".

Preis-Protokoll

Das Preis-Protokoll kann im Backend noch nicht manuell ergänzt bzw. korrigiert werden.

Automatische Ermittlung des geringsten Gesamtpreises

Für die automatische Ermittlung des geringsten Gesamtpreises kann nur die Preishistorie des Plugins verwendet werden. Siehe auch Einschränkungen der Automatischen Protokollierung.

Sonstiges

• Für Shopware 5.7.8 und aufwärts kann NICHT das Standard-Feld von Shopware verwendet werden. Es muss der Konfigurationsbereich unseres Plugins genutzt werden.
• Für die Ausgabe im Frontend verwenden wir wo möglich die von Shopware bereitgestellten Theme Blöcke. Das bedeutet dass der Wert aus dem Shopware Standardfeld nicht ausgegeben wird, sondern nur der des Plugins
• Eine Kompatibilität mit anderen Plugins, Shopware Premium Plugins oder spezifischen Shopware Patchlevels kann nicht garantiert werden. Bei Problemen untersuchen wir jedoch gerne Ihren Fall und bemühen uns um eine Lösung.

Grundpreise

Staffelpreise

Staffelpreise werden nicht berücksichtigt. Wir protokollieren derzeit nur den Preis für Menge 1.

Hinweise für Entwickler

Aus anderen Plugins kann der Notify Event "MndRegulationPrice_SyncPrices" aufgerufen werden um eine Aktualisierung des Protokolls auszulösen.

Falls Sie das Preisprotokoll selbst befüllen wollen, empfehlen wir die Datenbanktabelle mnd_regulation_price_logs manuell zu ändern/ergänzen.

Die manuelle Preisangabe kann direkt in die Tabelle mnd_regulation_price_manual eingetragen werden.

Welche Theme Variablen gibt es für Entwickler um den geringsten Gesamtpreis eines Artikels ausgeben zu können und wo sind diese verfügbar? Global?

Überall dort wo der ListProductService verwendet wird: ein Decorator erweitert die ListProduct Daten um eine extra Attribute: mnd_regulation_price (array) der Preis ist im Key "price". Also im Template wird es so verwendet. ListProductServie wird aber nicht überall verwendet, deshalb wird es auch über Events geschrieben, die Events hören auf Compare (Vergleich) und Note (Notizen) und erweitert dort die Daten entsprechend um den Regulated Price.

So sieht die Verwendung im globalen tpl file aus:

{if $sArticle.attributes && $sArticle.attributes.mnd_regulation_price}

    {assign 'regulatedPriceArray' $sArticle.attributes.mnd_regulation_price->toArray()}

    {assign 'regulatedPrice' $regulatedPriceArray.price}

{else}

    {assign 'regulatedPrice' $sArticle.mndRegulationPrice}

{/if}

hier ist der Preis über $regulatedPrice verfügbar.

Installation

Installation und Konfiguration über den Shopware 5 Plugin-Manager.

Nach der Installation muss der Preislogging Mechanismus konfiguriert werden. Falls Sie die Shopware Advanced Promotion Suite oder andere preisverändernde Plugins verwenden wählen Sie bitte "Erweiterter Logger". Nach dem Speichern der Konfiguration können Sie das initiale Logging über den Button "Alle Preise jetzt loggen" starten. Beachten Sie, dass dies bei größerer Anzahl von Artikeln und Kundengruppen etwas dauern kann. Bitte beachten sie den Abschnitt "Performance" um zu erfahren wie Sie das Plugin bei großer Datenmenge optimal nutzen können.

Sonstige Anmerkungen

• Sobald man eine Preisgruppe speichert (Grundeinstellungen - Preisgruppen) wird der Sync auf alle Artikel gestartet und der Preislog geschrieben falls sich durch die Änderung der Preisgruppe der Preis geändert hat.
• Sobald man einen Artikel im Backend speichert, wird ein Sync ausgeführt. Dabei werden nur die Preise für den soeben gespeicherten Artikel gesynct.

Performance

Sollten Sie den "erweiternen Logger" verwenden, kann es bei großer Menge von Artikeln, Kundengruppen und Subshops zu Performanceproblemen beim Logging kommen. Im Storefront selbst sollte es keine Performanceprobleme geben. Details siehe Abschnitt "Warum kann die Ermittlung der Preise langsam sein?".

Kann man das Logging beschleunigen?

Sie können das Preislogging beschleunigen, indem Sie den Worker des Plugins (CLI Commandos) verwenden (verfügbar seit Version 1.2.1).

Der Worker besteht aus 2 Teilen:

• bin/console mnd:regulationprice:sync-worker-prepare : befüllt eine Warteschlange mit den Artikeln, für die der Preis geloggt werden soll.
• bin/console mnd:regulationprice:sync-worker : arbeitet die Warteschlange ab. Der Worker ermittelt alle Preise des Artikels für alle Kundengruppen und Subshops und schreibt diese in den Preislog.

Multiple Worker

Bis jetzt gibt es noch keinen wirklichen Performancegewinn gegenüber einem Cronjob. Der Vorteil des Workers ist dass Sie diesen mehrfach gleichzeitig ausführen können. Die Worker teilen sich dann die Arbeit und arbeiten zusammen die Warteschlange ab. Wieviele Worker Sie gleichzeitig ausführen können, hängt von den Resourcen des Webservers ab.

Worker Daemon-Modus

Die Worker können auch im Daemon-Modus gestartet werden. bin/console mnd:regulationprice:sync-worker --daemon
Damit wird der Worker nach abgearbeiteter Arbeit nicht sofort beendet sondern schaut ständig nach ob eine neue Aufträge in der Warteschlange gibt. Empfohlen wird diese Methode mit Supervisord oder Linux Daemon.

Cronjob und Worker

Nach der Installation des Plugins werden 2 Cronjobs erstellt. Der eine Cronjob befüllt die Warteschlange mit Artikeln, für die der Preis geloggt werden soll (es handelt sich hierbei immer um alle Artikel). Der andere Cronjob arbeitet die Warteschlange ab. Im Grunde ist es auch nichts anderes als würde man die 2 oben erwähnten Befehle ausführen: bin/console mnd:regulationprice:sync-worker-prepare und bin/console mnd:regulationprice:sync-worker. Im Cronjob wird jedoch nur 1 Worker verwendet.

Stellen Sie sicher, dass das Ausführungsintervall des Cronjobs an Ihren Shop angepasst wird. Bei manchen Shops kann der Worker stündlich laufen, bei anderen täglich. Das hängt von der Anzahl der Artikel und wie oft Sie die Preise protokollieren möchten. Aktualisieren Sie die Preise im Shop täglich oder gar mehrmals am Tag, sollte der Cronjob so schnell wie möglich ausgefhrt werden. Bei vielen Artikeln und vielen Preisänderungen, wird es empfohlen den Cronjob zu deaktivieren und multiple Worker zu verwenden (siehe oben).

Warum kann die Ermittlung der Preise langsam sein?

Der erweiterte Preislogger, ist im Gegensatz zum einfachen Logger sehr genau, denn dieser nutzt überwiegend Shopware selbst um die Preise eines Artikels zu ermitteln. Damit werden Preise geloggt, die z.B. durch Plugins oder bestimmte Shop-Einstellungen verändert werden. Der Artikelpreis selbst in der Datenbank hat sich nicht geändert aber Shopware zeigt im Storefront dann einen berechneten / durch Plugins manipulierten Preis an. Der erweiterte Preislogger verwendet diesen im Storefront angezeigten Preis im Preislog an.

Zusätzlich zur Anzahl der Artikel, ist auch die Anzahl der Kundengruppen und Subshops relevant. Je mehr Kundengruppen und Subshops es sind, desto länger dauert es die Preisermittlung. Denn für einen Artikel muss der Preis für jede einzelne Kundengruppe und Subshop ermittelt werden. Beispiel: Wenn es 10 Kundengruppen und 5 Subshops gibt, dann müssen für jeden Artikel 10 * 5 = 50 Preise ermittelt werden. Das Preislog kann somit schnell sehr groß werden. Es werden allerdings nur Preisänderungen geloggt, also das Log wird beim Logging nicht immer voller wenn sich im Shop keine Preise geändert haben.

Sollte die automatische Protokollierung vollständig aktiv sein, wird der Preis auch im Backend beim Speichern von Artikeln geloggt und auch beim Updaten der Preise mittels API. Es kann vorkommen, dass es hier etwas länger als sonst dauert bis der Artikel gespeichert wurde. Es wird empfohlen in den Plugineinstellungen die automatische Protokokollierung von "vollständig" auf "Nur über Cronjob" umzustellen.

Kompatibilität

• Wir streben derzeit eine Kompatibilität von Shopware 5.2.0 aufwärts an. Bei entsprechender Nachfrage gegebenenfalls auch für noch ältere Shopware 5 Versionen. Schreiben Sie uns gerne Ihr Interesse an support@mndnext.de
• Das Plugin ist soweit nicht anders beschrieben mit dem Standard Shopware 5 Responsive Theme. Andere Themes sind nicht getestet, wir prüfen bei einem Problem aber gerne, ob wir es lösen können.
• Eine pauschale Kompatibilität mit anderen Plugins, darunter auch die Premium Plugins von Shopware, können wir nicht garantieren. Bitte testen Sie das Zusammenspiel mit den Erweiterungen und Anpassungen in Ihrem Shop gewissenhaft. Bei Problemen prüfen wir gerne, ob wir diese lösen können.

FAQ

Ist es möglich für Subshops unterschiedliche geringste Gesamtpreise auszugeben?

Ja. Artikelpreise in Subshops werden in Shopware 5 anhand der Standardkundengruppe ermittelt, welche in der Subshop-Konfiguration der Grundeinstellungen angegeben ist. Die Protokollierung unseres Plugins speichert die Preise für jede Kundengruppe – so wie auch die Preisangabe eines Artikels in Shopware erfolgt.

Wird der Streichpreis (Pseudopreis) durch den niedrigsten Gesamtpreis der letzten 30 Tage ersetzt?

Seit Version 1.1.0 kann dies eingestellt werden.

Anmerkungen zur Rechtssicherheit

Dieses Plugin ist ein Werkzeug, welches Ihnen die Umsetzung der rechtlichen Anforderungen Ihres Shops gemäß der für Sie zuständigen Rechtsberatung erleichtern soll. Dieses Plugin und damit verbundene Supportleistungen inkl. dieser Dokumentation stellen keine Rechtsberatung dar und berücksichtigen möglicherweise nicht die Eigenarten Ihres Shops. Die Implementierung dieses Plugins hat keinen Anspruch auf Vollständigkeit hinsichtlich der Umsetzung einer bestimmten Rechtsauffassung. Des weiteren geben wir als Hersteller keine Zusagen oder Garantien in Bezug auf die Implementierung gegenwärtiger oder zukünftiger Rechtsauffassungen oder Rechtspflichten.

Das gesagt, wollen wir natürlich eine möglichst optimale Lösung anbieten. Sollten Sie ein bestimmtes Feature oder Verhalten benötigen, welches das Plugin noch unzureichend abbildet, wenden Sie sich gerne an unseren Support und wir schauen was sich machen lässt.  support@mndnext.de.

Haben Sie Feature Requests oder Fragen?

Eröffnen Sie gerne ein Support Ticket im Shopware Account, oder wenden Sie sich gerne an support@mndnext.de