# Wissensdatenbank In unserer Wissensdatenbank findest du Anleitungen und Profi Wissen zu unseren Shopware 6 Plugins. Diese Datenbank ist stets deine erste Anlaufstelle für Fragen und Probleme mit unseren Erweiterungen. Hier findest du Antworten auf viele Fragen und musst oftmals gar nicht erst eine Supportanfrage stellen und auf unsere E-Mail warten. Solltest du hier keine Lösung finden, so kannst du natürlich gerne jederzeit eine Supportanfrage stellen.
Individuelles FeatureDu vermisst eine Funktion in einer unser Store Erweiterung oder benötigst eine eigene Erweiterung?Programmierung anfragen
Shop BetreuungDu möchtest Deinen Shop auf ein neues Level bringen und benötigst technische Unterstützung?Betreuung anfragen
SupportDu hast technische Probleme mit einer unserer Erweiterungen?
Support anfragen
# Plugins Das **Shopware 6 Plugin System** ist ein flexibles und modular aufgebautes System, mit dem Entwickler Funktionalitäten zur Shopware-Plattform hinzufügen oder bestehende Features erweitern können. Es basiert auf dem Symfony-Framework und verwendet moderne PHP-Standards. ### Zielsysteme Shopware Plugins können sowohl in selbst gehosteten Shopware Shops als auch für PaaS (Cloud) Shops verwendet werden. SaaS (Cloud) eignet sich hierfür nicht. ### **Kernmerkmale des Shopware 6 Plugin Systems**: 1. **Modularität** * Plugins können unabhängig entwickelt, installiert und aktualisiert werden. * Erweiterungen beeinflussen den Shop nicht direkt, sondern ergänzen oder verändern bestimmte Bereiche. 2. **Zwei Hauptarten von Erweiterungen** * **Apps**: Plattformunabhängige Erweiterungen, die per API mit Shopware interagieren und keine direkten Code-Änderungen vornehmen. * **Plugins**: PHP-basierte Erweiterungen, die tief in das System integriert sind und die Core-Funktionalität direkt verändern können. 3. **Symfony Event System & Hooks** * Plugins nutzen das **Event-Listener-System**, um bestehende Prozesse zu beeinflussen oder eigene Logik hinzuzufügen. * **Subscriber** können sich an Events binden, um beispielsweise Bestellprozesse oder das Frontend zu erweitern. 4. **Dependency Injection (DI)** * Das Plugin-System nutzt Symfony's DI-Container für die Verwaltung von Services, wodurch Erweiterungen effizient und flexibel eingebunden werden. 5. **Datenbankerweiterung mit Migrations** * Plugins können eigene Datenbanktabellen oder Felder über **Migrations-Skripte** hinzufügen. 6. **Theme-Erweiterung & Twig-Templates** * Plugins können das Frontend durch eigene Templates, Blöcke oder Erweiterungen in Twig anpassen. 7. **Verwaltung über das Shopware Admin Panel** * Plugins lassen sich bequem über den **Admin-Bereich** installieren, aktivieren und konfigurieren. # Prämienartikel/ Gratisartikel ### **Kostenlose Produkte im Checkout für Shopware 6** Mit dieser Erweiterung integrierst du attraktive Gratisartikel direkt in den Checkout-Prozess deines Shops. Über das bestehende Gutscheinmodul von Shopware lässt sich die Funktion unkompliziert steuern und flexibel an deine Verkaufsstrategie anpassen.
#### **Highlights der Erweiterung** **Automatische Gratisartikel ab Mindestbestellwert**\ Sobald ein festgelegter Warenkorbwert erreicht wird, erhalten Kund:innen automatisch ausgewählte Prämienprodukte – ganz ohne zusätzlichen Aufwand im Bestellprozess. **Flexible Mengenbegrenzung**\ Lege fest, wie viele Gratisartikel pro Bestellung ausgegeben werden dürfen – perfekt für gezielte Kampagnensteuerung. #### **Deine Vorteile auf einen Blick** **Steigerung des Umsatzes**\ Gratiszugaben schaffen Kaufanreize und sorgen dafür, dass Kund:innen häufiger höhere Warenkorbwerte erreichen. **Stärkere Kundenbindung**\ Belohne gezielt treue Kund:innen oder bestimmte Zielgruppen mit exklusiven Prämien und schaffe ein positives Einkaufserlebnis. **Nahtlose Integration**\ Da die Erweiterung auf dem nativen Gutscheinmodul basiert, bleibt dein Shop performant, übersichtlich und wartungsarm. # Voraussetzungen Die Erweiterung kann nur in einer selbst verwalteten Shopware-Umgebung mit mindestens Version 6.6.9 installiert werden. # Installation Nach der Installation der Erweiterung, muss diese unter **Erweiterungen -> Meine Erweiterungen -> Apps -> Prämienartikel/ Gratisartikel** konfiguriert werden.
Gebe zunächst einen **Verkaufskanal** an, für den die App aktiviert werden soll. Die Standardeinstellung ist **Alle Verkaufskanäle**. ### Allgemeine Einstellungen Die allgemeinen Eigenschaften bieten grundlegende Steuerelemente, wie z. B. die Aktivierung/Deaktivierung der App. | Feld | Typ | Beschreibung | | --------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------- | | App aktivieren | KippSch. | Aktivieren diese Einstellung, um die App in deinem Shop zu aktivieren. | | Im Off-Canvas anzeigen | Dropdown-Menü | Lege fest wie und ob die Prämien im OffCanvas Warenkorb angezeigt werden sollen. | | Im Warenkorb anzeigen | Dropdown-Menü | Wähle einen Eintrag aus der Liste um die Anzeige der Prämien im Warenkorb festzulegen. | | Auf der Bestellübersicht anzeigen | Dropdown-Menü | Durch Auswahl eines Eintrages kannst du die Anzeige der Prämien auf der Bestellübersichtsseite steuern. | ### Prämienartikel Einstellungen Mit den folgenden Einstellungen kann festgelegt werden, wie viele Prämienartikel erlaubt sind und wie die Berechnung des Mindest Warenkorbwertes erfolgen soll. | Feld | Typ | Beschreibung | | ------------------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nur eine Art Prämienartikel erlauben | KippSch. | Es kann nur eine Prämie ausgewählt werden. Die Menge der Prämie ist variabel und wird durch die Einstellungen am Produkt (max. Bestellmenge) gesteuert. | ### Slider Einstellungen In diesem Bereich kann eingestellt werden, welche Informationen zu Prämienartikeln angezeigt werden sollen. | Feld | Typ | Beschreibung | | ----------------------------- | -------- | -------------------------------------------------------------------- | | Produkt Titel anzeigen | KippSch. | Wenn aktiviert, wird der Titel des Produktes einer Prämie angezeigt. | | Produkt Beschreibung anzeigen | KippSch. | Aktiviere die Anzeige der Produkt Beschreibung für eine Prämie. | # Anlegen einer Prämie Die Einstellungen können in der Admin unter **Kataloge -> Produkte** vorgenommen werden. Hierfür ein bestehendes Produkt wählen, oder ein neues anlegen. Auf der Produkt Detailseite finden sich unter dem Tab **Spezifikationen** ganz unten die **Zusatzfelder**. Bitte den Zusatzfeld Tab **Prämien Produkt** auswählen. Folgende Einstellungsmöglichkeiten gibt es: | Feld | Typ | Beschreibung | | ------------------------------ | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Als Prämien Produkt aktivieren | Kipp. Schalter | Schalter aktivieren um dieses Produkt als Prämie anzubieten. | | Minimum Warenkorbwert | Währung Eingabe | Definiere den minimalen Warenkorb Wert (Die Prämie ist erst ab dem eingestellten Warenkorbwert gültig). Wenn neben der Standardwährung auch andere Währungen unterstützt werden sollen, so muss für die jeweilige Währung die Vererbung entfernt und ein Wert eingegeben werden. | | Maximalabnahme | Numerische Eingabe | Gib die maximale Bestellmenge für die Prämie an. Wenn kein Wert bzw. 0 hinterlegt ist, dann wird die maximale Bestellmenge des Produktes genutzt. | # Bonus System ### Einführung Die Bonussystem-App für Shopware 6 bietet ein komplettes Shop-Punktesystem, das es deinen Kunden ermöglicht, bei ihren Einkäufen Punkte gutgeschrieben zu bekommen und diese Punkte bei zukünftigen Einkäufen einzulösen.
Die Bonussystem-App ermöglicht völlige Flexibilität bei der Gutschrift und Einlösung von Punkten, einschließlich der Festlegung des Umrechnungskurses, der Definition von Kundengruppen, die ausgeschlossen oder bevorzugt behandelt werden, der Erstellung von Sonderangeboten für bestimmte Produkte und der Ablaufzeit für Punkte. Die Punktesalden der Kunden können über das bereitgestellte Dashboard, auf das du von deinem Shopware-Administrationsbereich aus zugreifen kannst, einfach eingesehen und verwaltet werden. # Voraussetzungen Die App kann nur in einer selbst verwalteten Shopware-Umgebung mit mindestens Version 6.2.0 installiert werden. # Installation Installieren Sie die App durch **Erweiterungen** > **Meine Erweiterungen**. Geben Sie nach der Installation einen **Verkaufskanal** an, für den die App aktiviert werden soll. Die Standardeinstellung ist Alle Verkaufskanäle. Die Bonussystem-App hat zwei Aspekte: * Grundlegende Konfiguration * Verwaltungs-Dashboard Führen Sie zunächst die Schritte im Abschnitt Basiskonfiguration aus und lesen Sie dann den Abschnitt Admin Dashboard, um zu erfahren, wie Sie die App fortlaufend verwalten können. ### Grundlegende Konfiguration Bevor Sie die App aktivieren, überprüfen Sie die Einstellungen in diesem Abschnitt und stellen Sie sicher, dass sie Ihren Anforderungen entsprechen. Nehmen Sie Änderungen an den einzelnen Feldern wie unten beschrieben vor, indem Sie **Meine Erweiterungen** > **Bonus System für Shopware 6** > **Konfiguration** wählen.
Geben Sie zunächst einen **Verkaufskanal** an, für den die App aktiviert werden soll. Die Standardeinstellung ist Alle Verkaufskanäle. ### Allgemeine Einstellungen Die allgemeinen Eigenschaften bieten grundlegende Steuerelemente, wie z. B. die Aktivierung/Deaktivierung der App und die Festlegung der Sichtbarkeit von Kundenpunkten an wichtigen Standorten. | **Feld** | **Typ** | **Beschreibung** | | ------------------------------------------------------------------ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Bonus System aktivieren | KippSch. | Aktivieren Sie diese Einstellung, um die Bonus-System-App in Ihrem Shop zu aktivieren. | | Bonus Punkte im Kopfbereich anzeigen | KippSch. | Aktivieren Sie diese Einstellung, um den Punktestand des Kunden im oberen rechten Bereich der Kopfzeile des Shops neben den Konto- und Warenkorbkontrollen anzuzeigen. | | Bonus Punkte auf der Rechnung anzeigen | KippSch. | Aktivieren Sie diese Einstellung, um den Punktestand des Kunden in allen Rechnungen anzuzeigen, die er aufgrund von Einkäufen im Shop erhält. | | Punkte Verdienst auf Detailseite von Produkten anzeigen | KippSch. | Aktivieren Sie diese Einstellung, um auf der Produktdetailseite die Anzahl der Punkte anzuzeigen, die Kunden für jeden Produktkauf gutgeschrieben werden. | | Punkte Verdienst in der Produktliste anzeigen | KippSch. | Aktivieren Sie diese Einstellung, um in der Produktliste die Anzahl der Punkte anzuzeigen, die Kunden für jeden Produktkauf gutgeschrieben werden. | | Bonus Punkte Hinweis bei Gast Registrierung anzeigen | KippSch. | Wenn die Option aktiv ist, dann wird dem Kunden bei Auswahl der Gast Registrierung ein Hinweis angezeigt, das er mit einem Kundenkonto Punkte sammeln könnte. | | Kundengruppe verbieten | Dropdown-Menü | Wenn Sie Kundengruppen definiert haben, können Sie diese vom Punktesystem ausschließen, indem Sie sie aus dem Dropdown-Menü auswählen. | | Zeigen Sie den Wert der Bonuspunkte in EUR auf der Detailseite an | KippSch. | Die benötigten Bonus Punkte werden in der Shop Währung angezeigt. Somit kann der Kunde genau sehen, wie viel Geld Wert die Bonus Punkte haben. | | Zeigen Sie den Wert der Bonuspunkte in EUR auf der Listingseite an | KippSch. | Die benötigten Bonus Punkte werden in der Shop Währung angezeigt. Somit kann der Kunde genau sehen, wie viel Geld Wert die Bonus Punkte haben. | | Shopseiten im Bonus System Menü anzeigen | Dropdown-Menü | Sie können Erlebnisswelten Seiten des Typs "Shopseite" auswählen, die nach dem Kundenlogin im Accountbereich des Bonus System Menüs angezeigt werden sollen. | ### Punkte sammeln Die Einstellungen in diesem Bereich beziehen sich darauf, wie Kunden Punkte gutgeschrieben werden. | **Feld** | **Typ** | **Beschreibung** | | ------------------------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Umrechnungsfaktor (1 EUR = ? Punkte) | Numerische Eingabe | Fügen Sie hier einen Wert für die Anzahl der Punkte ein, die Kunden pro ausgegebenem Euro gutgeschrieben werden. *Beispiel: Geben Sie 10 ein, um 10 Punkte pro ausgegebenem Euro zu erhalten.* | | Bonus Punkte nach Bedingungen | KippSch. | Ist diese Option aktiv dann erhalten Kunden nur Bonus Punkte für Produkte, die per [Bedingung ](/plugins/bonus-system/verwaltungs-dashboard/bedingungen)festgelegt sind. | | Punkte ohne Versandkosten sammeln | KippSch. | Aktivieren Sie diese Einstellung, um die Versandkosten vom Sammeln von Kundenpunkten auszuschließen. | | Punkte runden | Dropdown-Menü | Wählen Sie aus der Dropdown-Liste die Methode zum Aufrunden von kumulierten Punktbruchteilen aus, entweder **logisch runden, aufrunden** oder **abrunden**. | | Punkte für Admin/ API Bestellungen erhalten | KippSch. | Wenn aktiviert, dann erhalten Kunden auch Punkte für Bestellung, die in der Admin oder über die API erstellt wurden. | | Punkte für jede Bewertung | Numerische Eingabe | Geben Sie eine Anzahl an Punkten an, die Kunden für eine Bewertung eines Produktes erhalten. Dies funktioniert nur, wenn das reguläre Bewertungssystem von Shopware genutzt wird. | ### Newsletter Einstellungen Registriert sich ein Kunde für den Newsletter so können Punkte vergeben werden. \ Wichtig: Dies funktioniert nur, wenn die Shopware Standard Newsletter Registrierung verwendet wird. | | | | | ------------------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------- | | **Feld** | **Typ** | **Beschreibung** | | Bonus Punkte für die Newsletter Registrierung vergeben | KippSch. | Aktivieren Sie die Einstellung, wenn Kunden Punkte für eine Newsletter Registrierung erhalten sollen. | | Menge der Bonus Punkte für die Newsletter Registrierung | Numerische Eingabe | Geben Sie die Anzahl an Punkten an, die ein Kunde für die Registrierung zum Newsletter erhalten soll. | | Buchungsgrund für die Bonus Punkte | Dropdown-Menü | Wählen Sie hier einen Textbaustein dessen Inhalt später bei der Punkte Buchung erscheinen soll. | ### Punkte ausgeben Die Einstellungen in diesem Bereich beziehen sich darauf, wie Kunden die ihnen gutgeschriebenen Punkte einlösen können. | **Feld** | **Typ** | **Beschreibung** | | ----------------------------------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Punkte ausgeben deaktivieren | KippSch. | Aktivieren Sie diese Einstellung, um zu verhindern, dass Kunden Punkte einlösen können, die ihnen gutgeschrieben wurden (Kunden können weiterhin Punkte gutgeschrieben bekommen, solange diese Einstellung aktiviert ist). | | Beschränkung für Punkte Einlösung | Dropdown-Menü | Legen Sie optional eine Mindest-/Maximalbeschränkung für das Einlösen von Punkten durch Kunden fest. Wählen Sie entweder **Mindestens X EUR Bestellwert** oder **Maximal X EUR** aus dem Dropdown-Menü. Definieren Sie den Wert X in der nächsten Einstellung. | | EUR Wert der Beschränkung | Numerische Eingabe | Geben Sie den Wert X für alle in der vorherigen Einstellung festgelegten Einschränkungen ein. | | EUR Min. Wert für Bonus Produkt | Numerische Ein | Min. Warenkorbwert, ab dem der Kauf eines Bonus Produktes möglich ist. | | Umrechnungsfaktor (? Punkte = 1 EUR) | Numerische Eingabe |

Geben Sie einen Zahlenwert für die Anzahl der eingelösten Punkte ein, die erforderlich sind, um einen Wert von 1 Euro zu erreichen.
Beispiel: 20 = 20 Punkte für 1 Euro.

| | Einlösen von Punkten für den Versand ausschließen | KippSch | Wenn aktiviert, können Versandkosten nicht mit Bonus Punkten bezahlt werden. | | Bonus Produkte aktivieren | KippSch. | Aktivieren Sie diese Einstellung, um Kunden zu ermöglichen, bestimmte Bonusprodukte zu kaufen, indem sie die gesammelten Punkte einlösen. | | Standardmäßig mit Punkten kaufen | KippSch. | Wenn die Option „Nur mit Punkten kaufbar“ eines Bonusprodukts nicht aktiv ist, wird standardmäßig die Option „Für je X Bonuspunkte in den Warenkorb legen“ verwendet. | | Bonus Produkte Menü Eintrag deaktivieren | KippSch. | Durch die Aktivierung wird die Landingpage der Bonus Produkte deaktiviert. Diese Einstellung hat nur einen Effekt, wenn Sie Bonus Produkte aktiviert haben. | | Aktivieren Sie die Bonusproduktfunktion für jedes Produkt | KippSch. | Wenn aktiviert, so kann jedes Produkt des Shops mit Bonus Punkten erworben werden. | | Verfügbare Bonusprodukte im Warenkorb anzeigen | KippSch. | Zeigt alle verfügbaren Bonus Produkten im Warenkorb. | | Verfügbare Bonusprodukte im Checkout anzeigen | KippSch. | Zeigt alle verfügbaren Bonus Produkten im Checkout. | | Bonus Produkte Liste Header Bild | Bildauswahl | Zeigt ein Header Bild auf der Bonus Produkte Listing Seite. Es wird nur angezeigt, wenn Bonus Produkte aktiviert sind. | | Bonus Produkte Liste Header Text | Freie Texteingabe | Zeigt einen Header Text auf der Bonus Produkte Listing Seite. Es wird nur angezeigt, wenn Bonus Produkte aktiviert sind. | | Bonus Punkte automatisch bei Bestellung einlösen | KippSch. | Wenn aktiviert, dann werden Bonus Punkte automatisch im Checkout eingelöst. | | Deaktivieren von Gutscheinen, wenn Punkte im Warenkorb eingelöst werden | KippSch. | Wenn aktiviert und Bonus Punkte eingelöst werden, dann werden andere Gutscheine automatisch deaktiviert. | | Bonuspunkte-Artikelnummer | Freie Texteingabe |

Falls benötigst, kannst du eine Artikelnummer für Bonus Punkte festlegen. Diese wird genutzt, wenn Bonus Punkte eingelöst werden.
Hier findest Du mehr Informationen.

| | Bonuspunkte-Artikelnummer im Warenkorb anzeigen | KippSch. | Sollen Bonus Punkte eine Artikelnummer haben, so kannst Du festlegen, ob die Artikelnummer im Checkout angezeigt wird. | ### Abzug von Punkten Mit den Einstellungen in diesem Bereich können Sie steuern, wie die Erweiterung Rücksendungen handhabt. | | | | | ----------------------------------------------- | -------- | --------------------------------------------------------------------------------------------- | | **Feld** | **Typ** | **Beschreibung** | | Abzug von Punkten beim Bestellstatus: Storniert | KippSch. | Entfernt die zuvor gutgeschriebenen Punkte, wenn der Bestellstatus auf storniert gesetzt ist. | | Abzug von Punkten bei Lieferstatus: Retour | KippSch. | Entfernt die zuvor gutgeschriebenen Punkte, wenn der Lieferstatus auf Retour gesetzt ist. | | Abzug von Punkten bei Lieferstatus: Teilretour | KippSch. | Entfernt die zuvor gutgeschriebenen Punkte, wenn der Lieferstatus auf Teilretour gesetzt ist. | ### Punkte Verfall In diesem Bereich können Sie festlegen, ob Punkte ablaufen können und wie dies gehandhabt wird. | | | | | ------------------------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------- | | **Feld** | **Typ** | **Beschreibung** | | Bonus Punkte verfallen nach Tagen | Numerische Eingabe | Wenn der Wert größer 0 ist, werden die Punkte die abgelaufen sind (Heute - Eingabe Tage) vom Kundenkonto entfernt | | Zeige nach dem Login einen Hinweis, das Punkte bald verfallen | KippSch. | Verfallen bald Punkte, so wird dies einmalig nach dem Kunden Login angezeigt. | | Automatische E-Mail für den Ablauf von Punkten aktivieren | KippSch. | Verfallen bald Punkte, so kann der Kunde automatisch per E-Mail darüber informiert werden. | | Kunde kann sich von der Liste abmelden | KippSch. | Mit dieser Option können Kunden sich von der automatischen E-Mail Benachrichtigung abmelden. | | E-Mail Anzahl Tage vor Ablauf der Punkte | Numerische Eingabe | Die automatische E-Mail Benachrichtigung wird automatisch n-Tag vor Verfall der Punkte versendet. | ### Bonuspunkte Aktivierung Die Einstellungen in diesem Bereich steuern die Aktivierung und den Verfall von Bonuspunkten. | **Feld** | **Typ** | **Beschreibung** | | ----------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Bonuspunkte Aktivierung Bestellung | Dropdown-Menü |

Legen Sie fest, wie die Bonuspunkte aktiviert werden, indem Sie eine Option aus dem Dropdown-Menü auswählen:
– Immer manuell: über das Admin-Modul
– Bestellung bezahlt: Bonuspunkte werden automatisch aktiviert, nachdem die Bestellung bezahlt wurde
– Bestellung abgeschlossen: Bonuspunkte werden gutgeschrieben, sobald der Bestellstatus auf abgeschlossen gesetzt wird
– Direkt nach Bestellung: Bonuspunkte werden nach dem Absenden der Bestellung gutgeschrieben

| | Bonuspunkte n-Tage nach Bestellung freischalten | Numerische Eingabe | Diese Einstellung kann die Einstellung von „Bonuspunkte Aktivierung Bestellung“ umgehen. Ist das Feld nicht ausgefüllt oder hat den Wert 0, so erfolgt keine automatische Freischaltung nach n-Tagen.Ansonsten wird die Bestellung beim nächsten Login des Kunden nach n-Tagen freigeschaltet und die Bonus Punkte gutgeschrieben. Wurden die Bonuspunkte bereits manuell oder über eine andere Regel freigeschaltet, so hat die Einstellung keinen Effekt. | | Punkte abziehen bei Stornierung Bestellung | KippSch. | Aktivieren Sie diese Option, um automatisch alle gutgeschriebenen Punkte, die mit einer stornierten Bestellung verbunden sind, abzuziehen. | | Bonus Punkte verfallen nach Tagen | Numerische Eingabe | Legen Sie die Anzahl der gültigen Tage für Bonuspunkte fest, nach denen sie automatisch verfallen und vom Punktekonto des Kunden abgezogen werden. | ### Checkout Einstellungen Die Einstellungen in diesem Bereich steuern, wie die Bonuspunkte den Kunden während des Bestellvorgangs gutgeschrieben werden | **Feld** | **Typ** | **Beschreibung** | | ------------------------------------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Bonus Punkte für Bestellung im Warenkorb anzeigen | Dropdown-Menü | Wählen Sie, ob Sie die Bonuspunkte anzeigen möchten, die dem Kunden gutgeschrieben werden, wenn er den Bestellvorgang abschließt, entweder **oberhalb von Warenkorb**, **unterhalb von Warenkorb** oder **nein**, um diese Option zu deaktivieren. | | Bonus Punkte Einlösung im Checkout möglich | Dropdown-Menü | Standardmäßig können Bonuspunkte nur im Einkaufswagen eingelöst werden. Geben Sie optional an, ob Bonuspunkte auch **oberhalb vom Checkout** oder **unterhalb vom Checkout** eingelöst werden können (Standard ist **nein**). | | Bonus Punkte für Bestellung im Checkout anzeigen | Dropdown-Menü | Geben Sie an, ob und wo dem Benutzer angezeigt werden soll, wie viele Punkte mit der aktuellen Bestellung gutgeschrieben werden. Wählen Sie zwischen **„Nein“, „Über der Kasse“** und „**Unter der Kasse“.** | ### Design Einstellungen Die Einstellungen in diesem Bereich definieren das Aussehen und die Bedienung der Bonuspunkte-Benutzeroberfläche in Ihrem Shop. | **Feld** | **Typ** | **Beschreibung** | | ----------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------- | | Buchstabe Farbe | Farbwähler | Wählen Sie eine Primärfarbe mit dem Farbwähler aus oder geben Sie einen Hexadezimalwert für das Bonuspunkte-Symbol „P“ ein. | | Buchstabe Hintergrund Farbe | Farbwähler | Wählen Sie mit dem Farbwähler eine Hintergrundfarbe aus oder geben Sie einen Hexadezimalwert für das Bonuspunktesymbol „P“ ein. | | Badge Farbe | Farbwähler | Wählen Sie eine Hintergrundfarbe mit dem Farbwähler oder geben Sie einen Hexadezimalwert für das Abzeichensymbol ein. | | Farbe Punkte Text | Farbwähler | Wählen Sie eine Hintergrundfarbe mit dem Farbwähler oder geben Sie einen Hexadezimalwert für den numerischen Bonuspunktwert ein. | | Farbe Slider Punkt | Farbwähler | Wählen Sie eine Hintergrundfarbe mit dem Farbwähler oder geben Sie einen hexadezimalen Wert für den Schieberegler ein. | | Icon für Punkte Label (50×50 Pixel) | Bildauswahl | Wählen Sie ein Bild (50 x 50 Pixel) aus, das als Symbol für die Punktebeschriftung verwendet werden soll. | # Verwaltungs-Dashboard Nachdem Sie die Grundkonfiguration der Bonussystem-App abgeschlossen haben, verwenden Sie das Admin Dashboard, um das Sammeln und Einlösen von Bonuspunkten in Ihrem Geschäft zu überwachen. Rufen Sie das Admin Dashboard von Ihrer Shopware-Administrationsseite aus über **Marketing > Bonus System** auf.
Das Hauptdashboard ist in die folgenden Registerkarten unterteilt: * Dashboard-Übersicht (wird standardmäßig beim Zugriff auf das Admin-Dashboard angezeigt) * Buchungen * Kunden * Bedingungen * Bonus Produkte ### Dashboard-Übersicht Die Dashboard-Übersicht wird standardmäßig angezeigt, wenn Sie auf das Admin-Dashboard zugreifen, und bietet eine nützliche Zusammenfassung der jüngsten Aktivitätsmetriken, die in drei Tabellen unterteilt sind (Statistiken, die 5 wichtigsten gutgeschriebenen Punkte und die 5 wichtigsten Punktesalden) ### Statistik Die Tabelle Statistik fasst die Daten der Bonuspunkte in den folgenden Spalten zusammen: * Verkaufskanal * Punkte verdient * Punkte ausgegeben * Punkte nicht freigegeben * Guthaben **Klicken Sie auf das gestapelte Symbol auf der rechten Seite des Tabellenkopfes, um Spalten zu aktivieren/deaktivieren, zwischen kompakter und erweiterter Ansicht zu wechseln und Vorschaubilder zu deaktivieren/aktivieren.** Verwenden Sie das Dropdown-Menü für den Zeitbereich, um die in den Tabellen angezeigten Metriken zu filtern nach * Seit Beginn * Letzte 30 Tage * Letzte 14 Tage * Letzte 7 Tage * Letzte 24 Stunden * Seit gestern Je länger die gewählte Zeitspanne ist, desto mehr Daten werden in der Tabelle zusammengefasst. ### Top 5 Punkte Verdienst In dieser Tabelle werden die fünf Kunden, die die meisten Punkte erhalten haben, in den folgenden Spalten angezeigt: * Kunde * Punkte verdient * Punkte ausgegeben **Klicken Sie auf das gestapelte Symbol auf der rechten Seite des Tabellenkopfes, um Spalten zu aktivieren/deaktivieren, zwischen kompakter und erweiterter Ansicht zu wechseln und Vorschaubilder zu deaktivieren/aktivieren.** ### Top 5 Punkte Guthaben Der Guthaben eines Kunden ist die Anzahl der verbleibenden Punkte, die er hat. Die Punkte können für zukünftige Einkäufe eingelöst werden. In dieser Tabelle werden die fünf Kunden mit den höchsten Guthaben in den folgenden Spalten angezeigt: * Kunde * Guthaben **Klicken Sie auf das gestapelte Symbol auf der rechten Seite des Tabellenkopfes, um Spalten zu aktivieren/deaktivieren, zwischen kompakter und erweiterter Ansicht zu wechseln und Vorschaubilder zu deaktivieren/aktivieren.** # Buchungen Die Registerkarte Buchungen enthält eine Tabelle, in der, die den Kunden gutgeschriebenen Punkte, zusammengefasst sind. Dabei handelt es sich sowohl um gutgeschriebene Punkte aus Bestellungen als auch um eingelöste Punkte. Wenn Sie manuell Punkte gutgeschrieben oder abgezogen haben, werden diese ebenfalls angezeigt.
Sie enthält die folgenden Spalten: * Bestellung * Datum * Verkaufskanal * Name (des Kunde) * Punkte * Grund * Freigegeben Klicke auf die Schaltfläche Aktualisieren auf der rechten Seite, um die neuesten Daten abzurufen. **Für die Tabelle Buchungen sind zwei Filter verfügbar: Aktiviert (wählen Sie Ja oder Nein, um nach dem Aktivierungsstatus zu sortieren) und Ist Bestellung (wählen Sie Ja, um nur Punkte anzuzeigen, die im Zusammenhang mit einer Bestellung gutgeschrieben wurden, oder Nein für alle anderen Punkte).** ### Manuelles Freigeben von Buchungen Wenn ein Kunde einen Einkauf tätigt, müssen die gesammelten Punkte zunächst freigegeben werden, bevor sie dem Kunden zur Verfügung stehen. Bis zur Freigabe kann der Kunde keine Punkte einlösen, die ihm gutgeschrieben wurden Um die mit einem Kauf verbundenen Punkte manuell zu aktivieren, wähle die entsprechende Bestellung in der Liste aus und klicke auf **Aktivieren**. ### Automastisches Freigeben von Buchungen Du kannst diesen Aktivierungsprozess in den Einstellungen für die [Bonuspunkte Aktivierung](/plugins/bonus-system/installation#bonus-point-activation) automatisieren. Wenn du die automatische Aktivierung der Punkte aktivierst, stehen sie dem Kunden sofort nach einem bestimmten Ereignis zur Verfügung, und er kann sie dann gegen Einkäufe einlösen # Kunden Die Registerkarte Kunden enthält eine Tabelle mit einer Liste aller Kunden deines Shops, unabhängig davon, ob sie ein Punktekonto haben oder nicht. Für Kunden, die ein Punktekonto haben, wird dies ebenfalls in der Tabelle angezeigt.
Die angezeigten Spalten sind: * Name * Kundennummer * Punkte **Klicke auf das gestapelte Symbol auf der rechten Seite der Tabellenüberschrift, um Spalten zu aktivieren/deaktivieren und zwischen kompakter und erweiterter Ansicht zu wechseln.** ### Kunde bearbeiten Um einen Kunden in der Liste zu bearbeiten, klicke auf das Symbol **.**.. und wähle **Bearbeiten**. Es wird eine Zusammenfassung der Kundendaten angezeigt , die Kontaktdaten, der Kontostatus, die Kundengruppe, die Sprache und die Kundennummer. Außerdem gibt es die Möglichkeit des **Punkte buchen** mit dem manuell Punkte hinzugefügt oder entfernt werden können. In einer Tabelle darunter wird eine Historie der Einkäufe angezeigt. ### Manuelles Anrechnen/Abziehen von Punkten Es gibt zwei Möglichkeiten, dem Konto eines Kunden manuell Punkte gutzuschreiben oder abzuziehen: * Klicke auf der Registerkarte Kunden auf das Symbol **.**.. für einen Kunden und wähle **Punkte buchen**. * Klicke auf dem Bildschirm Kundendetails auf den Link **Punkte buchen** (unter dem Punktesaldo). In beiden Fällen wird das Dialogfeld Hinzufügen/ Entfernen von Punkten angezeigt. Gib einen **Grund** für die Gutschrift/den Abzug und den Wert der Punkte ein, die gutgeschrieben oder abgezogen werden sollen (um Punkte abzuziehen, gib ein Minuszeichen vor dem Wert ein, z. B. -100). Klicke auf **Jetzt buchen**, um die Aktion abzuschließen. Die Änderungen werden sofort in den Punktestand des Kunden übernommen. # Bedingungen Auf der Registerkarte Bedingungen kannst du zusätzliche Bonuspunktmechanismen für einen bestimmten Zeitraum (Datumsbereich) festlegen.
Es gibt sechs grundlegende Bedingungen, die du aktivieren kannst, wobei jede vollständig anpassbar ist: * **Produkte für** **Bonuspunkte ausschließen**: Lege einen Zeitraum fest, in dem das Einlösen oder Sammeln von Punkten für ein bestimmtes Produkt oder bestimmte Produkte oder Produktkategorien deaktiviert ist. * **Individueller Bonusfaktor für Kunde oder Kundengruppe**: Lege für einen bestimmten Einzelkunden, mehrere Kunden oder eine Kundengruppe einen individuellen Umrechnungsfaktor für das Sammeln oder Ausgeben von Bonus Punkten fest. * **Individueller Bonusfaktor für Produkt oder Produktgruppe**: Lege für ein bestimmtes Produkt oder bestimmte Produkte oder Produktgruppen einen individuellen Umrechnungsfaktor für das Sammeln von Bonus Punkten fest. * **Produkte für Bonus Punkte einschließen**: Zusammen mit der Konfigurationseinstellung der Erweiterung "Bonus Punkte nach Bedingung" werden nur Produke für Bonus Punkte freigeschaltet, die in der Bedingung definiert sind. * **Individueller Bonus Faktor im Geburtsmonat des Kunden**: Definiere einen individuellen Faktor für das Punkte sammeln oder Punkte einlösen im Geburtsmonat des Kunden. * **Individueller Bonus Faktor am Geburtstage des Kunden**: Wie zuvor, aber nur am Geburtstag des Kunden. ### Basis Einstellungen Lege den Namen, den Datumsbereich und die Konditionsart im Bereich der Grundeinstellungen fest. | **Feld** | **Typ** | **Beschreibung** | | ------------------------------------ | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | Freie Texteingabe | Gib einen aussagekräftigen Namen für die Bedingung ein, z. B. „September-Aktion“. | | Aktiv | Kontrollkästchen | Aktiviere das Kontrollkästchen, um die Bedingung zu aktivieren. Ist das Kontrollkästchen nicht markiert, ist die Bedingung deaktiviert. | | Gültig von/bis | Datumspicker | Lege den Datumsbereich für die Gültigkeit der Bedingung fest. | | Bedingung Typ | Dropdown-Menü | Lege die Art der Bedingung aus der Dropdown-Liste fest (siehe Beschreibung der einzelnen Arten oberhalb dieser Tabelle). | | Typ der Änderung | Dropdown-Menü |

Für den Ausschluss von Bonuspunkten wähle eine Option aus dem Dropdown-Menü:

– Ausschließen für das Punkte sammeln: Wähle diese Option, um Kunden davon auszuschließen, dass ihnen beim Kauf bestimmter Produkte oder Kategorien (definiert im Bereich Regeln) Punkte gutgeschrieben werden.

– Ausschließen für das Punkte einlösen: Wähle diese Option, um Kunden von der Einlösung von Punkten für bestimmte Produkte oder Kategorien auszuschließen (definiert im Bereich Regeln).

Für den individuellen Bonusfaktor wähle eine Option aus dem Dropdown-Menü:
– Umrechnungsfaktor Punkte einlösen: multipliziert die für bestimmte Produkte/Kategorien gutgeschriebenen Punkte mit einem von dir festgelegten Faktor (siehe Umrechnungsfaktor).
– Umrechnungsfaktor Punkte Einlösung: multipliziert die für bestimmte Produkte/Kategorien eingelösten Punkte mit einem von dir festgelegten Faktor (siehe Umrechnungsfaktor).

| | Umrechnungsfaktor (1 EUR = ? Punkte) | Numerische Eingabe | Lege den Faktor für den Bonusbetrag fest, mit dem die eingelösten oder gutgeschriebenen Punkte multipliziert werden, indem du einen numerischen Wert eingibst (gilt nicht für die Bedienungstyp **Produkte für das Punkte ausschließen**). | ### Regeln Definiere die spezifischen Gruppen, die von der Bedingung betroffen sein sollen, im Regelbereich. | **Feld** | **Typ** | **Beschreibung** | | -------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Kundengruppen | Dropdown-Menü | Wähle eine oder mehrere Kundengruppen aus, auf die die ausgewählte Bedingung angewendet werden soll. Diese Option gilt nur für die Kondition **Individueller Bonusfaktor für Kunde oder Kundengruppe**. | | Kundennummern | Numerische Eingabe | Gib eine oder mehrere Kundennummern ein, auf die die ausgewählte Bedingung angewendet werden soll. Diese Option gilt nur für die Kondition **Individueller Bonusfaktor für Kunde oder Kundengruppe**. | | Produkte | Dropdown-Menü | Wähle ein oder mehrere Produkte aus, auf die die ausgewählte Bedingung angewendet werden soll. Diese Option gilt nur für die Bedingung **Individueller Bonusfaktor für Produkt oder Produktgruppe**. | | Produktgruppen | Dropdown-Menü | Wähle eine oder mehrere Produktgruppen aus, auf die die ausgewählte Bedingung angewendet werden soll. Diese Option gilt nur für die Bedingung **Individueller Bonusfaktor für Produkt oder Produktgruppe**. | # Bonus Produkte / Prämien Auf dieser Registerkarte kannst du festlegen, welche Produkte aus deinem bestehenden Katalog direkt mit Punkten gekauft werden können. Du kannst auch festlegen, dass die Produkte nur mit Punkten oder in Kombination mit Geld gekauft werden können.
Die Registerkarte „Bonus Produkte“ hat zwei Bereiche: die Übersicht der Bonus Produkte (Standardansicht beim Aufrufen der Registerkarte) und die Detailseite der Bonus Produkte (wenn du ein neues Produkt zu deinem Bonusprogramm hinzufügst). ### Übersicht der Bonusprodukte Diese Tabelle zeigt eine Zusammenfassung der Produkte, die mit deinem Bonusprogramm verbunden sind, in den folgenden Spalten: * Name * Aktiv * Gültig von * Gültig bis **Klicke auf das gestapelte Symbol auf der rechten Seite des Tabellenkopfes, um Spalten zu aktivieren/deaktivieren, zwischen kompakter und erweiterter Ansicht zu wechseln und Vorschaubilder zu deaktivieren/aktivieren.** ### Ein Produkt hinzufügen Um ein bestehendes Produkt in deinem Katalog dem Bonusprogramm hinzuzufügen, klicke auf **Neues Produkt** und fülle die Felder auf dem Detailbildschirm des Bonus Produkts wie folgt aus. Klicke auf **Speichern**, um deine Einstellungen zu übernehmen. | **Feld** | **Typ** | **Beschreibung** | | ------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Produkt | Dropdown-Menü | Wähle über das Dropdown-Menü ein bestehendes Produkt aus deinem Katalog aus, das du in dein Bonusprogramm aufnehmen möchtest. | | Aktiv | Kontrollkästchen | Markiere das Kästchen, um dieses Produkt in deinem Bonusprogramm zu aktivieren. Ist das Kästchen nicht markiert, ist das Produkt ausgeschlossen. | | Maximalabnahme | Numerische Eingabe | Gib hier einen Wert ein, um ein Limit für die Menge festzulegen, die jeder Kunde von dem ausgewählten Produkt kaufen kann. | | Gültig von/bis | Datumspicker | Lege den Datumsbereich für das ausgewählte Produkt fest, das in dein Bonusprogramm aufgenommen werden soll. | | Kosten | Dropdown-Menü |

Wähle eine Option aus dem Dropdown-Menü (dies ist obligatorisch, da es keine Standardeinstellung gibt):
– Umrechnungsfaktor Punkte einlösen von Plugin-Einstellungen: Wähle diese Option, um den Umrechnungsfaktor aus Bedingungen > Grundeinstellungen zu verwenden.
– Fester Punktewert: Wähle diese Option, um einen eindeutigen Punktwert für dieses spezifische Produkt zu definieren. Gib den Punktewert in das Feld Anzahl Punkte ein.

| | Nur mit Punkten erwerbbar | Kontrollkästchen | Aktiviere das Kontrollkästchen, damit Kunden dieses Produkt nur mit gesammelten Punkten kaufen können. Wenn das Kästchen nicht angekreuzt ist, kann das Produkt normal (mit Geld) oder mit Punkten gekauft werden. | # Weitere Menüpunkte im Account anlegen Im Accountbereich werden Seiten vom Bonus System angezeigt. Ergänzend können Seiten hinzugefügt werden Loggen sich Kunden in den Account Bereich ein, dann werden standardmäßig die Seiten "Punktekonto" und "Bonus Produkte" (fall das Feature aktiviert wurde) angezeigt.
Ergänzend hierzu, können weitere Seiten hinzugefügt werden. Dies könnte beispielsweise eine Seite mit einem Anleitungstext sein. Weitere Seiten können in der [Konfiguration der Erweiterung](/plugins/bonus-system/installation#allgemeine-einstellungen) unter dem Punkt "Shopseiten im Bonus System Menü anzeigen" ausgewählt werden. Es stehen alle Erlebnisswelten des Typs "Shopseite" zur Verfügung. # Geplante Aufgaben / Cronjobs ### Überprüfung auf abgelaufene Punkte Wie im Abschnitt [Punkte Verfall](/plugins/bonus-system/installation#punkte-verfall) beschrieben, können Sie einen Zeitraum festlegen, nach dem ungenutzte Bonuspunkte automatisch verfallen. Diese Berechnung wird bei jeder Anmeldung des Kunden durchgeführt, Sie können die Prüfung aber auch über die Kommandozeile manuell oder über einen Cronjob durchführen: ``` ./bin/console prems:bonus-system:set-expired-points ``` ### Automatische Aktivierung von Punkten Sie können diesen Aktivierungsprozess in den Einstellungen für die [Bonuspunkte Aktivierung](/plugins/bonus-system/installation#bonus-point-activation) automatisieren. Sind die dort definierten Bedingungen erfüllt, dann erhält der Kunde entweder nach seinem Login die Punkte oder wenn die geplante Aufgabe von Shopware automatisch durchgeführt wurde. Die Aufgabe *prems\_bonus\_system.bonus\_point\_activation\_task* wird bei Installation des Plugin automatisch in Shopware angelegt und Sie müssen hier normalerweise keine Anpassung vornehmen. ### E-Mail Hinweis für ablaufende Punkte Wenn Sie das [Verfallen von Punkten aktiviert](/plugins/bonus-system/installation#bonus-point-activation-1) haben und eine Hinweis E-Mail vor dem Ablauf der Punkte konfiguriert wurde, so wird die geplante Aufgabe *prems\_bonus\_system.points\_expiration\_notification\_task* von Shopware automatisch durchgeführt. Falls ein Kunde Punkte hat die verfallen, so wird dieser per E-Mail vorab darüber informiert. # Migration von Punkten Diese Anleitung beschreibt den Prozess der Migration von Punkten von einem Shopsystem nach Shopware 6. Diese ist vorgesehen für Entwickler und System Administratoren die mit dem System vertraut sind. ### Import von Punkten zu Shopware 6 Es ist möglich die Punkte von anderen Systemen nach Shopware6 zu übernehmen. Hierfür muss die Datenbanktabelle **prems\_bonus\_system\_import\_point** mit Einträgen aus dem Fremdsystem befüllt werden. Pflichtfelder für den Import sind: * id (binary(16)) * customer\_number (int) * points (int) * reason (text, optional) * created\_at (datetime(3)) Optional kann das Feld "reason" mit einem maximal 255 Zeichen langen Text gefüllt werden. Dieser Text tauscht später bei den Kunden als Grund für die Buchung auf. Der Texte könnte beispielsweise "Migration" oder "Punkteübernahme Altsystem" lauten. Nachdem die Tabelle befüllt wurde, muss auf der Konsole der folgende Befehl ausgeführt werden: `./console prems:bonus-system:import-points-from-db-table` Ggf. ist es notwendig den Befehl mehrfach zu wiederholen, bis keine Einträge in der Tabelle **prems\_bonus\_system\_import\_point** mehr vorhanden sind. ### Migration von Punkten am Beispiel von Shopware 5 Punkte aus altem Shopsystem auslesen: ``` SELECT UUID() AS id, u.customernumber AS customer_number, up.points AS points, "Migration" AS reason FROM s_core_plugins_bonus_user_points AS up LEFT JOIN s_user AS u ON up.userID = u.id; ``` Die Punkte exportieren (ggf. als CSV) und nach UTF 8 kodieren. In Shopware 6 Datenbank die CSV Datei in Datenbanktabelle *prems\_bonus\_system\_import\_point* einlesen. Anschließend auf der Konsole den Befehl ausführen: `./console prems:bonus-system:import-points-from-db-table` # Admin API ### 👋 Für wen ist diese Anleitung? Diese Anleitung richtet sich an **Dich als Shop-Betreiber**, wenn Du das **Bonus System von PremSoft** in Deinem Shopware 6 Shop einsetzt und besser verstehen möchtest, **wie das System im Hintergrund mit Shopware kommuniziert** – zum Beispiel beim Speichern von Bonuspunkten oder Konfigurationen im Admin-Bereich. *** ### 🔍 Was ist die Admin API? Die **Admin API** ist sozusagen die **Sprache**, über die das Shopware-Backend (also die Admin-Oberfläche) mit dem Server kommuniziert. Immer wenn Du im Admin etwas tust – z. B. Bonuspunkte vergibst, Einstellungen änderst oder einen neuen Kundenbonus anlegst – läuft das im Hintergrund über diese Schnittstelle. Auch das **Bonus System von PremSoft** nutzt diese Schnittstelle – direkt nach der Installation, ohne dass Du selbst etwas konfigurieren musst. *** ### ⚙️ Was übernimmt Shopware automatisch? Das **Bonus System von PremSoft** bringt eigene Daten mit – zum Beispiel eine Übersicht über vergebene Bonuspunkte, Regelwerke oder Einstellungen zur Berechnung. Diese Daten nennt man **Entitäten**. Shopware erkennt diese Entitäten automatisch und stellt Dir sofort die passenden Funktionen zur Verfügung: | Funktion | Was bedeutet das für Dich? | | -------------------------- | ------------------------------------------------- | | ✔️ Bonusdaten anzeigen | Du siehst Punkte und Regeln im Admin-Bereich | | ✔️ Neue Einträge erstellen | Du kannst z. B. manuell Punkte vergeben | | ✔️ Daten bearbeiten | Änderungen an bestehenden Regeln sind möglich | | ✔️ Daten löschen | Nicht mehr benötigte Einträge kannst Du entfernen | ### 🔐 Was musst Du beachten? Damit Du das **Bonus System von PremSoft** vollständig nutzen kannst, brauchst Du im Shopware-Adminbereich die **richtigen Benutzerrechte**. Falls Du z. B. keine Punkte speichern oder bestimmte Einstellungen nicht öffnen kannst, fehlt Dir möglicherweise eine entsprechende Berechtigung. 💡 Schau in dem Fall einfach in den **Benutzer-Rollen** nach und prüfe, ob die passenden Rechte für das Bonus System gesetzt sind. *** ### 🧩 Wie genau nutzt das Bonus System die Admin API? Wenn Du zum Beispiel im Bonus System einen neuen Punkte-Eintrag speicherst, wird diese Information im Hintergrund an eine sogenannte **API-Adresse** geschickt (z. B. `/api/bonus-points`). Du musst Dich darum nicht kümmern – das System erledigt alles automatisch. Du klickst einfach auf „Speichern“, und das Bonus System überträgt die Daten sicher an den Server – dank der Admin API. *** ### 🧪 Für Neugierige: Ein kurzer technischer Einblick Wenn Du mit einer Agentur arbeitest oder technisch interessiert bist: * Die Admin API nutzt moderne Webstandards (REST, JSON) * Sie funktioniert nur für eingeloggte Admin-Nutzer * Alle Schnittstellen kannst Du im Shop über `/api/_info/stoplightio.html` einsehen Das Bonus System nutzt diese Infrastruktur vollständig und entspricht den Shopware-Standards. Wenn Du die Admin API für ein externes System nutzen möchtest, dann stehen folgende Standard Endpunkte für das Bonus System zur Verfügung: * `/api/_info/stoplightio.html#/schemas/PremsBonusSystemBonusProduct` * `/api/_info/stoplightio.html#/schemas/PremsBonusSystemBooking` * `/api/_info/stoplightio.html#/schemas/PremsBonusSystemCondition` * `/api/_info/stoplightio.html#/schemas/PremsBonusSystemImportPoint` * `/api/_info/stoplightio.html#/schemas/PremsBonusSystemUserPoint` *** ### ✅ Dein Vorteil als Shop-Betreiber * Du musst **nichts selbst einrichten oder programmieren.** * Das Bonus System funktioniert direkt nach der Installation. * Speichern, Bearbeiten und Anzeigen von Bonuspunkten läuft automatisch über die Admin API. * Du bekommst ein sauberes, sicheres System für die Verwaltung Deiner Bonuslogik. *** ### 📌 Fazit * Das **Bonus System von PremSoft** nutzt die Shopware Admin API, um mit Deinem Shop zu kommunizieren. * Alle wichtigen Funktionen wie das Anlegen, Bearbeiten und Löschen von Bonuspunkten laufen zuverlässig im Hintergrund. * Falls etwas nicht funktioniert, lohnt sich ein Blick in die Benutzerrechte im Admin. * Die Admin API kann auch genutzt werden um mit anderen Systemen Daten in Shopware zu ändern. # Update von Bonus Punkten mit der API Wir stellen die API für die Aktualisierung von Kundenpunkten zur Verfügung.\ Nachfolgend findest du eine Postman-Sammlung mit allen erforderlichen Daten.\ Die postman-Sammlung enthält diese Variablen: ``` SHOPWARE_DOMAIN - Die Domain des Shopware Projekts, ohne http/https Protokol. SW_ACCESS_KEY - Der Shopware Access Key. (Wird in Shopware definiert) SW_SECRET_ACCESS_KEY - Der Shopware Secret Key. (Wird in Shopware definiert) ACCESS_TOKEN - Das Bearer Token. (Wird automatisch ausgefüllt nach Ausführung von "1. Obtain API access token" aus der Kollektion) ``` Der Testvorgang mit einem Postman:\ Erstelle eine JSON Datei mit dem unten stehenden Code. 1. Importieren eine Sammlung. (eine Datei im JSON-Format) 2. Füllen die Variablen der Sammlung aus. 3. Führen den Post „1. Obtain API access token“ aus, um die erforderliche Variable ACCESS\_TOKEN zu füllen. 4. Führe andere Einträge aus der Sammlung aus. (Aktualisierung der Bonuspunkte nach Kunden-ID oder -nummer) ``` { "info": { "_postman_id": "55d7c3c5-bd28-44ad-bb5a-093a40ccd426", "name": "PremsBonusSystem: Update bonus points", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id": "5184947" }, "item": [ { "name": "1. Obtain API access token", "event": [ { "listen": "test", "script": { "exec": [ "var jsonData = JSON.parse(responseBody);", "pm.collectionVariables.set(\"ACCESS_TOKEN\", jsonData.access_token);" ], "type": "text/javascript", "packages": {} } } ], "request": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"client_credentials\",\n \"client_id\": \"{{SW_ACCESS_KEY}}\",\n \"client_secret\": \"{{SW_SECRET_ACCESS_KEY}}\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "https://{{SHOPWARE_DOMAIN}}/api/oauth/token", "protocol": "https", "host": [ "{{SHOPWARE_DOMAIN}}" ], "path": [ "api", "oauth", "token" ] } }, "response": [] }, { "name": "Update bonus points by customer number", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{ACCESS_TOKEN}}", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"customerNumber\": \"10382\", // Customer number\n \"description\": \"Test points\", // Description for added/removed bonus points\n \"points\": 5, // Amount of points, can be positive or negative\n \"salesChannelId\": \"\" // Optional: If it's not defined, it's obtained from the customer\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "https://{{SHOPWARE_DOMAIN}}/api/v2/prems-bonus-system/create-bonus-booking", "protocol": "https", "host": [ "{{SHOPWARE_DOMAIN}}" ], "path": [ "api", "v2", "prems-bonus-system", "create-bonus-booking" ] } }, "response": [] }, { "name": "Update bonus points by customer ID", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{ACCESS_TOKEN}}", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"customerId\": \"019685763d44731cb4ac5938f107993e\", // Customer ID\n \"description\": \"Test points\", // Description for added/removed bonus points\n \"points\": 5, // Amount of points, can be positive or negative\n \"salesChannelId\": \"\" // Optional: If it's not defined, it's obtained from the customer\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "https://{{SHOPWARE_DOMAIN}}/api/_action/prems/create-bonus-booking-by-customer-id", "protocol": "https", "host": [ "{{SHOPWARE_DOMAIN}}" ], "path": [ "api", "_action", "prems", "create-bonus-booking-by-customer-id" ] } }, "response": [] } ], "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "packages": {}, "exec": [ "" ] } }, { "listen": "test", "script": { "type": "text/javascript", "packages": {}, "exec": [ "" ] } } ], "variable": [ { "key": "SHOPWARE_DOMAIN", "value": "domain.dev", "type": "string" }, { "key": "SW_ACCESS_KEY", "value": "xxx", "type": "string" }, { "key": "SW_SECRET_ACCESS_KEY", "value": "xxx", "type": "string" }, { "key": "ACCESS_TOKEN", "value": "", "type": "string" } ] } ``` # Artikelnummer für Bonus Punkte Diese Anleitung beschreibt das Vorgehen um Bonus Punkte mit einer Artikelnummer auszustatten. Diese ist vorgesehen für Entwickler und System Administratoren für die Warenwirtschaft Anbindung. Grundsätzlich können Bonus Punkte auf zwei Arten eingelöst werden: 1. Als Prämienprodukte:\ In dem Fall wird das Prämienprodukt, welches als reguläres Produkt in Shopware 6 angelegt ist in der Bestellung angelegt. Somit wird die Artikelnummer dieses Produktes verwendet. 2. Als Gutscheinposition:\ Die Bonus Punkte reduzieren den Bestellwert und werden als eigene Position innerhalb der Bestellung angelegt. Diese Position hat normalerweise keine Bestellnummer. Nachfolgend wird beschrieben, wie eine Bestellnummer angelegt und ausgelesen werden kann. In der Konfiguration der Erweiterung gibt es die Einstellungen **Bonuspunkte-Artikelnummer** und **Bonuspunkte-Artikelnummer im Warenkorb anzeigen**. Bei der erst genannten Einstellung muss die gewünschte Artikelnummer für die Bonus Punkte hinterlegt und gespeichert werden. Werden nun bei einer Bestellung Bonus Punkte eingesetzt, so wird die Artikelnummer bei der entsprechenden Bonus Punkte Position hinterlegt: ``` lineItem.payload.productNumber ``` # Individuelles Angebot Die Individuelles Angebot Erweiterung für Shopware ermöglicht es deinen Kunden, schnell und einfach eine Angebotsanfrage aus dem Warenkorb heraus zu erstellen, indem sie auf den Link **Angebot anfordern** klicken (anstatt zur Kasse zu gehen).
Du kannst diese Anfrage in der Shopverwaltung bearbeiten und individuelle Angebotspreise für die Artikel zuweisen oder die Anfrage ablehnen. Nach Annahme des Angebots findet dein Kunde das Angebot in seinem Kundenkonto und kann eine Bestellung aus diesem Angebot erstellen. Es werden auch erweiterte Funktionen angeboten, wie z.B. Zwei-Wege-Nachrichten mit dem Kunden, Ablaufdaten von Angeboten und vollständig anpassbare Felder. # Voraussetzungen Die App kann nur in einer selbst verwalteten Shopware-Umgebung installiert werden, in der mindestens die Version 6.2.0 läuft. # Installation Installiere die App durch **Erweiterungen** > **Meine Erweiterungen**. Nach der Installation konfigurierst du die App durch Auswahl von **Meine Erweiterungen** > **Individuales Angebot** > **Konfiguration**.
Konfiguriere jede der in den folgenden Abschnitten beschriebenen Einstellungen. ### Allgemeine Einstellungen Konfiguriere die Einstellungen im Bereich **Allgemeine Einstellungen** wie folgt: | **Einstellung** | **Typ** | **Beschreibung** | | ------------------------------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Angebotsanfrage im Warenkorb aktivieren | KippSch. | Aktiviere diese Einstellung, um die Schaltfläche **Angebot anfordern** auf der Warenkorb-Seite anzuzeigen. | | Angebotsanfrage im OffCanvas Warenkorb aktivieren | KippSch. | Aktiviere diese Einstellung, um die Schaltfläche **Angebot anfordern** im Off-Canvas-Warenkorb anzuzeigen. | | Angebote als PDF herunterladbar | KippSch. | Aktiviere diese Einstellung, damit Kunden eine PDF-Version eines Angebots herunterladen können. | | Kunden können Nachrichten zum Angebot schreiben | KippSch. | Aktiviere diese Einstellung, um Kunden die Möglichkeit zu geben, dem Shop-Administrator Nachrichten über ein Angebot zu schicken. Administratoren können auf alle Nachrichten antworten, die sie von Kunden erhalten. | | Warenkorb nach Angebotsanfrage leeren | KippSch. | Aktiviere diese Einstellung, um den Warenkorb eines Kunden automatisch zu leeren, nachdem er ein Angebot angefordert hat. | | Angebot sofort freischalten | KippSch. | Aktiviere diese Einstellung, um automatisch ein Angebot zu erstellen, wenn ein Angebot angefordert wird. | | Mindest Warenkorbwert für Angebotsanfrage | Numerische Eingabe | Gib hier einen Betrag ein, der den Mindestkorbwert festlegt, bevor ein Kunde ein Angebot anfordern kann. | | Standard Gültigkeit von Angeboten in Tagen | Numerische Eingabe | Gib die Anzahl der Tage ein, die ein Angebot gültig ist, bevor es automatisch zurückgezogen wird. | | Formularfeld „Ihr Zeichen“ bei Angebotsanfrage | KippSch. | Aktiviere diese Option, damit deine Kunden ihr Zeichen direkt übertragen können, wenn sie ein Angebot anfordern. | |

Default Kommentartext

| Freie Texteingabe | Verwende dieses Feld, um einen Standardkommentar zu allen Angebots-PDFs hinzuzufügen. Der Standardkommentar wird im Angebot vorausgefüllt und kann für jedes Angebot nach Bedarf angepasst werden. | | Kundengruppe verbieten | Dropdown-Menü | Wenn du Kundengruppen definiert hast, kannst du diese durch Auswahl aus dem Dropdown-Menü von den Angeboten ausschließen. | ### E-Mail Einstellungen Konfiguriere die Einstellungen im Bereich **E-Mail-Eigenschaften** wie folgt:
EinstellungTypBeschreibung
E-Mail Adresse für BenachrichtigungenE-Mail-EingabeGib die E-Mail-Adresse ein, an die Benachrichtigungen an den Administrator gesendet werden sollen.
Absender E-Mail AdresseE-Mail-EingabeGib die Absender-E-Mail-Adresse für die Benachrichtigungen ein, die an den Kunden gesendet werden sollen.
Wenn ein Angebot erstellt wird, PDF mit der E-Mail versendenKippSch.Aktiviere diese Einstellung, um automatisch eine PDF-Datei eines Angebots per E-Mail zu versenden, sobald es erstellt wurde.
Infomail an Kunde: Admin lehnt Angebot abKippSch.Aktiviere diese Einstellung, um automatisch eine E-Mail an den Kunden zu senden, wenn ein Angebot von ihm vom Administrator abgelehnt wird.
Infomail an Admin: Kunde lehnt Angebot abKippSch.Aktiviere diese Einstellung, um automatisch eine E-Mail an den Administrator zu senden, wenn ein Angebot von einem Kunden abgelehnt wird.
Infomail an Admin: Kunde erstellt AngebotanfrageKippSch.Aktiviere diese Einstellung, um automatisch eine E-Mail an den Administrator zu senden, wenn ein Kunde eine Angebotsanfrage erstellt.
Infomail an Kunde: Admin hat Angebot erstelltKippSch.Aktiviere diese Einstellung, um automatisch eine E-Mail an den Kunden zu senden, wenn der Administrator eine Angebotsanfrage für ihn erstellt.
### Technische Einstellungen | Einstellung | Typ | Beschreibung | | ------------------------------------------------------------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Whitelist: Definierte Artikeltypen für das Angebot zulassen | Text Feld |

Definierte Artikeltypen können dem Angebot hinzugefügt werden.

Beispielsweise: "dvsn-set-configurator"

| | Whitelist: Benutze Referenz ID für Positionen die einen der definierten Payload Werte haben | Text Feld |

Wenn der definierte Payload Wert existiert, dann wird die Referenz ID anstelle der Standard ID genutzt. Dies behebt meistens Probleme mit einem Produkt Konfigurator.

Beispielsweise: "bogxProductConfigurator"

| # E-Mails anpassen Die App für individuelle Angebote enthält E-Mail-Vorlagen für alle gängigen Szenarien, die Sie unter **Einstellungen** > **E-Mail-Templates** finden. Diese Vorlagen sind in der folgenden Tabelle beschrieben. **Wenn Ihre Shop Umgebung mehrere Sprachen unterstützt, sind für jede Sprache Vorlagen enthalten. Verwenden Sie das Dropdown-Menü für die Sprachauswahl, um zwischen den Sprachen zu wechseln.**
| **E-Mail-Template** | **Beschreibung** | | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | | Offer created info to customer | Wird an den Kunden gesendet, um ihn zu informieren, dass ein Angebot für ihn erstellt wurde. | | Offer declined by admin | Wird an den Kunden gesendet, um ihn darüber zu informieren, dass ein Administrator ein Angebot abgelehnt hat. | | Offer declined by customer | Wird an den Administrator gesendet, um ihn zu informieren, dass der Kunde ein Angebot abgelehnt hat. | | Offer message from admin | Wird an den Kunden gesendet, um ihn zu informieren, dass ein Administrator ihm eine Nachricht zu einem Angebot geschickt hat. | | Offer message from customer | Wird an einen Administrator gesendet, um ihn zu informieren, dass ein Kunde ihm eine Nachricht zu einem Angebot geschickt hat. | | Offer request from customer | Wird an einen Administrator gesendet, um ihn zu informieren, dass ein Kunde ein Angebot angefordert hat. | Jede E-Mail-Vorlage kann bearbeitet, dupliziert oder gelöscht werden, indem Sie auf die entsprechende „**…**„-Menüschaltfläche für eine Vorlage klicken und **Bearbeiten**, **Duplizieren** oder **Löschen** auswählen, allesamt Standardoptionen der Shopware-Verwaltung. **Die Bearbeitung von E-Mail-Vorlagen ist ein optionaler, weiterführender Schritt und sollte nur dann durchgeführt werden, wenn die Standard-E-Mail-Vorlagen für Ihren Shop nicht geeignet sind, z.B. um den Wortlaut anzupassen.**
### Eine E-Mail-Vorlage bearbeiten Ändern Sie auf der Seite E-Mail-Vorlage bearbeiten die Eigenschaften der E-Mail-Vorlage in den folgenden Feldern nach Bedarf und klicken Sie dann auf **Speichern**. Alle dynamischen Elemente im Betreff und im Text der E-Mail können durch Strings wie **{{offer.customer.salutation.letterName }}** definiert werden. Hinweis: Die Änderung dieser Zeichenfolgen kann dazu führen, dass dynamische Elemente in E-Mails nicht korrekt angezeigt werden, z. B. der Name des Kunden. | **Einstellung** | **Bereich** | **Typ** | **Beschreibung** | | ----------------- | ----------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Typ | Information | Dropdown-Menü | Der Typ ist ein vordefinierter Wert, der zur Identifizierung des richtigen Szenarios für eine E-Mail-Vorlage erforderlich ist. **Ändern Sie diese Einstellung nicht** für die Standard-E-Mail-Vorlagen, da dies zu Problemen mit der App führen wird. | | Beschreibung | Information | Freie Texteingabe | Geben Sie eine optionale Beschreibung für die Vorlage ein. | | Betreff | Optionen | Freie Texteingabe |

Ändern Sie den Standardtext der E-Mail-Betreffzeile Neues Angebot nach Bedarf.
Der String {{ offer.offerNumber }} ermöglicht die dynamische Anzeige der entsprechenden Angebotsnummer und sollte nicht geändert werden.

| | Absender | Optionen | Freie Texteingabe | Standard ist der String **{{ salesChannel.name }}**, der eine dynamische Anzeige des Vertriebskanals ermöglicht. Dies sollte nicht geändert werden. | | Dateien Hochladen | Anhänge | Datei-Explorer | Laden Sie alle Dateien hoch, die Sie als Anhang für die aktuell ausgewählte E-Mail-Vorlage einfügen möchten, z. B. Geschäftsbedingungen oder eine Datenschutzrichtlinie. | | Text | Mail-Text | Freie Texteingabe | Ändern Sie die Standard-Klartextversion des E-Mail-Textes. Hier gibt es verschiedene Strings, die dynamische Elemente im E-Mail-Text ermöglichen. Diese sollten nicht geändert werden. | | HTML | Mail-Text | Freie Texteingabe | Ändern Sie die Standard-HTML-Textversion des E-Mail-Textes. Hier gibt es verschiedene Zeichenketten, die dynamische Elemente im E-Mail-Text ermöglichen. Diese sollten nicht geändert werden. | ### Eine E-Mail-Vorlage duplizieren Wenn Sie die Option **Duplizieren** wählen, wird eine Kopie dieser E-Mail-Vorlage erstellt und der Bildschirm E-Mail-Vorlage bearbeiten geöffnet (siehe vorheriger Abschnitt). ### Eine E-Mail-Vorlage löschen **Löschen Sie nicht die Standard-E-Mail-Vorlagen**, da dies zu Problemen mit der App führen würde. Alle zusätzlichen Vorlagen, die Sie erstellen, können ohne Probleme gelöscht werden. # Angebot PDF anpassen Mit den **PDF-Einstellungen** können Sie die PDF-Datei, die bei der Erstellung eines Angebots erstellt und per E-Mail an den Kunden gesendet wird, vollständig anpassen. Greifen Sie auf die PDF-Einstellungen zu über **Einstellungen** > **Dokumente**, dann klicken Sie auf die Schaltfläche **Bearbeiten** für den Eintrag **individual\_offer**. ### Einstellungen Der Einstellungsbereich enthält allgemeine Konfigurationsoptionen für die PDF-Datei, z. B. das Firmenlogo, das Seitenformat und die Anzahl der Elemente pro Seite.. | Feld | Typ | Beschreibung | | ----------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | Freie Texteingabe | Der eindeutige Bezeichner für die App. Ändern Sie diesen Wert nicht, da er zur Identifizierung des Dokumententwurfs für die Erstellung der Angebots-PDF erforderlich ist. | | Geschäftslogo | Bildauswahl | Laden Sie ein neues Firmenlogo hoch oder wählen Sie ein vorhandenes Bild aus der Galerie der bereits hochgeladenen Bilder aus. | |

Dateinamen-Präfix

| Freie Texteingabe | Geben Sie das Präfix für Dateien ein, die mit der App Individuelles Angebot erstellt wurden. Der Standard ist **offer\_**. | | Dateinamen-Suffix | Freie Texteingabe | Geben Sie ein Suffix für Dateien ein, die mit der App Individuelles Angebot erstellt wurden (optional, standardmäßig kein Suffix). | | Seitenausrichtung | Dropdown-Menü | Wählen Sie Hochformat (Standard) oder Querformat. | | Seitenformat | Dropdown-Menü | Wählen Sie **A4, A5, Legal** oder **Letter**. Standard ist **A4**. | | Positionen pro Seite | Numerische Eingabe | Geben Sie die Anzahl der Positionen ein, die auf jeder Seite erscheinen sollen. Der Standardwert ist **10**. | | Kopfzeile anzeigen | Kontrollkästchen | Standardmäßig werden die Kopfzeilen angezeigt. Deaktivieren Sie das Kontrollkästchen, um Kopfzeilen zu deaktivieren. | | Fußzeile anzeigen | Kontrollkästchen | Standardmäßig werden Fußzeilen angezeigt. Deaktivieren Sie das Kontrollkästchen, um Fußzeilen zu deaktivieren. | | Seitennummerierung anzeigen | Kontrollkästchen | Standardmäßig werden die Anzahl der Seiten und die aktuelle Seitenzahl angezeigt. Deaktivieren Sie das Kontrollkästchen, um die Seitennummerierung zu deaktivieren. | | Bestellpositionen anzeigen | Kontrollkästchen | Standardmäßig werden Bestellpositionen angezeigt. Deaktivieren Sie das Kontrollkästchen, um Bestellpositionen zu deaktivieren. | | Bestellpositionen nummerieren | Kontrollkästchen | Standardmäßig werden die Positionen der Positionen angezeigt. Deaktivieren Sie das Kontrollkästchen, um Positionspositionen zu deaktivieren. | | Preise anzeigen | Kontrollkästchen | Standardmäßig werden die Preise für jeden Artikel angezeigt. Deaktivieren Sie das Kontrollkästchen, um die Preise zu deaktivieren. | | Dokument in „Mein Konto“ Bereich anzeigen | Kontrollkästchen | Aktivieren Sie diese Einstellung, um dem Kunden den Zugriff auf das Dokument über seine Seite **Mein Konto** zu ermöglichen. | ### Geschäftseinstellungen Der Bereich Unternehmenseinstellungen enthält unternehmensspezifische Konfigurationsoptionen, wie z.B. die Kontaktdaten des Unternehmens, die Umsatzsteuernummer und die Bankverbindung. | Feld | Typ | Beschreibung | | ----------------------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------- | | Geschäftsadresse anzeigen | Kontrollkästchen | Standardmäßig wird die Firmenadresse angezeigt. Deaktivieren Sie das Kontrollkästchen, um die Firmenadresse auszublenden. | | Geschäftsadresse | Freie Texteingabe | Die eingetragene Adresse Ihres Unternehmens. Geben Sie eine neue Zeichenfolge ein, um die Firmenadresse zu ändern. | | Geschäftsname | Freie Texteingabe | Der Firmenname. Geben Sie eine neue Zeichenfolge ein, um den Firmennamen zu ändern. | | Geschäfts-E-Mail-Adresse | Freie Texteingabe | Die E-Mail-Adresse des Unternehmens. Geben Sie eine neue gültige E-Mail-Adresse ein, um die E-Mail-Adresse zu ändern.. | | Geschäfts-Telefon | Freie Texteingabe | Die Telefonnummer des Unternehmens. Geben Sie eine neue gültige Telefonnummer ein, um die Telefonnummer der Firma zu ändern. | | Geschäfts-Webseite | Freie Texteingabe | Die Adresse der Unternehmenswebsite. Geben Sie eine neue gültige URL ein, um die Adresse der Unternehmenswebsite zu ändern. | | Geschäfts-Steuernummer | Freie Texteingabe | Die Steuernummer des Unternehmens. Geben Sie bei Bedarf eine neue gültige Steuernummer ein. | | Finanzamt | Freie Texteingabe | Das eingetragene Finanzamt des Unternehmens. Geben Sie den Namen des Finanzamtes wie gewünscht ein. | | Geschäfts-USt-Id | Freie Texteingabe | Die Umsatzsteuer-Identifikationsnummer des Unternehmens. Geben Sie bei Bedarf eine gültige MwSt.-Nummer ein. | | Bank | Freie Texteingabe | Die Bank des Unternehmens. Geben Sie den Namen der Bank wie gewünscht ein. | | IBAN | Freie Texteingabe | Die IBAN-Nummer des Unternehmens. Geben Sie bei Bedarf eine gültige IBAN-Nummer ein. | | BIC | Freie Texteingabe | Die BIC-Nummer des Unternehmens. Geben Sie bei Bedarf eine gültige BIC-Nummer ein. | | Gerichtsstand / Handelsregister-Nr. | Freie Texteingabe | Der Gerichtsstand (Stadt) oder die Handelsregisternummer. Geben Sie eine dieser beiden Angaben ein. | | Erfüllungsort | Freie Texteingabe | Der Erfüllungsort für Rechtsstreitigkeiten. Geben Sie bei Bedarf einen Ort ein. | | Geschäftsführer | Freie Texteingabe | Der Geschäftsführer oder CEO des Unternehmens. Geben Sie den Namen der Person ein. | ### Zuweisung Die Einstellung Dokumententyp kann nicht geändert werden. # Zusatzfelder verwenden Zusatzfelder (benutzerdefinierte Felder) werden für jedes Angebot über das Feld Benutzerdefinierte Felder auf der Detailseite des Angebots unterstützt. Um benutzerdefinierte Felder zu verwenden, müssen Sie sie zunächst wie folgt in Shopware erstellen: 1. Klicken Sie auf **Einstellungen** > **System** > **Zusatzfelder**. 2. Wählen Sie **Individuales Angebot** aus. 3. Klicken Sie auf **Set Anlegen** und füllen Sie die in der folgenden Tabelle beschriebenen Felder aus. 4. Klicken Sie auf **Speichern**. | **Setting** | **Type** | **Description** | | ---------------------------------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Technischer Name | Freie Texteingabe | Eindeutiger Bezeichner für das benutzerdefinierte Feld. Er muss eindeutig sein und kann nicht mehr geändert werden, sobald das benutzerdefinierte Feld gespeichert wurde. | | Position | Freie Texteingabe | Geben Sie die Position für das benutzerdefinierte Feld ein (numerischer Wert). | | In allen Administrationssprachen pflegen | KippSch. | Aktivieren Sie diese Einstellung, um mehrere Sprachvarianten für das benutzerdefinierte Feld zuzulassen. | | Label | Freie Texteingabe | Geben Sie den Beschriftungstext für das benutzerdefinierte Feld ein. Wenn die Einstellung für mehrere Sprachvarianten aktiviert ist, geben Sie den Beschriftungstext in jeder unterstützten Sprache ein. | | Verwenden für | Dropdown-Menü | Wählen Sie eine Kategorie aus, der das benutzerdefinierte Feld zugeordnet werden soll. | **Sie können vorhandene benutzerdefinierte Felder auch von dieser Seite aus bearbeiten, indem Sie auf die Menüschaltfläche „…“ klicken und Bearbeiten wählen.** #### Benutzerdefinierte Felder im Shop anzeigen Um benutzerdefinierte Felder in der Shop-Front anzuzeigen, müssen Sie Template-Änderungen in Ihrem Theme oder über eine Erweiterung implementieren. Zum Beispiel: Sie haben ein Textfeld mit dem Namen **prems\_individual\_offer\_offer\_test**\ erstellt. Sie können in Ihrem Theme eine neue Datei **resources/views/storefront/page/individual\_offer/index.html.twig** erstellen. Fügen Sie den folgenden Code ein, um das benutzerdefinierte Feld anzuzeigen: 
{% sw_extends "@Storefront/storefront/page/individual_offer/index.html.twig" %}

{% block page_account_offers_table_order_number %}
{{ parent() }}
{% if order.customFields.prems_individual_offer_offer_test %}
Your label test text: {{ order.customFields.prems_individual_offer_offer_test }}
{% endif %}
{% endblock %}
# Angebote verwalten ### Übersicht der Angebote Um eine Übersicht über alle angeforderten Angebote zu erhalten, wähle **Kunden > Angebote** aus.
{% hint style="info" %} Du kannst ein Angebot von dieser Seite aus löschen, indem du die Menüschaltfläche „…“ klickst und **Löschen** wählst. Gelöschte Angebote können nicht wiederhergestellt werden. {% endhint %} ### Angebot editieren Um ein Angebot zu bearbeiten, klicke auf die entsprechende Menüschaltfläche „**…**“ für einen Eintrag und wähle **Bearbeiten** aus. Auf dem Detailbildschirm des Angebots sind folgende Registerkarten verfügbar, die in den nächsten Abschnitten beschrieben werden: * Übersicht/Status * Elemente * Einstellungen * Nachrichten * Kommentare ### Übersicht/Status Die Seite **Übersicht/Status** bietet eine Zusammenfassung der ausgewählten Angebotsanfrage.
* Informationen wie die ursprüngliche Summe, der Rabatt, die Angebotssumme sowie die Kontaktdaten des Kunden werden im **Übersichtsbereich** angezeigt. * Der **Status** des Angebots wird darunter angezeigt. * Klicke auf **Freigeben**, um ein Angebot aus der Angebotsanfrage des Kunden zu erstellen. * Klicke auf **Ablehnen**, um die Angebotsanfrage des Kunden abzulehnen. ### Elemente Auf dem Bildschirm Positionen wird eine Liste aller in der ausgewählten Angebotsanfrage enthaltenen Positionen angezeigt, die in die folgenden Spalten unterteilt ist: * Name * Steuer * Alter Preis * EK (brutto) * Menge * % * Angebotspreis * Angebotspreis Summe ### Ein Katalogprodukt hinzufügen Während sich das Angebot im Status **Anfrage** befindet, fügst du auf dem Bildschirm Artikel wie folgt weitere Artikel aus dem Katalog hinzu: 1. Klicke auf **Produkt hinzufügen**. Eine neue Zeile wird der Liste der Angebotsartikel hinzugefügt. 2. Doppelklicke auf das Feld **Name** und verwende das Dropdown-Feld, um einen vorhandenen Katalogartikel auszuwählen. 3. Klicke anschließend auf das Häkchen ✔. ### Benutzerdefiniertes Produkt hinzufügen Während sich das Angebot im Status **Anfrage** befindet, fügst du auf dem Bildschirm Artikel wie folgt benutzerdefinierte Artikel hinzu (z. B. „einmalige“ Artikel, die nicht im Katalog vorhanden sind): 1. Klicke auf den Pfeil nach unten neben **Produkt hinzufügen** und wähle **Leere Position hinzufügen**. 2. Gib den Namen für den benutzerdefinierten Artikel ein. 3. Gib die **Steuer** (nur den numerischen Wert, der %-Wert wird automatisch hinzugefügt) und den Angebotspreis ein. 4. Klicke anschließend auf das Häkchen ✔. ### Rabatt/Gutschrift hinzufügen Während sich das Angebot im Status **Anfrage** befindet, fügst du der Angebotssumme wie folgt einen Rabatt oder eine Gutschrift hinzu: 1. Klicke auf den Pfeil nach unten neben **Produkt hinzufügen** und wähle **Gutschrift hinzufügen**. 2. Gib den **Namen** für den Rabatt-/Gutscheinartikel ein (beachte, dass dieser für den Kunden im Angebot sichtbar sein wird). 3. Gib den Betrag, der vom Gesamtangebot abgezogen werden soll, in das Feld **Angebotspreis** ein. Beachte, dass der Wert ein Minus sein muss, damit er abgezogen werden kann. -10 zieht also 10 EUR (oder die gewählte Währung) von der Angebotssumme ab. 4. Klicke anschließend auf das Häkchen ✔. ### Einstellungen Die Seite **Einstellungen** enthält die folgende Felder: * Gültigkeit Angebot in Tagen: Geben Sie hier einen Wert für die Anzahl der Tage ein, für die das Angebot gültig sein soll. * Versandart: Wählen Sie **Alle Versandarten gültig**, **Standard** oder **Express** aus. * Versandkostenberechnung: Wählen Sie **Standard Berechnung**, **Keine Versandkosten** oder **Feste Versandkosten** aus. **Alle benutzerdefinierten Felder, die du erstellt hast, werden ebenfalls auf dieser Seite angezeigt.** ### Nachrichten Auf diesem Bildschirm wird eine Liste der Nachrichten (falls vorhanden) angezeigt, gruppiert nach Absender und Datum. * Um eine neue Nachricht an den Kunden zu senden, klicke auf **Neue Nachricht**. Gib den Nachrichtentext in das freie Textfeld ein und klicke dann auf **Senden**. Der Kunde erhält die Nachricht in seinem Shopware-Kontrollzentrum.
### Kommentare Auf diesem Bildschirm wird eine Liste der Kommentare (falls vorhanden) angezeigt, gruppiert nach Absender und Datum. * Um einen neuen Kommentar hinzuzufügen, klicke auf **Kommentar hinzufügen**. Gib den Kommentartext in das freie Textfeld ein und klicke dann auf **Senden**. * Kommentare sind nur für den internen Gebrauch im Shopware-Administrationsbereich bestimmt und sind für Kunden nicht sichtbar. Hier kann ein Administrator oder mehrere Administratoren Notizen zum Status des Angebots hinzufügen. # Feste Versandkosten und Versandart # Angebot in der Admin erstellen Obwohl der typische Anwendungsfall darin besteht, dass der Kunde eine Angebotsanfrage über das Shop-Frontend erstellt, kannst du ein Angebot auch über das Shopware Admin-Dashboard erstellen. Dies ist nützlich, wenn der Kunde eine Angebotsanfrage per Telefon gestellt hat. Auf der Seite Angebotsübersicht: 1. Klicke auf **Angebot erstellen**. 2. Wenn der Kunde bereits ein Shop-Konto hat, wähle ihn aus dem Dropdown-Menü Kunde aus. Wenn nicht, klicke auf **Kunden anlegen**, um ein Konto für ihn anzulegen, und fülle die Felder entsprechend den verfügbaren Informationen aus (der Kunde kann die fehlenden Informationen bei Bedarf selbst ergänzen). Klicke auf **Speichern**, wenn du fertig bist. 3. Wähle die gewünschte **Währung** für das Angebot und klicke auf **Speichern**. Das Angebot wird erstellt und zur Liste der aktuellen Angebote hinzugefügt. Um das Angebot zu bearbeiten, siehe [Individuelles Angebot bearbeiten](broken://pages/yxBWsTKftVPMXfE63LXf) oben. # Angebot in der Admin bestellen Der typische Anwendungsfall ist, das ein Kunde im Warenkorb oder Checkout bei dir eine Angebotsanfrage stellt, du dann entsprechend hieraus in der Admin ein Angebot erstellt und der Kunde den Checkoutprozess durchläuft um das Angebot zu bestellen. Manchmal kann es aber auch nötig sein, die Bestellung für den Kunden durchzuführen. Hierfür haben wir ein Erweiterung erstellt, welche die Administration um diese Möglichkeit ergänzt. Mit unser Erweiterung [Angebot Backend Bestellung](/plugins/angebot-backend-bestellung) wird jedes Angebot um einen Bestellen Button ergänzt. Sobald du das Angebot in der Admin erstellst hast, kannst du es für deinen Kunden bestellen. # Angebot Backend Bestellung Es wird das Plugin [Individuelles Angebot](https://store.shopware.com/prems68891056375/individuelles-angebot.html) mindestens in der Version 3.6.1 benötigt.
Installation über den Erweiterungs-Manager. Sobald Sie ein Angebot freigegeben haben, finden Sie in der Admin in den Angebotsdetails den Button "Bestellung anlegen". Nach Klick auf den Button werden Sie durch den Bestellprozess geleitet. # Affiliate System ### Einführung Das Affiliate System für Shopware 6 ist eine komplette Kunden werben Kunden Erweiterung. Mittels dieser ist es möglich, das Ihre Shop Kunden Partner werden und mit einem Partner Link neue Kunden werben. Für jede Bestellung eines, durch den Partner geworbenen Kunden, können Sie eine Provision vergeben.
Mit dem Affiliate System gibt es die volle Flexibilität wieviel Provision pro Bestellung gewährt werden soll und ob diese relativ oder absolut berechnet wird. Partner, Bestellung und Provisionsguthaben, können in der Administration geprüft und verwaltet werden. # Voraussetzungen Die Erweiterung kann nur in einer selbst verwalteten Shopware-Umgebung mit mindestens Version 6.5.0 installiert werden. # Installation Bevor du die Erweiterung aktivierst, überprüfe die Einstellungen in diesem Abschnitt und stelle sicher, dass diese deinen Anforderungen entsprechen. Nehme Änderungen an den einzelnen Feldern wie unten beschrieben vor, indem du **Meine Erweiterungen** > **Affiliate System** > **Konfiguration** wählst. Es gibt zwei Bereiche des Affiliate System, in denen eine Konfiguration vorgenommen werden muss: * Basis Konfiguration * Admin Dashboard Bitte führezuerst die Schritte der Basis Konfiguration durch und lesen anschließend im Bereich Admin Dashboard weiter. ### Basis Konfiguration Bitte prüfe zuerst in den Einstellungen, ob diese deinen Anforderungen entsprechend. Mache entsprechende Anpassungen, die nachfolgend beschrieben werden. Wählen Sie hierfür **Meine Erweiterungen** > **Affiliate System** > **Konfigurieren**.
Gebe zunächst einen **Verkaufskanal** an, für den die Erweiterung aktiviert werden soll. Die Standardeinstellung ist „Alle Verkaufskanäle“. ### Allgemeine Einstellungen Die allgemeinen Eigenschaften bieten grundlegende Steuerelemente, wie z. B. die Aktivierung/Deaktivierung der Erweiterung und Basiseinstellungen für Partner und deren Provision.
| Feld | Typ | Beschreibung | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------- | | Plugin aktivieren | Toggle | Aktivieren diese Einstellung, um das Affiliate System in Ihrem Shop zu aktivieren. | | Partner kann seinen Partner Code ändern | Dropdown |

Legen fest, ob ein Partner seinen eigenen Partner Code selbst ändern darf, indem du eine Option aus dem Dropdown-Menü auswählst: | |
– Nein: Der Partner Code kann nur durch einen Admin geändert werden | | | |
– Ja, der Code wird sofort geändert: Der neue Code wird ohne weitere Prüfung übernommen | | | |
– Ja, aber die Änderung muss durch Admin bestätigt werden: Die gewünschte Code-Änderung muss erst durch einen Admin freigegeben werden, bevor sie aktiv wird.

| | | ### Partner Registrierung Die Einstellungen in diesem Bereich beziehen sich auf die Registrierung von Partnern. | Feld | Typ | Beschreibung | | ------------------------------------------------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Neuer Partner benötigt Freischaltung | Schalter | Aktivieren diese Einstellung um neue Partner manuell zu prüfen, bevor Sie diese freischalten. | | Partner muss Bewerbung schreiben | Schalter | Wenn diese Einstellung aktiv ist, muss ein Kunde zur Aufnahme in das Partnerprogramm, einen kurzen Bewerbungstext schreiben. | | Partner darf Affiliate Code selber wählen | Schalter | Ist diese Option aktiv, dann darf der Partner den Affiliate Code selber wählen. Andernfalls wird ein Zufallscode generiert. | | Partner muss die Partner Bedingungen akzeptieren | Schalter | Aktivieren diese Einstellung, damit ein neuer Partner während der Registrierung die Partner-Bedingungen bestätigen muss. Bitte unter **Admin → Textbausteine** den Textbaustein **partner-terms** editieren und den Link zu deinen Bedingungen hinterlegen. | | Benötigte Anzahl Tage registriert | Numerische Eingabe | Wie viele Tage muss ein Kunde mindestens registriert sein, bevor er Partner werden kann? | | Benötigter Umsatz in EUR | Numerische Eingabe | Geben einen Mindestumsatz an, den ein Kunde erreichen muss, bevor dieser Partner werden kann. | | Erlaubte Kundengruppen | Mehrfachauswahl | Wählen alle Kundengruppen aus, für die die Partner Registrierung aktiv sein soll. Wird keine Gruppe gewählt, so ist das Partnerprogramm nicht verfügbar. | ### Provision sammeln Die Einstellungen in diesem Bereich, beziehen sich auf das Sammeln von Provision. | Feld | Typ | Beschreibung | | --------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Partner kann Kunden von anderen Part | Schalter | Ist diese Einstellung aktiv so kann ein Kunde, der bereits einem Partner zugewiesen ist, bei Klick auf einen anderen Partnerlink abgeworben werden. | | Lebenszeit eines Partner Cookies in Tagen | Numerische Eingabe | Bei Klick auf einen Affiliate Link, wird ein Cookie erstellt. Definieren Sie hier die Anzahl Tage, die das Cookie bestehen bleiben soll. | | Provision Aktivierung Bestellung | Dropdown |

Legen fest, wie die Provision für eine Bestellung aktiviert wird, indem Sie eine Option aus dem Dropdown-Menü auswählen:
– Immer manuell: über das Admin-Modul
– Bestellung bezahlt: Die Provision wird automatisch aktiviert, nachdem die Bestellung bezahlt wurde
– Bestellung abgeschlossen: Die Provision wird gutgeschrieben, sobald der Bestellstatus auf abgeschlossen gesetzt wird
– Bestellung versendet: Die Provision wird gutgeschrieben, sobald die Bestellung den Status versendet hat.

| | Aktivierungsbedingungen für Provision | Dropdown | Legen hier fest ob die Einstellung „Provision Aktivierung Bestellung“ eine **ODER** „Provision n-Tage nach Bestellung freischalten“ oder eine **UND** Bedingung ist. | | Provision n-Tage nach Bestellung freischalten | Numerische Eingabe | Geben die Anzahl an Tagen an, die vergangen sein müssen, das die Provision einer Bestellung automatisch gutgeschrieben wird. | | Provision abziehen bei Stornierung Bestellung | Schalter | Mit aktivierter Option wird eine Provision automatisch abgezogen, wenn die zugehörige Bestellung storniert wurde. | ### Provision abziehen | Feld | Typ | Beschreibung | | ------------------------------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Provision entfernen bei Lieferstatus: Retour | Schalter | Mit aktivierter Option wird eine zuvor gutgeschriebene Provision automatisch abgezogen, sobald der Lieferstatus der zugehörigen Bestellung auf Retour gesetzt wird. | | Provision entfernen bei Lieferstatus: Teilretour | Schalter | Mit aktivierter Option wird eine zuvor gutgeschriebene Provision automatisch abgezogen, sobald der Lieferstatus der zugehörigen Bestellung auf Teilretour gesetzt wird. | ### Provision Auszahlung | Feld | Typ | Beschreibung | | ------------------------------------- | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Individueller Gutschein Code Struktur | Text | Lege das Muster fest, mit dem individuelle Gutschein-Codes erzeugt werden, wenn ein Partner seine Provision in einen Gutschein umwandelt. Jedes %s wird durch ein zufälliges Zeichen ersetzt. Der Standardwert %s%s%s%s%s erzeugt einen fünfstelligen Code. | ### Technische Einstellungen | Feld | Typ | Beschreibung | | ------------------------------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Affiliate-Link Parameter | Text (Pflichtfeld) | Lege den URL-Parameter fest, der in Affiliate-Links verwendet wird. Im Standard verwenden wir partner, sodass ein Link wie generiert wird. Bitte nicht ändern, wenn Sie bereits aktive Partner haben — andernfalls werden alle bisher genutzten Affiliate-Links ungültig. | | Affiliate Cookie als technisch notwendig beim Cookie Consent setzen | Schalter | Aktiviere diese Einstellung, damit das Affiliate-Cookie beim Cookie Consent als technisch notwendiges Cookie registriert wird. Ist die Option deaktiviert, dann ist das Affiliate-Cookie ein optionales Cookie — Besucher, die es nicht akzeptieren, werden keinem Partner zugeordnet. | # Verwaltungs-Dashboard Nachdem Sie die Grundkonfiguration des Affiliate System abgeschlossen haben, verwenden Sie das Admin Dashboard um Partner, Partner Gruppen, Bestellungen und Auszahlungen zu verwalten. Sie erhalten Zugriff auf das Admin Dashboard in der Shopware Administration unter **Marketing > Affiliate System**. Das Verwaltungsdashboard ist unterteilt in die folgenden Reiter: * Überblick (Wird standardmäßig angezeigt, wenn Sie das Modul aufrufen) * Auszahlung * Bestellung * Partner * Partner Gruppe Bitte beachten Sie: Wenn Sie die Erweiterung neu installiert haben, dann ist der Bereich „Partner Gruppe“ am Wichtigsten. Denn jeder Partner muss einer Partner Gruppe zugewiesen sein (dies ist eine ähnliche Logik wie bei Kunden und Kunden Gruppen). Nach der Installation wird eine Standard Partnergruppe automatisch erstellt. Diese muss aber noch abschließend manuell konfiguriert werden. ### Überblick Dieser Bereich wird standardmäßig angezeigt, wenn Sie das Admin Dashboard aufrufen. Sie finden hier eine nützliche Zusammenfassung der wichtigsten Kennzahlen, aufgeteilt in zwei Tabellen\ (Statistik und Top 5 aktuelle Provision). Des Weiteren finden Sie hier neue Partner Bewerbungen, die Sie direkt editieren können.
#### Statistik Die Tabelle Statistik fasst die Daten der Bonuspunkte in den folgenden Spalten zusammen: * Verkaufskanal * Verdiente Provision * Ausgegebene Provision * Nicht genehmigte Provision * Aktuelle Provision (gesamte Zeit) Verwenden Sie das Dropdown-Menü für den Zeitbereich, um die in den Tabellen angezeigten Metriken zu filtern nach * Seit Beginn * Letzte 30 Tage * Letzte 14 Tage * Letzte 7 Tage * Letzte 24 Stunden * Seit gestern Je länger die gewählte Zeitspanne ist, desto mehr Daten werden in der Tabelle zusammengefasst. #### Top 5 aktuelle Provision Das Guthaben eines Partners ist die Summe seiner verdienten Provision, die noch nicht ausgegeben wurde. Provision kann eingelöst werden für Gutscheine, Bonus Punkte oder gegen Geld. In dieser Tabelle werden die fünf Kunden mit den höchsten Guthaben in den folgenden Spalten angezeigt: * Partner * Guthaben ### Auszahlung Unter dem Tab „Auszahlung“ wird eine Tabelle mit allen Auszahlungen der Partner angezeigt. Bis auf den Auszahlung Typ „Geld“ funktionieren die Auszahlungen automatisch. Wenn ein Partner die Auszahlung als Geld beantragt, dann müssen Sie diese hier freigeben. Klicken Sie hierfür auf die drei Punkte und öffnen den Auszahlungsdialog. In dem neuen Fenster, sehen Sie die Bankdaten Ihres Partners. Sie müssen dann Ihre Banksoftware nutzen, um dem Partner das Geld manuell zu senden. Sobald Sie dies abgeschlossen haben, können Sie dies in dem Fenster bestätigen. Optional können Sie ein Auszahlungs-PDF für Ihren Partner hochladen und per E-Mail versenden.
In der Tabelle werden die folgenden Spalten angezeigt: * Kundennummer * Name * Typ * Betrag * Ausgezahlt * Auszahlungsdatum Klicken Sie auf die Schaltfläche Aktualisieren auf der rechten Seite, um die neuesten Daten abzurufen. ### Bestellung Unter dem Tab „Bestellungen“, finden Sie alle Affiliate Bestellungen, die durch Ihre Partner geworben wurden.
In der Tabelle werden die folgenden Spalten angezeigt: * Bestellnummer * Partner * Bestellwert * Provision * Bestellung Status * Freigeschaltet **Klicken Sie auf das gestapelte Symbol auf der rechten Seite des Tabellenkopfes, um Spalten zu aktivieren/deaktivieren, zwischen kompakter und erweiterter Ansicht zu wechseln.** #### Manuelle Aktivierung der Provision Wenn ein geworbener Kunde eine Bestellung tätigt, dann muss defaultmäßig die Provision für den Partner aktiviert werden, bevor diese für den Partner nutzbar wird. Sie können diesen Prozess automatisieren, indem Sie in den Einstellungen der Erweiterung bestimmte Events festlegen bei deren Eintreten die Provision automatisch freigeschaltet wird. Alternativ können Sie die Provision auch manuell freischalten. Klicken Sie hierzu auf die drei Punkte bei einer entsprechenden Bestellungen und wählen „Freischalten“.
### Partner Unter dem Tab „Partner“, finden Sie eine Tabelle mit einer Liste aller Partner Ihres Shops, unabhängig davon, ob diese aktuell ein Provisionsguthaben haben oder nicht.
In der Tabelle werden die folgenden Spalten angezeigt: * Kundennummer * Name * Anzahl Bestellungen * Umsatz * Provision * Status #### Partner editieren Um einen Partner aus der Liste zu editieren, klicken Sie das drei Punkte Icon und wählen **Editieren.** Es wird eine Zusammenfassung der Partner Details angezeigt, unter anderem: Die aktuelle Provision, Kontakt Details, Account Status, Kundengruppe und Partnergruppe. Zusätzlich haben Sie ein **Bestellung** und **Auszahlung** Tab. Unter diesen Tabs verbirgt sich dieselbe Funktionalität, die bereits zuvor beschrieben wurde mit dem einzigen Unterschied, das die Bestellungen und Auszahlungen nur für den ausgewählten Partner gelten. ### Partner Gruppe Unter dem Tab „Partner Gruppe“, finden Sie eine Liste aller Partner Gruppen in Ihrem System.
In der Tabelle werden die folgenden Spalten angezeigt: * Name * Provisions Typ * Provisions Faktor * Anzahl Partner * Standardgruppe #### Anlegen/ Editieren einer Partner Gruppe. Um eine neue Partner Gruppe anzulegen, wählen Sie den Button „Gruppe hinzufügen“ im Kopfbereich der Administration. Zum Editieren, klicken Sie die drei Punkte bei einer Partner Gruppe in der Liste und wählen „Editieren“.
| Feld | Typ | Beschreibung | | ---------------------------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | Freitext | Vergeben Sie einen eindeutigen Namen für die Gruppe, beispielsweise „Premium Partner“. | | Kampagnen Code | Freitext | Vergeben Sie einen Kampagnen Code, wenn Sie die Bestellungen dieser Partner Gruppe filterbar machen wollen. | | Provision Typ | Dropdown | Wählen Sie, ob die Provision für eine Bestellung relativ oder absolut sein soll. | | Provision Faktor | Numerische Eingabe | Wählen Sie den Faktor für die Provision. Wenn Sie einen relativen „Provision Typ“ ausgewählt haben, dann bedeutet ein Wert von 5 beispielsweise 5% Provision auf den Bestellwert. Bei einer absoluten Provision, entspricht ein Wert von „5.91“ einer Provision von 5,91 EUR für Ihren Partner bei einer Bestellung. | | Benötigt Freischaltung | Schalter | Wenn deaktiviert, dann wird die Provision für eine Bestellung direkt freigeschaltet. | | Provision nur für die ersten n-Bestellungen | Numerische Eingabe | Ein Wert größer 0 bedeutet, das Ihr Partner nur für die ersten n-Bestellungen Provision erhält. Bei einem Wert von 0 gibt es für alle zukünftigen Bestellungen Provision. | | Erweiterte Provision | Liste/ Overlay | Stellen Sie detailliert ein, für welche Produkte es was für eine Provision gibt und ob es diese nur bei der ersten Bestellung oder auch bei Folgebestellungen gibt. | | Ansprechpartner Informationen anzeigen – Auf Registrieren Seite | Schalter | Aktivieren Sie diese Option um Kunden auf der Registrieren Seite eine Infobox mit Partner Informationen wie „Name“ und „Kontakt Daten“ anzuzeigen. Die Texte können in der Administration unter „Einstellungen -> Shop -> Textbausteine“ mit der Suche nach „prems-affiliate.partner-infos-for-customer.register-page“ angepasst werden. | | Ansprechpartner Informationen anzeigen – Auf Account Seite | Schalter | Aktivieren Sie diese Option um Kunden auf der Account Seite eine Infobox mit Partner Informationen wie „Name“ und „Kontakt Daten“ anzuzeigen. Die Texte können in der Administration unter „Einstellungen -> Shop -> Textbausteine“ mit der Suche nach „prems-affiliate.partner-infos-for-customer.account-home-page“ angepasst werden. | | Ansprechpartner Informationen anzeigen – Auf der Checkout Seite | Schalter | Aktivieren Sie diese Option um Kunden auf der Checkout Seite eine Infobox mit Partner Informationen wie „Name“ und „Kontakt Daten“ anzuzeigen. Die Texte können in der Administration unter „Einstellungen -> Shop -> Textbausteine“ mit der Suche nach „prems-affiliate.partner-infos-for-customer.confirm-page“ angepasst werden. | | Partner Gutschein – Gutschein aktivieren | Schalter | Alternativ zum Affiliate Link können Ihre Partner auch einen Gutschein Code erhalten, mit dem sie neue Kunden werben. Nutzt ein Kunde diesen Gutschein Code, so wird er automatisch dem Partner zugewiesen. | | Partner Gutschein – Gutschein Typ | Dropdown | Wählen Sie ob der Gutscheinwert absolut oder relativ sein soll. | | Partner Gutschein – Gutschein Höhe | Numerische Eingabe | Legen Sie die Höhe des Gutscheins fest. | | Partner Gutschein – Name | Freitext | Ein eindeutiger Name muss für den Gutschein hinterlegt werden. Der Platzhalter ###partnerCode### ist erforderlich. | | Partner Gutschein – Code | Freitext | Legt den Gutschein Code fest. Der Platzhalter ###partnerCode### ist erforderlich. | | Partner Gutschein – Max. Nutzer | Numerische Eingabe | Definiert wie viele Nutzer dieser Gutschein haben darf. | | Partner Gutschein – Max. Nutzung pro Kunde | Numerische Eingabe | Legt fest, wie oft ein Kunde den Gutschein verwenden darf. | | Partner Gutschein – Verbiete Kombination mit anderen Gutscheinen | Schalter | Verbiete andere Promotion Aktionen im Warenkorb, wenn der Gutschein verwendet wird. | | Auszahlung als Gutschein | Schalter | Mit aktivierter Option können Partner die Provision als Gutschein einlösen. | | Auszahlung als Geld | Schalter | Ist diese Option aktiv, so können Partner die Provision als Geld auszahlen lassen. | | Auszahlung als Bonus Punkte | Schalter | Aktivieren Sie diese Option, so das Partner die Provision in Bonus Punkte umwandeln können. **Wichtig**: Das funktioniert nur, wenn unsere Bonus Punkte Erweiterung installiert ist. | | Gutscheine | Tabelle | Dieses Feld ist nur sichtbar, wenn die Option „Auszahlung als Gutschein“ aktiv ist. Sie können hier Gutscheine aus dem Bereich „Marketing -> Rabatte & Aktionen“ unter Angabe der Provision zuweisen, die ein Partner aufbringen muss, um den Gutschein zu kaufen. Bitte wählen Sie ausschließlich Gutscheine die unter „Aktionscodes -> Actionscodetypen“ den Wert „Individuelle Aktionscodes“ definiert haben. Erstellen Sie keine Rabattcodes dieser Kampagne manuell. Der Gutschein muss den Status „Aktiv“ haben, einem passenden Verkaufskanal zugewiesen sein und einen Rabatt haben. | | Auszahlungshöhe – Min. Betrag | Numerische Eingabe | Dieses Feld ist nur sichtbar, wenn die Option „Auszahlung als Geld“ aktiv ist. Definieren Sie hier die Höhe der Provision, die ein Partner mindestens haben muss, bevor eine Auszahlung möglich ist. | | Bonus Punkte – Punkte pro EUR | Numerische Eingabe | Dieses Feld ist nur sichtbar, wenn die Option „Auszahlung als Bonus Punkte“ aktiv ist. In dem Feld muss die Anzahl an Punkten angegeben werden, die ein Partner für 1 EUR Provision erhält. | | Bonus Punkte – Rundung | Numerische Eingabe | Dieses Feld ist nur sichtbar, wenn die Option „Auszahlung als Bonus Punkte“ aktiv ist. Geben Sie hier an, wie die Rundung zwischen Provision und Bonus Punkte erfolgen soll. | | | | | #### Erweiterte Provision
| Feld | Typ | Beschreibung | | ------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | Freitext | Vergeben Sie einen eindeutigen Namen für die „Erweiterte Provision“, beispielsweise „One time provision“. | | Produkt Gruppe | Dropdown | Wählen Sie eine „Dynamische Produktgruppe“ um einzustellen, welcher Produkte von den Provisionseinstellungen betroffen sind. | | Provision Typ | Dropdown | Wählen Sie, ob die Provision für eine Bestellung relativ oder absolut sein soll. | | Provision Faktor | Numerische Eingabe | Wählen Sie den Faktor für die Provision. Wenn Sie einen relativen „Provision Typ“ ausgewählt haben, dann bedeutet ein Wert von 5 beispielsweise 5% Provision auf den Bestellwert. Bei einer absoluten Provision, entspricht ein Wert von „5.91“ einer Provision von 5,91 EUR für Ihren Partner bei einer Bestellung. | | Provision nur für die ersten n-Bestellungen | Numerische Eingabe | Ein Wert größer 0 bedeutet, das Ihr Partner nur für die ersten n-Bestellungen Provision erhält. Bei einem Wert von 0 gibt es für alle zukünftigen Bestellungen Provision. | #### Löschen einer Partner Gruppe Um eine Partner Gruppe zu löschen, klicken Sie die drei Punkte in der Partner Gruppen Liste and wählen „Löschen“ aus.
Bitte beachten Sie: Die Erweiterungen benötigt eine Default Partner Gruppe um zu funktionieren. Es ist nicht möglich die Gruppe mit dem „Default“ Flag zu löschen. Wenn eine Partnergruppe gelöscht wird, bei der Partner zugeordnet sind, dann werden diese der Default Partnergruppe zugewiesen. ### Marketing Seite Optional können Sie für jede Partner Gruppe eine Seite mit Marketing Material anlegen. Diese Seite wird als Erlebniswelt erstellt und im Shopware Account Bereich angezeigt.
# Anzeige im Accountbereich Um den Kunden das **Affiliate System** im Account Bereich anzuzeigen, müssen die folgenden Einstellungen getätigt werden: 1. Die **Affiliate** Erweiterung muss installiert und aktiviert sein. 2. In den Einstellungen der Erweiterung, muss die Option **Plugin aktivieren** ausgewählt sein. 3. Das Registrierungsdatum des Kunden muss älter sein als die Anzahl Tage, die in den Einstellungen der Erweiterung bei **Benötigte Anzahl Tage registriert** gesetzt wurden. 4. **Benötigter Umsatz (in EUR)** in den Einstellungen der Erweiterung, muss durch den Umsatz des Kunden erreich sein. 5. Mindestens eine Kundengruppe muss bei **Erlaubte Kundengruppen** in den Einstellungen der Erweiterung gesetzt sein und der Kunde muss in dieser Kundengruppe sein. Wurde keine Kundengruppe gesetzt, so wird die Erweiterung niemandem angezeigt. # Provision freischalten Wird eine Bestellung getätigt, die dein Partner geworben hat, dann musst du die Provision erst genehmigen, bevor diese deinem Partner gutgeschrieben wird. Hierfür bietet unsere Erweiterung [verschiedene Automatismen](/plugins/affiliate-system/installation#provision-sammeln). Falls du diese nicht nutzen möchtest, dann musst du die Provision für jede [Bestellung manuell freischalten](/plugins/affiliate-system/verwaltungs-dashboard#manuelle-aktivierung-der-provision). # Registrierung als Partner Ein Partner muss immer als regulärer Kunde im Shop registriert sein. Um Partner zu werden, gibt es verschiedene Wege. ### Partnerbereich im Kunden Account Unabhängig, wie der Partner registriert wurde, ist in der Storefront der Partnerbereich im Accountbereich des Kunden zu finden. Du kannst einen Partner in der Admin anlegen, oder ein Kunde beantragt die Freischaltung als Partner im Accountbereich. ### Registrierung eines Partners über die Administration In der Shopware Administration findest du unter **Marketing -> Affiliate System -> Partner** die Liste aller Partner. Mittels des Button **Partner hinzufügen**, kannst du hier auch manuell neue Partner hinzufügen. Folgende Schritte sind hierfür erforderlich: 1. Klicke auf den Button **Partner hinzufügen**. 2. Wähle einen bestehenden Shop Kunden aus oder lege einen neuen an. 3. Lege einen Partner Code fest (Das ist der Code mit dem der Partner später neue Kunden werben kann) und weise den Partner einer **Partner Gruppe** zu. Im Standard ist immer die Gruppe **Default** verfügbar. 4. Klicke auf den Button **Speichern**. 5. Der Partner muss anschließend noch mittels Betätigen des Buttons **Freischalten** aktiviert werden. ### Registrierung des Partners über die Storefront Kunden können sich als Partner im Accountbereich der Storefront registrieren. Abhängig davon, wie du die Erweiterung konfiguriert hast, muss der Kunde eine Bewerbung schreiben, Partnerprogramm Bedingungen akzeptieren und auf eine Freischaltung warten. {% hint style="info" %} Mittels [Konfiguration der Erweiterung](/plugins/affiliate-system/installation#partner-registrierung) kannst du auch festlegen, unter welchen Bedingungen Kunden den Partnerbereich sehen und am Partnerprogramm teilnehmen können. {% endhint %} ### Warum wird der Partnerbereich nicht angezeigt? Damit der Partnerbereich in der Storefront deinen Kunden angezeigt wird, müssen bestimmte Voraussetzungen erfüllt sein: 1. Folge den Hinweisen unter [Anzeige im Accountbereich](/plugins/affiliate-system/anzeige-im-accountbereich). 2. Theme oder Drittanbieter Plugin 1. Wird der Bereich trotz aller erfüllter Bedingungen aus Punkt 1 nicht angezeigt? Logge dich im Accountbereich mit einem Kunden ein, der das Partnerprogramm eigentlich sehen müsste und rufe den Partnerbereich-Link mittels **\/account/affiliate** direkt auf. Ersetze hierbei \ mit der Domain deines Shops. Wenn der Link zum Partnerbereich führt, dann überschreibt das Theme oder ein anderes Plugin die Navigation im Accountbereich. 2. Deaktiviere testweise andere Plugins oder aktiviere das Standard Theme von Shopware. # E-Mails anpassen Die Affiliate System Erweiterung enthält E-Mail-Vorlagen für alle gängigen Szenarien, die du unter **Einstellungen** > **E-Mail-Templates** findest. Diese Vorlagen sind in der folgenden Tabelle beschrieben. {% hint style="info" %} **Wenn deine Shop Umgebung mehrere Sprachen unterstützt, sind für jede Sprache Vorlagen enthalten. Verwende das Dropdown-Menü für die Sprachauswahl, um zwischen den Sprachen zu wechseln.** {% endhint %}
| **E-Mail-Template** | **Beschreibung** | | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | | PremsAffiliate: Absage Info an Partner | Eine E-Mail die den Kunden darüber informiert, das seine Bewerbung als Partner abgelehnt wurde. | | PremsAffiliate: Auszahlung erfolgt Info an Partner | Diese E-Mail Vorlage informiert den Partner über seine Provisionsauszahlung. | | PremsAffiliate: Freischaltung Info an Partner | Mit dieser E-Mail wird der Kunde darüber informiert, das seine Bewerbung als Partner akzeptiert wurde. | | PremsAffiliate: Neuer Partnerantrag info an Admin | E-Mail Hinweis an den Shopbetreiber, das ein Kunde eine Bewerbung als Partner abgesendet hat. | | PremsAffiliate: Partner beantragt Auszahlung info an Admin | Beantragt ein Partner die Auszahlung seiner Provision, so wird diese E-Mail an den Shopbetreiber gesendet. | | PremsAffiliate: Partnercode-Änderung abgelehnt | Informiert einen Partner darüber, das seine angefragte Änderung des Affiliate Codes abgelehnt wurde. | | PremsAffiliate: Partnercode-Änderung angefordert | Info E-Mail an den Shopbetreiber, das ein Partner seinen Affiliate Code ändern möchte. | | PremsAffiliate: Partnercode-Änderung genehmigt | Mit dieser E-Mail wird der Partner darüber informiert, das seine angefragte Affiliate Code Änderung akzeptiert wurde. | Jede E-Mail-Vorlage kann bearbeitet, dupliziert oder gelöscht werden, indem du auf die entsprechende „**…**„-Menüschaltfläche für eine Vorlage klickst und **Bearbeiten**, **Duplizieren** oder **Löschen** auswählen, allesamt Standardoptionen der Shopware-Verwaltung. {% hint style="info" %} **Die Bearbeitung von E-Mail-Vorlagen ist ein optionaler, weiterführender Schritt und sollte nur dann durchgeführt werden, wenn die Standard-E-Mail-Vorlagen für deinen Shop nicht geeignet sind, z.B. um den Wortlaut anzupassen.** {% endhint %}
### Eine E-Mail-Vorlage bearbeiten Ändere auf der Seite E-Mail-Vorlage bearbeiten die Eigenschaften der E-Mail-Vorlage in den folgenden Feldern nach Bedarf und klicke dann auf **Speichern**. Alle dynamischen Elemente im Betreff und im Text der E-Mail können durch Strings wie **{{partner.customer.salutation.letterName }}** definiert werden. Hinweis: Die Änderung dieser Zeichenfolgen kann dazu führen, dass dynamische Elemente in E-Mails nicht korrekt angezeigt werden, z. B. der Name des Kunden. | **Einstellung** | **Bereich** | **Typ** | **Beschreibung** | | ----------------- | ----------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Typ | Information | Dropdown-Menü | Der Typ ist ein vordefinierter Wert, der zur Identifizierung des richtigen Szenarios für eine E-Mail-Vorlage erforderlich ist. **Ändere diese Einstellung nicht** für die Standard-E-Mail-Vorlagen, da dies zu Problemen mit der App führen wird. | | Beschreibung | Information | Freie Texteingabe | Geben eine optionale Beschreibung für die Vorlage ein. | | Betreff | Optionen | Freie Texteingabe |

Ändere den Standardtext der E-Mail-Betreffzeile Neues Angebot nach Bedarf.
Der String {{ offer.offerNumber }} ermöglicht die dynamische Anzeige der entsprechenden Angebotsnummer und sollte nicht geändert werden.

| | Absender | Optionen | Freie Texteingabe | Standard ist der String **{{ salesChannel.name }}**, der eine dynamische Anzeige des Vertriebskanals ermöglicht. Dies sollte nicht geändert werden. | | Dateien Hochladen | Anhänge | Datei-Explorer | Lade alle Dateien hoch, die du als Anhang für die aktuell ausgewählte E-Mail-Vorlage einfügen möchten, z. B. Geschäftsbedingungen oder eine Datenschutzrichtlinie. | | Text | Mail-Text | Freie Texteingabe | Ändere die Standard-Klartextversion des E-Mail-Textes. Hier gibt es verschiedene Strings, die dynamische Elemente im E-Mail-Text ermöglichen. Diese sollten nicht geändert werden. | | HTML | Mail-Text | Freie Texteingabe | Änder die Standard-HTML-Textversion des E-Mail-Textes. Hier gibt es verschiedene Zeichenketten, die dynamische Elemente im E-Mail-Text ermöglichen. Diese sollten nicht geändert werden. | ### Eine E-Mail-Vorlage duplizieren Wenn du die Option **Duplizieren** wählst, wird eine Kopie dieser E-Mail-Vorlage erstellt und der Bildschirm E-Mail-Vorlage bearbeiten geöffnet (siehe vorheriger Abschnitt). ### Eine E-Mail-Vorlage löschen **Lösche nicht die Standard-E-Mail-Vorlagen**, da dies zu Problemen mit der App führen würde. Alle zusätzlichen Vorlagen, die du erstellst, können ohne Probleme gelöscht werden. ### Flow Builder (E-Mails) Wann eine E-Mail gesendet wird und an welche Empfänger diese geht, wird komplett über den Flow Builder gesteuert. Der Flow Builder ist in der Shopware Admin zu finden unter **Einstellungen -> Shop -> Flow Builder**. Die Flow vom Affiliate System beginnen alle mit **PremsAffiliate**. Mit Klick auf die 3 Punkte, kann ein Flow editiert werden. In der Detailansicht im Tab **Flow**, kannst du die Auslöser und Aktionen festlegen. Um die Empfänger eine E-Mail zu ändern, klicke bei der Aktion **E-Mail verschicken** auf die 3 Punkte und wähle **Aktion bearbeiten**. In dem geöffneten Layer kannst Du den **Empfänger** verändern. # Affiliate Link und Gutschein Code Hier erfährst du, wie deine Partner neue Kunden werben können, wo der Affiliate-Link zu finden ist und wie der Gutschein-Code eingestellt werden kann. Deine Partner können grundsätzlich über zwei verschiedene Wege neue Kunden werben: * Dies kann über einen Affiliate-Link erfolgen, den deine Partner an potenzielle Kunden weitergeben. Sobald sich ein Neukunde über diesen Link registriert, wird er dem Partner zugewiesen. * Optional kannst du deinem Partner auch einen Gutschein-Code bereitstellen. Dieser Gutschein-Code kann von einem Partner für das Werben von Neukunden verwendet werden. Ein Neukunde erhält dann beispielsweise 5% Rabatt bei Nutzung des Gutscheincodes.\ Durch Eingabe des Gutscheincodes im Bestellprozess, wird der Neukunde automatisch dem Partner zugewiesen. ### Affiliate Link einrichten In der [Konfiguration der Erweiterung](/plugins/affiliate-system/installation#partner-registrierung), kannst du einstellen, ob ein Partner seinen Affiliate-Code selbst auswählen darf oder ob sein Code automatisch vergeben wird. Falls der Partner seinen Code selbst wählen darf, legt er diesen bei der Registrierung als Partner in der Storefront fest. Für die Registrierung benötigt der Partner ein bestehendes Kundenkonto, muss sich mit diesem einloggen und im Accountbereich als Partner registrieren. Bei Bedarf kannst du den Affiliate-Code jederzeit ändern. Klicke hierfür in der Shopware Administration **Marketing -> Affiliate System** bei einem Partner auf **...** und wähle **Editieren**.
{% hint style="info" %} Nach Änderung des Affiliate Codes können dem Partner keine Kunden mehr zugeordnet werden, die noch den alten Code verwenden. Dies kann dann der Fall sein, wenn etwaige Neukunden den alten Link vom Partner zugesendet und noch nicht verwendet haben, oder wenn ein Kunde bereits auf den alten Link geklickt, sich aber noch nicht registriert hat und dies dann zu einem späteren Zeitpunkt nachholt. {% endhint %} ### Affiliate-Link Weiterleitungsziel Standardmäßig wird der Affiliate-Link auf die Startseite weitergeleitet.\ Unter **Marketing → Affiliate-System → Partnergruppe** kann definiert werden, wohin der Affiliate-Link weiterleiten soll. * Produkt * Kategorie
### Affiliate Link finden Klicke in der Shopware Administration **Marketing -> Affiliate System** bei einem Partner auf **...** und wähle **Anzeigen** oder **Editieren**.
Der vollständige Affiliate-Link wird deinem Partner in der Storefront unter **Account -> Partnerprogramm** angezeigt.
### Gutschein Code einrichten Ob ein Partner Gutschein-Codes verwenden darf, um neue Kunden zu werben, legst du je Partner Gruppe fest. Öffne hierzu in der Shopware Administration unter **Marketing -> Affiliate System -> Partner Gruppe** mit Klick auf **...** und Klick auf **Editieren** die jeweilige Partner Gruppe. Aktiviere im Bereich **Partner Gutschein** die Einstellung **Gutschein aktivieren**.
Alle weiteren Einstellungen sind vordefiniert und geben vor, welche Eigenschaften der Gutschein haben soll, sobald dieser für den Partner generiert wird. Es handelt sich um einen regulären Gutschein, der unter **Marketing -> Rabatte & Aktionen** angelegt wird. Weiterführende Informationen zu den Einstellungsmöglichkeiten findest du auch [hier](/plugins/affiliate-system/verwaltungs-dashboard#partner-gruppe). {% hint style="info" %} Nutze die Option **Max. Nutzung pro Kunde**, um sicherzustellen, dass ein neu geworbener Kunde den Gutschein-Code nicht beliebig oft nutzen darf. {% endhint %} Nachdem du die Möglichkeit der Gutscheine aktiviert hast, kannst du bei allen Partnern, die der jeweiligen Partner Gruppe zugeordnet sind, den Gutschein generieren oder einen bestehenden Gutschein zuweisen. Klicke hierfür in der Shopware Administration **Marketing -> Affiliate System** bei einem Partner auf **...** und wähle **Editieren**.
{% hint style="info" %} Wenn du den Gutschein selbst anlegst und keinen automatisch generierten nutzt, stelle bitte sicher, dass du mit einem festen Gutscheincode arbeitest. Außerdem sollte der Gutschein nicht durch Regeln eingeschränkt sein. {% endhint %} ### Gutschein Code finden Es gibt zwei Möglichkeiten, den Gutschein-Code anzuzeigen. Deine Partner können das in der Storefront im Partnerbereich tun, der nach dem Login angezeigt wird.
Als Admin kannst du dir den Code in der Shopware Administration ansehen. Öffne hierzu in der Shopware Administration unter **Marketing -> Affiliate System -> Partner Gruppe** mit Klick auf **...** und Klick auf **Editieren** die jeweilige Partner Gruppe. Klicke dann auf den Link des Gutscheins.
Es öffnet sich der passende Gutschein aus dem Bereiche **Marketing -> Rabatte & Aktionen**. # Auto-Complete und Validierung ### Einführung Mit der App für die automatische Vervollständigung und Validierung von Benutzerdaten für Shopware kannst du die Zahl der Kundenanmeldungen erhöhen und die Qualität der erfassten Kundendaten verbessern.
Dank des intelligenten und dynamischen App-Designs müssen neue Kunden das Formular nicht mehr manuell ausfüllen, was den Anmeldeprozess erheblich vereinfacht. Darüber hinaus sorgen die bereitgestellten Validierungskontrollen dafür, dass die erfassten Informationen viel genauer sind, was bedeutet, dass später keine Änderungen erforderlich sind und keine Probleme beim Erreichen der Kunden nach dem Verkauf auftreten ### Voraussetzungen Die App kann nur in einer selbstverwalteten Shopware-Umgebung mit mindestens Version 6.2.0 installiert werden. {% hint style="warning" %} **Important notice!** Der alte `AutocompleteService` wurde durch den neuen `AutocompleteSuggestion` ersetzt. Für diese Änderung muss die **Places API (New)** im Google-Konto aktiviert sein. {% endhint %} #### Generieren und Konfigurieren von Google API-Schlüsseln Für die App sind zwei Google-API-Schlüssel (sowie ein Google-Konto) erforderlich, da es zwei Google-Dienste in Anspruch nimmt. * Der **erste API-Schlüssel** ist für die automatische Vervollständigung der Adressdaten erforderlich und muss mit der **Domain deines Shops** verschlüsselt werden. * Der **zweite API-Schlüssel** wird für die Adress-Existenzprüfung benötigt und muss mit der **IP-Adresse deines Shops** geschützt werden. Befolge diese Schritte, um die Google-API-Schlüssel zu generieren und zu konfigurieren: 1. Melde dich bei der [Google Konsole](https://console.cloud.google.com/) an. Wenn du noch kein Google-Konto hast, [erstelle zunächst eines](https://support.google.com/accounts/answer/27441?hl=en). 2. Wähle ein Projekt aus.\ \&#xNAN;*Wenn du noch kein Projekt erstellt hast, klicke auf **Mein erstes Projekt** und dann auf **NEUES PROJEKT.** Gib einen Namen für dein Projekt ein und klicke auf **ERSTELLEN**.* 3. Klicke im Projekt-Dashboard auf das Navigationsmenü oben links, wähle dann **APIs & Dienste** und anschließend **Anmeldedaten**. 4. Wähle **Anmeldedaten erstellen > API-Schlüssel**, um den **ersten API-Schlüssel** zu erstellen. 5. Click **Restrict Key** and then **HTTP referrers.** Enter your shop domain in the format: **\*.shopdomain.de**, then click **SAVE**. 6. Klicke im Projekt-Dashboard auf das Navigationsmenü oben links, wähle dann **APIs & Dienste** und anschließend **Anmeldeinformationen**. 7. Wähle **Anmeldedaten erstellen > API-Schlüssel**, um den **zweiten API-Schlüssel** zu erstellen. 8. Klicke auf **Schlüssel einschränken** und dann auf **IP-Adressen**. Gib die **IP-Adresse deines Shops** ein und klicke dann auf **SPEICHERN**. **Notiere dir deine beiden API-Schlüssel, einschließlich des jeweiligen Schlüssels, da du sie später benötigen wirst. Du kannst jederzeit zur Google-Konsole zurückkehren, um deine API-Schlüssel zu verwalten oder abzurufen.** {% hint style="info" %} Unsere Erweiterung nutzt die **Geocoding API**, die **Maps JavaScript API** und die **Places API**. Du kannst den API-Schlüssel bei Bedarf auf diese drei APIs einschränken. {% endhint %} #### Google API-Abrechnung aktivieren Einige der für die App erforderlichen Google-APIs sind kostenpflichtig, daher musst du die Abrechnung für dein Konto aktivieren, bevor du sie nutzen kannst. Folge diesen Schritten: 1. Melde dich bei der [Google Konsole](https://console.cloud.google.com/) an. 2. Wähle aus der Projektliste das Projekt aus, das du verwenden möchtest. 3. Rufe das Menü auf der linken Seite auf und wähle **Billing**. 4. Klicke auf **Abrechnung aktivieren**. Hinweis: Wenn die Rechnungsstellung bereits aktiviert ist, ist diese Option nicht verfügbar. 5. Wenn du noch kein Rechnungskonto hast, erstelle eines. 6. Wähle deinen Standort, fülle das Formular aus und klicke dann auf **Senden** und aktiviere die Rechnungsstellung. #### Aktiviere die erforderlichen APIs für dein Google API-Projekt Durch die Aktivierung einer Google-API wird diese mit dem aktuellen Projekt verknüpft, es werden Überwachungsseiten hinzugefügt und die Abrechnung für diese API wird aktiviert (sofern die Abrechnung für das Projekt aktiviert ist). So aktivierst du eine API für dein Projekt: 1. Melde dich bei der [Google Konsole](https://console.cloud.google.com/) an. 2. Wähle aus der Projektliste das Projekt aus, das du verwenden möchtest. 3. Wenn die Seite APIs & Dienste nicht bereits geöffnet ist, öffne das Menü auf der linken Seite und wähle **APIs & Dienste** und dann **Bibliothek**. 4. Wähle die folgenden APIs aus: **Maps**, **Places** und **Geocoding**. 5. Klicke auf **AKTIVIEREN**. ### Einrichtung Installiere die App durch **Erweiterungen** > **Meine Erweiterungen**. Nach der Installation konfigurierst du die App, indem du **Meine Erweiterungen** > **AutoComplete und Validierung für Benutzerdaten** > **Konfiguration** wählst. Gib einen **Verkaufskanal** an, für den die App aktiviert werden soll. Die Standardeinstellung ist Alle Verkaufskanäle. ### Allgemeine Eigenschaften Die optionale Einstellung **Auto-Complete Validierung auf Länder beschränken** ermöglicht es dir, die Adressüberprüfung auf bestimmte Länder oder geografische Regionen zu begrenzen. Dies kann nützlich sein, wenn du in Ländern tätig bist, in denen Google nur über begrenzte Adressdaten verfügt. Verwende das Mehrfachauswahlfeld, um nur die Länder auszuwählen, für die du die Adressvalidierung anwenden möchtest. Klicke auf **Speichern**, um deine Änderungen zu speichern ### API-Zugangsdaten Stelle sicher, dass du zuerst deine Google API-Schlüssel generiert und konfiguriert hast, wie unter [Generieren und Konfigurieren von Google API-Schlüsseln](#google-api-keys). 1. Kopiere den ersten Schlüssel und füge ihn in das Feld **Google API Key 1** ein. 2. Kopiere den zweiten Schlüssel und füge ihn in das Feld **Google API Key 2** ein. 3. Klicke auf **Speichern**, um deine Änderungen zu speichern. **Dieser Schritt ist obligatorisch. Ohne gültige Google-API-Schlüssel funktioniert die App nicht korrekt.** ### Eigenschaften der automatischen Vervollständigung Mit den Eigenschaften der Autovervollständigung kannst du steuern, inwieweit die Felder automatisch mit Informationen gefüllt werden, wenn der Benutzer das Formular ausfüllt. | **Einstellung** | **Typ** | **Beschreibung** | | -------------------------------------------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Sprache | Freie Texteingabe | Legt die Sprache der App fest. Gib ein Länderkürzel ein, z.B. EN für Englisch, DE für Deutsch, IT für Italienisch, usw. | |

Anzahl Vorschläge für Autocomplete Strasse

| Numerische Eingabe | Legt die Anzahl der vorgeschlagenen Straßennamen fest, die auf der Grundlage der Benutzereingabe unter dem Feld „Straße“ angezeigt werden. | | Plz, Ort, Land immer neu befüllen | KippSch. | Aktiviere diese Einstellung, um Felder automatisch zu aktualisieren, wenn neue Informationen vom Benutzer eingegeben werden. | | Ort vorschlagen | KippSch. | Aktiviere diese Einstellung, um auf der Grundlage der vom Benutzer eingegebenen Informationen automatisch eine Stadt vorzuschlagen. | | Automatische Großschreibung Anfangsbuchstaben | KippSch. | Aktiviere diese Einstellung, um automatisch den ersten Buchstaben der vom Benutzer in Felder wie den Straßennamen eingegebenen Informationen groß zu schreiben. | | Korrektur Großschreibung Anfangsbuchstabe Strasse deaktivieren | KippSch. | Aktiviere diese Option, um die automatische Großschreibung für den ersten Buchstaben der Straße zu deaktivieren. | | Korrektur Großschreibung Anfangsbuchstabe Ort deaktivieren | KippSch. | Aktiviere diese Option, um die automatische Großschreibung für den ersten Buchstaben der Stadt zu deaktivieren. | | Standard Land | Dropdown-Menü | Wähle das Standardland aus dem Dropdown-Menü. Der Benutzer kann dies außer Kraft setzen, indem er ein anderes Land auswählt. | ### Validierung Einstellungen Mit den Überprüfungseigenschaften kannst du steuern, inwieweit die Überprüfung auf Felder angewendet wird, in die der Benutzer seine Informationen eingibt. | **Einstellung** | **Typ** | **Beschreibung** | | ------------------------------------------------------------ | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Telefonnummer validieren | KippSch. | Aktiviere diese Einstellung, um automatisch das Format der Telefonnummer zu überprüfen, um sicherzustellen, dass sie eine Vorwahl hat und die richtige Länge. | | Telefonnumernvalidierung Regex | Freie Texteingabe | Gib hier einen benutzerdefinierten Regex-Wert für die benutzerdefinierte Telefonnummernüberprüfung ein (die obige Einstellung muss aktiviert sein, damit dies angewendet werden kann). | | Button bei Fehler deaktivieren | Toggle | Aktiviere diese Einstellung, um die Schaltfläche **Weiter** zu deaktivieren, wenn das Formular Validierungsfehler enthält. | | Neupositionieren Land, PLZ, Strasse | KippSch. | Um die Reihenfolge der Felder zu ändern, wähle eine der verfügbaren Optionen aus dem Dropdown-Menü. Die Standardoption mit dem Land an erster Stelle wird empfohlen, da dies zu einer höheren Anmeldequote führt. | | Hausnummerneingabe validieren | Toggle | Aktiviere diese Einstellung, um automatisch zu prüfen, ob die vom Benutzer eingegebene Straßennummer für diese Straße gültig ist. | | Mindestlänge der Straße bevor die Hausnummernprüfung startet | Freie Texteingabe | Gib hier einen numerischen Wert für die Anzahl der Zeichen ein, die der Benutzer eingeben muss, bevor die Überprüfung der Straßennummer beginnt. | | Adressenexistenz prüfen | KippSch. | Aktiviere diese Einstellung, um automatisch zu prüfen, ob die vom Benutzer eingegebene Adresse gültig ist (z.B. ob sie existiert). | | Passwortstärke anzeigen | KippSch. | Aktiviere diese Einstellung, um eine Anzeige unter dem Passwortfeld einzublenden, die dem Benutzer zeigt, wie „stark“ (sicher) das Passwort ist. | # Interaktive Hotspots ### Einführung Mit der Erweiterung Interaktive Hotspots für Shopware 6 kannst du ein einzelnes Foto mit Links zu verwandten Produkten in deinem Katalog anreichern, so dass deine Kunden sehen können, wie gut sich die einzelnen Produkte gegenseitig ergänzen.
Das gezeigte Beispiel eines modernen Wohnzimmers ist ein Blickfang, der mehrere Produkte im Raum zum Kauf anbietet. Kunden, die zum Beispiel ein neues Sofa suchen, werden durch eine solche Szene inspiriert und kaufen aufgrund der Präsentation mit größerer Wahrscheinlichkeit weitere ergänzende Produkte. Interactive Hotspots bietet auch eine viel effizientere Methode des Einkaufens. Die Kunden können ganze Einkaufswelten besuchen und müssen nicht mehr durch viele ähnliche Produkte blättern und ihre Vorstellungskraft einsetzen, um sie im Zusammenhang zu sehen. Interaktive Hotspots ist eine höchst individualisierbare App, die externe Links zu Produktbeschreibungen, Übersichtsseiten, Social-Media-Profilen oder jede anderen denkbaren Webseite ermöglicht, sowie ansprechende Mouseover-Effekte und attraktive Overlays bietet. Lade einfach dein Szenenbild hoch, definiere deine Produkt-Hotspots und gestalte deinen Shop um – alles mit wenigen Klicks. ### Voraussetzungen Die App kann nur in einer selbst verwalteten Shopware-Umgebung installiert werden, in der mindestens die Version 6.2.0 läuft. ### Installation Installiere die App auf die übliche Weise über Shopware „Meine Erweiterungen“. **Im Gegensatz zu anderen App muss die App für Interaktive Hotspots nach der Installation nicht konfiguriert werden. Du kannst sofort mit der Erstellung von Layouts mit Hotspots beginnen.** ### Ein interaktives Einkaufserlebnis schaffen #### Ein neues Layout erstellen Um mit der App für Interaktive Hotspots zu beginnen, erstelle zunächst wie folgt ein neues Layout: 1. Wähle in deinem Shopware Admin Dashboard **Inhalte** > **Erlebniswelten**. 2. Wähle **Neues Layout anlegen** und dann **Shopseite.** Wähle **Volle Breite**. 3. Klicke auf das **+** Symbol auf der rechten Seite, um einen neuen Block hinzuzufügen, und wähle für die Blockkategorie **Text & Bilder**. 4. Suche den Block **Interaktive Hotspots** am unteren Rand und ziehe ihn in den Hauptarbeitsbereich. 5. Um die Basis-Informationen zu ändern (z. B. den Layout-Namen), klicke jederzeit auf das **Zahnradsymbol** **⚙**. Klicke auf **Speichern**, um deine Änderungen zu speichern.
Ihr Layout für die interaktiven Hotspots kann nun angepasst werden. #### Bild hinzufügen Bewege den Mauszeiger über den Block Interaktive Hotspots und klicke auf das **Zahnradsymbol** **⚙** in der oberen rechten Ecke, um das Fenster Elementeinstellungen zu öffnen (Registerkarte Basis Einstellungen).
* Um ein vorhandenes Bild für das interaktive Einkaufserlebnis zu verwenden, klicke auf **Medien öffnen**. Wähle ein geeignetes Bild aus der Medienbibliothek aus. * Um ein neues Bild hochzuladen, klicke auf **Datein hochladen** und suche das gewünschte Bild auf deinem lokalen Rechner oder im Netzwerk.
#### Basiseinstellungen definieren Nachdem du ein Bild für dein interaktives Einkaufserlebnis hinzugefügt hast, aktiviere oder deaktiviere die folgenden Einstellungen nach Bedarf: * **Zeige Hotspot Liste unter dem Bild:** Zeigt eine Liste aller Hotspots unter dem Hauptbild an**.** * **Bei Klick zu Listeneintrag blättern**: Automatisch zum entsprechenden Listeneintrag blättern, wenn der Benutzer auf einen Hotspot klickt. #### Hotspot hinzufügen Klicke im Fenster Elementeinstellungen / Basiseinstellungen auf **Hotspot hinzufügen**, um die neue Registerkarte „Hotspot 1“ hinzuzufügen. Klicke erneut auf **Hotspot hinzufügen**, um einen weiteren Hotspot hinzuzufügen (mit fortlaufender Nummerierung), bis du die erforderliche Anzahl an Hotspots hast. Klicke auf die entsprechende **Registerkarte des Hotspots**, um dessen Einstellungen zu ändern, die in den folgenden Abschnitten beschrieben werden. Um einen Hotspot zu entfernen, klicke auf der entsprechenden Hotspot-Registerkarte auf **Hotspot entfernen**. Nachdem du eine der folgenden Hotspot-Einstellungen geändert hast, klicke auf **Fertig**, um das Fenster zu schließen. #### Hotspot-Position festlegen Die Hotspot-Position ist die Position des anklickbaren Elements, mit dem der Benutzer interagiert. Standardmäßig wird der Hotspot als blau-weißer Kreis vor dem Hauptbild angezeigt, das Aussehen ist jedoch vollständig anpassbar.
* Am einfachsten kannst du eine neue Hotspot-Position festlegen, indem du auf eine beliebige Stelle des Hauptbildes klickst. Die Hotspot-Markierung wird an diese Stelle verschoben. * Alternativ kannst du auch die **X-** und **Y-Koordinaten** für den Hotspot in die beiden Felder unter dem Hauptbild eingeben. #### Hotspot-Farben festlegen Jeder Hotspot-Marker hat zwei Farben: **Hintergrund** (der größere äußere Kreis) und **Symbol** (der kleinere innere Kreis). Für den Fall, dass der Benutzer mit Mauszeiger über den Hotspot fährt, kannst du auch verschiedene Farben definieren; diese werden mit dem Wort **Mouseover** unterschieden. Um diese Farben zu definieren, verwende die entsprechenden Farbwähler oder gib für jedes der folgenden Felder einen hexadezimalen Wert ein: * Hintergrund Farbe * Hintergrund Farbe Mouseover * Symbol Farbe * Symbol Farbe Mouseover #### Hotspot-Design einstellen Über das Dropdown-Menü kannst du zwischen zwei Designs wählen: * **Standard**: die Standard-Hotspot-Markierung ohne zusätzlichen Text. * **Zeichen**: Wähle diese Option, um der Hotspot-Markierung eine Textbeschriftung hinzuzufügen. Füge in dem Feld **Beschriftung** einen beliebigen Text hinzu.
#### Animationsstile festlegen Du kannst auf jeden Hotspot-Marker einen anderen Animationsstil anwenden, um deine Kunden anzulocken. Du kannst aus vier Animationsstilen wählen: * Pulse * Heartbeat * Energize * Resonate Probiere jede der Animationen aus und schau, welche du bevorzugst, oder verwende eine Kombination aus ihnen für deine Hotspots. #### Overlay hinzufügen Füge dem Hotspot optional ein Overlay hinzu, das ein Textfeld erscheinen lässt, wenn der Nutzer mit dem Mauszeiger darüber fährt. Das Overlay kann verwendet werden, um ein Produkt weiter zu bewerben und auf es aufmerksam zu machen.
1. Aktiviere den Schalter **Overlay anzeigen**. 2. Gib einen **Overlay Titel** und einen **Overlay Text** in die beiden unteren Felder ein. Das gesamte Overlay wird auch ein anklickbarer Link sein, den du in den Link-Feldern definierst (beschrieben im nächsten Abschnitt). #### Link hinzufügen Durch Hinzufügen eines Links zum Hotspot kannst du Kunden zu einem bestimmten Produkt in deinem Shop oder zu einer bestimmten Webseite leiten. Folge diesen Schritten: 1. Wähle für den **Link-Typ** entweder **Extern** (für einen Link zu einer bestimmten Webseite) oder **Produkt** (für einen Link zu einem bestimmten Produkt). 2. Lege den Zielort des Links fest, wenn er angeklickt wird. Wenn der Link extern ist, gib die Adresse in das Feld **Link URL** ein**.** Wenn der Link auf ein bestimmtes Produkt verweist, wähle das **Produkt** aus dem Dropdown-Menü. 3. Gib den **Link Text** ein. 4. Lege das **Link Ziel** fest: entweder **Aktuelles Fenster** oder **Neues Fenster** (empfohlen, da die Besucher sonst möglicherweise von deinem Shop weg navigieren). # Größe Hotspot Markierungen anpassen Wir nutzen feste Größen für die Hotspot Markierungen. Wenn du diese ändern möchtest, dann wird CSS Code benötigt. ``` .container-point { width: 50px; height: 50px; } .container-point .point .point-content { width: 40px; height: 40px; } ``` # One Page Checkout Mit der One Page Checkout Erweiterung für Shopware 6 wird der Checkout Prozess von Shopware optimiert. Dies kann zu einer besseren Conversion-Rate und einem positiven Einkaufserlebnis beitragen.
Ein One-Page-Checkout in einem Online-Shop bietet viele Vorteile: 1. **Benutzerfreundlichkeit**: Der Checkout-Prozess ist einfach und übersichtlich, was die Benutzererfahrung verbessert. Kunden müssen nicht zwischen mehreren Seiten navigieren, was oft frustrierend sein kann. 2. **Zeiteinsparung**: Da alle erforderlichen Informationen auf einer Seite eingegeben werden, können Kunden ihren Einkauf schneller abschließen. Dies reduziert die Wahrscheinlichkeit, dass sie den Checkout-Prozess abbrechen. 3. **Weniger Abbrüche**: Ein kürzerer und unkomplizierter Checkout-Prozess kann dazu beitragen, die Abbruchrate zu verringern. Wenn Kunden alle Informationen auf einer Seite sehen, fühlen sie sich oft sicherer und motivierter, den Kauf abzuschließen. 4. **Bessere Übersicht**: Kunden haben eine klare Übersicht über ihre Bestellung, einschließlich der gewählten Produkte, der Versandoptionen und der Gesamtkosten. Dies kann das Vertrauen in den Kaufprozess stärken. # Voraussetzungen Diese Erweiterung kann nur in einer selbst verwalteten Shopware-Umgebung mit mindestens Version 6.0.0 installiert werden. # Installation Installiere die Erweiterung unter **Erweiterungen** > **Meine Erweiterungen**. Gebe nach der Installation einen **Verkaufskanal** an, für den die Erweiterung aktiviert werden soll. Die Standardeinstellung ist Alle Verkaufskanäle. ### Grundlegende Konfiguration Bevor du die App aktivierst, überprüfe die Einstellungen in diesem Abschnitt und stelle sicher, dass sie deinen Anforderungen entsprechen. Nehme Änderungen an den einzelnen Feldern wie unten beschrieben vor, indem Du **Meine Erweiterungen** > **One Page Checkout** > **Konfigurieren** wählst.
Gebe zunächst einen **Verkaufskanal** an, für den die App aktiviert werden soll. Die Standardeinstellung ist Alle Verkaufskanäle. ### Allgemeine Einstellungen Die allgemeinen Eigenschaften bieten grundlegende Steuerelemente, wie z. B. die Aktivierung/Deaktivierung der Erweiterung und die Anzeige bestimmter Elemente. | **Feld** | **Typ** | **Beschreibung** | | --------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | OnePageCheckout aktivieren | KippSch. | Legt fest, ob die Erweiterung für den jeweiligen Verkaufskanal genutzt werden soll. | | Registrierung vor Login | KippSch. | Wenn aktiviert, wird die Registrierung vor dem Login gezeigt. | | Zeige Feldüberschriften beim Registrierungsformular | KippSch. | Wähle, ob über den Formularfeldern Überschriften gezeigt werden sollen. Ansonsten werden nur Platzhaltertext in leeren Formularfeldern angezeigt. | | Registrierungsfelder vorausfüllen | KippSch. | Wenn aktiviert, werden die Registrierungsfelder vorausgefüllt, sobald Daten in der Session vorhanden sind. | | AGB über Bestellen Button anzeigen | KippSch. | Wenn aktiviert, werden die AGBs über dem Bestellen angezeigt. Ansonsten über den 3 Schritten. | | Anrede deaktivieren | KippSch. | Das Dropdown für die Anrede, kann mit dieser Einstellung ausgeblendet werden. | | Nur Gastbestellungen | KippSch. | Ist diese Option aktiv, dann können Kunden als als Gast bestellen. | | Checkbox für AGB verstecken | KippSch. | Legt fest, ob die AGBs bestätigt werden müssen oder nicht. | | Widerrufsbelehrung Checkbox anzeigen | KippSch. | Zeigt zusätzlich zur Widerrufsbelehrung im Checkout eine Checkbox an. | | Gutschein hinzufügen im Checkout | KippSch. | Aktiviert die "Gutschein hinzufügen" Funktion im Checkout. | | Bundeslandauswahl im Checkout deaktivieren | KippSch. | Ist die Option aktiv, so wird das Auswahlfeld für Bundesländer nicht mehr angezeigt. Bitte diese Option nur aktivieren, wenn Bundesländer nicht als Pflichtfeld eingestellt sind. | | Link im Checkout bei Produkten | Dropdown | Wähle hier ob sich die Verlinkung von Produkten wie im Standard verhalten soll, die Produkte immer mit der Produktdetailseite verlinkt sind oder stattdessen Basis Infos in einem Modal Fenster angezeigt werden sollen. | ### Newsletter Einstellungen Die Einstellungen in diesem Bereich beziehen sich darauf, ob sich Nutzer zum Newsletter anmelden können. | **Feld** | **Typ** | **Beschreibung** | | -------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Newsletter Checkbox anzeigen | KippSch. | Legt fest, ob sich Kunden direkt mit Bestätigung einer Checkbox für den Newsletter registrieren können. Diese Funktion ist nur für den Shopware Standard geeignet. Das heißt wenn E-Mail Adressen in Shopware abgelegt werden. | | Newsletter Checkbox für Gäste zulassen | KippSch. | Wenn aktiviert, dann können sich auch Gäste für die Newsletter Liste anmelden. | ### Layout Einstellungen Hier kannst Du ein paar Layout Einstellungen für den One Page Checkout vornehmen. | | | | | -------------------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Feld** | **Typ** | **Beschreibung** | | Rahmen nicht anzeigen | KippSch. | Die Aufteilung des Checkouts erfolgt in drei Spalten. Normalerweise ist jede Spalte mit einem Rahmen eingegrenzt. Mit Aktivierung der Option, wird der Rahmen ausgeblendet. | | Rahmen des Warenkorbs anzeigen | KippSch. | Nach Aktivierung dieser Einstellung, wird der Warenkorb mit einem zusätzlichem Rahmen hervorgehoben. | | Schritte immer vertikal darstellen | KippSch. | Normalerweise werden die Checkout Schritte bei ausreichend Platz nebeneinander dargestellt und brechen erst bei kleineren Auflösungen um. Ist diese Option aktiviert, so werden die Schritte immer untereinander dargestellt. | | Produkte im Checkout zugeklappt | KippSch. | Normalerweise werden in der Bestellzusammenfassung alle Produkte gezeigt. Mit dieser Option sind diese standardmäßig zugeklappt. Dies bietet sich an, wenn in der Regel sehr viele Positionen gleichzeitig gekauft werden. | | Standardmäßig ausgeklappte Produkte anzeigen | KippSch. |

Diese Option funktioniert nur in Verbindung mit der aktivierten Option Produkte im Checkout zugeklappt.
Ist diese Option aktiv, dann kann die Produktliste zuegklappt werden, ist standarmäßig aber aufgeklappt.

| | Schritt 2 und 3 ausgrauen | KippSch. | Wenn aktiviert, wird Schritt 2 und Schritt 3 vor dem Login/ Registrierung ausgegraut. | | Zusätzliche Informationen Position | Dropdown |

Lege fest wo der Block Zusätzliche Informationen angezeigt werden soll.
Die Einstellung Shopware Standard zeigt dies über dem Bestellen Button an wohingegen Unterhalb des Titels "Schritt 3" diesen Bereich unter den Titel der Spalte verschiebt.

| | Anzahl der Zahlungsmethoden, die direkt angezeigt werden | Numerische Eingabe | Bei einer größeren Menge an Zahlungsmethoden, kürzt Shopware diesen Bereich und weitere Zahlungsmethoden werden erst nach Klick auf einen **Mehr anzeigen** Link gezeigt. Lege hier genau fest, wie viele Zahlungsmethoden auf den ersten Blick sichtbar sein sollen. | ### Zusätzliche Checkbox Legt die Einstellungen fest, ob eine weitere Checkbox im Checkout angezeigt werden soll. | **Feld** | **Typ** | **Beschreibung** | | ----------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Zusätzliche Checkbox im Checkout anzeigen | KippSch. | Zeigt eine zusätzliche Checkbox im Checkout an. Hier kannst du beispielsweise die Zustimmung zu Marketing Zwecken einfordern. Der Text kann über den Textbaustein 'additionalCheckbox' beliebig angepasst werden. | | Pflichtfeld | KippSch. | Legt fest ob die Checkbox ein Pflichtfeld ist. | | Label Text in Administration | Textfeld | Gib hier den Text ein unter dem die Checkbox in der Admin angezeigt werden soll. | ### Drittanbieter Erweiterungen Mit den Einstellungen in diesem Bereich kann das Verhalten von Drittanbieter Erweiterungen gesteuert werden. | | | | | ------------------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Feld** | **Typ** | **Beschreibung** | | PayPal Express Button Position | Dropdown | Wird das PayPal Plugin versendet, so kann ausgewählt werden, ob der PayPal Button oberhalb des "Login/ Registrieren" Bereich oder unterhalb des "Login" Buttons angezeigt werden soll. | # Wunschlisten für Shopware 6 Die Wunschlisten Erweiterung fügt deinem Online Shop die Möglichkeit hinzu, das Kunden beliebig viele öffentliche und private Wunschlisten erstellen können.
#### **Vorteile für Kunden:** ✅ **Mehr Flexibilität durch unbegrenzte Wunschlisten**\ – Kunden können Wunschlisten für verschiedene Anlässe erstellen (z. B. „Weihnachtsgeschenke“, „Technik-Gadgets“, „Kleidung für den Sommer“). ✅ **Bessere Kaufplanung & Organisation**\ – Kunden müssen nicht sofort kaufen, sondern können Produkte übersichtlich speichern und später entscheiden. ✅ **Einfache Geschenkplanung & Teilen mit anderen**\ – Öffentliche Wunschlisten ermöglichen es, Wünsche direkt mit Freunden oder Familie zu teilen, ideal für Geburtstage, Hochzeiten oder Weihnachten. ✅ **Schnelles Wiederfinden von Produkten**\ – Gespeicherte Produkte können einfach in den Warenkorb gelegt werden, ohne sie erneut suchen zu müssen. #### **Vorteile für den Online-Shop:** 📈 **Höhere Kaufabschlüsse & Conversion-Rate**\ – Kunden kehren eher zurück, um Produkte von ihrer Wunschliste zu kaufen. 📊 **Wertvolle Einblicke in Kundeninteressen**\ – Händler können analysieren, welche Produkte häufig gespeichert werden, um Bestseller besser zu erkennen oder gezielte Rabatte anzubieten. 📣 **Kostenlose Werbung durch Teilen öffentlicher Wunschlisten**\ – Kunden bewerben Produkte indirekt, indem sie Wunschlisten mit Freunden oder in sozialen Netzwerken teilen. 👥 **Steigerung der Kundenbindung**\ – Wunschlisten motivieren Kunden, den Shop regelmäßig zu besuchen und sich aktiv mit den Produkten auseinanderzusetzen.\ \ **Fazit:**\ \ Die Wunschlisten-Funktion schafft eine Win-Win-Situation: Kunden profitieren von einer besseren Organisation und einfacheren Kaufentscheidungen, während der Händler durch höhere Verkäufe, mehr Traffic und wertvolle Daten zur Kundenanalyse profitiert. 🚀 # Voraussetzungen Die Erweiterung kann nur in einer selbst verwalteten Shopware-Umgebung mit mindestens Version 6.0.0 installiert werden. # Installation Installiere die Erweiterung durch **Erweiterungen** > **Meine Erweiterungen**. Ab Shopware 6.4: Bitte den Shopware eigenen Merkzettel unter "Einstellungen -> Warenkorb -> Merkzettel" deaktivieren. Die Erweiterung hat zwei Aspekte: * Basiskonfiguration * Verwaltungs-Dashboard Führe zunächst die Schritte im Abschnitt **Basiskonfiguration** aus und lese dann den Abschnitt **Verwaltungs-Dashboard**, um zu erfahren, wie du die Erweiterung fortlaufend verwalten kannst. ### Basiskonfiguration Bevor du die Erweiterung aktivierst, überprüfe die Einstellungen in diesem Abschnitt und stelle sicher, dass diese deinen Anforderungen entsprechen. Nimm Änderungen an den einzelnen Feldern wie unten beschrieben vor, indem du **Meine Erweiterungen** > **Wunschlisten für Shopware 6** > **Konfigurieren** wählst.
Gib zunächst einen **Verkaufskanal** an, für den die Erweiterung aktiviert werden soll. Die Standardeinstellung ist **Alle Verkaufskanäle**. ### Allgemeine Einstellungen Die allgemeinen Eigenschaften bieten grundlegende Steuerelemente, wie z. B. die Aktivierung/Deaktivierung der Erweiterung und die Festlegung der Sichtbarkeit von Daten. | Feld | Typ | Beschreibung | | ----------------------------------------------------------------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Wunschlisten aktivieren | KippSch. | Aktiviere diese Einstellung, um die Wunschlisten Erweiterungen in deinem Shop zu nutzen. | | Zur Wunschliste hinzufügen im Artikellisting | Dropdown |

Bietet die Möglichkeit Artikel bereits im Artikellisting der Wunschliste hinzuzufügen. Dies Option steht nur bei Artikeln ohne Varianten zur Verfügung. Mögliche Einstellungen sind:
- Nein
- Als Herz Icon
- Als Button

| | Wunschlisten Icon im Header zeigen | KippSch. | Zeigt ein Wunschlisten Icon im Header neben dem Account Icon an. | | Login benötigt | KippSch. | Wenn aktiviert, muss ein Kunde eingeloggt sein, bevor Artikel zur Wunschliste hinzugefügt werden können. | | Zusätzliche Daten in Wunschlisten anzeigen | KippSch. | Wenn aktiviert, werden mehr Informationen zu einem Produkt angezeigt. | | Produktmenge als Textfeld | KippSch. | Wenn aktiviert, wird die Menge bei Wunschlisten Produkten per Textfeld und nicht per Dropdown gewählt. | | Max. Anzahl Wunschlisten pro Nutzer | Numerische Auswahl | Maximale Anzahl an Wunschlisten pro Nutzer. 0 = unlimitiert. | | Menge 0 erlaubt | KippSch. | Produkte dürfen die Menge 0 in der Wunschliste haben. | | Die Produkte auf der öffentlichen Wunschliste nach der Bestellung eines ihrer Produkte aktualisieren. | KippSch. | Nach der Bestellung des Produkts aus der öffentlichen Wunschliste wird die Menge des bestellten Produkts aktualisiert oder das Produkt wird aus der öffentlichen Wunschliste entfernt, wenn die neue Menge weniger als 1 beträgt. | ### Automatisches Löschen von alten Wunschlisten Die Einstellungen in diesem Bereich beziehen sich darauf, ob alte Wunschlisten automatisch gelöscht werden sollen. | Feld | Typ | Beschreibung | | -------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ | | Automatisches Löschen aktivieren | KippSch. | Aktiviert das automatische Löschen von alten Wunschlisten. Dies sind Wunschlisten die ein bestimmtes Erstellungsdatum überschritten haben. | | Nur anonyme Wunschlisten löschen | KippSch. | Wenn aktiviert, dann werden nur Wunschlisten von Gästen gelöscht. Das sind Wunschlisten, die keinem registrierten Kunden zugeordnet sind. | | Wunschlisten löschen nach Tagen | Numerische Eingabe | Legt fest wie alt das Erstellungsdatum der Wunschliste sein muss, bevor diese automatisch gelöscht wird. | ### Automatische Reinigung des Warenkorbs Die Einstellungen dieses Bereichs legen fest was mit Produkten im Warenkorb geschieht, wenn diese zu einer Wunschliste hinzugefügt werden. | Feld | Typ | Beschreibung | | ---------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | Leere Warenkorb nach Hinzufügen zu Wunschliste | KippSch. | Ist diese Option aktiv und ein kompletter Warenkorb wird zu einer Wunschliste hinzugefügt, dann werden alle Produkte aus dem Warenkorb entfernt. | ### Checkout Einstellungen Lege fest, wie sich die Wunschlisten Erweiterung im Checkout verhalten soll. | Feld | Typ | Beschreibung | | ------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Wunschlisten Tool im Offcanvas Warenkorb anzeigen | Dropdown |

Ermöglicht es dem Kunden im Offcanvas Warenkorb eine bestehende Wunschliste zu laden oder den Warenkorb als Wunschliste zu speichern. Mögliche Einstellungen sind:
- Nein
- Oberhalb vom Offcanvas Warenkorb
- Unterhalb vom Offcanvas Warenkorb

| | Wunschlisten Tool im Warenkorb anzeigen | Dropdown |

Ermöglicht es dem Kunden im Warenkorb eine bestehende Wunschliste zu laden oder den Warenkorb als Wunschliste zu speichern.
Mögliche Einstellungen sind:
- Nein
- Oberhalb vom Warenkorb
- Unterhalb vom Warenkorb

| | Wunschlisten im Checkout anzeigen | Dropdown |

Zeigt die Wunschlisten des Kunden im Checkout an und ermöglicht es Produkte dem Warenkorb hinzuzufügen.
Mögliche Einstellungen sind:
- Nein
- Oberhalb vom Warenkorb
- Unterhalb vom Warenkorb

| ### Produktliste Einstellungen Die folgenden Einstellungen steuern das Verhalten der Produkte in der Wunschliste. | Feld | Typ | Beschreibung | | ------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------- | | Produktdetails in Modalfenster öffnen | KippSch. | Wenn aktiviert, werden Details zu dem Produkt in einer Wunschliste nach Klick auf den Produktnamen in einem Modalfenster angezeigt. | | Button alle zum Warenkorb hinzufügen anzeigen | KippSch. | Button "Alles zum Warenkork hinzufügen" anzeigen. Ansonsten wird ein Button "Ausgewählte zum Warenkorb hinzufügen" angezeigt. | | Warenkorb Button bei jedem Artikel anzeigen | KippSch. | Wenn aktiviert, wird bei jedem Artikel in der Wunschliste ein Warenkorb Button angezeigt. | | Anzeige Artikelnummer für Wunschlisten Produkte | KippSch. | Durch die Aktivierung dieser Option, wird bei jeder Produkt Position in der Wunschliste die zugehörige Produktnummer angezeigt. | | Sortierung von Artikeln in Wunschliste aktivieren | KippSch. | Das Aktivieren dieser Einstellung ermöglicht es dem Kunden seine Produkte innerhalb von Wunschlisten zu sortieren. | | Hinzufügen durch Artikelnummer anzeigen | KippSch. | Bietet die Möglichkeit bei einer Wunschliste einen Artikel direkt durch Eingabe der Artikelnummer hinzuzufügen. | # Verwaltungs-Dashboard In der Shopware Administration können Wunschlisten editiert, angelegt und gelöscht werden. Das Verwaltungs-Dashboard kann in der Shopware Administration unter dem Menü Punkt **Marketing > Wunschlisten** geöffnet werden. Es öffnet sich eine Liste aller bestehenden Wunschlisten. Außerdem gibt es die Möglichkeit eine neue Wunschliste anzulegen oder Wunschlisten per CSV zu importieren.
### Liste aller Wunschlisten In der Auflistung werden sämtliche Wunschlisten des Shops aufgeführt. Diese enthält die folgenden Spalten: * Name * Kunde * Verkaufskanal * Anzahl Artikel * Privat Klicke auf die Schaltfläche Aktualisieren auf der rechten Seite, um die neuesten Daten abzurufen. {% hint style="info" %} Wird in der Spalte **Kunde** kein Name angezeigt, so handelt es sich um eine Wunschliste, die von einem Besucher des Shops angelegt wurde, der nicht eingeloggt war. {% endhint %} {% hint style="info" %} Bei Wunschlisten wird zwischen **Privat** und **Öffentlich** unterschieden. Eine Öffentliche Wunschliste eines Kunden kann geteilt werden und die URL beispielsweise in Social Media Kanälen veröffentlicht werden. {% endhint %} Mittels Klick auf die drei Punkte bei einer Wunschliste, öffnet sich ein Menü. Es kann zwischen **Bearbeiten**, **Duplizieren** und **Löschen** gewählt werden.
### Bearbeiten Um eine Wunschliste zu editieren, klick auf die drei Punkte und wähle **Bearbeiten** aus. Es öffnet sich die [Seite zum Editieren einer Wunschliste](/plugins/wunschlisten-fur-shopware-6/verwaltungs-dashboard/wunschliste-editieren). ### Duplizieren Mittels **Duplizieren**, wird die gewählte Wunschliste kopiert. Du kannst diese Funktion beispielsweise nutzen, wenn Du für bestimmte Kunden Verkaufslisten erzeugen möchtest und eine Liste für mehrere Kunden benötigt wird. Nach dem Duplizieren einer Wunschliste, öffnet sich die Bearbeitungsmaske der kopierten Wunschliste. ### Löschen Nach Auswahl der Option **Löschen** einer Wunschliste, öffnet sich ein Bestätigungsfenster. Wenn du dem Löschen zustimmst, so wird die Wunschliste eines Kunden unwiderruflich entfernt. ### Wunschlisten importieren Mittels Klick auf den Button **Wunschliste importieren** ist es möglich eine CSV Datei mit Wunschlisten hochzuladen und somit den Import von Wunschlisten zu starten. Detaillierte Informationen zur Funktionsweise ist unter [Import von Wunschlisten](/plugins/wunschlisten-fur-shopware-6/verwaltungs-dashboard/import-von-wunschlisten) zu finden. ### Wunschliste anlegen Neben dem Bearbeiten von bestehenden Wunschlisten, kann auch eine neue Wunschliste für einen Kunden angelegt werden. Weitere Informationen sind unter [Wunschliste erstellen](/plugins/wunschlisten-fur-shopware-6/verwaltungs-dashboard/wunschliste-erstellen) zu finden. # Wunschliste editieren In der Bearbeitungsmaske einer Wunschliste, kannst Du sowohl Basis Einstellungen an der Wunschliste vornehmen als auch neue Produkte zuweisen, bestehende Produkte entfernen oder die Reihenfolge der Produkte steuern. Die Bearbeitungsmaske ist in zwei Bereiche eingeteilt: * Basis Informationen * Produkte {% hint style="info" %} Normalerweise können Kunden ihre Wunschlisten im Accountbereich selber bearbeiten. In der Administration hast Du aber die Möglichkeit Anpassungen an den Wunschlisten vorzunehmen oder manuell Wunschlisten anzulegen. {% endhint %} ### Basis Informationen Lege den Namen und grundlegende Einstellungen der Wunschliste wie die Zuweisung zu einem Verkaufskanal und Kunden fest. | Feld | Typ | Beschreibung | | ------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Feld | Typ | Beschreibung | | Name | Freitext | In diesem Feld kann der Name der Wunschliste festgelegt werden. | | Privat | Checkbox | Private Wunschlisten können nur von einem Kunden gesehen werden. Ist die Checkbox nicht aktiv, dann ist die Wunschliste öffentlicht und kann von jedem Nutzer aufgerufen werden, der den Link dieser Wunschliste kennt. | | Priorität | Numerische Eingabe | Hat ein Kunde mehrere Wunschlisten, so können diese automatisch sortiert werden. Je Größer der Wert in diesem Feld ist, desto höher steht die Wunschliste in der Liste. | | Verkaufskanal | Dropdown | Lege fest für welchen Verkaufskanal die Wunschliste sichtbar sein soll. | | Kunde | Dropdown | Wähle einen Kunden, für den die Wunschliste sein soll. | ### Produkte In dem Bereich gibt es die Möglichkeit neue Produkte einer Wunschliste zuzuweisen, bestehende Produkte zu entfernen oder die Reihenfolge zu ändern. | | | | | ----------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Feld | Typ | Beschreibung | | Produkt-Zuordnung | Dropdown | Wähle ein neues Produkt aus dem Dropdown aus oder tippe einen Produktnamen oder Produktnummer direkt in das Dropdown Feld um nach bestimmten Produkten zu filtern. | Unter dem Dropdown für die **Produkt-Zuordnung** wird eine Liste aller Produkte der Wunschliste angezeigt. Mittels Klick auf die Hoch- und Runter Pfeile, kann die Anzeigereihenfolge verändert werden. Bei Klick auf die drei Punkte, öffnet sich ein Menü mit der Option ein Produkt von der Wunschliste zu entfernen. # Wunschliste erstellen Neben dem Editieren einer Wunschliste, kann eine Wunschliste auch komplett neu erstellt werden. Die Bedeutung der Felder ist identisch mit [Wunschliste editieren](/plugins/wunschlisten-fur-shopware-6/verwaltungs-dashboard/wunschliste-editieren). Neben dem manuellen Erstellen einer Wunschliste, können [Wunschlisten auch per CSV importiert werden](/plugins/wunschlisten-fur-shopware-6/verwaltungs-dashboard/import-von-wunschlisten). # Import von Wunschlisten Neben dem manuellen Erstellen von Wunschlisten in der Storefront oder Administration, können Wunschlisten auch per CSV importiert werden. ### Auswahl einer CSV Datei Im Verwaltungs-Dashboard deiner Wunschlisten, findest Du den Button **Wunschlisten importieren.** Nach Klick auf den Button öffnet sich ein Dialogfenster. In diesem Fenster muss eine passende CSV Datei hochgeladen werden und ein Verkaufskanal gewählt werden {% hint style="info" %} Im Dialogfenster zur Wahl einer CSV Datei ist ein Link zu einer Beispiel CSV Datei hinterlegt. Bitte nutzen genau das dort aufgeführte Format. {% endhint %} ### Aufbau der CSV Datei
FeldPflichtfeldBeschreibung
KundennummertrueWähle die Kundennummer um die Wunschliste dem passenden Kunden zuzuordnen.
Wunschlisten NametrueDer Name der Wunschliste wird später dem Kunden angezeigt.
Wunschliste PrivatfalseEine private Wunschliste (= Wert 0) ist nur für den Kunden. Eine öffentliche Wunschliste (= Wert 1), kann jeder sehen, der den Link kennt.
Wunschliste SortierungfalseWähle eine Positionsnummer um die Reihenfolge der Wunschlisten festzulegen, falls der Kunde mehrere Wunschlisten hat.
ProduktnummertrueSetze die Produktnummer, so wie sie für das Produkt bereits im Shop hinterlegt ist.
Anzahl ProduktefalseDefiniere die Menge, mit der das Produkt in die Wunschliste gelegt werden soll.
ProduktsortierungfalseLege mit einer Nummer die Reihenfolge von Produkte innerhalb einer Wunschliste fest, insofern es hier mehrere Produkte gibt.
{% hint style="info" %} Wenn eine Wunschliste mehrere Produkte haben soll, so lege für jedes Produkt genau eine Zeile mit allen oben stehenden Pflichtfeldern an. {% endhint %} # Rabatt Kategorie für Shopware 6 #### **Maximiere deinen Umsatz mit unserer leistungsstarken Rabatt-Erweiterung für deinen Online-Shop!** Steigere deine Verkaufszahlen und optimiere das Einkaufserlebnis deiner Kunden – mit unserer intelligenten Rabatt-Erweiterung, die sich nahtlos in deinen Online-Shop integriert. Unsere Lösung bietet dir eine Vielzahl an Funktionen, mit denen du Rabattaktionen gezielt steuern und sichtbar machen kannst.
**Deine Vorteile auf einen Blick:** ✅ **Automatische Rabattvergabe**\ Lege Rabatte für ganze Kategorien oder nach individuellen Regeln fest – ganz ohne manuellen Aufwand. So steuerst du Preisnachlässe effizient und flexibel. ✅ **Klar kommunizierte Preisvorteile**\ Dank anpassbarer Rabatt-Hinweise auf Kategorieseiten und Produktdetailseiten sehen deine Kunden sofort, wo sie sparen können. Das steigert die Kaufbereitschaft und reduziert Absprungraten. ✅ **Auffällige Rabatt-Badges für mehr Sichtbarkeit**\ Hebe rabattierte Produkte mit markanten Badges hervor und lenke die Aufmerksamkeit deiner Kunden gezielt auf attraktive Angebote. **Warum unsere Rabatt-Erweiterung?** 🔹 **Mehr Umsatz durch gezielte Rabattaktionen**\ 🔹 **Bessere Conversion-Raten durch klare Rabattkommunikation**\ 🔹 **Zeiteinsparung dank vollautomatisierter Rabattsteuerung**\ 🔹 **Wettbewerbsvorteil durch eine optimierte Verkaufsstrategie** Nutze das volle Potenzial deines Online-Shops und biete deinen Kunden ein überzeugendes Einkaufserlebnis! 🚀

# Voraussetzungen Die Erweiterung kann nur in einer selbst verwalteten Shopware-Umgebung mit mindestens Version 6.4.0 installiert werden. # Installation Installiere die Erweiterung durch **Erweiterungen** > **Meine Erweiterungen**.
Die Erweiterung hat zwei Aspekte: * Grundlegende Konfiguration * Verwaltungs-Dashboard Führe zunächst die Schritte im Abschnitt **Grundlegende Konfiguration** aus und lese dann den Abschnitt **Verwaltungs-Dashboard**, um zu erfahren, wie du die Erweiterung fortlaufend verwalten kannst. ### Grundlegende Konfiguration Bevor du die App aktivierst, überprüfe die Einstellungen in diesem Abschnitt und stelle sicher, dass sie deinen Anforderungen entsprechen. Nehme Änderungen an den einzelnen Feldern wie unten beschrieben vor, indem du **Meine Erweiterungen** > **Rabatt Kategorie für Shopware 6** > **Konfiguration** wählst. ### Allgemeine Einstellungen Die allgemeinen Eigenschaften bieten grundlegende Steuerelemente, wie z. B. die Aktivierung/Deaktivierung der Erweiterung. | Feld | Typ | Beschreibung | | ----------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | Rabatt Kategorie System aktivieren | KippSch. | Aktiviere diese Einstellung, um die Erweiterung in deinem Shop zu aktivieren. | | Mehrfach Kampagnen bei Produkten erlauben | KippSch. | Wenn aktiviert und es gibt mehrere Kampagnen für ein Produkt, dann werden die Rabatte summiert. Andernfalls wird nur der höchste Rabatt berücksichtigt. | | Ausblenden der regulären Shopware Badges | KippSch. | Mit dieser Einstellung werden alle anderen Shopware Badges deaktiviert und nur die Rabatt Hinweise der Erweiterung angezeigt. | # Verwaltungs-Dashboard ### Übersicht der Kampagnen Um eine Übersicht aller aktuellen Rabatt Kampagnen zu erhalten wähle **Marketing > Rabatt Kategorie** in der Shopware Administration aus.
Um eine [neue Kampagne anzulegen](/plugins/rabatt-kategorie-fur-shopware-6/verwaltungs-dashboard/kampagne-erstellen) klicke auf den Button **Erstellen**. In der Listenansicht werden alle verfügbaren Kampagnen dargestellt. Diese sind unterteilt in die Spalten: | Spalte | Beschreibung | | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | Der interne Name der Kampagne | | Status | Zeigt an ob die Kampagne aktiv oder inaktiv gesetzt ist. | | Priorität | Falls mehrere Kampagnen für ein Produkt zutreffen dann regelt die Priorität, welcher Rabatt als erstes abgezogen wird bzw. welcher Rabatt überhaupt gültig ist. Je höher die Priorität, desto wichtiger ist die Kampagne. | | Gültig von | Lege hier fest, wenn die Kampagne automatisch zu einem bestimmten Datum starten soll. | | Gültig bis | Definiere ein Datum, zu dem die Kampagne automatisch endet. | | Rabatt | Zeigt die Höhe des Rabattes and und ob es ein absoluter Rabatt oder ein prozentualer Rabatt ist. | | ![](/files/l4miRgishvjDOodBcPyS) | Mit Klick auf das Icon, kannst Du einzelne Spalten ein- oder ausblenden. Außerdem gibt es in jeder Zeile die drei "...". Mit klick auf die Punkte, öffnet sich ein Kontext Menü und du kannst zwischen [**Bearbeiten**](/plugins/rabatt-kategorie-fur-shopware-6/verwaltungs-dashboard/kampagne-editieren), [**Duplizieren** ](/plugins/rabatt-kategorie-fur-shopware-6/verwaltungs-dashboard/kampagne-duplizieren)oder **Löschen** wählen. | {% hint style="info" %} Du kannst eine Kampagne von dieser Seite aus löschen, indem du die Menüschaltfläche „…“ klickst und **Löschen** wählst. Gelöschte Kampagnen können nicht wiederhergestellt werden. {% endhint %} ### Häufige Frage
Nach Installation und Erstellung einer Rabatt Kampagne wird kein Rabatt angezeigt. \- Bitte stelle sicher, das die Erweiterung für den passenden Verkaufskanal in der Konfiguration der Erweiterung aktiviert ist. \- Bitte stelle sicher, das bei der Rabatt Aktion eine dynamische Produktgruppe zugewiesen wurde, die den entsprechenden Verkaufskanal Produkte hat.\ \ \- Bitte führe ein Update des Index in der Admin unter "Einstellungen -> Caches & Indexes" durch. # Kampagne erstellen Zum Erstellen einer Kampagne klicke den Button **Erstellen** in der Listenansicht der Kampagnen. Es öffnet sich eine Seite, die in 4 Tabs unterteilt ist.
| Tab | Beschreibung | | ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Allgemein](/plugins/rabatt-kategorie-fur-shopware-6/verwaltungs-dashboard/kampagne-erstellen/allgemein) | In diesem Bereich werden grundlegende Einstellungen der Kampagne wie das Start- und Enddatum, Rabatthinweistext für Listing, Detailseite und Badges sowie die Wahl einer Produktgruppe vorgenommen. | | [Rabatt](/plugins/rabatt-kategorie-fur-shopware-6/verwaltungs-dashboard/kampagne-erstellen/rabatt) | Einstellungen für den Rabatt Typ, Rabatt Höhe und die Anzeige eines Rabattes werden in diesem Bereich vorgenommen. Auch kann hier anstelle eines Rabattes ein Aufpreis vergeben werden. | | [Beschränkungen](/plugins/rabatt-kategorie-fur-shopware-6/verwaltungs-dashboard/kampagne-erstellen/beschrankungen) | Verfeinere die Verfügbarkeit des Rabattes in diesem Bereich. So kann der Rabatt nur bei Existenz eines bestimmten Cookies, URL Parameter oder anderen Regeln freigeschaltet werden. | | [Statistiken](/plugins/rabatt-kategorie-fur-shopware-6/verwaltungs-dashboard/kampagne-erstellen/statistiken) | Zur Erfolgskontrolle deiner Kampagne kannst du in diesem Bereich Statistiken aufrufen. Die Statistiken stehen erst zur Verfügung, wenn deine Kampagne aktiv ist oder war und genutzt wurde. | # Allgemein ### Basis Daten Hinterlege einen Namen für die Rabattaktion, definiere einen Gültigkeitszeitraum und aktiviere Rabatt Hinweise für Listing und Detailseite. | Feld | Typ | Beschreibung | | ------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | Textfeld | Lege einen Namen für die Rabatt Kampagne fest. | | Aktiv | KippSch. | Die Kampagne greift erst, wenn der Kippschalter auf aktiv gesetzt wurde. | | Gültig von | Datumsauswahl | Optional kann ein Startdatum für die Kampagne festgelegt werden. | | Gültig bis | Datumsauswahl | Optional kann ein Datum festgelegt werden an dem die Kampagne automatisch endet. | | Priorität | Numerische Eingabe | Falls mehrere Kampagnen für ein Produkt zutreffen dann regelt die Priorität, welcher Rabatt als erstes abgezogen wird bzw. welcher Rabatt überhaupt gültig ist. Je höher die Priorität, desto wichtiger ist die Kampagne. | | Rabatt Badge im Listing anzeigen | KippSch. | Lege fest, ob in der Produkt Listenansicht, rabattierte Produkte mit einem Badge gekennzeichnet werden sollen. | | Rabatt Hinweis Box im Listing anzeigen | KippSch. | Aktiviere diese Option, wenn Du eine Rabatt Hinweisbox oberhalb des Produkt Listing anzeigen möchtest. | | Rabatt Hinweis Box auf Detailseite anzeigen | KippSch. | Nach Aktivierung dieser Option, kann ein Rabatt Hinweis auf Produkt Detailseiten angezeigt werden. | ### Badge im Listing Wähle einen Text für den Badge und verändere die Farben. Dieser Bereich wird nur angezeigt wenn bei den **Basis Daten** die Option **Rabatt Badge im Listing anzeigen** aktiviert wurde. | Feld | Typ | Beschreibung | | ----------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Text | Textfeld | Lege einen Text fest, der im Badge angezeigt werden soll. | | Farbe Badge Text | Farbauswahl | Wähle aus, welche Farbe der Badge Text haben soll. Wenn du auf das Icon vor dem Textfeld klickst, dann öffnet sich ein Farbauswahl Fenster. Alternativ kannst Du auch direkt einen Hex-Wert für Deine Farbe angeben. | | Farbe Badge Hintergrund | Farbauswahl | Wähle aus, welche Farbe der Badge Hintergrund haben soll. Wenn du auf das Icon vor dem Textfeld klickst, dann öffnet sich ein Farbauswahl Fenster. Alternativ kannst Du auch direkt einen Hex-Wert für Deine Farbe angeben. | ### Rabatt Hinweis Box im Listing In diesem Bereich kannst du einstellen, wie die Rabatthinweisbox auf Kategorie Seiten aussehen soll und welcher Text dort angezeigt wird. Außerdem kannst du präzisieren in welchen Kategorien der Hinweis angezeigt wird. Dieser Bereich wird nur angezeigt wenn bei den **Basis Daten** die Option **Rabatt Hinweis Box im Listing anzeigen** aktiviert wurde. | Feld | Typ | Beschreibung | | ---------------------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Hinweis Box Titel Text | Textfeld | Wähle einen Text für den Titel der Box aus. | | Infosymbol anzeigen | KippSch. | Für die Anzeige des Hinweistext wird die Standard Shopware Meldungsbox verwendet. Diese hat normalerweise ein Infosymbol Icon. Dieses wird nur angezeigt, wenn du die Option aktivierst. | | Hinweis Box Text | Textfeld | Schreibe in dieses Feld den Text, der in der Hinweisbox erscheinen soll. | | Farbe Box Text | Farbauswahl | Wähle aus, welche Farbe der Box Text haben soll. Wenn du auf das Icon vor dem Textfeld klickst, dann öffnet sich ein Farbauswahl Fenster. Alternativ kannst Du auch direkt einen Hex-Wert für Deine Farbe angeben. | | Farbe Box Hintergrund | Farbauswahl | Wähle aus, welche Farbe der Hintergrund der Box haben soll. Wenn du auf das Icon vor dem Textfeld klickst, dann öffnet sich ein Farbauswahl Fenster. Alternativ kannst Du auch direkt einen Hex-Wert für Deine Farbe angeben. | | Kategorien | Mehrfach Auswahl | Wähle einzelne Kategorien aus, falls Du im folgenden Auswahlfeld den **Kategorie Modus** einstellen möchtest. | | Kategorie Modus | Auswahlfeld | Mit dem **Kategorie Modus** hast du die Möglichkeit einzustellen, ob die Infobox nur bei bestimmten Kategorien gezeigt werden soll oder alle Kategorien innerhalb eines Artikel Pfades berücksichtigt werden sollen. | ### Rabatt Hinweis Box auf Detailseite Wähle in diesem Bereich, wie die Rabatthinweisbox auf der Detail Seite aussehen soll und welcher Text dort angezeigt wird. Dieser Bereich wird nur angezeigt wenn im bei den **Basis Daten** die Option **Rabatt Hinweis Box auf Detailseiten anzeigen** aktiviert wurde. | Feld | Typ | Beschreibung | | ---------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Hinweis Box Titel Text | Textfeld | Wähle einen Text für den Titel der Box aus. | | Infosymbol anzeigen | KippSch. | Für die Anzeige des Hinweistext wird die Standard Shopware Meldungsbox verwendet. Diese hat normalerweise ein Infosymbol Icon. Dieses wird nur angezeigt, wenn du die Option aktivierst. | | Hinweis Box Text | Textfeld | Schreibe in dieses Feld den Text, der in der Hinweisbox erscheinen soll. | | Farbe Box Text | Farbauswahl | Wähle aus, welche Farbe der Box Text haben soll. Wenn du auf das Icon vor dem Textfeld klickst, dann öffnet sich ein Farbauswahl Fenster. Alternativ kannst Du auch direkt einen Hex-Wert für Deine Farbe angeben. | | Farbe Box Hintergrund | Farbauswahl | Wähle aus, welche Farbe der Hintergrund der Box haben soll. Wenn du auf das Icon vor dem Textfeld klickst, dann öffnet sich ein Farbauswahl Fenster. Alternativ kannst Du auch direkt einen Hex-Wert für Deine Farbe angeben. | ### Dynamische Produktgruppe In diesem Bereich kannst du den Rabatt, automatisiert für eine Vielzahl von Produkten, zuweisen. Dies geschieht über eine dynamische Produkte. | | | | | -------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Dynamische Produktgruppenauswahl | Auswahlfeld | Wähle eine [dynamische Produktgruppe](https://docs.shopware.com/de/shopware-6-de/Kataloge/DynamischeProduktgruppen), deren Produkte den Rabatt erhalten sollen. | {% hint style="info" %} Da nur Produkte rabattiert werden, die in der dynamischen Produktgruppe sind, muss diese zwingend zugewiesen werden.\ Bitte teste in der Shopware Administration über den Vorschaumodus der dynamischen Produktgruppe, ob die gewünschten Produkte enthalten sind. {% endhint %} # Rabatt ### Discount Höhe und Typ Lege in diesem Bereich fest was du für einen Rabatt oder ob du einen Aufpreis vergeben möchtest. | Feld | Typ | Beschreibung | | ---------------------------------- | ------------------ | --------------------------------------------------------------------------------------------- | | Rabatt Typ | Auswahlfeld | Wähle, ob der Rabatt absolut (ein bestimmter EUR Betrag) oder relativ (prozentual) sein soll. | | Relativer Rabatt/ Absoluter Rabatt | Numerische Eingabe | Abhängig von der **Rabatt Typ** Auswahl erscheint ein Feld zur Eingabe der Rabatthöhe. | | Rabatt oder Aufschlag | Auswahlfeld | Neben Rabatten, können mit der Erweiterung auch Aufschläge vergeben werden. | ### Rabattanzeige Wähle aus, wie Streichpreis und Rabatt auf der Produkt Detailseite angezeigt werden sollen. | Feld | Typ | Beschreibung | | ------------------------------------ | ----------- | ----------------------------------------------------------------------------------------------------- | | Zeige Rabatt auf Produkt Detailseite | Auswahlfeld | Wähle, wie ein Rabatt auf Produkt Detailseite angezeigt werden soll | | Zeige Rabatt auf Produkt Listenseite | Auswahlfeld | Verändere die Anzeige des Rabattes auf Kategorie Seiten, indem du eine entsprechende Auswahl tätigst. | # Beschränkungen ### Cookie Beschränkung Lege einen Cookie Namen und Wert fest. Nur wenn dieses Cookie existiert, wird der Rabatt gewährt. | Feld | Typ | Beschreibung | | ----------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Cookie Name | Textfeld | Gebe den Namen des Cookies ein, beispielsweise **meinCookie** | | Cookie Wert | Textfeld |

Lege einen Wert für das Cookie fest, wie beispielsweise rabattAnzeigen

Der Rabatt würde dann nur angezeigt werden, wenn das Cookie meinCookie mit dem Wert rabattAnzeigen vorhanden ist.

| ### Url Parameter Beschränkung Mittels der URL Parameter Beschränkung kannst Du festlegen, das der Rabatt nur vergeben wird, wenn der Kunde die Shop URL mit einem speziellen Parameter aufruft. Der Aufruf hierfür lautet später beispielsweise: ?myParameter=yes | Feld | Typ | Beschreibung | | ------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Url Parameter Name | Textfeld | Gebe den Namen des URL Parameter an, beispielsweise **meinParam** | | Url Parameter Wert | Textfeld |

Lege einen Wert für dem Parameter fest, wie beispielsweise rabattAnzeigen
Der URL Parameter wäre dann später
?meinParam=rabattAnzeigen

| ### Einschränkung der Kunden In diesem Bereich kannst Du Kunden oder Kundengruppen wählen für die der Rabatt ausschließlich gilt. | Feld | Typ | Beschreibung | | ---------------------------- | ---------------- | -------------------------------------------------------------------------- | | Auf Kundengruppe beschränken | Mehrfach Auswahl | Wähle eine oder mehrere Kundengruppen aus, für die der Rabatt gelten soll. | | Auf Kunden beschränken | Mehrfach Auswahl | Begrenze den Rabatt auf bestimmte Kunden. | ### Einschränkung des Verkaufskanal Wähle Verkaufskanäle für die der Rabatt gültig sein soll. | Feld | Typ | Beschreibung | | ----------------------------- | ---------------- | ----------------------------------------------------------------------------------------- | | Auf Verkaufskanal beschränken | Mehrfach Auswahl | Wähle ein oder mehrere Verkaufskanäle für die der Rabatt ausschließlich gültig sein soll. | ### Rabatte & Aktionen ausschließen Schließe in diesem Bereich andere Rabatte & Aktionen aus, wenn der Kampagnen Rabatt aktiv ist. | Feld | Typ | Beschreibung | | ----------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------ | | Keine Rabatte & Aktionen zulassen | Checkbox | Aktiviere diese Option um andere Rabatte zu verbieten, sobald ein Produkt mit einem Kampagnen Rabatt im Warenkorb liegt. | | Bestimmte Aktionen und Rabatte blockieren | Dropdown | Wähle einen Rabatt aus, der nicht zusammen mit einer Rabatt Kategorie Aktion im Warenkorb liegen darf. | # Statistiken In diesem Bereich werden Statistiken der gesamten Kampagne angezeigt. | Spalte | Beschreibung | | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | Anzahl der Bestellungen | In dem Feld ist die Anzahl der Bestellungen zu finden, die mindestens ein Produkt mit aktiver Rabatt Kampagne enthalten haben. | | Marge | Wenn bei den Produkten der Einkaufspreis gepflegt wurde, so wird hier die Gesamtmarge der Bestellungen angezeigt. | | Anzahl der rabattierten Produkte | Finde hier die Gesamtanzahl an Produkten mit Rabatten dieser Kampagne aus allen Bestellungen. | | Umsatz | In diesem Feld wird der Umsatz aller Bestellungen angezeigt. | ### Verkauf rabattierte Produkte Sämtliche verkaufte Produkte einer Rabattaktion werden in diesem Bereich tabellarisch aufgelistet. | Spalte | Beschreibung | | ------------- | ---------------------------------------------------------------------------------------------------------------- | | Name | Es wird der Name des Produktes angezeigt | | Produktnummer | In diesem Feld findest Du die Produktnummer des bestellen Produktes. | | Verkäufe | Es wird die Anzahl aller Verkäufe des rabattierten Produktes angezeigt. | | Gesamtmarge | Wenn bei den Produkten der Einkaufspreis gepflegt wurde, so wird hier die Gesamtmarge für das Produkt berechnet. | | Umsatz | Der Umsatz eines rabattierten Produktes wird in diesem Feld angezeigt. | # Kampagne editieren Die Felder beim Editieren sind identisch zu denen beim [Anlegen einer Kampagne](/plugins/rabatt-kategorie-fur-shopware-6/verwaltungs-dashboard/kampagne-erstellen). Bitte folge der Anleitung aus dem Bereich. # Kampagne duplizieren Anstelle des kompletten neu anlegen einer Kampagne, kannst du auch eine bestehende Kampagne wählen und diese duplizieren. Wähle hierfür in der Listenansicht deiner Kampagnen einen entsprechenden Eintrag aus und klicke auf die drei "...". Es öffnet sich ein Kontext Menü. Wöhle in diesem Menü den Eintrag **Duplizieren**. Es wird eine Kopie der Kampagne erstellt und es öffnet sich die Seite zum Editieren dieser neuen Kampagne. Die neue Kampagne erhält automatisch den Zusatz **Kopie** im Namen und wird auf **inaktiv** gesetzt. Die Felder beim Editieren einer duplizierten Kampagne sind identisch zu denen beim [Anlegen einer Kampagne](/plugins/rabatt-kategorie-fur-shopware-6/verwaltungs-dashboard/kampagne-erstellen). Bitte folge der Anleitung aus dem Bereich. # Cross Selling Warenkorb und Checkout Der Warenkorb und der Checkout sind die wertvollsten Stellen in deinem Shop. Wer dort steht, hat sich entschieden zu kaufen — und ist deutlich offener für **eine zweite oder dritte Position** als jede:r Besucher:in auf einer Listenseite. Genau dort setzt **Cross-Selling Warenkorb und Checkout** an: Es zeigt deinen Kund:innen passende Zusatzprodukte zum richtigen Zeitpunkt — und kann sie auf Wunsch sofort mit einem **Rabatt** versehen.
## Wie das Plugin dir hilft * **Mehr Umsatz pro Bestellung** — Kund:innen sehen passende Produkte direkt im Warenkorb, Off-Canvas oder Checkout. * **Volle Kontrolle, kein Manuell-Pflegen** — Regeln verbinden Trigger-Produkte mit Cross-Selling-Produkten. Du legst sie einmal an, das Plugin entscheidet automatisch, wem es was zeigt. * **Rabatte ohne Gutscheincode** — du gibst direkt im Slider einen Prozent-Rabatt, das Plugin rechnet ihn in den Warenkorb und Checkout durch — inklusive Mehrwertsteuer, Staffelpreisen und Grundpreisen. * **Auffälliges Rabatt-Badge** — jedes Produkt mit Rabatt erhält ein eigenes Badge mit Farben und Text deiner Wahl. * **Funktioniert mit dynamischen Produktgruppen** — du musst nicht jedes Produkt einzeln zuordnen. Filterregeln wie „alle Produkte mit Hersteller X" reichen. ## Mehr als nur ein zweiter Cross-Selling-Slider * Funktioniert sowohl mit **manuell ausgewählten Produkten** als auch mit **dynamischen Produktgruppen**. * **Automatisches Erkennen** der vorhandenen Shopware-Cross-Selling-Zuordnungen aus deinen Produkten — kein doppelter Pflegeaufwand. * **Zeitlich begrenzte Aktionen** — Start- und Enddatum pro Regel, perfekt für Black Friday, Weihnachten oder saisonale Kampagnen. * **Mehrsprachig** — Regelname, Rabattbezeichnung im Warenkorb und Badge-Text sind pro Sprache übersetzbar. * **Pro Verkaufskanal aktivierbar** — du entscheidest, in welchem Shop die Cross-Sellings aktiv sind. ## Flexibel an jeder Stelle im Checkout-Prozess Du wählst pro Position eigenständig, ob und wo der Cross-Selling-Slider eingeblendet wird: * **Off-Canvas-Warenkorb** — oberhalb, unterhalb oder ganz unten. * **Warenkorb-Seite** — oberhalb oder unterhalb der Positionsliste. * **Checkout-Seite** (Bestellbestätigung / Registrierung) — oberhalb oder unterhalb des Checkouts. * **Produktdetailseite** — Produkte, die unter eine aktive Rabatt-Regel fallen, zeigen ihren rabattierten Preis automatisch an. * **Listing- und Suchseiten** — Produkte erscheinen mit reduziertem Preis und Badge in Listings und Suchergebnissen. ## Ergebnis Mehr verkaufte Artikel pro Bestellung, höhere Warenkorbwerte, weniger Pflegeaufwand. Aus einem klassischen „Ich bestelle nur das eine Produkt" wird sehr oft ein „Ich nehme das passende Zubehör direkt mit" — und das ganz ohne manuelle Pflege jeder einzelnen Produktbeziehung. ## So geht's weiter * [Voraussetzungen](/plugins/cross-selling-warenkorb-und-checkout/voraussetzungen) — was du vor der Installation prüfen solltest. * [Quickstart](/plugins/cross-selling-warenkorb-und-checkout/quickstart) — in unter zehn Minuten zur ersten aktiven Cross-Selling-Regel. * [Verwaltungs-Dashboard](/plugins/cross-selling-warenkorb-und-checkout/verwaltungs-dashboard) — Regeln anlegen und pflegen. * [Storefront-Integration](/plugins/cross-selling-warenkorb-und-checkout/storefront-integration) — wo deine Kund:innen die Slider und Badges sehen. # Quickstart Dieser Quickstart führt dich in wenigen Minuten zur ersten aktiven Cross-Selling-Regel. Wir nehmen ein einfaches Beispiel: **„Wer eine Kaffeemaschine kauft, bekommt 10 % Rabatt auf Kaffeebohnen."** {% stepper %} {% step %} ## Plugin installieren und aktivieren Falls noch nicht geschehen, installiere das Plugin wie in der [Installation](/plugins/cross-selling-warenkorb-und-checkout/installation) beschrieben und aktiviere es in der **Plugin-Konfiguration** über den Schalter **App aktivieren** für den gewünschten Verkaufskanal. {% endstep %} {% step %} ## Slider-Positionen festlegen Bleibe in der Plugin-Konfiguration und stelle ein, wo deine Kund:innen die Cross-Selling-Produkte sehen sollen — zum Beispiel: * **Cross-Selling Slider im Off-Canvas Warenkorb:** *Unterer Bereich des Off-Canvas* * **Cross-Selling Slider im Warenkorb:** *Unterhalb vom Warenkorb* * **Cross-Selling Slider im Checkout:** *Oberhalb vom Checkout* Speichere die Konfiguration. {% endstep %} {% step %} ## Erste Regel anlegen 1. Öffne in der Administration den Menüpunkt **Cross-Selling Checkout** (Hauptmenü links). 2. Klicke oben rechts auf **Anlegen**. {% endstep %} {% step %} ## Basis-Daten ausfüllen Im Reiter **Basis-Daten** trägst du ein: | Feld | Beispielwert | | ----------------------------------- | ------------------------------ | | Name | `Kaffeebohnen zur Maschine` | | Aktiv | An | | Gültig von / Gültig bis | Leer lassen oder Zeitraum | | Rabatt | `10` (Prozent) | | Name des Rabatt im Warenkorb | `10 % Rabatt auf Kaffeebohnen` | | Badge bei Rabatt-Produkten anzeigen | An | Der **Name** ist nur intern, **Name des Rabatts im Warenkorb** sehen deine Kund:innen als Beschriftung der Rabattposition im Warenkorb. {% endstep %} {% step %} ## Badge konfigurieren (optional) Im Reiter **Badge** kannst du Text, Hintergrund- und Textfarbe für das Rabatt-Badge ändern. Lässt du die Farben leer, gelten die Standardfarben aus der Plugin-Konfiguration. Beispiel: | Feld | Beispielwert | | ---------------------- | ---------------- | | Badge-Text | `Bundle-Rabatt` | | Badge-Text-Farbe | `#ffffff` (Weiß) | | Badge-Hintergrundfarbe | `#d9534f` (Rot) | Im Slider und auf der Produktdetailseite erscheint dann ein Badge wie `-10% Bundle-Rabatt`. {% endstep %} {% step %} ## Cross-Selling-Typ wählen Im Reiter **Cross-Selling Einstellungen** wählst du, **wie** die Cross-Selling-Produkte gefunden werden: * **Automatisch anhand des Cross-Sellings der Produkte im Warenkorb** — das Plugin nimmt die Produkte, die du bereits über das **native Shopware-Cross-Selling** an deinen Produkten gepflegt hast. Ideal, wenn du diese Pflege schon hast. * **Definiert durch Produkte / Dynamische Produktgruppe** — du legst selbst fest, **welche Trigger-Produkte** die Regel auslösen und **welche Cross-Selling-Produkte** angeboten werden. Genau das wählen wir für unser Beispiel. {% endstep %} {% step %} ## Trigger-Produkte festlegen Im Reiter **Trigger-Produkte** legst du fest, welche Produkte im Warenkorb die Regel auslösen sollen. Zwei Wege stehen dir zur Auswahl: * **Produkte** — wähle einzelne Produkte (in unserem Beispiel: deine Kaffeemaschinen). * **Dynamische Produktgruppe** — wähle eine Gruppe wie „Alle Kaffeemaschinen". Die Gruppe pflegst du in **Kataloge → Dynamische Produktgruppen**. Sobald **eines** der Trigger-Produkte im Warenkorb landet, gilt die Regel. {% endstep %} {% step %} ## Cross-Selling-Produkte festlegen Im Reiter **Cross-Selling-Produkte** trägst du ein, **was angeboten wird**, sobald die Regel ausgelöst ist. Auch hier gibt es zwei Wege: * **Manuelle Produktliste** — wähle einzelne Produkte (z. B. eine handverlesene Auswahl an Bohnen). * **Dynamische Produktgruppe** — wähle eine Gruppe wie „Alle Kaffeebohnen". Auf diese Weise wachsen die Cross-Sellings automatisch mit deinem Sortiment. Die Reihenfolge im Slider richtet sich nach der Sortier-Einstellung in der Plugin-Konfiguration. Bei manueller Liste kannst du die Position pro Produkt setzen. {% endstep %} {% step %} ## Speichern und testen * Klicke oben rechts auf **Speichern**. * Öffne deinen Shop in einem privaten Fenster. * Lege ein Trigger-Produkt (z. B. eine Kaffeemaschine) in den Warenkorb. * Öffne den Off-Canvas-Warenkorb, die Warenkorb-Seite oder den Checkout — die rabattierten Kaffeebohnen erscheinen mit Badge im Slider, und beim Hinzufügen wird der Rabatt automatisch in den Bestellpositionen abgezogen. {% endstep %} {% endstepper %} ## Nächste Schritte * [Verwaltungs-Dashboard](/plugins/cross-selling-warenkorb-und-checkout/verwaltungs-dashboard) — alle Felder der Regel im Detail. * [Dynamische Produktgruppen](/plugins/cross-selling-warenkorb-und-checkout/dynamische-produktgruppen) — wie du Gruppen einsetzt. * [Rabatt-Badges](/plugins/cross-selling-warenkorb-und-checkout/rabatt-badges) — Badges gestalten. * [Storefront-Integration](/plugins/cross-selling-warenkorb-und-checkout/storefront-integration) — wo deine Kund:innen alles sehen. # Voraussetzungen ## Unterstützte Umgebungen Das Plugin läuft auf **self-hosted Shopware-Installationen** und in **PaaS-Umgebungen (Cloud)**, sofern mindestens **Shopware 6.5.0.0** installiert ist. {% hint style="warning" %} SaaS-Umgebungen werden nicht unterstützt. {% endhint %} ## Systemvoraussetzungen | Komponente | Anforderung | | ------------- | ---------------------------------------------- | | Shopware | 6.5.0.0 oder neuer | | PHP | 8.2 oder neuer | | MySQL/MariaDB | wie Shopware 6.5 vorgibt | | Theme | Shopware Default Theme oder abgeleitete Themes | ## Verkaufskanäle Das Plugin wird **pro Verkaufskanal** aktiviert. In Shops mit mehreren Verkaufskanälen kannst du das Cross-Selling gezielt nur dort einschalten, wo es benötigt wird — zum Beispiel im B2C-Shop aktivieren, im B2B-Shop deaktivieren. ## Empfohlene Vorbereitung Damit du beim Quickstart sofort sinnvolle Regeln anlegen kannst, sollten in deinem Shop bereits folgende Dinge existieren: * **Mindestens ein gepflegter Produktkatalog** mit aktiven Produkten. * **Optional: dynamische Produktgruppen** (Kataloge → Dynamische Produktgruppen) — diese erleichtern das Zuweisen ganzer Produktbereiche zu einer Cross-Selling-Regel deutlich. * **Optional: Shopware-Cross-Selling** an Produkten — wenn du die bereits gepflegt hast, kannst du sie ohne Doppelpflege im Plugin übernehmen. Keines dieser Dinge ist Pflicht — sie machen das Anlegen der ersten Regel aber spürbar schneller. # Installation ## Plugin installieren 1. Öffne in der Administration **Erweiterungen → Meine Erweiterungen**. 2. Suche **Cross-Selling Warenkorb und Checkout** in der Liste oder lade es aus dem Shopware Store. 3. Klicke auf **Installieren**. 4. Klicke nach der Installation auf den Schalter, um das Plugin zu **aktivieren**. {% hint style="info" %} Bei der Installation werden automatisch die benötigten Datenbanktabellen angelegt. Bestehende Produkte, Cross-Sellings oder Bestellungen werden dabei **nicht** verändert. {% endhint %} ## Plugin-Konfiguration Öffne die Plugin-Konfiguration über **Erweiterungen → Meine Erweiterungen → Cross-Selling Warenkorb und Checkout → … → Konfiguration**. ### Allgemeine Einstellungen | Feld | Bedeutung | | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------- | | **App aktivieren** | Zentraler Schalter pro Verkaufskanal. Ohne diesen Schalter werden weder Slider noch Rabatte angezeigt. | | **Standard Rabatt Badge Hintergrund Farbe** | Hintergrundfarbe für Badges ohne eigene Farbe in der Regel. Voreinstellung `#ff0000` (Rot). | | **Standard Rabatt Badge Text Farbe** | Textfarbe für Badges ohne eigene Farbe in der Regel. Voreinstellung `#ffffff` (Weiß). | | **Max. Anzahl Produkte im Cross-Selling Slider** | Begrenzt, wie viele Produkte maximal pro Slider angezeigt werden. Voreinstellung `10`. | | **Produkt-Sortierung im Slider** | Bestimmt die Reihenfolge der Produkte (Name, Rabatt, Preis, Veröffentlichungsdatum — je auf-/absteigend). | | **Immer den „In den Warenkorb"-Button anzeigen** | Zeigt den Button auch bei Varianten-Mutter-Produkten direkt im Slider an. | ### Slider-Positionen Pro Stelle im Checkout entscheidest du, ob und an welcher Position der Slider erscheint: | Einstellung | Optionen | | ------------------------------------------------ | ---------------------------------------------------------------------------------------- | | **Cross-Selling Slider im Off-Canvas Warenkorb** | Nein · Oberhalb vom Warenkorb · Unterhalb vom Warenkorb · Unterer Bereich des Off-Canvas | | **Cross-Selling Slider im Warenkorb anzeigen** | Nein · Oberhalb vom Warenkorb · Unterhalb vom Warenkorb | | **Cross-Selling Slider im Checkout anzeigen** | Nein · Oberhalb vom Checkout · Unterhalb vom Checkout | > Mehr Details zu den Positionen findest du im Abschnitt [Storefront-Integration](/plugins/cross-selling-warenkorb-und-checkout/storefront-integration). ## Plugin pro Verkaufskanal konfigurieren Über das Auswahlfeld oben links in der Konfiguration kannst du jeden Verkaufskanal separat einstellen. Möchtest du das Plugin nur in einem bestimmten Shop nutzen, lass den Schalter **App aktivieren** dort eingeschaltet und in allen anderen Verkaufskanälen ausgeschaltet. ## Nächste Schritte * [Quickstart](/plugins/cross-selling-warenkorb-und-checkout/quickstart) — die erste Regel in wenigen Minuten. * [Konfiguration](/plugins/cross-selling-warenkorb-und-checkout/konfiguration) — alle Felder im Detail. * [Verwaltungs-Dashboard](/plugins/cross-selling-warenkorb-und-checkout/verwaltungs-dashboard) — Regeln pflegen. # Konfiguration Die Plugin-Konfiguration findest du unter **Erweiterungen → Meine Erweiterungen → Cross-Selling Warenkorb und Checkout → … → Konfiguration**. Über das Auswahlfeld oben links wählst du den Verkaufskanal, für den die Einstellungen gelten sollen. {% hint style="info" %} Alle Einstellungen wirken **pro Verkaufskanal**. So kannst du in deinem B2C-Shop andere Slider-Positionen wählen als im B2B-Shop. {% endhint %} ## Allgemeine Einstellungen ### App aktivieren Der zentrale Schalter pro Verkaufskanal. Ist er aus, werden weder Slider noch Rabatte angezeigt — unabhängig davon, wie viele Regeln aktiv sind. Damit kannst du das gesamte Plugin in einem Shop vorübergehend deaktivieren, ohne deine Regeln zu verlieren. ### Standard-Badge-Farben | Feld | Bedeutung | | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | **Standard Rabatt Badge Hintergrund Farbe** | Hintergrundfarbe für Badges, bei denen in der Regel selbst keine Farbe gesetzt ist. Voreinstellung `#ff0000` (Rot). | | **Standard Rabatt Badge Text Farbe** | Textfarbe für Badges ohne eigene Farbe in der Regel. Voreinstellung `#ffffff` (Weiß). | Diese Werte greifen als **Fallback** — gibst du in einer Regel eigene Farben an, überschreiben sie die Standardwerte. ### Max. Anzahl Produkte im Cross-Selling Slider Begrenzt, wie viele Produkte pro Slider angezeigt werden. Voreinstellung: `10`. {% hint style="info" %} Erhöhe diesen Wert nur dann, wenn du wirklich viele relevante Cross-Sellings hast — zu lange Slider lenken Kund:innen ab. Werte zwischen 6 und 12 funktionieren in der Praxis am besten. {% endhint %} ### Produkt-Sortierung im Slider Bestimmt, in welcher Reihenfolge die Produkte im Slider erscheinen. Verfügbar sind: * **Name** (alphabetisch) * **Rabatt aufsteigend / absteigend** * **Preis aufsteigend / absteigend** * **Veröffentlichungsdatum aufsteigend / absteigend** Bei manuell ausgewählten Cross-Selling-Produkten kannst du die Reihenfolge in der Regel zusätzlich über die Position überschreiben. ### Immer den „In den Warenkorb"-Button anzeigen Wenn aktiv, wird der **„In den Warenkorb"-Button** im Slider immer angezeigt — auch bei Varianten-Mutter-Produkten. Standardmäßig führt ein Klick auf solche Produkte zur Detailseite (damit Kund:innen die Variante wählen können). Mit dieser Option erscheint der Button direkt, was bei Single-Variant-Produkten den schnellsten Weg in den Warenkorb ergibt. ## Slider-Positionen ### Cross-Selling Slider im Off-Canvas Warenkorb anzeigen | Wert | Bedeutung | | ---------------------------------- | ----------------------------------------------------------------------- | | **Nein** | Kein Slider im Off-Canvas. | | **Oberhalb vom Warenkorb** | Slider vor den Positionen. | | **Unterhalb vom Warenkorb** | Slider direkt nach den Positionen, vor der Summe. | | **Unterer Bereich des Off-Canvas** | Slider ganz unten — unter den Buttons. Sehr wirkungsvoll im Mobil-Flow. | ### Cross-Selling Slider im Warenkorb anzeigen Steuert den Slider auf der eigenen Warenkorb-Seite: * **Nein** * **Oberhalb vom Warenkorb** * **Unterhalb vom Warenkorb** ### Cross-Selling Slider im Checkout anzeigen Steuert den Slider auf der Bestellbestätigungs- und Checkout-Registrierungsseite: * **Nein** * **Oberhalb vom Checkout** * **Unterhalb vom Checkout** ## Sinnvolle Standardeinstellungen Für die meisten Shops funktioniert diese Kombination gut: | Einstellung | Empfehlung | | ---------------------------------------- | ------------------------------------------- | | Max. Produkte im Slider | `8`–`10` | | Produkt-Sortierung | Rabatt absteigend | | „In den Warenkorb"-Button immer anzeigen | An (außer du nutzt viele Variantenprodukte) | | Off-Canvas | Unterer Bereich des Off-Canvas | | Warenkorb | Unterhalb vom Warenkorb | | Checkout | Oberhalb vom Checkout | So sehen Kund:innen den Slider an drei wichtigen Stellen — ohne dass er den Kaufabschluss stört. ## Pro Verkaufskanal abweichend einstellen Wenn du mehrere Verkaufskanäle betreibst, kannst du oben links den Kanal wechseln und die Einstellungen abweichend pflegen. So lässt sich beispielsweise im B2C-Shop ein auffälliger Slider zeigen, während im B2B-Shop nur eine dezente Position unterhalb des Warenkorbs aktiv ist. # Storefront Integration Damit Cross-Selling im Warenkorb und Checkout funktioniert, fügt das Plugin an mehreren Stellen automatisch Inhalte ein. Du steuerst über die [Konfiguration](/plugins/cross-selling-warenkorb-und-checkout/konfiguration), an welcher Stelle und an welcher Position der Slider erscheint. ## Wo wird der Cross-Selling-Slider angezeigt? Der Slider ist überall dort verfügbar, wo Kund:innen ihren Einkauf betrachten oder abschließen — und kann pro Stelle einzeln aktiviert werden: ### Off-Canvas-Warenkorb Das ist der ausklappbare Warenkorb, der nach dem Hinzufügen eines Produkts erscheint. Hier hast du vier Optionen: * **Nein** — der Slider wird nicht angezeigt. * **Oberhalb vom Warenkorb** — der Slider erscheint vor der Positionsliste. * **Unterhalb vom Warenkorb** — der Slider erscheint zwischen Positionen und Zwischensumme. * **Unterer Bereich des Off-Canvas** — der Slider erscheint ganz unten unterhalb der Buttons. ### Warenkorb-Seite Die eigene Warenkorb-Seite (z. B. nach Klick auf „Warenkorb anzeigen"): * **Nein** * **Oberhalb vom Warenkorb** * **Unterhalb vom Warenkorb** ### Checkout-Seite Sowohl die Bestellbestätigung als auch die Checkout-Registrierungsseite: * **Nein** * **Oberhalb vom Checkout** * **Unterhalb vom Checkout** > Tipp: Viele Shopbetreiber:innen kombinieren **Off-Canvas (unten)** mit **Warenkorb-Seite (unterhalb)**. So sehen Kund:innen den Slider sowohl im schnellen Kaufprozess als auch in der ausführlichen Warenkorb-Ansicht. ### Produktdetailseite Auf der Produktdetailseite gibt es **keinen eigenen Slider**, der das Cross-Selling anzeigt. Stattdessen wird der **rabattierte Preis** direkt am Produkt angezeigt, sobald das Produkt unter eine aktive Cross-Selling-Regel fällt. Das funktioniert auch dann, wenn das auslösende Produkt noch nicht im Warenkorb liegt — solange die Regel vom Typ „Definiert durch Produkte / Dynamische Produktgruppe" ist und das aktuelle Produkt zur Cross-Selling-Liste gehört. ### Listing- und Suchseiten Ebenso erscheinen Produkte mit rabattiertem Preis und Rabatt-Badge in: * Kategorie-Listings * Suchergebnisseiten * Suchvorschlägen (Auto-Suggest) So fällt das Angebot bereits in der Übersicht auf, nicht erst im Warenkorb. ## Wie sieht der Slider aus? Der Slider ist ein **Produkt-Slider im Shopware-Standard-Design**: * Titel „Passende Produkte" (übersetzbar pro Sprache über Shopware-Snippets). * Navigationspfeile außen, Touch-Swipe für Mobilgeräte. * Standard-Karten-Layout, kompatibel zu allen Standard-Themes. * Rabattierte Produkte erhalten ein farbiges **Badge** mit Prozentwert und individuellem Text. * Optional: **„In den Warenkorb"-Button** sofort sichtbar — auch bei Variantenprodukten (steuerbar in der Konfiguration). ## Was passiert beim Klick auf ein Slider-Produkt? Klickt eine Kundin auf das Slider-Produkt: 1. **Beim Hinzufügen in den Warenkorb** wird automatisch der konfigurierte Rabatt abgezogen — als eigene Rabattposition mit deiner gewählten Beschriftung („Name des Rabatts im Warenkorb"). 2. Im Warenkorb und Checkout zeigt Shopware den **reduzierten Preis pro Position** sowie die **separate Rabattzeile**. 3. Auch der **Bestelldruck und die Bestätigungsmail** enthalten den korrekten Rabatt — du musst dafür nichts zusätzlich konfigurieren. ## Rabatte werden überall korrekt durchgerechnet Das Plugin nutzt die Shopware-Standard-Preisberechnung. Daher funktionieren auch: * **Mehrwertsteuer** — Brutto- und Netto-Preise stimmen weiterhin überein. * **Staffelpreise** — bei mehreren Mengen wird jede Staffel separat rabattiert. * **Grundpreise** (Referenzpreise) — der angezeigte Preis pro Einheit ist ebenfalls korrekt reduziert. * **Streichpreise (UVP)** — der ursprüngliche Preis bleibt als Streichpreis sichtbar, der reduzierte Preis daneben. ## Mehrsprachigkeit Alle sichtbaren Texte sind übersetzbar: * **Regelname** und **Rabatt-Bezeichnung im Warenkorb** legst du pro Sprache in der Regel an. * **Badge-Text** kannst du ebenfalls pro Sprache übersetzen. * Der **Slider-Titel** wird über Shopware-Snippets (`prems-cross-selling-checkout.slider-title`) gesteuert. Was nicht übersetzt ist, fällt automatisch auf die Systemsprache zurück. # Verwaltungs-Dashboard Das Plugin ergänzt das Shopware-Hauptmenü um einen eigenen Eintrag **Cross-Selling Checkout**. Darin pflegst du sämtliche Regeln, mit denen du Cross-Selling-Produkte und Rabatte steuerst. ## Die Regel-Liste Die Übersicht zeigt alle vorhandenen Cross-Selling-Regeln. Pro Zeile siehst du: | Spalte | Bedeutung | | -------------- | -------------------------------------------------------------------------------------------- | | **Name** | Der von dir vergebene Regelname. | | **Status** | `Aktiv`, `Inaktiv` oder `Abgelaufen` (wenn das Gültig-Bis-Datum in der Vergangenheit liegt). | | **Gültig von** | Startdatum, ab dem die Regel greift. Leer = sofort gültig. | | **Gültig bis** | Enddatum, bis zu dem die Regel greift. Leer = unbegrenzt. | | **Rabatt (%)** | Prozentualer Rabatt, der auf die Cross-Selling-Produkte angewendet wird. | Über **Anlegen** legst du eine neue Regel an, über die Zeilenaktionen kannst du bestehende bearbeiten oder löschen. ## Regel anlegen oder bearbeiten Der Editor ist in mehrere Reiter gegliedert: | Reiter | Inhalt | | --------------------------- | --------------------------------------------------------------------------------- | | Basis-Daten | Name, Status, Gültigkeit, Rabatt, Rabatt-Bezeichnung im Warenkorb, Badge-Schalter | | Badge | Badge-Text, Text- und Hintergrundfarbe | | Cross-Selling Einstellungen | Cross-Selling-Typ (automatisch / individuell) | | Trigger-Produkte | Welche Produkte die Regel auslösen | | Cross-Selling Produkte | Welche Produkte als Cross-Selling angeboten werden | ## Reiter „Basis-Daten" | Feld | Bedeutung | | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | **Name** | Interner Anzeigename in Liste und Übersichten. Übersetzbar. | | **Aktiv** | Schalter: aktiv / inaktiv. Inaktive Regeln werden in der Storefront ignoriert. | | **Gültig von / Gültig bis** | Optionales Zeitfenster. Außerhalb des Fensters wird die Regel nicht angewendet — du kannst dadurch Aktionen vorausplanen. | | **Rabatt** | Prozent-Wert zwischen 0 und 100. Bei `0` wird kein Rabatt angewendet, der Slider zeigt die Produkte aber trotzdem an. | | **Name des Rabatt im Warenkorb** | Beschriftung der Rabattposition im Warenkorb. Übersetzbar. Beispiel: „Bundle-Rabatt 10 %". | | **Badge bei Rabatt-Produkten anzeigen** | Wenn aktiv, erhält jedes Produkt, das unter diese Regel fällt, ein Rabatt-Badge in der Storefront. | ## Reiter „Badge" Steuert das Erscheinungsbild des Rabatt-Badges. Lässt du Farben leer, gelten die Standardfarben aus der Plugin-Konfiguration. | Feld | Bedeutung | | -------------------------- | -------------------------------------------------------------------------------------------- | | **Badge-Text** | Zusatztext neben dem Rabatt-Prozentwert. Übersetzbar. Beispiel: `Bundle-Aktion`, `Top-Deal`. | | **Badge-Text-Farbe** | Farbe des Textes. Hex-Code wie `#ffffff`. | | **Badge-Hintergrundfarbe** | Hintergrundfarbe. Hex-Code wie `#d9534f`. | > Weitere Details und Praxisbeispiele findest du auf der Seite [Rabatt-Badges](/plugins/cross-selling-warenkorb-und-checkout/rabatt-badges). ## Reiter „Cross-Selling Einstellungen" Zwei Typen stehen zur Auswahl: * **Automatisch anhand des Cross-Sellings der Produkte im Warenkorb**\ Das Plugin schaut nach den Produkten, die du bereits im **Shopware-Standard-Cross-Selling** an deinen Produkten gepflegt hast. Steht eines dieser Produkte im Warenkorb, werden seine Cross-Sellings im Slider angezeigt und können automatisch rabattiert werden. *Ideal, wenn du eh schon Cross-Sellings an deinen Produkten pflegst und keine doppelte Liste führen möchtest.* * **Definiert durch Produkte / Dynamische Produktgruppe**\ Du legst selbst fest, welche Produkte als **Trigger** dienen und welche Produkte als **Cross-Selling** angeboten werden. Beide Listen können entweder manuell oder über eine **dynamische Produktgruppe** gefüllt werden. *Ideal für Aktionen wie „Wer Produkt A kauft, erhält 10 % auf alle Produkte aus Kategorie B"*. ## Reiter „Trigger-Produkte" Nur sichtbar, wenn der Typ **Definiert durch Produkte / Dynamische Produktgruppe** gewählt ist. | Feld | Bedeutung | | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | **Produkte** | Manuelle Liste an Triggerprodukten. Sobald **eines** davon im Warenkorb landet, ist die Regel aktiv. | | **Dynamische Produktgruppe** | Alternativ eine Produktgruppe. Trifft die Filterregel der Gruppe auf ein Produkt im Warenkorb zu, ist die Regel aktiv. | Du kannst entweder Produkte, eine Gruppe oder beides kombinieren. Die Regel ist aktiv, sobald **irgendein** Treffer entsteht. ## Reiter „Cross-Selling Produkte" | Feld | Bedeutung | | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Produkte** | Manuell ausgewählte Produkte, die als Cross-Selling angeboten werden. Du kannst die **Position** pro Produkt festlegen, um eine feste Reihenfolge zu erzwingen. | | **Dynamische Produktgruppe** | Alternativ eine Produktgruppe. Sortierung und Maximalzahl steuerst du global in der [Konfiguration](/plugins/cross-selling-warenkorb-und-checkout/konfiguration). | Produkte, die bereits im Warenkorb liegen, werden im Slider automatisch ausgeblendet — Doppelangebote verhindert das Plugin von selbst. Auch das Trigger-Produkt selbst wird nicht als sein eigenes Cross-Selling-Produkt angezeigt. ## Mehrsprachigkeit Folgende Felder sind übersetzbar: * **Name** der Regel * **Name des Rabatts im Warenkorb** * **Badge-Text** Wechsle in der oberen Sprach-Auswahl der Detail-Seite die Sprache und pflege die Übersetzungen wie bei Shopware üblich. Was nicht übersetzt ist, fällt automatisch auf die Systemsprache zurück. ## Was passiert beim Speichern? Sobald du speicherst, wirkt die Regel im Hintergrund über den Cart-Processor von Shopware: * In der Storefront wird **bei jedem Warenkorb-Aufruf** geprüft, welche Cross-Selling-Produkte angeboten werden sollen. * Beim Hinzufügen eines Cross-Selling-Produkts wird der Rabatt automatisch in den Warenkorb übernommen — inkl. Mehrwertsteuer, Staffelpreisen und Grundpreisen. * Auf Produktdetail-, Listing- und Suchseiten wird der reduzierte Preis automatisch angezeigt, wenn das Produkt unter eine aktive Regel fällt. Mehr zu den Anzeigeorten findest du auf [Storefront-Integration](/plugins/cross-selling-warenkorb-und-checkout/storefront-integration). # Rabatt Badges Rabattierte Produkte können in der Storefront ein eigenes **Badge** tragen — ein farbiger Hinweis mit Rabatt-Prozentwert und Zusatztext. So fallen Aktionen sofort ins Auge. ## Wo erscheint das Badge? Das Badge wird überall dort angezeigt, wo das Produkt als rabattiert geführt wird: * Im **Cross-Selling-Slider** (Off-Canvas, Warenkorb, Checkout) * Auf der **Produktdetailseite** * In **Kategorie-Listings** * Auf **Suchergebnisseiten** und in Suchvorschlägen ## So aktivierst du das Badge Pro Regel im Verwaltungs-Dashboard kannst du das Badge ein- oder ausschalten: 1. Öffne **Cross-Selling Checkout → Regel → Reiter „Basis-Daten"**. 2. Schalte **Badge bei Rabatt-Produkten anzeigen** ein. 3. Speichere die Regel. Ist der Schalter aus, erhalten die rabattierten Produkte **kein** Badge — der Rabatt wird trotzdem im Warenkorb gewährt. ## Badge gestalten Im Reiter **Badge** legst du das Aussehen fest: | Feld | Beispiel | | -------------------------- | ------------------------------------------------------------------------------------- | | **Badge-Text** | `Bundle-Aktion`, `Top-Deal`, `Aktion`, `Sale`. Übersetzbar pro Sprache. | | **Badge-Text-Farbe** | Hex-Code wie `#ffffff` (Weiß), `#ffe600` (Gelb), `#000000` (Schwarz). | | **Badge-Hintergrundfarbe** | Hex-Code wie `#d9534f` (Rot), `#198754` (Grün), `#0d6efd` (Blau), `#fd7e14` (Orange). | Das Badge wird dann zusammengesetzt aus dem **Rabatt-Prozentwert** und dem **Badge-Text**. Beispiel: bei `Rabatt = 15` und `Badge-Text = Aktion` erscheint: > **−15 % Aktion** Lässt du Farben leer, werden die in der [Konfiguration](/plugins/cross-selling-warenkorb-und-checkout/konfiguration) hinterlegten Standardfarben verwendet. ## Praxisbeispiele | Aktion | Hintergrund | Textfarbe | Text | | ---------------------- | ----------- | --------- | --------------- | | Black Friday | `#000000` | `#ffffff` | `Black Friday` | | Sommer-Sale | `#fd7e14` | `#ffffff` | `Summer Sale` | | Bundle-Rabatt | `#0d6efd` | `#ffffff` | `Bundle-Aktion` | | Treuekund:innen-Aktion | `#198754` | `#ffffff` | `Treue-Aktion` | | Lager-Räumung | `#d9534f` | `#ffffff` | `Räumung` | ## Mehrsprachige Badge-Texte Wechsle in der Detail-Seite oben rechts die Sprache, um einen abweichenden Text für eine andere Sprache zu hinterlegen. Lässt du einen Sprach-Eintrag leer, fällt das Badge automatisch auf den Text der Systemsprache zurück. ## Hinweise * Wenn der **Rabatt-Wert 0 %** ist, erscheint **kein** Badge — eine Regel mit 0 % wirkt rein als „Produktempfehlungs"-Regel ohne Rabatt. * Pro Produkt wird **ein** Badge angezeigt. Liegt ein Produkt unter mehreren Regeln, gewinnt die Regel mit dem höchsten Rabatt. * Das Badge nutzt einfaches Inline-CSS und ist daher mit so gut wie jedem Storefront-Theme kompatibel. # Dynamische Produktgruppen Dynamische Produktgruppen sind eine **Shopware-Standardfunktion** unter **Kataloge → Dynamische Produktgruppen**. Sie definieren über Filterregeln (z. B. „Hersteller = Acme" oder „Kategorie enthält ‚Kaffee'"), welche Produkte zu einer Gruppe gehören. Sobald du ein neues Produkt anlegst, das die Regel erfüllt, gehört es automatisch zur Gruppe — du musst nichts mehr manuell zuweisen. Das Plugin nutzt diese Gruppen sowohl für die **Trigger-Produkte** als auch für die **Cross-Selling-Produkte** einer Regel. So sparst du dir laufende Pflegearbeit. ## Wo werden dynamische Produktgruppen verwendet? * **Trigger-Produkte:** Bestimme über die Gruppe, **wann** eine Regel ausgelöst wird. Beispiel: Liegt irgendein Produkt aus der Gruppe „Kaffeemaschinen" im Warenkorb, schlägt die Regel an. * **Cross-Selling-Produkte:** Bestimme über die Gruppe, **welche Produkte** als Cross-Selling angeboten werden. Beispiel: Alle Produkte aus der Gruppe „Kaffeebohnen" erscheinen im Slider. ## Eine neue dynamische Produktgruppe anlegen 1. Öffne **Kataloge → Dynamische Produktgruppen**. 2. Klicke auf **Dynamische Produktgruppe hinzufügen**. 3. Vergib einen aussagekräftigen Namen, z. B. `Kaffeebohnen — Aktion`. 4. Definiere unter **Filter** die Bedingungen, z. B. „Kategorie ist `Kaffeebohnen`". 5. Speichere die Gruppe — Shopware zeigt dir sofort eine Vorschau der zugeordneten Produkte. {% hint style="info" %} Du kannst Filter beliebig kombinieren. Zum Beispiel „Hersteller = Acme **und** Preis ≤ 50 €" — perfekt für gezielte Aktionen. {% endhint %} ## Gruppe in einer Regel verwenden 1. Öffne im **Cross-Selling Checkout** eine Regel und gehe zum Reiter **Trigger-Produkte** oder **Cross-Selling Produkte**. 2. Wähle im Feld **Dynamische Produktgruppe** die zuvor angelegte Gruppe. 3. Speichere die Regel — die Gruppe wirkt sofort. Du kannst Trigger- und Cross-Selling-Liste auch **kombinieren**: zum Beispiel einzelne Trigger-Produkte zusätzlich zur Gruppe pflegen. ## Varianten und dynamische Gruppen Damit auch Variantenprodukte korrekt erkannt werden, prüft das Plugin **sowohl die Variante als auch das Hauptprodukt** gegen die Gruppe. Eine Regel wie „Wenn ein T-Shirt im Warenkorb liegt" greift damit für alle Größen und Farben des T-Shirts, sofern die Gruppe das T-Shirt selbst oder seine Variante erfasst. ## Beispielszenarien | Szenario | Trigger-Gruppe | Cross-Selling-Gruppe | | -------------------------------------- | -------------------------------- | -------------------- | | „Wer Hardware kauft, bekommt Zubehör" | `Hardware` | `Zubehör` | | „Aktion auf Bohnen zu Kaffeemaschinen" | `Kaffeemaschinen` | `Kaffeebohnen` | | „Reduzierung für Premium-Kund:innen" | Manuell ausgewählte Top-Produkte | `Treue-Aktion` | | „Saisonale Aktion" | `Sommerprodukte` | `Sommer-Aktion` | ## Vorteile gegenüber manueller Produktliste * **Kein Nachpflegen** beim Sortimentswechsel — neue Produkte fließen automatisch ein. * **Skalierbar** — auch tausende Produkte sind problemlos abgedeckt. * **Wiederverwendbar** — dieselbe Gruppe kann in mehreren Regeln und sogar im Shopware-Standard-Cross-Selling oder in Aktionen wiederverwendet werden. ## Wann lieber eine manuelle Liste? * Wenn die Cross-Selling-Auswahl bewusst **kuratiert** sein soll. * Wenn du **feste Reihenfolge** der Produkte im Slider erzwingen möchtest — bei manueller Liste lässt sich die Position pro Produkt setzen. * Bei sehr kleinen Aktionen mit wenigen Produkten — dort ist die Pflege per Hand schneller als das Anlegen einer Gruppe. {% hint style="info" %} Manuelle Listen und dynamische Gruppen lassen sich **kombinieren**. So pflegst du z. B. 3 Top-Empfehlungen manuell mit fester Position und füllst die restlichen Plätze über eine Gruppe auf. {% endhint %} # Preis auf Anfrage - Individuelles Angebot Es wird das Plugin [Individuelles Angebot](https://store.shopware.com/prems68891056375/individuelles-angebot.html) mindestens in der Version 1.3.0 benötigt. Installation über den Plugin Manager. Nach der Installation bitte das Plugin konfigurieren.
### Pluginkonfiguration \- Plugin aktivieren \- Preise für Kundengruppe ausblenden
Wenn Sie in der Administration ein Produkt editieren, finden Sie außerdem den neuen Bereich "Preis auf Anfrage". Im Dropdown "Verwendung" gibt es die folgenden Möglichkeiten: \- Plugin Einstellungen verwenden \- Alle Preise immer ausblenden \- Immer alle Preise anzeigen


# Belohnungsstufen mit Bonus Punkten Bitte stellen Sie sicher, das Sie das Plugin "Bonus System für Shopware 6" bereits erworben und installiert haben. Die Installation des Belohnungsstufen Plugins erfolgt über den Plugin Manager. Nach der Installation muss das Plugin konfiguriert werden.
### Konfiguration \- Plugin aktivieren: Aktiviert das Plugin für den jeweiligen Verkaufskanal\ \- Multi Level aktivieren: Erreicht Ihr Kunde eine neue Belohnungsstufe, so gelten auch die Rabatte der zuvor erreichten Stufen weiterhin.\ \- Kundengruppe verbieten: Schließt bestimmte Kundengruppen vom Belohnungsstufen System aus.\
### Verwaltung Unter "Marketing -> Bonus System -> Belohnungsstufen" können Sie neue Belohnungsstufen anlegen oder bestehende editieren. Zum Anlegen einer neuen Belohnungsstufe klicken Sie den Button "Neue Belohnungsstufe anlegen". Wählen Sie einen Namen und optional ein Bild und Beschreibungstext. Definieren Sie, wieviele Bonuspunkte erreicht sein müssen, bevor ein bestimmter Rabatt greift. Mittels der Option "Badge bei rabattierten Produkten in Liste anzeigen", können Sie neben dem Prozent Icon auch einen individuellen Badge Text mit festgelegter Textfarbe und Hintergrundfarbe ausgeben lassen. Im Bereich Bedingungen können Sie genau definieren, welche Produkte für den Rabatt ausgewählt werden sollen. Vergessen Sie am Ende nicht den Schieberegler auf "aktiv" zu setzen und zu speichern. # B-Ware #### 🔁 **B-Ware clever verkaufen – mit unserer Erweiterung für Shopware 6** Mit unserer **B-Ware-Erweiterung für Shopware 6** bringst Du Rückläufer, Ausstellungsstücke oder generalüberholte Produkte ganz einfach zurück in den Verkauf – **transparent, automatisiert und kundenfreundlich**.
🛠️ **Einfache Verwaltung & klare Kennzeichnung**\ Markiere Produkte schnell und unkompliziert als B-Ware und ergänze individuelle Hinweise zu **Zustand**, **Rabatt** oder **Rückgaberechten**. So wissen Deine Kunden genau, was sie erwartet – und Du sorgst für Vertrauen und Kaufbereitschaft. *** 🛒 **Nahtlose Integration in Deinen Shop**\ Ob im **Produktlisting** oder auf der **Detailseite** – B-Ware wird übersichtlich dargestellt, auf Wunsch mit **Badges** und **Filtermöglichkeiten**. Damit wird kein Angebot übersehen. *** 🔄 **Automatische Verlinkung von B-Ware**\ Ist für einen Neuwaren-Artikel eine passende B-Ware-Version verfügbar, wird diese automatisch auf der Produktseite angezeigt. Deine Kunden können mit nur einem Klick direkt zur günstigeren Alternative wechseln – **perfekt für mehr Conversions!** *** 🚫 **Steuerung nach Kundengruppe**\ Du entscheidest, **wer B-Ware sehen oder kaufen darf**: In den Einstellungen kannst Du gezielt Kundengruppen ausschließen – z. B. für B2B-Shops, Sonderaktionen oder exklusive Zielgruppen. *** 🌱 **Nachhaltig. Effizient. Umsatzstark.**\ Mit der B-Ware-Erweiterung machst Du mehr aus Deinen Beständen, senkst Retourenkosten und bietest gleichzeitig nachhaltige Einkaufsmöglichkeiten – **ganz ohne Zusatzaufwand**. *** 💡 **Ideal für alle Händler**, die ihre B-Ware professionell, sichtbar und kontrolliert verkaufen möchten – direkt in Shopware 6 integriert. # Voraussetzungen Die Erweiterung kann nur in einer selbst verwalteten Shopware-Umgebung mit mindestens Version 6.6.0 installiert werden. # Installation Installieren die Erweiterung in der Admin unter **Erweiterungen** > **Meine Erweiterungen**. Gebe nach der Installation einen **Verkaufskanal** an, für den die Erweiterung aktiviert werden soll. Die Standardeinstellung ist **Alle Verkaufskanäle**. Die Erweiterung hat zwei Aspekte: * Grundlegende Konfiguration * Anlegen/ Editieren von B-Ware Führe zunächst die Schritte im Abschnitt Basiskonfiguration aus und lese dann den Abschnitt **Anlegen/ Editieren von B-Ware**, um zu erfahren, wie du B-Ware fortlaufend verwalten kannst. ### Grundlegende Konfiguration Bevor du die Erweiterung aktivierst, überprüfe die Einstellungen in diesem Abschnitt und stellen sicher, dass sie deinen Anforderungen entsprechen. Nehme Änderungen an den einzelnen Feldern wie unten beschrieben vor, indem du **Meine Erweiterungen** > **B-Ware** > **Konfiguration** wählst.
### Allgemeine Einstellungen Die allgemeinen Einstellungen bieten grundlegende Steuerelemente, wie z. B. die Aktivierung/Deaktivierung der Erweiterung. | Feld | Typ | Beschreibung | | ----------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Für diesen Verkaufskanal aktivieren | KippSch. | Aktiviere mit dieser Einstellung die B-Ware für den zugehörigen Verkaufskanal. | | Kundengruppe verbieten | Dropdown-Menü | Wähle in dem Dropdown Kundengruppen aus, die keine B-Ware sehen und kaufen dürfen. | | B-Ware nicht als normales Shop Produkt anzeigen | KippSch. | Wenn diese Option aktiviert ist, wird ein als generalüberholt definiertes Produkt aus der Produktliste ausgeblendet, kann nicht gesucht werden und die Produktdetailseite kann nicht aufgerufen werden. | | B-Ware auf Detailseite von Neuware anzeigen | KippSch. | Wenn einem Produkt B-Ware zugeordnet ist, wird diese auf der Produktdetailseite angezeigt. | # Anlegen/ Editieren von B-Ware Dieser Bereich umfasst mehrere Teilbereiche. * Anlegen und Editieren von Zuständen * Anlegen und Editieren von B-Ware (as regular product) * Nutzung der B-Ware Pflegemaske ### Anlegen und Editieren von Zuständen Für B-Ware können vordefinierte Zustände angelegt werden wie beispielsweise "Aufbereitet", "Kratzer" etc. und für diese Zustände Beschreibungstexte hinterlegt werden. Ein Zustand kann dann einem B-Ware Produkt zugeordnet werden. Dies ist optional und alternativ kann ein individueller Beschreibungstext auch bei dem jeweiligen B-Ware Produkt hinterlegt werden. Das Anlegen oder Editieren eines Zustandes erfolgt in der Shopware Admin unter **Kataloge -> B-Ware -> Zustände**. ### Anlegen und Editieren von B-Ware als reguläres Produkt B-Ware wird als reguläres Shop Produkt unter **Kataloge -> Produkte** angelegt. Damit aus einem normalen Produkt ein B-Ware Produkt wird, wähle ein bestehendes Produkt aus oder lege ein Neues an und wechsle dann auf den Reiter Spezifikationen.
Unter **Zusatzfelder**, kannst du im Tab **B-Ware** die passenden Einstellungen für das Produkt vornehmen.
Es stehen die folgenden Möglichkeiten zur Verfügung: | Feld | Typ | Beschreibung | | -------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | B-Ware | KippSch. | Aktiviere den Schalter um das Produkt als B-Ware zu markieren. | | Eltern Produkt | Dropdown-Menü | Wähle das Neuware Produkt aus, zu dem das B-Ware Produkt gehört. | | Zustand | Dropdown-Menü | Optional: Wähle einen vordefinierten Zustand der B-Ware aus. | | Zustand Beschreibung | Textfeld | Optional: Lege einen Beschreibungstext für den Zustand an. Falls du bereits einen Zustand ausgewählt hast, wird der vordefinierte Text verwendet, wenn du ihn hier nicht überschreibst. | | Zustand Bild | Medien Auswahlfeld | Optional: Wählen ein Bild aus dem Medienmanager, welches etwaige Mängel des B-Ware Produktes aufzeigt. | {% hint style="info" %} Das B-Ware Produkt muss ein eigenständiges Produkt ohne Varianten sein. Es darf nicht als Variante des Neuware Produktes angelegt werden. \ Wenn Du B-Ware für eine Variante anbieten möchtest, dann lege ein neues Produkt an, konfiguriere es als B-Ware and wähle als Eltern Produkt die Variante. {% endhint %} ### Nutzung der B-Ware Pflegemaske Als Alternative zum Weg über **Kataloge -> Produkte**, kannst Du B-Ware auch über eine spezielle Pflegemaske aufrufen. Diese findest du unter **Kataloge -> B-Ware -> B-Ware**. Eine Liste aller B-Ware Produkte wird angezeigt. Mittels Klick auf **...** kannst Du bestehende Einträge editieren oder löschen. Mittels Klick auf den Button **Hinzufügen**, kannst Du ein neues B-Ware Produkt anlegen. {% hint style="info" %} Es handelt sich hierbei um eine vereinfachte Pflegemaske für Produkte. Wenn Du mehr Funktionalitäten benötigst, so klicke den Button **Produkt Detail Fenster**. Es öffnet sich dann die reguläre Produkt Detailseiten mit allen gewohnten Optionen. {% endhint %} # SCHUFA Bonitätsprüfung Mit der SCHUFA-Bonitätsprüfung erhalten Online-Shops eine verlässliche Entscheidungsgrundlage, um wirtschaftliche Risiken im digitalen Handel effektiv zu steuern. Die Echtzeitbewertung der Kreditwürdigkeit von Kundinnen und Kunden hilft dabei, Ausfallquoten zu senken und betrügerische Aktivitäten frühzeitig zu erkennen.
Auf Basis der individuellen Bonität können Zahlungsarten wie Rechnungskauf oder SEPA-Lastschrift automatisch freigeschaltet oder eingeschränkt werden. Risikobehaftete Zahlungsoptionen werden somit gezielt nur denjenigen angeboten, deren Zahlungsfähigkeit entsprechend positiv bewertet wurde. Kundinnen und Kunden mit guter Bonität profitieren von größerer Flexibilität und einem komfortableren Einkaufserlebnis durch zusätzliche Zahlungsoptionen. Die Integration der SCHUFA-Bonitätsprüfung in den Checkout-Prozess ist unkompliziert und unterstützt eine transparente Entscheidungsfindung. Dadurch sichern Händlerinnen und Händler nicht nur ihre Umsätze, sondern stärken auch ihre langfristige Liquidität. # Voraussetzungen 1. Die Erweiterung kann nur in einer selbst verwalteten Shopware-Umgebung mit mindestens Version 6.6.9 installiert werden. 2. Es werden ein SCHUFA-Anschlussvertrag und API Zugangsdaten benötigt. 3. Der Shop muss Zahlarten enthalten, die ein Ausfallrisiko aufweisen und die über den Shop Betreiber selber abgewickelt werden. {% hint style="warning" %} Eine SCHUFA Abfrage darf nur für Zahlungsarten durchgeführt werden, bei denen ein Ausfallrisiko für den Shop Betreiber besteht. Dies sind die Zahlarten: **Kauf auch Rechnung** und **SEPA Lastschrift**. In der Datenschutzerklärung des Shops muss darauf hingewiesen werden, das SCHUFA Anfragen für die genannten Zahlarten bei Bestellabschluss durchgeführt werden, hierzu stellt die SCHUFA eine Textvorlage nach DSGVO bereit. {% endhint %} 4. Die Erweiterung ist ausschließlich für EUR Geldbeträge. Stelle sicher, das Du keine anderen Währungen zusammen mit der Prüfung verwendest. # Installation Installation der Erweiterung unter **Erweiterungen >** **Meine Erweiterungen**.
Nach der Installation ist die Konfiguration für die Erweiterung zu finden unter **Einstellungen > Erweiterungen > SCHUFA Bonitätsprüfung**. Die Installation der Erweiterung umfasst zwei Teilbereiche: * SCHUFA Zugangsdaten * Konfiguration der Erweiterung Schließe erst den Bereich **SCHUFA Zugangsdaten** ab, bevor du die **Konfiguration der Erweiterung** durchführst. ### Schufa Zugangsdaten Um eine SCHUFA Bonitätsabfrage in deinem Shop durchzuführen, musst du zuerst einen SCHUFA Account beantragen und deine SCHUFA API Zugangsdaten konfigurieren. Folge unserer Schritt für Schritt [Anleitung](/plugins/schufa-bonitatsprufung/installation/schufa-zugangsdaten) für weitere Informationen. ### Konfiguration der Erweiterung Die Konfiguration der Erweiterung ist in der Shopware Administration zu finden unter **Einstellungen > Erweiterungen > Schufa Bonitätsprüfung**. Führe hier mindestens die Konfiguration unter dem Reiter **SCHUFA API** durch. Details zu den Einstellungen findest du unter folgendem [Link](/plugins/schufa-bonitatsprufung/installation/konfiguration-der-erweiterung). # SCHUFA Zugangsdaten Um die Erweiterung zu nutzen, musst du diese Schritte abschließen: * [ ] SCHUFA Zugangsdaten beantragen * [ ] Zugangsdaten aus den SCHUFA E-Mails übernehmen * [ ] SCHUFA Zertifikatsdateien anfordern und herunterladen * [ ] Zugangsdaten und Zertifikate in der Erweiterung hinterlegen ### SCHUFA Zugangsdaten beantragen Für die Nutzung der Erweiterung benötigst du SCHUFA Zugangsdaten. Kontaktiere hierfür: Frank Wuttke\ E-Mail: \ Telefon: +49 173 994 654 2 {% hint style="info" %} Erwähne bei der Beantragung, dass du die PremSoft SCHUFA Erweiterung einsetzen möchtest.\ So setzt die SCHUFA die passenden Berechtigungen für deinen Zugang. {% endhint %} ### Zugangsdaten aus den SCHUFA E-Mails übernehmen Nach der Kontaktaufnahme erhältst du eine E-Mail mit ersten Informationen und Vertragsunterlagen. Sobald alle Fragen geklärt sind und der Vertrag unterschrieben ist, bekommst du ein paar Tage später eine weitere E-Mail mit den benötigten Zugangsdaten. ### SCHUFA Zertifikat anfordern Eine der E-Mails enthält deine SCHUFA **Teilnehmerkennung** und dein **Online-Passwort**. Diese Werte brauchst du später in der Konfiguration. In einer weiteren E-Mail wird beschrieben, wie du die benötigten SCHUFA Zertifikatsdateien anforderst. {% hint style="info" %} Während der Zertifikatsanforderung weist die SCHUFA darauf hin, dass die Ausstellung etwas dauern kann.\ Sobald das Zertifikat verfügbar ist, wirst du per E-Mail benachrichtigt. {% endhint %} ### Zugangsdaten und Zertifikatsdateien in der Erweiterung hinterlegen Sobald du Zugangsdaten und Zertifikatsdateien erhalten hast, hinterlegst du sie in der Shopware Administration in der Konfiguration der Erweiterung. Weiter mit [Konfiguration der Erweiterung](/plugins/schufa-bonitatsprufung/voraussetzungen). # Konfiguration der Erweiterung Um eine SCHUFA Bonitätsabfrage in deinem Shop durchzuführen, musst du zuerst einen SCHUFA Account beantragen und deine SCHUFA API Zugangsdaten konfigurieren. Folge unserer Schritt für Schritt [Anleitung](/plugins/schufa-bonitatsprufung/installation/schufa-zugangsdaten) für weitere Informationen. ### SCHUFA API In dem Bereich werden die Zugangsdaten hinterlegt, welche für die Verbindung zur SCHUFA notwendig sind.
| Feld | Typ | Beschreibung | | -------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Modus | Auswahlfeld | Auswahl zwischen Test- und Live Modus. Die Funktionsweise der Erweiterung sollte immer erst im Test Modus geprüft werden. Hierbei ist zu beachten, das ausschließlich mit den Testdatensätzen der SCHUFA getestet werden darf. | | Öffentliche Zertifikat Schlüssel Datei | Datei Upload | Lade die Datei mit dem öffentlichen Zertifikatsschlüssel hier hoch, welche du von der SCHUFA erhalten hast. Dies ist eine Datei mit der Endung **certs.pem**. | | Private Zertifikat Schlüssel Datei | Datei Upload | Lade die Datei mit dem privaten Zertifikatsschlüssel hier hoch, welche du von der SCHUFA erhalten hast. Dies ist eine Datei mit der Endung **key.pem**. | | Schlüssel Passwort | Passwort Feld | Gebe das Passwort ein, mit dem du deine Zertifikat Schlüssel Datei gesichert hast. | | Teilnehmerkennung | Texteingabe | Die Teilnehmerkennung erhälst du von der SCHUFA per E-Mail. | | Teilnehmerpasswort | Passwort Feld | Hinterlege das Teilnehmerpasswort, welches dir die SCHUFA per E-Mail mitgeteilt hat. | {% hint style="info" %} Stelle sicher, das du die API Daten korrekt hinterlegt hast indem du nach dem Speichern der Daten den **Verbindung prüfen** Button klickst. Nach Betätigen des Buttons erscheint eine Erfolgs- oder Fehlermeldung. {% endhint %} ### Konfiguration Tätige allgemeine Konfigurationseinstellungen für die Nutzung der Erweiterung.
| Feld | Typ | Beschreibung | | ---------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Minimum Warenkorbwert in EUR | Numerische Eingabe | Mit Eingabe eines Minimum Netto-Warenkorbwertes kann festgelegt werden, das eine SCHUFA Abfrage erst ab einer bestimmten Schwelle getätigt wird. | | Log Level | Auswahlfeld |

Legt fest ob Debug Informationen oder lediglich nur Fehler im Logfile des Shops erfasst werden sollen.
Im Live Betrieb sollten lediglich Fehler geloggt werden, da das Logfile ansonsten stark anwachsen kann.

| | Cache aktivieren | Schalter |

Aktiviert das Caching von SCHUFA Abfragen. Sowohl als Zusatzfelder als auch in der Session des Nutzers.
Wichtig: Das Caching sollte nur im Test-Modus und zu Fehlersuche Zwecken deaktiviert werden. Ansonsten erfolgen unnötig viele SCHUFA Abfragen.

| ### B2C Rating Stufen Der Bereich zeigt die SCHUFA Score Stufen für B2C Kunden und ist unterteilt in die Spalten: * Rating Level * Risikoquote in % * Maximaler Warenkorbwert in EUR * Speicherzeit in Tagen
Das **Rating Level** und die **Risikoquote** sind die Bewertung der SCHUFA für den angefragten Kunden. Der **Maximale Warenkorbwert** ist eine Beschränkung wie hoch der Warenkorbwert für den angefragten Kunden mit der entsprechenden Risikoeinstufung sein darf. Das heißt wenn der Warenkorbwert überschritten wird, dann wird eine entsprechende Zahlart automatisch gesperrt, auch wenn diese auf Basis der Bonität des Kunden erlaubt wäre. Mit der **Speicherzeit in Tagen** wird festgelegt wie lange die Anfrage eines Kunden im Shop gespeichert wird, bevor bei erneuter Bestellung eine neue SCHUFA Abfrage durchgeführt wird. Bei **Rating Level** und **Riskoquote** handelt es sich um feste, unveränderliche Werte, wohingegen **Maximaler Warenkorbwert** und **Speicherzeit** angepasst werden können. #### Anpassen des Warenkorbwerts und der Speicherzeit Klicke auf die drei **...** bei einem Eintrag und wähle die Option **Bearbeiten**. Es öffnet sich die Seite zum Editieren des Eintrages. Die Felder Rating Level und Risikoquote sind nicht veränderlich, da diese Werte fest über die SCHUFA Schnittstelle ausgegeben werden.
| Feld | Typ | Beschreibung | | ------------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Rating Level | Gesperrtes Feld | SCHUFA Rating Level | | Risikoquote in % | Gesperrtes Feld | SCHUFA Risikoquote | | Maximaler Warenkorbwert in EUR | Numerische Eingabe | Lege fest wie hoch der maximale Netto Warenkorbwert in EUR sein darf, wenn ein Kunde das Rating Level bzw. die Risikoquote hat, die für diesen Eintrag hinterlegt sind. | | Speicherzeit in Tagen | Numerische Eingabe | Gibt für wie viele Tage eine erfolgte SCHUFA Anfrage gespeichert werden soll. Tätigt ein Nutzer innerhalb dieser Zeit eine erneute Bestellung, so wird keine neue Abfrage gestartet. | Zum Speichern von Änderungen klicke den Button **Speichern**. Um wieder auf die Listenansicht zu gelangen klicke den Button **Abbrechen**. ### B2B Rating Stufen Der Bereich zeigt die SCHUFA Score Stufen für B2B Kunden und ist unterteilt in die Spalten: * Bonitätsindex * Risikoquote in % * Maximaler Warenkorbwert in EUR * Speicherzeit in Tagen
Der **Bonitätsindex** und die **Risikoquote** sind die Bewertung der SCHUFA für den angefragten Kunden. Der **Maximale Warenkorbwert** ist eine Beschränkung wie hoch der Warenkorbwert für den angefragten Kunden mit der entsprechenden Risikoeinstufung sein darf. Das heißt wenn der Warenkorbwert überschritten wird, dann wird eine entsprechende Zahlart automatisch gesperrt, auch wenn diese auf Basis der Bonität des Kunden erlaubt wäre. Mit der **Speicherzeit in Tagen** wird festgelegt wie lange die Anfrage eines Kunden im Shop gecacht wird, bevor bei erneuter Bestellung eine neue SCHUFA Abfrage durchgeführt wird. Bei **Rating Level** und **Bonitätsindex** handelt es sich um feste, unveränderliche Werte, wohingegen **Maximaler Warenkorbwert** und **Speicherzeit** angepasst werden können. #### Anpassen des Warenkorbwerts und der Speicherzeit Klicke auf die drei **...** bei einem Eintrag und wähle die Option **Bearbeiten**. Es öffnet sich die Seite zum Editieren des Eintrages. Die Felder Rating Level und Risikoquote sind nicht veränderlich, da diese Werte fest über die SCHUFA Schnittstelle ausgegeben werden.
| Feld | Typ | Beschreibung | | ------------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Bonitätsindex | Gesperrtes Feld | SCHUFA Bonitätsindex | | Risikoquote in % | Gesperrtes Feld | SCHUFA Risikoquote | | Maximaler Warenkorbwert in EUR | Numerische Eingabe | Lege fest wie hoch der maximale Netto Warenkorbwert in EUR sein darf, wenn ein Kunde das Rating Level bzw. die Risikoquote hat, die für diesen Eintrag hinterlegt sind. | | Speicherzeit in Tagen | Numerische Eingabe | Gibt für wie viele Tage eine erfolgte SCHUFA Anfrage gespeichert werden soll. Tätigt ein Nutzer innerhalb dieser Zeit eine erneute Bestellung, so wird keine neue Abfrage gestartet. | Zum Speichern von Änderungen klicke den Button **Speichern**. Um wieder auf die Listenansicht zu gelangen klicke den Button **Abbrechen**. ### Konfigurieren von Zahlarten für SCHUFA Prüfung Soll eine Zahlart für eine Bestellung nur nach positiver SCHUFA Prüfung möglich sein, so musst du dies bei der jeweiligen Zahlart konfigurieren. {% hint style="warning" %} Eine SCHUFA Abfrage darf nur für Zahlungsarten durchgeführt werden, bei denen ein Ausfallrisiko für den Shop Betreiber besteht. Dies sind die Zahlarten: **Kauf auch Rechnung** und **SEPA Lastschrift**. {% endhint %} Wähle in der Shopware Administration unter **Einstellungen > Shop > Zahlungsarten** die gewünschte Zahlart aus und klicke auf **Details bearbeiten**.\ Es öffnet sich die Editiermaske der Zahlart. Scrolle nach unten bis der Bereich Zusatzfelder angezeigt wird. Aktiviere die Risikoprüfung für die Zahlart indem du den Schalter bei **SCHUFA Risikoprüfung aktivieren** klickst. {% hint style="info" %} Wenn der Shop mehrsprachig ist, dann diese Einstellung bitte für die Standard Sprache vornehmen oder für jede Sprache, falls die Vererbung nicht genutzt werden soll. {% endhint %}
# Google Merchant Center Das Benutzerhandbuch steht auf Englisch zur Verfügung: # FedEx Das Benutzerhandbuch steht auf Englisch zur Verfügung: # USPS Das Benutzerhandbuch steht auf Englisch zur Verfügung: # SSO / Single Sign-On Login Das Benutzerhandbuch steht auf Englisch zur Verfügung: # Abgebrochene Warenkörbe Erinnerung ### **Verpasste Verkäufe zurückgewinnen – mit dem Abandoned-Cart-Plugin** Ein nicht abgeschlossener Warenkorb bedeutet nicht automatisch einen verlorenen Kunden. Mit unserem leistungsstarken Abandoned-Cart-Plugin können Sie genau diese Chancen nutzen und potenzielle Käufer zurück in Ihren Shop bringen. Die Erweiterung erinnert Ihre Kunden automatisch daran, ihren Einkauf zu vollenden – effizient, personalisiert und komplett automatisiert.
#### Mehr Umsatz durch automatisierte Erinnerungen Das Plugin verschickt automatisch Erinnerungs-E-Mails an Kunden, die ihren Einkauf unterbrochen haben. Du kannst selbst festlegen, wann diese Nachrichten versendet werden sollen – zum Beispiel nach 3, 10 oder 30 Tagen. So bleibst du präsent, ohne zusätzliche Arbeit investieren zu müssen. #### Klare Auswertungen und hilfreiche Statistiken Behalte jederzeit den Überblick über deine Ergebnisse. Die integrierten Statistiken zeigen dir, wie viele Warenkörbe erfolgreich reaktiviert wurden und welche E-Mail-Kampagnen besonders effektiv sind. #### Flexible Gestaltung der E-Mail-Vorlagen Passe deine Erinnerungs-E-Mails individuell an dein Markenbild an. Integriere dein Logo, verwende personalisierte Texte und setze klare Handlungsaufforderungen, um deine Kunden gezielt zurück in den Bestellprozess zu führen. #### Kundenfreundliche Opt-Out-Funktion Transparenz ist entscheidend für Vertrauen. Ihre Kunden können in ihrem Benutzerkonto jederzeit entscheiden, ob sie Erinnerungen erhalten möchten oder diese deaktivieren. #### Übersichtliche Verwaltung im Admin-Bereich Alle abgebrochenen Warenkörbe werden übersichtlich in deiner Shop-Administration dargestellt. Dadurch kannst du schnell analysieren, welche Produkte häufig im Warenkorb bleiben und entsprechende Optimierungen vornehmen. #### **Fazit** Dieses Plugin ist mehr als nur eine Erinnerungslösung. Es unterstützt dich aktiv dabei, verlorene Umsätze zurückzuholen, deine Conversion-Rate zu steigern und das volle Potenzial deines Online-Shops auszuschöpfen. **Jetzt installieren und weniger Verkäufe verlieren!** # Voraussetzungen Die Erweiterung kann nur in einer selbst verwalteten Shopware-Umgebung mit mindestens Version 6.6.9 installiert werden. # Installation Installiere die Erweiterung durch **Erweiterungen** > **Meine Erweiterungen**.
Nehme Änderungen an den einzelnen Feldern wie unten beschrieben vor, indem du **Meine Erweiterungen** > **Verlassener Warenkorb Erinnerung** > **Konfigurieren** wählst. ### Allgemeine Einstellungen Die allgemeinen Eigenschaften bieten grundlegende Steuerelemente, wie z. B. die Aktivierung/Deaktivierung der Erweiterung. | Feld | Typ | Beschreibung | | ---------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Aktiv | Schieberegler | Mit dem Schieberegler kann die Erweiterung für bestimmte Verkaufskanäle aktiviert werden. | | Geplante Aufgabe | Schieberegler |

Lege fest ob die verlassenen Warenkörbe per geplanter Aufgabe geprüft werden sollen. Anstelle der geplanten Aufgabe, kann auch ein Cronjob mit dem folgenden Kommando verwendet werden: ./bin/console prems:abandoned-cart:process
Diese Einstellung muss für Alle Verkaufskanäle aktiviert/ deaktiviert werden und kann nicht für jeden Verkaufskanal separat eingestellt werden.

| | Protokollstufe | Auswahlfeld | Wähle ob nur Fehler im Logfile erfasst werden sollen oder auch Hinweismeldungen. | ### E-Mail Benachrichtigung | Feld | Typ | Beschreibung | | -------------------------------------------------------------------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Checkbox um E-Mail Benachrichtigungen zu erhalten | Schieberegler | Kunden können per Checkbox wählen, ob sie Nachrichten über verlassene Warenkörbe erhalten wollen. Ist diese Option nicht aktiviert, dann erhalten automatisch alle Kunden die E-Mail Benachrichtigungen. | | Checkbox für E-Mail Benachrichtigungen im Standard für Neukunden aktiviert | Schieberegler | Ist die vorherige Option aktiv, so kann hier festgelegt werden, das die Checkbox im Standard immer aktiv ist. | | Abmelden Link in E-Mail Benachrichtigung | Schieberegler | Lege fest, ob in der E-Mail Benachrichtigung automatisch ein Link zur Abmeldung vom Service angezeigt werden soll. | | E-Mail-Erinnerungen | Liste + Button |

Mit dieser Einstellung wird definiert, nach welcher Zeit in Stunden eine E-Mail Erinnerung über den verlassenen Warenkorb an den Kunden gesendet werden soll. Es ist möglich mehrere Erinnerungen einzurichten.

Im kostenpflichtigen Tarif ist eine automatische E-Mail-Erinnerung zu unterschiedlichen Zeitpunkten möglich.

Derzeit ist es nicht möglich, für jede Erinnerung eine eigene E-Mail-Vorlage festzulegen.

Stattdessen kann der Inhalt der E-Mail-Vorlage je nach Anzahl der versendeten Benachrichtigungen angepasst werden:

  • {% if abandonedCart.numberNotification == 1 %} |

```
...
```

{% endif %} 
  • {% if abandonedCart.numberNotification == 2 %}
...
{% endif %}
| ### Aufräumen Nehme Einstellungen dazu vor, wie lange verlassene Warenkörbe gespeichert bzw. ob diese gelöscht werden sollen. | Feld | Typ | Beschreibung | | ------------------------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | Alte verlassene Warenkörbe löschen | Schieberegler | Wenn aktiviert, werden verlassenen Warenkörbe nach einer bestimmten Zeit gelöscht. Dies ist sinnvoll, da ansonsten die Datenbank immer weiter anwächst. | | Verlassene Warenkörbe nach n-Tagen löschen | Numerische Eingabe | Lege fest nach wie vielen Tagen ein verlassener Warenkorb gelöscht wird. | ### Statistik Um detaillierte Statistiken darüber zu erhalten, wie viele Bestellungen durch die Warenkorb-Erinnerung zurückgewonnen wurden, wie viele Bestellungen insgesamt abgebrochen wurden und welche Produkte am häufigsten zu Warenkorbabbrüchen geführt haben, klicke auf den Button **Statistik anzeigen** oder navigiere zu **Marketing > Abgebrochene Warenkörbe**. # E-Mail Erinnerung Template anpassen Die Erweiterung enthält E-Mail-Vorlagen für verlassene Warenkörbe, die du unter **Einstellungen** > **E-Mail-Templates** findest. Im Standard ist dort die Vorlage **PremsAbandonedCart: Verlassener Warenkorb Info an Kunde** vorhanden. Wenn deine Shop Umgebung als Sprache DE und EN unterstützt, so findest du Vorlagen für beide Sprachen. Verwende das Dropdown-Menü für die Sprachauswahl, um zwischen den Sprachen zu wechseln.
Jede E-Mail-Vorlage kann bearbeitet, dupliziert oder gelöscht werden, indem du auf die entsprechende „**…**„-Menüschaltfläche für eine Vorlage klickst und **Bearbeiten**, **Duplizieren** oder **Löschen** auswählst, allesamt Standardoptionen der Shopware-Verwaltung. **Die Bearbeitung von E-Mail-Vorlagen ist ein optionaler, weiterführender Schritt und sollte nur dann durchgeführt werden, wenn die Standard-E-Mail-Vorlagen für deinen Shop nicht geeignet sind, z.B. um den Wortlaut anzupassen.** ### Eine E-Mail-Vorlage bearbeiten Ändere auf der Seite E-Mail-Vorlage bearbeiten die Eigenschaften der E-Mail-Vorlage in den folgenden Feldern nach Bedarf und klicke dann auf **Speichern**. Alle dynamischen Elemente im Betreff und im Text der E-Mail können durch Strings wie **{{ abandonedCart.identToken }}** definiert werden. Hinweis: Die Änderung dieser Zeichenfolgen kann dazu führen, dass dynamische Elemente in E-Mails nicht korrekt angezeigt werden, z. B. der Name des Kunden. | **Einstellung** | **Bereich** | **Typ** | **Beschreibung** | | ----------------- | ----------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Typ | Information | Dropdown-Menü | Der Typ ist ein vordefinierter Wert, der zur Identifizierung des richtigen Szenarios für eine E-Mail-Vorlage erforderlich ist. **Ändere diese Einstellung nicht** für die Standard-E-Mail-Vorlagen, da dies zu Problemen mit der Erweiterung führen wird. | | Beschreibung | Information | Freie Texteingabe | Gebe eine optionale Beschreibung für die Vorlage ein. | | Betreff | Optionen | Freie Texteingabe | Änder den Standardtext der E-Mail-Betreffzeile nach Bedarf. | | Absender | Optionen | Freie Texteingabe | Standard ist der String **{{ salesChannel.name }}**, der eine dynamische Anzeige des Vertriebskanals ermöglicht. Dies sollte nicht geändert werden. | | Dateien Hochladen | Anhänge | Datei-Explorer | Lade alle Dateien hoch, die du als Anhang für die aktuell ausgewählte E-Mail-Vorlage einfügen möchten, z. B. Geschäftsbedingungen oder eine Datenschutzrichtlinie. | | Text | Mail-Text | Freie Texteingabe | Ändere die Standard-Klartextversion des E-Mail-Textes. Hier gibt es verschiedene Strings, die dynamische Elemente im E-Mail-Text ermöglichen. | | HTML | Mail-Text | Freie Texteingabe | Ändere die Standard-HTML-Textversion des E-Mail-Textes. Hier gibt es verschiedene Zeichenketten, die dynamische Elemente im E-Mail-Text ermöglichen. | ### Eine E-Mail-Vorlage duplizieren Wenn du die Option **Duplizieren** wählst, wird eine Kopie dieser E-Mail-Vorlage erstellt und der Bildschirm E-Mail-Vorlage bearbeiten geöffnet (siehe vorheriger Abschnitt). ### Eine E-Mail-Vorlage löschen **Lösche nicht die Standard-E-Mail-Vorlagen**, da dies zu Problemen mit der Erweiterung führen würde. Alle zusätzlichen Vorlagen, die du erstellst, können ohne Probleme gelöscht werden. ### Flow Builder (E-Mails) Wann eine E-Mail gesendet wird und an welche Empfänger diese geht, wird komplett über den Flow Builder gesteuert. Der Flow Builder ist in der Shopware Admin zu finden unter **Einstellungen -> Shop -> Flow Builder**. Der Flow von dieser Erweiterung heißt **Abandoned notification to customer**. Mit Klick auf die 3 Punkte, kann ein Flow editiert werden. In der Detailansicht im Tab **Flow**, kannst du die Auslöser und Aktionen festlegen. Um die Empfänger eine E-Mail zu ändern, klicke bei der Aktion **E-Mail verschicken** auf die 3 Punkte und wähle **Aktion bearbeiten**. In dem geöffneten Layer kannst Du **Absender** und **Empfänger** verändern. # Wieder auf Lager-Benachrichtigung Wenn Produkte ausverkauft sind, bedeutet das nicht automatisch verlorene Kunden. Mit **PremsStockReminder** gibst du Besuchern die Möglichkeit, sich bei nicht verfügbaren Artikeln vormerken zu lassen – und informierst sie automatisch, sobald diese wieder bestellbar sind.
**Typische Situation:**\ Ein Kunde interessiert sich für ein Produkt, stellt aber fest, dass es aktuell nicht lieferbar ist. Ohne weitere Interaktion verlässt er den Shop – oft endgültig. **So hilft dir PremsStockReminder:**\ Statt eines Sackgassen-Erlebnisses bietest du eine einfache Lösung: Ein Anmeldeformular erscheint direkt beim nicht verfügbaren Produkt. Der Kunde trägt seine E-Mail-Adresse ein und wird automatisch benachrichtigt, sobald der Artikel wieder auf Lager ist. Das erhöht die Chance auf einen späteren Kauf erheblich. *** #### Highlights der Erweiterung **Intelligente Erkennung**\ Nicht verfügbare Produkte werden automatisch erkannt, und das Formular wird kontextabhängig angezeigt – auf Produktseiten, in Kategorien und in Suchergebnissen. **Rechtssichere Anmeldung**\ Dank Double-Opt-In bestätigten Nutzer ihre Anmeldung per E-Mail und erfüllen damit alle DSGVO-Anforderungen. **Gezielte Steuerung**\ Über dynamische Produktgruppen bestimmst du flexibel, bei welchen Artikeln die Funktion aktiv ist – z. B. auch für Vorankündigungen oder limitierte Produkte. **Nahtlose Shopware-Integration**\ Der Versand der E-Mails erfolgt über den Flow Builder, wodurch sich bestehende Prozesse und Designs problemlos nutzen lassen. **Automatische Benachrichtigung**\ Sobald ein Produkt wieder verfügbar ist, startet der Versand an alle registrierten Interessenten automatisch im Hintergrund. **Volle Transparenz im Backend**\ Verwalte alle Einträge zentral und analysiere die Performance über integrierte Statistiken. **Gezielte Nutzerführung**\ Optional lassen sich Kaufoptionen bei nicht verfügbaren Produkten ausblenden, um die Aufmerksamkeit auf die Benachrichtigungsfunktion zu lenken. **Flexibel pro Verkaufskanal**\ Passe alle Einstellungen individuell für unterschiedliche Vertriebskanäle an. **API-Unterstützung**\ Auch für Headless-Setups geeignet: Die Funktionen stehen vollständig über die Store API zur Verfügung. *** **Kurz gesagt:**\ Mit PremsStockReminder verwandelst du „nicht verfügbar“ in eine zweite Chance auf Umsatz. # Voraussetzungen Das Plugin kann nur in einer selbst verwalteten Shopware-Umgebung oder einer PaaS (Cloud)-Umgebung mit mindestens Shopware Version 6.6.9.0 installiert werden. SaaS-Umgebungen werden nicht unterstützt. # Installation Installiere das Plugin über **Erweiterungen > Meine Erweiterungen**. Gib nach der Installation einen Verkaufskanal an, für den das Plugin aktiviert werden soll. Die Standardeinstellung ist **Alle Verkaufskanäle**. Das Stock Reminder Plugin hat zwei Aspekte: 1. **Grundlegende Konfiguration** – Einstellungen für das Verhalten des Benachrichtigungsformulars und der E-Mails. 2. **Verwaltungs-Dashboard** – Übersicht über Abonnements und Statistiken im Administrationsbereich. Führe zunächst die Schritte im Abschnitt Grundlegende Konfiguration aus und lies anschließend den Abschnitt Verwaltungs-Dashboard, um zu erfahren, wie du das Plugin fortlaufend verwalten kannst. ## Grundlegende Konfiguration Bevor du das Plugin aktivierst, überprüfe die Einstellungen in diesem Abschnitt und stelle sicher, dass sie deinen Anforderungen entsprechen. Nehme Änderungen an den einzelnen Feldern vor, indem du **Meine Erweiterungen > Stock Reminder > Konfiguration** wählst. Gib zunächst einen Verkaufskanal an, für den das Plugin aktiviert werden soll. Die Standardeinstellung ist **Alle Verkaufskanäle**. ### Allgemeine Einstellungen Die allgemeinen Einstellungen bieten grundlegende Steuerelemente wie die Aktivierung des Plugins und die Konfiguration des Benachrichtigungsformulars. | Feld | Typ | Beschreibung | | --------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Plugin aktiv | Kippschalter | Aktiviert oder deaktiviert den Benachrichtigungsservice für den gewählten Verkaufskanal. | | Warenkorb-Button ausblenden | Kippschalter | Wenn aktiv, wird der Warenkorb-Button bei ausverkauften Produkten ausgeblendet und nur das Benachrichtigungsformular angezeigt. Wenn deaktiviert, wird der Warenkorb-Button zusätzlich zum Benachrichtigungsformular angezeigt. Standardmäßig aktiviert. | | Double-Opt-In aktivieren | Kippschalter | Wenn aktiv, muss der Besucher seine E-Mail-Adresse über einen Bestätigungslink verifizieren, bevor die Benachrichtigung aktiviert wird. Wenn deaktiviert, wird die Benachrichtigung sofort nach dem Absenden des Formulars aktiviert. Die Deaktivierung kann sinnvoll sein, um die Hürde für Nutzer zu senken, birgt aber das Risiko von Missbrauch durch fremde E-Mail-Adressen. Standardmäßig aktiviert. | | Mengenauswahl ausblenden | Kippschalter | Wenn aktiv, wird das Mengenfeld im Benachrichtigungsformular ausgeblendet. Die Benachrichtigung wird dann automatisch mit der für das Produkt konfigurierten Mindestbestellmenge angelegt. Dies vereinfacht das Formular, wenn die gewünschte Menge keine Rolle spielt. | ### Produktgruppen Über dynamische Produktgruppen kannst du flexibel steuern, für welche Produkte das Benachrichtigungsformular angezeigt wird und unter welchen Bedingungen die Benachrichtigungs-E-Mail versendet wird. | Feld | Typ | Beschreibung | | ------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Anzeigebedingung (Dynamische Produktgruppe) | Auswahl | Legt fest, für welche Produkte das Benachrichtigungsformular angezeigt wird. Nur Produkte, die den Bedingungen dieser dynamischen Produktgruppe entsprechen, erhalten das Formular. Wenn kein Wert gesetzt ist, wird das Formular standardmäßig bei allen Produkten mit einem Bestand von 0 oder weniger angezeigt. | | Versandbedingung (Dynamische Produktgruppe) | Auswahl | Legt fest, unter welchen Bedingungen die Benachrichtigungs-E-Mail tatsächlich versendet wird. Nur wenn ein Produkt mit aktiven Abonnements den Bedingungen dieser dynamischen Produktgruppe entspricht, wird die E-Mail ausgelöst. Wenn kein Wert gesetzt ist, wird standardmäßig bei einem Bestand größer 0 benachrichtigt. | > **Beispiel für die Anzeigebedingung:** Erstelle eine dynamische Produktgruppe mit der Bedingung „Verfügbarer Bestand ist kleiner oder gleich 0", um das Standardverhalten abzubilden, oder ergänze weitere Bedingungen wie Kategorie oder Hersteller. > **Beispiel für die Versandbedingung:** Erstelle eine dynamische Produktgruppe mit den Bedingungen „Aktiv ist Ja UND Verfügbarer Bestand ist größer als 3", um erst ab einem gewissen Lagerbestand zu benachrichtigen. ### Bereinigung | Feld | Typ | Beschreibung | | --------------------------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Alte Abonnement-Einträge nach n Tagen löschen | Numerische Eingabe | Bereits benachrichtigte Abonnement-Einträge werden nach der angegebenen Anzahl an Tagen automatisch gelöscht. Bei 0 werden keine Einträge automatisch gelöscht. Standardwert: 30 Tage. Diese Einstellung gilt global für alle Verkaufskanäle. | # Verwaltungs-Dashboard Das Verwaltungs-Dashboard erreichst du über den Administrationsbereich unter **Marketing > Lagerbenachrichtigungen** in der Hauptnavigation. Dort gibt es zwei Tabs: **Abonnements** und **Statistik**. {% tabs %} {% tab title="Abonnements" %} Der Abonnements-Tab zeigt alle aktuellen Benachrichtigungs-Abonnements in einer Listenansicht. Jeder Eintrag enthält die folgenden Informationen: * **Produkt** – Der Produktname des abonnierten Artikels. * **E-Mail** – Die E-Mail-Adresse des Abonnenten. * **Menge** – Die gewünschte Bestellmenge. * **Bestätigt**– Bei aktiviertem Double-Opt-In Anzeige ob die E-Mail bestätigt wurde. * **Benachrichtigt**– Zeigt ob der Kunde die Wieder-auf-Lager E-Mail erhalten hat. * **Erstellt am** – Das Datum der Anmeldung. Über die Listenansicht kannst du einzelne Abonnements löschen, um Einträge manuell zu bereinigen. Gelöschte Einträge werden nicht mehr auf das Subscription-Limit der kostenlosen Version angerechnet. #### Subscription-Limit (kostenlose Version) In der kostenlosen Version des Plugins sind maximal 10 aktive Abonnements möglich. Im Abonnements-Tab wird ein Fortschrittsbalken angezeigt, der den aktuellen Verbrauch darstellt (z. B. „3 von 10 Abonnements verwendet"). Ist das Limit erreicht, können keine neuen Abonnements angelegt werden und das Benachrichtigungsformular wird in der Storefront ausgeblendet. Durch den Kauf der **Advanced**-Version über den In-App Purchase wird dieses Limit aufgehoben. {% endtab %} {% tab title="Statistiken" %} {% hint style="info" %} Der Statistiken-Tab ist nur mit der Advanced-Version verfügbar. In der kostenlosen Version wird ein entsprechender Hinweis mit der Möglichkeit zum Upgrade angezeigt. {% endhint %} Der Statistiken-Tab bietet einen Überblick über die Nutzung des Benachrichtigungsservices: * **Abos Gesamt** – Wie viele Benachrichtigungen insgesamt angelegt wurden. * **E-Mails Gesamt** – Wie viele E-Mails erfolgreich versendet wurden. * **Käufe gesamt** – Wie viele Käufe haben sich auf Grund von Benachrichtigungen ergeben. * **Conversion Gesamt** – Wie hoch ist die Conversion Rate (Verhältnis Käufe zu E-Mails versendet). {% endtab %} {% endtabs %} # Flow Builder & E-Mail Vorlagen Das Stock Reminder Plugin integriert sich vollständig in den Shopware Flow Builder. Dadurch kannst du den E-Mail-Versand für Benachrichtigungen und Bestätigungen individuell steuern und mit bestehenden Workflows kombinieren. ### Verfügbare Events Das Plugin stellt drei eigene Business Events bereit, die im Flow Builder als Trigger verwendet werden können: #### `prems_stock_reminder.double_opt_in` Dieses Event wird ausgelöst, wenn ein Besucher das Benachrichtigungsformular absendet und die Double-Opt-In-Funktion aktiviert ist. Es enthält die Daten, die für die Bestätigungs-E-Mail benötigt werden, einschließlich des Bestätigungslinks. **Typischer Flow:** Versende eine E-Mail mit dem Bestätigungslink an den Abonnenten. | Variable | Beschreibung | | ------------- | ------------------------------------------------------ | | `productName` | Name des abonnierten Produkts | | `confirmUrl` | Bestätigungslink für das Double-Opt-In | | `shopName` | Name des Shops (aus den Stammdaten des Verkaufskanals) | | `email` | E-Mail-Adresse des Abonnenten | #### `prems_stock_reminder.back_in_stock` Dieses Event wird ausgelöst, wenn ein Produkt wieder verfügbar ist und die Benachrichtigungs-E-Mail an den Abonnenten versendet werden soll. Es enthält die Produktdaten und die Informationen zum Abonnement. **Typischer Flow:** Versende eine E-Mail an den Abonnenten mit den Produktinformationen und einem Link zum Produkt. | Variable | Beschreibung | | ------------- | ------------------------------------------------------ | | `productName` | Name des wieder verfügbaren Produkts | | `productId` | ID des Produkts, z. B. für einen Link zum Produkt | | `quantity` | Vom Abonnenten gewünschte Menge | | `shopName` | Name des Shops (aus den Stammdaten des Verkaufskanals) | | `email` | E-Mail-Adresse des Abonnenten | > **Tipp:** Mit der Variable `productId` kannst du in der E-Mail-Vorlage einen Link zum Produkt erzeugen, z. B. über `rawUrl('frontend.detail.page', {'productId': productId}, salesChannel.domains|first.url)`. #### `prems_stock_reminder.subscription_created` Dieses Event wird ausgelöst, sobald sich ein Kunde neu für eine Lagerbenachrichtigung zu einem Produkt anmeldet. Damit kannst du z. B. den Shopbetreiber automatisch darüber informieren, welches Produkt abonniert wurde. Das Event wird nur beim erstmaligen Abonnement einer E-Mail-Adresse für ein Produkt ausgelöst – nicht, wenn ein bestehendes Abonnement erneut abgesendet wird. Der Versand wird ausschließlich über den Flow Builder gesteuert: Der mitgelieferte Flow **Stock Reminder - Subscription Notification** ist nach der Installation zunächst **deaktiviert**. Um die Funktion zu nutzen, aktiviere den Flow unter **Einstellungen > Flow Builder**. Als Empfänger ist der Standard-Empfänger konfiguriert – das ist die Shopbetreiber-Adresse aus den Stammdaten des Verkaufskanals (**Stammdaten > E-Mail-Adresse**). Den Empfänger kannst du in der Flow-Aktion jederzeit anpassen. **Typischer Flow:** Versende eine E-Mail an den Shopbetreiber mit den Informationen zum neuen Abonnement. | Variable | Beschreibung | | --------------- | ------------------------------------------------------ | | `productName` | Name des abonnierten Produkts | | `productNumber` | Produktnummer des abonnierten Produkts | | `productId` | ID des Produkts, z. B. für einen Link zum Produkt | | `quantity` | Vom Abonnenten gewünschte Menge | | `shopName` | Name des Shops (aus den Stammdaten des Verkaufskanals) | | `email` | E-Mail-Adresse des Abonnenten | Zusätzlich steht bei allen Events in den E-Mail-Vorlagen das Objekt `salesChannel` mit den Daten des jeweiligen Verkaufskanals zur Verfügung. ### E-Mail-Vorlagen einrichten Die E-Mail-Vorlagen werden bei der Installation des Plugins automatisch angelegt und im Flow Builder mit den entsprechenden Events verknüpft. Du kannst die Vorlagen jederzeit über **Einstellungen > E-Mail-Templates** anpassen. Folgende Vorlagen und Flows liefert das Plugin mit: | E-Mail-Vorlage (Typ) | Flow | Event | Nach Installation aktiv | | ------------------------------------------------ | ------------------------------------------- | ------------------------------------------- | ----------------------- | | Lagerbenachrichtigung - Double-Opt-In | Stock Reminder - Double Opt-In Confirmation | `prems_stock_reminder.double_opt_in` | Ja | | Lagerbenachrichtigung - Wieder verfügbar | Stock Reminder - Back in Stock Notification | `prems_stock_reminder.back_in_stock` | Ja | | Lagerbenachrichtigung - Neues Abonnement (Admin) | Stock Reminder - Subscription Notification | `prems_stock_reminder.subscription_created` | Nein | # Advanced Version Die Advanced-Version des Stock Reminder Plugins wird über einen In-App Purchase im Shopware Store erworben. Sie hebt die Einschränkungen der kostenlosen Version auf und schaltet zusätzliche Funktionen frei. ## Kostenlose Version Die kostenlose Version beinhaltet alle Kernfunktionen des Plugins: * Benachrichtigungsformular auf Produktdetailseiten und in Produktlisten * Double-Opt-In-Verfahren * E-Mail-Versand über den Flow Builder * Automatischer Versand bei Wiederverfügbarkeit * Konfiguration pro Verkaufskanal * Dynamische Produktgruppen für Anzeige- und Versandbedingungen * Abonnementverwaltung im Administrationsbereich * Automatische Bereinigung alter Einträge * Store API für Headless-Projekte {% hint style="warning" %} **Einschränkung:** Maximal 10 aktive Abonnements gleichzeitig. Ist das Limit erreicht, wird das Benachrichtigungsformular in der Storefront ausgeblendet und neue Abonnements über die Store API werden abgelehnt. {% endhint %} ## Advanced Version Mit der Advanced-Version erhältst du zusätzlich: * **Unbegrenzte Abonnements** – Keine Beschränkung auf 10 aktive Einträge. * **Statistiken** – Vollständiger Zugriff auf den Statistiken-Tab im Verwaltungs-Dashboard mit Kennzahlen und Entwicklung über Zeit. ## Upgrade durchführen Das Upgrade auf die Advanced-Version kannst du direkt aus dem Administrationsbereich heraus vornehmen. Im Abonnements-Tab oder im Statistiken-Tab findest du eine Schaltfläche „Jetzt upgraden", die dich zum In-App Purchase weiterleitet. Nach dem Kauf werden die Einschränkungen sofort aufgehoben. # Geplante Aufgaben Das Stock Reminder Plugin verwendet zwei geplante Aufgaben (Scheduled Tasks), die automatisch im Hintergrund ausgeführt werden. ## Benachrichtigungs-Task Dieser Task prüft regelmäßig, ob Produkte mit aktiven Abonnements wieder verfügbar sind. Sobald ein Produkt die Versandbedingung erfüllt (standardmäßig: Bestand größer 0), werden die Benachrichtigungs-E-Mails an alle Abonnenten dieses Produkts versendet. Der Versand erfolgt über den Shopware Flow Builder. Die E-Mail-Vorlagen können dort individuell angepasst werden. Nach dem Versand wird der Status des Abonnements auf „benachrichtigt" gesetzt. ## Bereinigungs-Task Dieser Task löscht automatisch alte Abonnement-Einträge, die bereits benachrichtigt wurden. Die Aufbewahrungsdauer wird über die Konfiguration „Alte Abonnement-Einträge nach n Tagen löschen" gesteuert (Standardwert: 30 Tage). Ist der Wert auf 0 gesetzt, erfolgt keine automatische Bereinigung. {% hint style="info" %} Die geplanten Aufgaben werden über das Shopware Scheduled-Task-System ausgeführt. Stelle sicher, dass der Cronjob in deiner Shopware-Umgebung korrekt eingerichtet ist, damit die Aufgaben zuverlässig ausgeführt werden. {% endhint %} # Store API Das Stock Reminder Plugin stellt zwei Store-API-Endpunkte bereit, die für Headless-Projekte oder individuelle Storefront-Implementierungen genutzt werden können. ## Abonnement anlegen Erstellt ein neues Benachrichtigungs-Abonnement für ein Produkt. **Endpunkt:** `POST /store-api/prems/stock-reminder/subscribe` **Login erforderlich:** Nein **Parameter:** | Parameter | Typ | Pflicht | Beschreibung | | --------- | ------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | productId | string | Ja | Die UUID des Produkts. | | email | string | Ja | Die E-Mail-Adresse des Abonnenten. Muss eine gültige E-Mail-Adresse sein. | | quantity | int | Nein | Die gewünschte Bestellmenge. Standardwert: 1. Wird ignoriert, wenn die Mengenauswahl in der Konfiguration ausgeblendet ist – in diesem Fall wird die Mindestbestellmenge des Produkts verwendet. | **Antwort:** `204 No Content` bei Erfolg. **Fehler:** * `403 Forbidden` – Das Plugin ist für den Verkaufskanal nicht aktiv oder das Subscription-Limit der kostenlosen Version wurde erreicht. * `400 Bad Request` – Ungültige Eingabedaten (fehlende Produkt-ID, ungültige E-Mail). ## Abonnement bestätigen Bestätigt ein Abonnement über den Double-Opt-In-Hash. **Endpunkt:** `POST /store-api/prems/stock-reminder/confirm/{hash}` **Login erforderlich:** Nein **Parameter:** | Parameter | Typ | Pflicht | Beschreibung | | --------- | ------ | ------- | ----------------------------------------------------------------------------- | | hash | string | Ja | Der eindeutige Bestätigungs-Hash aus der Bestätigungs-E-Mail (URL-Parameter). | **Antwort:** `204 No Content` bei Erfolg. **Fehler:** * `404 Not Found` – Ungültiger oder bereits bestätigter Hash. --- [Next Page](/llms-full.txt/1)