Preis nach Land, Shop & Währung: Dokumentation

Preis nach Land, Shop & Währung wendet einen Margen-Koeffizienten und eine psychologische Rundung pro Markt an und schreibt das Ergebnis als native PrestaShop-Sonderpreise. Diese Anleitung behandelt Installation, Regelerstellung, Preisberechnung, Simulation, Neuberechnung, das Rückgängigmachen einer Neuberechnung und die Automatisierung per Cron.

Installation und Update

Das Modul ist mit PrestaShop 8.0 bis 9.x kompatibel, im Einzel- wie im Multishop-Betrieb.

1. Öffnen Sie im Back-Office Module > Modulmanager, klicken Sie auf Modul hochladen und wählen Sie die ZIP-Datei.
2. Das Modul legt seine Tabellen, einen Reiter DF Multi Price unter Katalog und ein Cron-Token an.
3. Öffnen Sie die Modulkonfiguration, um die automatische Anwendung und die Stapelgröße einzustellen und die Cron-URL abzurufen.

Eine Preisregel erstellen

Öffnen Sie Katalog > DF Multi Price und klicken Sie auf Neue Regel hinzufügen. Das Formular hat vier Blöcke.

Wer sieht diesen Preis

• Shop: ein Shop oder alle. Bei „Alle Shops“ werden die Basispreise aus dem Standard-Shop gelesen.
• Land: Seine Mehrwertsteuer dient zur Berechnung des gerundeten Bruttopreises. Ein Besucher ohne Adresse wird dem Standardland des Shops zugeordnet, außer bei aktivierter Geolokalisierung, und ein Währungswechsel ändert sein Land nicht. Eine Regel für ein anderes Land erreicht also nur Kunden mit einer Adresse in diesem Land. Für eine Währungsregel „Alle Länder“ beibehalten.
• Währung: Legen Sie eine Regel pro Währung an, um die Endung in jeder Währung zu steuern. Bei „Alle Währungen“ wird der Preis in der Standardwährung angegeben und PrestaShop rechnet ihn für die anderen Währungen um, die dabei die Endung verlieren.
• Kundengruppe: für B2B-Preislisten. Gruppenrabatte aus Kunden > Gruppen gelten weiterhin zusätzlich.

Welche Produkte

• Kategorie: die Kategorie mit allen Unterkategorien oder der gesamte Katalog.
• Marke: beschränkt die Regel auf eine Marke.
• Ausgeschlossene Produkte: Produkt-IDs, durch Kommas getrennt.
• Laufende Aktionen beibehalten: siehe eigener Abschnitt weiter unten.

Preisberechnung

• Preisbasis: Nettoverkaufspreis oder Einkaufspreis. Beim Einkaufspreis werden Produkte ohne Einkaufspreis übersprungen.
• Margen-Koeffizient: Preis = Basis x Koeffizient. 1,20 fügt 20 % hinzu. Mit 1 wird nur gerundet.
• Jede Variante bepreisen: empfohlen. Jede Variante erhält ihren eigenen Preis inklusive Aufpreis. Ohne diese Option addiert PrestaShop den Variantenaufpreis nach der Rundung und die Endung geht verloren.
• Rundung: nächstgelegene Endung, immer aufrunden, immer abrunden oder keine Rundung.
• Psychologische Endung: x,90, x,95, x,99, x,50 oder x,00.
• Rundungsschritt: rundet auf ein Vielfaches eines Schritts statt auf eine Endung. Verfügbare Schritte: 0,05, 0,10, 0,20, 0,25, 0,50, 1, 5 und 10. Die Richtung folgt dem Feld Rundung: mit 0,10 und Nächstgelegene Endung wird 23,47 zu 23,50; mit 10 und Immer aufrunden wird 23,47 zu 30; mit 10 und Immer abrunden zu 20. Ist ein Schritt gewählt, ersetzt er die Endung. Der Preis wird nie auf null gerundet: Er beträgt mindestens einen Schritt. „Keiner“ (Standard) behält die Endung.
• Bruttopreis runden: empfohlen für B2C. Für netto angezeigte B2B-Preise deaktivieren: Dann wird der Nettopreis gerundet.

Schutzmechanismen

• Mindestpreis: minimaler angezeigter Preis in der Regelwährung. 0 = kein Minimum.
• Mindestmarge auf den Einkaufspreis: Koeffizient auf den Einkaufspreis, unter den der Preis nie fällt, z. B. 1,15. Gilt für Produkte mit Einkaufspreis. 0 = deaktiviert.
• Priorität: Niedrige Werte laufen zuerst. Zielen zwei Regeln auf denselben Shop, dasselbe Land, dieselbe Währung und Gruppe, behält die erste den Preis und die andere zählt einen Konflikt.
• Aktiv: Das Deaktivieren einer Regel entfernt die von ihr erzeugten Preise.

Wie der Endpreis berechnet wird

Rundung ergibt nur auf dem Betrag Sinn, den der Kunde sieht. Die Engine folgt dieser Reihenfolge:

1. Netto-Basispreis (Variante inklusive, wenn die Option aktiv ist) multipliziert mit dem Koeffizienten.
2. Umrechnung in die Regelwährung zum Wechselkurs des Shops.
3. Wechsel zu brutto mit der Mehrwertsteuer des Regellandes, plus Öko-Abgabe, wenn sie in PrestaShop aktiviert ist.
4. Rundung auf die gewählte Endung oder, wenn ein Rundungsschritt gesetzt ist, auf ein Vielfaches des Schritts.
5. Mindestpreis, dann Mindestmarge, beide aufgerundet.
6. Rückkehr zum Nettopreis, gespeichert in der Regelwährung.

Beispiel: Ein Basispreis von 69,99 € netto, ein Koeffizient von 1,20, 19 % MwSt. und die Endung x,99 ergeben 99,99 € brutto im Shop.

Einen Preis im Shop prüfen

Das Panel Einen Preis im Shop prüfen über der Regelliste bildet die Berechnung von PrestaShop für einen bestimmten Kontext nach. Geben Sie eine Produkt-ID und bei Bedarf eine Varianten-ID ein und wählen Sie Shop, Land (standardmäßig das des Shops), Währung und Gruppe (standardmäßig Besucher). Das Panel zeigt:

• das Land, dem Besucher ohne Adresse zugeordnet werden, und den Status der Geolokalisierung;
• den angezeigten Preis, netto oder brutto je nach Gruppe;
• den von PrestaShop verwendeten Sonderpreis und seine Herkunft: Modulregel, manuell erfasster Preis oder Katalogpreisregel;
• den Status jeder Regel: angewendet, anderer Kontext (mit Shop, Land, Währung oder Gruppe der Regel), Produkt außerhalb der Regel, neu zu berechnen, Aktion beibehalten oder von einem anderen Sonderpreis überdeckt.

Die Regelliste zeigt außerdem einen Hinweis, wenn eine Regel ohne Geolokalisierung auf ein anderes Land als das Standardland ihres Shops zielt oder eine Regel „Alle Shops“ Shops mit unterschiedlichen Standardländern abdeckt.

Vor der Anwendung simulieren

In der Regelliste öffnet die Aktion Simulieren ein Fenster, das für die ersten betroffenen Produkte den aktuellen Shop-Preis, den neuen Preis und die Abweichung in Prozent zeigt. Nichts wird gespeichert. Ausgelassene Produkte erscheinen mit ihrem Grund: laufende Aktion oder kein Basispreis.

Die Aktion CSV-Vorschau exportieren erzeugt die vollständige Liste (Produkt-ID, Varianten-ID, Artikelnummer, Name, aktueller Preis, neuer Preis, gespeicherter Nettopreis, Status) als CSV mit Semikolon, lesbar in Excel.

Neu berechnen

• Die Aktion Neu berechnen einer Regel wendet diese Regel auf den Katalog an.
• Die Schaltfläche Alle aktiven Regeln neu berechnen in der Symbolleiste verkettet die Regeln in Prioritätsreihenfolge.

Die Verarbeitung läuft in Stapeln mit Fortschrittsbalken und anschließender Bilanz:

• Erstellt, Aktualisiert, Unverändert: von der Regel geschriebene Preise.
• Aktionen beibehalten: Produkte, die wegen einer Aktion unberührt bleiben.
• Konflikte: Preise, die bereits eine vorrangige Regel mit denselben Dimensionen hält.
• Übersprungen: Produkte ohne verwendbaren Basispreis.
• Entfernt: gelöschte oder dem Händler zurückgegebene Preise, z. B. für ein Produkt außerhalb des Geltungsbereichs.

Eine nach ihrer letzten Neuberechnung bearbeitete Regel zeigt in der Liste den Hinweis Neu zu berechnen. Die Stapelgröße (10 bis 500 Produkte) wird in der Modulkonfiguration eingestellt.

Eine Neuberechnung rückgängig machen

Jede Neuberechnung, manuell oder per Cron, speichert den vorherigen Stand jedes Preises, den sie ändert. Zum Zurückgehen:

• in der Regelliste die Aktion Letzte Neuberechnung rückgängig machen;
• oder in der Modulkonfiguration die Schaltfläche Rückgängig im Verlauf.

Das Rückgängigmachen löscht die von der Neuberechnung erstellten Preise, gibt geänderten Preisen ihren Wert zurück und legt entfernte Preise neu an. Es funktioniert in umgekehrter Reihenfolge: zuerst die jüngste Neuberechnung, dann die vorherige, bis zu 5 Neuberechnungen zurück pro Regel. Eine abgebrochene Neuberechnung (Fenster während der Verarbeitung geschlossen) lässt sich eine Stunde nach ihrem Start rückgängig machen.

Danach zeigt die Regel Neu zu berechnen, da die Preise nicht mehr zu ihren Einstellungen passen. Passen Sie die Regel bei Bedarf an, simulieren Sie und berechnen Sie neu.

Aktionen und manuelle Preise

PrestaShop wendet pro Produkt nur einen Sonderpreis an: der spezifischste gewinnt. Ein Preis pro Land und Währung würde also eine breitere Aktion verdecken. Mit Laufende Aktionen beibehalten bleibt ein Produkt mit aktivem Rabatt (nicht vom Modul angelegt) unberührt und wird bei der ersten Neuberechnung nach Ende der Aktion neu bepreist. Planen Sie den Cron, damit dies automatisch geschieht.

Existiert bereits ein manueller Festpreis mit denselben Dimensionen wie die Regel, ohne Rabatt und ohne Datum, übernimmt die Regel ihn, statt ein Duplikat anzulegen. Sein ursprünglicher Wert wird gespeichert und beim Rückgängigmachen, beim Deaktivieren oder Löschen der Regel oder bei der Deinstallation des Moduls zurückgegeben. Aktionen und Preise mit anderen Dimensionen werden nie verändert.

Mit Cron automatisieren

Die token-geschützte Cron-URL wird in der Modulkonfiguration angezeigt:

https://ihrshop.de/index.php?fc=module&module=dfmultiprice&controller=cron&token=IHR_TOKEN

Fügen Sie &id_rule=3 hinzu, um nur eine Regel neu zu berechnen. Planen Sie die URL bei Ihrem Hoster, zum Beispiel jede Nacht: So folgen die Preise Wechselkurs- und Kostenänderungen sowie dem Ende von Aktionen. Der Cron liefert eine JSON-Bilanz pro Regel und jeder Lauf lässt sich wie eine manuelle Neuberechnung rückgängig machen. Bei einem Leck des Tokens erzeugen Sie es in der Konfiguration neu: Die alte URL funktioniert dann nicht mehr.

Automatische Anwendung

Ist die Option aktiviert, wendet das Anlegen oder Ändern eines Produkts oder einer Variante die aktiven Regeln auf dieses Produkt an. Praktisch für regelmäßige Importe.

Verlauf

Die Modulkonfiguration listet die letzten 20 Neuberechnungen: Datum, Regel, Quelle (manuell oder Cron), Status, Zähler und Anzahl der für das Rückgängigmachen erfassten Änderungen.

Deaktivieren, Löschen und Deinstallieren

• Das Deaktivieren oder Löschen einer Regel entfernt die von ihr erzeugten Preise und gibt übernommenen manuellen Preisen ihren Wert zurück.
• Das Duplizieren einer Regel erzeugt eine deaktivierte Kopie, bereit für einen anderen Markt.
• Die Deinstallation entfernt alle erzeugten Preise und gibt übernommenen manuellen Preisen ihren Wert zurück.

Fehlerbehebung

Ein Produkt wird nicht aktualisiert

Prüfen Sie, ob es im Shop der Regel aktiv ist, zur Zielkategorie und -marke gehört und nicht ausgeschlossen ist. Starten Sie eine Simulation: Der Status zeigt, ob es in einer Aktion ist oder keinen Basispreis hat. Bei der Basis „Einkaufspreis“ braucht es einen Einkaufspreis.

Der angezeigte Preis hat nicht die richtige Endung

Prüfen Sie, ob „Bruttopreis runden“ aktiviert ist und das Regelland dem des Kunden entspricht. Für eine Variante mit Aufpreis aktivieren Sie „Jede Variante bepreisen“. In einer anderen als der Regelwährung rechnet PrestaShop den Preis um: Legen Sie eine Regel für diese Währung an.

Der Preis stimmt in Euro, aber nicht in einer anderen Währung

Die Regel steht auf „Alle Währungen“: Der Preis wird in der Standardwährung gespeichert und PrestaShop rechnet ihn um, zum Beispiel 23,90 € in 27,84 $. Die Endung bleibt nicht erhalten. Das Panel Preis prüfen zeigt dann in beiden Währungen denselben Sonderpreis. Legen Sie eine Regel pro Währung an, mit Land auf „Alle Länder“, und berechnen Sie neu.

Eine Länderregel gilt nicht für Besucher

Besucher ohne Adresse werden dem Standardland des Shops zugeordnet. Eine Regel für ein anderes Land gilt nur für Kunden mit einer Adresse in diesem Land oder, bei aktivierter Geolokalisierung, für alle Besucher aus diesem Land (International > Lokalisierung > Geolokalisierung).

Die Endung stimmt in nur einem Shop nicht

Im Multishop verwendet die Rundung die Mehrwertsteuer des Standardlandes des Shops, auf den die Regel zielt. Eine Regel „Alle Shops“ basiert auf dem Standard-Shop: Haben Ihre Shops nicht dasselbe Standardland, legen Sie eine Regel pro Shop an.

Die Endung erscheint nicht auf dem Nettopreis, den Besucher sehen

Zeigt die Gruppe Besucher Nettopreise an, deaktivieren Sie „Bruttopreis runden“: Die Endung gilt dann für den Nettopreis, den Besucher sehen.

Die Bilanz zeigt Konflikte

Eine andere Regel mit demselben Shop, Land, derselben Währung und Gruppe hält diese Preise bereits. Passen Sie die Prioritäten an oder führen Sie die beiden Regeln zusammen.

Die Schaltfläche Rückgängig erscheint nicht

Nur die letzte Neuberechnung jeder Regel lässt sich rückgängig machen, sofern sie mit 1.1.1 erfolgte und zu den letzten 5 gehört. Eine seit weniger als einer Stunde laufende Neuberechnung lässt sich noch nicht rückgängig machen.

Der Cron gibt „Invalid token“ zurück

Das Token der URL stimmt nicht mehr mit dem gespeicherten überein. Holen Sie die aktuelle URL aus der Konfiguration.

Bei einigen Produkten erscheint ein Badge „-0,00 €“

Das ist kein Theme-Problem. PrestaShop ab 8.1 berechnet den angezeigten Rabatt, indem es den auf 2 Nachkommastellen gerundeten Preis vom Preis ohne Rabatt abzieht, der 6 Nachkommastellen behält. Da der Preis einer Regel netto gespeichert wird, bleibt beim Zurückrechnen auf brutto bei 19, 21 oder 23 % MwSt. manchmal eine Abweichung von 0,000001, die das Theme als Rabatt von -0,00 € anzeigt. Seit Version 1.1.4 gleicht das Modul diese Abweichung bei seinen eigenen Preisen aus: Aktualisieren Sie das Modul und leeren Sie den Cache unter Erweiterte Einstellungen > Leistung. Eine Neuberechnung ist nicht nötig.