DataFirefly Auto Clearance: Ladenhüter automatisch abverkaufen

Installation

Installieren Sie das Modul über Module > Modulverwaltung > Modul hochladen, indem Sie die ZIP-Datei senden, oder legen Sie den Ordner dfclearance im Verzeichnis /modules/ Ihres Shops ab und klicken Sie auf Installieren.

Bei der Installation:

• legt das Modul unter Startseite eine Kategorie Outlet an, die Sie umbenennen oder durch eine bestehende Kategorie ersetzen können;
• fügt es den Tab Katalog > Automatischer Abverkauf hinzu, der die Produkte im Outlet auflistet;
• erstellt es seine Tabellen (Outlet-Produkte, Ausschlüsse, Protokoll, Outlet-Verkäufe);
• bleibt es deaktiviert: Kein Preis und keine Kategorie ändert sich, solange Sie die automatische Ausführung nicht aktivieren.

Erste Schritte

Die Konfigurationsseite zeigt eine Checkliste mit vier Schritten, solange das Modul nicht vollständig in Betrieb ist:

1. Stufen festlegen im Tab Stufen und Preise. Standardwerte: 10 % nach 90 Tagen, 20 % nach 150 Tagen und 35 % nach 240 Tagen.
2. Simulation starten mit der Schaltfläche Simulieren oben auf der Seite. Der Bericht listet die Produkte, die ins Outlet kämen, die Rabatte, die sich ändern würden, und die Produkte, die es verlassen würden. Es wird nichts geschrieben.
3. Automatische Ausführung aktivieren, erste Option im Tab Stufen und Preise.
4. Cronjob einrichten mit der URL aus dem Tab Cronjob.

Nach einer Simulation führt die Schaltfläche Jetzt anwenden den Lauf tatsächlich aus, sofern das Modul aktiviert ist.

Stufen und Preise

Standardstufen

Jede Stufe verknüpft eine Anzahl Tage ohne Verkauf mit einem prozentualen Rabatt. Die erste Stufe ist die Eintrittsschwelle ins Outlet. Jede Stufe muss einen höheren Rabatt als die vorherige geben. Eine Zeitleiste unter der Tabelle zeigt den Verlauf und markiert unstimmige Stufen vor dem Speichern.

Die Tage ohne Verkauf werden ab der letzten gültigen Bestellung gezählt, die das Produkt enthält, alle Varianten zusammengenommen. Ein nie verkauftes Produkt zählt ab seinem Erstellungsdatum.

Stufenverlauf

• Tage ohne Verkauf: Der Zähler startet nach jedem Verkauf neu, auch nach einem Verkauf im Outlet.
• Verweildauer im Outlet: Die Stufen laufen weiter, auch wenn sich das Produkt verkauft.

In beiden Fällen sinkt der Rabatt eines Outlet-Produkts nie.

Stufen pro Kategorie

Die Schaltfläche Kategorieregel hinzufügen legt eigene Stufen für eine Kategorie an. Die Regel gilt für die Kategorie und alle Unterkategorien und ersetzt die Standardstufen für die betroffenen Produkte. Passt ein Produkt zu mehreren Regeln, gilt die erste in der Liste. Bei einem ins Outlet verschobenen Produkt verwendet das Modul die Kategorien, die es vor dem Eintritt hatte.

Umgang mit Kategorien

• Hinzufügen (empfohlen): Das Produkt wird dem Outlet hinzugefügt und bleibt in seinen Kategorien.
• Als Standardkategorie hinzufügen: Das Outlet wird zusätzlich Standardkategorie und erscheint im Breadcrumb.
• Verschieben: Das Produkt erscheint nur noch im Outlet. Seine Kategorien werden gespeichert und beim Austritt wiederhergestellt.

Preisschutz

• Höchstrabatt (standardmäßig 60 %): Obergrenze für alle Stufen.
• Margenschutz: Der Outlet-Preis fällt nie unter den Netto-Einkaufspreis zuzüglich der Mindestmarge (standardmäßig 5 %). Produkte ohne Einkaufspreis werden nicht begrenzt. Ist kein Rabatt möglich, kommt das Produkt nicht ins Outlet.
• Preisendung: Exakt, x,99, x,90 oder x,00. Das Modul rundet den Bruttopreis im Outlet für das Standardland auf die nächste Endung. Liegt keine Endung innerhalb von 5 Punkten des Stufenrabatts, bleibt der exakte Prozentsatz erhalten.

Das Feld Vorschau mit einem Produkt zu berechnet live den Preis jeder Stufe für einen Preis Ihrer Wahl, inklusive Rundung und Höchstrabatt.

Teilnahmebedingungen

Aufnahmebedingungen

• Mindestbestand für die Aufnahme: Mit 2 oder mehr bleibt die letzte Einheit zum Normalpreis.
• Bereits reduzierte Produkte ignorieren: Ein Produkt mit einem aktiven Rabatt für alle Kunden kommt nicht ins Outlet, damit sich Rabatte nicht addieren.
• Ausgeschlossene Kategorien und Marken: Die betroffenen Produkte kommen nie ins Outlet. Ein Filterfeld hilft, eine Kategorie in einer langen Liste zu finden.

Virtuelle, deaktivierte und kostenlose Produkte werden immer ignoriert.

Austrittsbedingungen

• Outlet bei ausverkauftem Bestand verlassen: Das Produkt erhält Kategorien und Normalpreis zurück, sobald es ausverkauft ist.
• Outlet bei Nachschub verlassen: Das Produkt tritt aus, wenn sein Bestand die Menge beim Eintritt übersteigt.
• Ein deaktiviertes oder ausgeschlossenes Produkt tritt ebenfalls beim nächsten Lauf aus.

Wiederaufnahmefrist

Ein Produkt, das das Outlet verlässt, ob manuell entfernt, nachbestellt oder ausgeschlossen und wieder zugelassen, kann vor Ablauf dieser Frist nicht zurückkehren (standardmäßig 30 Tage, 0 deaktiviert sie). Mit 30 Tagen entspricht der durchgestrichene Preis immer dem niedrigsten Preis der letzten 30 Tage, wie es die EU-Omnibus-Richtlinie und in Deutschland die Preisangabenverordnung verlangen. Nach einem Wechsel der Outlet-Kategorie gilt die Frist nicht.

Neue Produkte pro Ausführung

Begrenzt die Zahl der Produkte, die pro Lauf ins Outlet kommen (standardmäßig 200). Der Rest wird in den folgenden Läufen verarbeitet. Jeder Lauf hat außerdem ein Zeitbudget, um die Grenzen des Hostings einzuhalten.

Pause

Geben Sie ein Start- und ein Enddatum ein, um den Abverkauf während des Schlussverkaufs oder einer Black-Friday-Aktion auszusetzen. Während der Pause kommt kein Produkt ins Outlet und kein Rabatt steigt. Austritte gelten weiterhin, die aktuellen Outlet-Preise bleiben unverändert. Die Kopfzeile des Moduls zeigt die laufende Pause an.

Cronjob

Der Tab Cronjob liefert die URL, die einmal täglich aufgerufen werden soll, am besten nachts, mit einer Kopierschaltfläche. Verfügbare Parameter:

• &simulate=1: Probelauf, nichts wird geändert;
• &all_shops=1: verarbeitet alle Shops einer Multishop-Installation.

Beispielzeile für crontab oder cPanel:

0 3 * * * curl -s "https://ihr-shop.de/module/dfclearance/cron?token=IHR_TOKEN" > /dev/null

Das Datum des letzten Aufrufs wird angezeigt. Ist die automatische Ausführung aktiviert und wurde der Cronjob seit mehr als 48 Stunden nicht aufgerufen, erscheint oben auf der Seite ein Hinweis. Die Schaltfläche Neues Token macht die aktuelle URL ungültig.

Dashboard

Der Tab Dashboard zeigt:

• die Zahl der Produkte und Einheiten im Outlet;
• den abzuverkaufenden Bestand zum Einkaufswert und seinen Wert zum Outlet-Preis;
• den Netto-Outlet-Umsatz der letzten 30 Tage mit Zahl der Bestellungen und Einheiten, sowie seit der Installation;
• den abverkauften Bestand zum Einkaufswert;
• den Durchschnittsrabatt der Outlet-Produkte;
• ein Tagesdiagramm des Outlet-Umsatzes, die Bewegungen der letzten 30 Tage, die Verteilung der Produkte nach Rabatt und die fünf Outlet-Bestseller.

Verkäufe werden bei der Bestellung erfasst, für die Produkte, die zu diesem Zeitpunkt im Outlet sind. Nur gültige Bestellungen zählen, Beträge werden in die Standardwährung umgerechnet. Die Zahlen beginnen mit der Installation des Moduls: Es gibt keine rückwirkende Historie.

Demnächst und Ausschlüsse

Der Tab Demnächst listet die Produkte, die ihre Eintrittsschwelle in den nächsten 7, 14, 30 oder 60 Tagen erreichen, mit dem Rabatt, den sie erhalten, ihrem Bestand und dessen Einkaufswert. Mit „nächster Lauf“ markierte Produkte haben ihre Schwelle bereits überschritten. Die Schaltfläche Ausschließen nimmt sie dauerhaft vom Abverkauf aus.

Der Tab Ausgeschlossene Produkte akzeptiert durch Kommas getrennte IDs oder Artikelnummern. Wird ein Produkt ausgeschlossen, das bereits im Outlet ist, verlässt es dieses sofort. Die Schaltfläche Ausschluss aufheben macht es nach Ablauf der Wiederaufnahmefrist wieder teilnahmeberechtigt.

Badge und E-Mails

Badge

Das Badge erscheint auf Produktminiaturen und Produktseiten neben dem nativen Rabatt-Badge. Farbe und Text lassen sich pro Sprache festlegen, mit Live-Vorschau.

E-Mail-Bericht

Nach der Aktivierung wird nach jedem echten Lauf, der Produkte ins Outlet aufnimmt, entfernt oder einen Rabatt ändert, ein Bericht gesendet. Er listet die betroffenen Produkte mit Rabatt und Grund. Lassen Sie das Empfängerfeld leer, um die E-Mail-Adresse des Shops zu verwenden, oder geben Sie mehrere durch Kommas getrennte Adressen ein. Die Testschaltfläche sendet das Ergebnis einer Simulation.

Liste der Outlet-Produkte

Katalog > Automatischer Abverkauf listet die Produkte im Outlet mit Rabatt, Normalpreis brutto, Outlet-Preis brutto, Bestand, Eintrittsdatum und nächster Stufe (zum Beispiel „35 % in 38 Tagen“). In dieser Liste können Sie:

• ein Produkt aus dem Outlet nehmen, das dann erst nach Ablauf der Wiederaufnahmefrist zurückkehren kann;
• einen manuellen Lauf starten;
• die Liste als CSV exportieren.

Wie der Rabatt angewendet wird

Der Rabatt ist ein nativer PrestaShop-Sonderpreis für alle Kunden, Währungen und Länder. Das Theme zeigt daher den üblichen Streichpreis und das Rabatt-Badge. Ohne Preisendung ist der Rabatt ein Prozentsatz. Mit Preisendung ist er ein für das Standardland berechneter Bruttobetrag, und Themes zeigen die Ersparnis dann als Betrag statt als Prozentsatz.

Das Modul aktualisiert den Preisindex des Facettensuche-Moduls, sofern dieses es erlaubt, damit der Preisfilter korrekt bleibt. Ändert sich der Grundpreis eines Produkts, während es im Outlet ist, wird der Sonderpreis beim nächsten Lauf neu berechnet.

Deinstallation und Zurücksetzen

Die Schaltfläche Alle Produkte herausnehmen im Tab Cronjob entfernt alle Produkte aus dem Outlet, stellt ihre Kategorien wieder her und löscht ihre Outlet-Preise. Danach gilt die Wiederaufnahmefrist. Die Deinstallation des Moduls tut dasselbe, bevor sie seine Tabellen löscht. Die Outlet-Kategorie wird nicht gelöscht.

Fehlerbehebung

Kein Produkt kommt ins Outlet

Starten Sie eine Simulation. Der Abschnitt Übersprungene Produkte listet die Produkte, die der Margenschutz nicht rabattieren lässt. Die anderen Filter erzeugen keine Zeile im Bericht: Prüfen Sie den Mindestbestand, die Option für bereits reduzierte Produkte, die ausgeschlossenen Kategorien und Marken, die Wiederaufnahmefrist und eine eventuelle Pause. Prüfen Sie zuletzt, ob die erste Stufe nicht länger ist als das Alter Ihrer Produkte.

Ein manuell entferntes Produkt kommt nicht zurück

Das ist die Wiederaufnahmefrist. Verkürzen Sie sie oder setzen Sie sie auf 0, wenn Sie nicht in der Europäischen Union verkaufen.

Der Outlet-Preis endet nicht auf ,99

Bei einem günstigen Produkt liegt keine Endung innerhalb von 5 Punkten des Stufenrabatts: Das Modul behält dann den exakten Prozentsatz. In anderen Ländern als dem Standardland verschiebt ein anderer Mehrwertsteuersatz die Endung ebenfalls.

Der Cronjob läuft nicht

Öffnen Sie die Cron-URL im Browser: Sie muss ein JSON-Ergebnis liefern. Ein Fehler 503 deutet meist auf den Wartungsmodus hin, ein Fehler 403 auf ein ungültiges Token.

Kompatibilität

• PrestaShop 8.0 bis 9.x, dieselbe ZIP-Datei deckt beide Versionen ab.
• Multishop und mehrsprachig.
• Ohne Composer-Abhängigkeit.
• Rabatt pro Produkt, alle Varianten zusammengenommen.
• Oberfläche auf Französisch, Englisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch und Portugiesisch.