Musterbestellung

Einleitung

Mit Musterbestellung bestellen deine Kunden Muster deiner Artikel direkt im Shop. Dafür bekommt die Produktseite einen eigenen Button, auf Wunsch auch das Listing. Du legst fest, welche Artikel es als Muster gibt, was ein Muster kostet, wie viele Muster kostenlos sind und ob eine Musterpauschale anfällt.

Was du mit diesem Plugin erreichst

• Deine Kunden legen mit Muster in den Warenkorb ein Muster in den Warenkorb, ohne den Artikel selbst zu kaufen.
• Das Badge Muster möglich zeigt im Listing auf einen Blick, welche Artikel es als Muster gibt.
• Du gibst je Artikel einen eigenen Musterpreis vor oder bietest das Muster kostenlos an.
• Du legst fest, wie viele Muster kostenlos sind und was jedes weitere Muster kostet.
• Du berechnest auf Wunsch eine Musterpauschale, zum Beispiel für Bestellungen, die nur Muster enthalten.
• Du begrenzt, wie viele Muster in einen Warenkorb passen.
• Muster tragen im Warenkorb einen eigenen Namen und eine eigene Artikelnummer. So unterscheidest du sie sofort von normalen Artikeln.
• Führst du ein Muster als eigenen Artikel, zum Beispiel mit eigener Artikelnummer und eigenem Lagerbestand, legt der Musterbutton genau diesen Artikel in den Warenkorb.
• Du entscheidest, ob Promotions und Gutscheine für den ganzen Warenkorb auch deine Muster vergünstigen.
• Du überträgst die Muster-Angaben einer Kategorie mit einem Klick auf alle Artikel darin.
• Du steuerst alles je Verkaufskanal, zum Beispiel Muster nur in deinem B2B-Shop.

Für wen ist dieses Plugin?

Für Shop-Betreiber, deren Kunden vor dem Kauf Material, Farbe oder Qualität in der Hand halten möchten. Du brauchst keine technischen Kenntnisse: Alles richtest du in der Shopware-Administration ein.

Installation

Nach dem Kauf steht dir das Plugin direkt in deiner Administration zur Verfügung. Du musst nichts herunterladen.

1. Melde dich in deiner Shopware-Administration an.
2. Öffne Erweiterungen → Meine Erweiterungen. Ist die Liste lang, gib oben in der Suchleiste „Musterbestellung“ ein.
3. Klicke in der Zeile Musterbestellung auf Installieren.
4. Aktiviere das Plugin mit dem Schalter ganz links in der Zeile.

Musterbestellung unter Meine Erweiterungen, installiert und aktiviert

Ist alles erledigt, ist der Schalter eingeschaltet, und rechts in der Zeile stehen die Version und der Link Konfigurieren.

Taucht Musterbestellung nicht in der Liste auf, ist dein Shopware-Account noch nicht mit dem Shop verbunden. Das erledigst du unter Erweiterungen → Meine Erweiterungen im Reiter Shopware Account.

Erste Schritte

In vier Schritten bietest du dein erstes Muster an:

1. Einstellungen öffnen: Klicke unter Erweiterungen → Meine Erweiterungen neben Musterbestellung auf Konfigurieren. Prüfe, ob Plugin für diesen Verkaufskanal aktivieren eingeschaltet ist. Nach der Installation ist das der Fall. Mehr dazu unter Einstellungen.
2. Musterpauschale festlegen: Entscheide, ob zusätzlich zu den Mustern eine Pauschale anfällt. Willst du keine, stelle Musterpauschale auf Nein. Mehr dazu unter Musterpauschale berechnen.
3. Artikel als Muster freischalten: Schalte am Artikel hat Muster ein und speichere. Wie das geht, steht unter So bietest du einen Artikel als Muster an.
4. Ergebnis prüfen: Öffne den Artikel in deinem Shop. Bei den Preisangaben steht jetzt der Musterpreis, und unter In den Warenkorb erscheint der Button Muster in den Warenkorb. Mehr dazu unter So sehen deine Kunden die Muster.

Einstellungen

Du öffnest die Einstellungen unter Erweiterungen → Meine Erweiterungen mit einem Klick auf Konfigurieren neben Musterbestellung. Änderungen übernimmst du oben rechts mit Speichern.

Einstellungen je Verkaufskanal festlegen

Ganz oben auf der Seite wählst du unter Verkaufskanal aus, für welchen Shop deine Einstellungen gelten. Unter Alle Verkaufskanäle legst du die Grundeinstellung fest, die überall gilt. Wählst du einen einzelnen Verkaufskanal aus, legst du dort einzelne Werte abweichend fest. Alle anderen Werte übernimmt dieser Verkaufskanal aus der Grundeinstellung.

Wozu das gut ist: Du betreibst zum Beispiel einen B2B- und einen B2C-Shop. Dann bietest du Muster nur im B2B-Shop an oder verlangst dort andere Preise.

Oberer Teil der Einstellungen mit Verkaufskanal-Auswahl, Verkaufskanal-Konfiguration und Prefix/Suffix Einstellungen

Plugin im Verkaufskanal ein- oder ausschalten

Im Abschnitt Verkaufskanal-Konfiguration findest du den Button zur Dokumentation. Er öffnet die Online-Dokumentation zu diesem Plugin. Darunter liegt der Schalter Plugin für diesen Verkaufskanal aktivieren.

Schaltest du ihn aus, zeigt dieser Verkaufskanal keine Musterbuttons, keine Musterpreise und kein Badge Muster möglich. Eine Musterpauschale wird dort ebenfalls nicht berechnet. Standardmäßig ist der Schalter eingeschaltet.

Wozu das gut ist: Du legst Muster in einem Verkaufskanal still, ohne das Plugin zu deinstallieren und ohne Angaben an deinen Artikeln zu ändern.

Muster im Warenkorb erkennbar machen

Im Abschnitt Prefix/Suffix Einstellungen legst du fest, wie Name und Artikelnummer eines Musters im Warenkorb aussehen. Das Plugin setzt deine Angaben vor oder hinter den Namen und die Nummer des Artikels:

• Mit Artikelnummer Präfix und Artikelnummer Suffix ergänzt du die Artikelnummer vorne bzw. hinten.
• Mit Artikelnamen Präfix und Artikelnamen Suffix ergänzt du den Artikelnamen vorne bzw. hinten.

Alle vier Felder sind anfangs leer. Dann tragen Muster denselben Namen und dieselbe Nummer wie der Artikel.

Im Beispiel oben sind „MUSTER-“ als Präfix für die Artikelnummer und „Muster: “ als Präfix für den Namen eingetragen. Im Warenkorb heißt das Muster des Artikels „Awesome Leather Chuffy“ dann „Muster: Awesome Leather Chuffy“, und seine Produktnummer beginnt mit „MUSTER-“.

Wozu das gut ist: Du und deine Kunden erkennen Muster im Warenkorb sofort und verwechseln sie nicht mit dem eigentlichen Artikel.

Tipp: Hast du am Artikel im Feld Name überschreiben einen eigenen Namen eingetragen, trägt das Muster genau diesen Namen. Artikelnamen Präfix und Artikelnamen Suffix werden dann nicht ergänzt.

Musterpauschale berechnen

Die folgenden Einstellungen findest du weiter unten im Abschnitt weitere Einstellungen.

Abschnitt weitere Einstellungen mit Beispielwerten

Mit Musterpauschale legst du fest, ob zusätzlich zu den Mustern ein fester Betrag anfällt. Die Pauschale steht im Warenkorb als eigene Position Musterpauschale. Du hast drei Möglichkeiten:

• nur Muster im Warenkorb: Die Pauschale fällt an, wenn der Warenkorb ausschließlich Muster enthält. Legt der Kunde zusätzlich einen normalen Artikel in den Warenkorb, entfällt sie. Das ist die Standardeinstellung.
• wenn Muster im Warenkorb: Die Pauschale fällt an, sobald mindestens ein Muster im Warenkorb liegt.
• Nein: Es fällt keine Pauschale an.

Den Betrag trägst du unter Preis für Musterpauschale ein. Anfangs steht dort 0. Wie der Shop den Betrag anzeigt, liest du unter So zeigt der Shop Bruttobeträge und Nettobeträge an.

Deine Kunden können die Musterpauschale nicht selbst aus dem Warenkorb entfernen.

Wozu das gut ist: Du deckst Porto und Verpackung für reine Musterbestellungen ab. Kunden, die ohnehin etwas kaufen, belastest du mit der Einstellung nur Muster im Warenkorb nicht.

Wichtig: Wählst du eine Pauschale aus und lässt den Betrag auf 0, steht im Warenkorb trotzdem die Position Musterpauschale, und zwar mit Gratis!. Willst du gar keine Pauschale, wähle Nein.

Kostenlose Muster und den Preis danach festlegen

Mit Maximale Anzahl kostenloser Muster (0 = unbegrenzt) legst du fest, wie viele Muster in einem Warenkorb kostenlos sind. Mit Musterpreis nach kostenfrei legst du fest, was jedes weitere Muster kostet.

So rechnet das Plugin:

• Ein Muster mit eigenem Musterpreis am Artikel kostet immer genau diesen Preis. Es zählt nicht zu den kostenlosen Mustern.
• Ein Muster aus einem Musterartikel kostet den Preis dieses Artikels. Es zählt ebenfalls nicht zu den kostenlosen Mustern. Mehr dazu unter Einen eigenen Artikel als Muster verwenden.
• Alle anderen Muster sind kostenlos, bis die eingestellte Anzahl erreicht ist.
• Jedes weitere Muster ohne eigenen Musterpreis kostet den Betrag aus Musterpreis nach kostenfrei.
• Steht die Anzahl auf 0, sind alle Muster ohne eigenen Musterpreis kostenlos. Das ist die Standardeinstellung.
• Lässt du Musterpreis nach kostenfrei leer, bleiben auch alle weiteren Muster kostenlos.

Beispiel aus den Abbildungen: Zwei Muster sind kostenlos, danach kostet jedes Muster 1,50 €. Ein Kunde legt zuerst ein Muster mit eigenem Musterpreis von 2,50 € in den Warenkorb, danach zwei Muster ohne eigenen Preis. Er zahlt 2,50 € für das erste Muster, die beiden anderen sind Gratis!. Für jedes weitere Muster zeigt ihm die Produktseite jetzt Musterpreis: 1,50 € an.

Wozu das gut ist: Du schenkst deinen Kunden ein paar Muster zum Kennenlernen und schützt dich trotzdem vor großen Musterbestellungen zum Nulltarif.

Anzahl der Muster je Warenkorb begrenzen

Mit Maximale Anzahl von Mustern legst du fest, wie viele Muster ein Kunde höchstens in einen Warenkorb legen kann. Steht dort 0, gibt es keine Grenze. Das ist die Standardeinstellung.

Ist die Grenze erreicht, legt der Shop kein weiteres Muster in den Warenkorb und zeigt den Hinweis Maximale Anzahl Muster im Warenkorb erreicht. Mehr dazu unter Hinweise für deine Kunden.

Unabhängig davon gilt: Von jedem Artikel bestellt ein Kunde höchstens ein Muster.

Wozu das gut ist: Du hältst den Aufwand für Musterversand planbar, auch wenn ein Kunde sehr viele Muster auf einmal möchte.

So zeigt der Shop Bruttobeträge und Nettobeträge an

Für alle Beträge rund um Muster gilt dieselbe Regel. Das betrifft das Feld Musterpreis am Artikel, Musterpreis nach kostenfrei und Preis für Musterpauschale. Der Shop zeigt den Betrag so an, wie du ihn einträgst. Ob er als Brutto- oder Nettobetrag gilt, bestimmt die Steuerdarstellung der Kundengruppe:

• Bei Brutto ist dein Betrag der Preis inklusive Mehrwertsteuer.
• Bei Netto ist dein Betrag der Preis ohne Mehrwertsteuer.

Beispiel aus den Abbildungen: Für die Musterpauschale sind 4.95 eingetragen. Ein Kunde, dessen Kundengruppe die Steuerdarstellung Brutto hat, sieht im Warenkorb 4,95 € inklusive Mehrwertsteuer. Trage die Beträge deshalb so ein, wie deine Kunden sie sehen sollen.

Versandkosten für Muster

Mit Muster immer versandkostenfrei kennzeichnest du jedes Muster als versandkostenfrei. Ist der Schalter ausgeschaltet, übernimmt das Muster die Versandeinstellung seines Artikels: Ist der Artikel versandkostenfrei, ist es auch sein Muster. Standardmäßig ist der Schalter ausgeschaltet.

Wozu das gut ist: Du verschickst Muster ohne Versandkosten, auch wenn für den eigentlichen Artikel Versandkosten anfallen.

Muster bei Warenkorb-Rabatten berücksichtigen

Mit Muster in Warenkorb-Rabatte einbeziehen legst du fest, ob Promotions und Gutscheine, die auf den ganzen Warenkorb wirken, auch deine Muster vergünstigen. Standardmäßig ist der Schalter ausgeschaltet.

• Ausgeschaltet: Muster zählen nicht zum Rabatt und behalten ihren vollen Preis. Der Rabatt berechnet sich nur aus den übrigen Artikeln im Warenkorb.
• Eingeschaltet: Die Musterpreise zählen zum Rabatt mit. Ein Gutschein über 10 % auf den Warenkorb gilt dann auch für deine Muster.

Die Musterpauschale zählt in keinem Fall zum Rabatt.

Muster, für die du am Artikel einen eigenen Musterartikel hinterlegt hast, liegen als normaler Artikel im Warenkorb. Für sie gilt der Schalter nicht, sie zählen immer zum Rabatt mit. Mehr dazu unter Einen eigenen Artikel als Muster verwenden.

Wozu das gut ist: Muster sind meist knapp kalkuliert. Mit der Standardeinstellung verhinderst du, dass ein Gutschein ihren Preis zusätzlich senkt. Soll eine Promotion wie „10 % auf alles“ auch für Muster gelten, schalte Muster in Warenkorb-Rabatte einbeziehen ein.

Muster im Listing zeigen

Drei Schalter bestimmen, was deine Kunden im Listing sehen, zum Beispiel auf Kategorieseiten:

• Badge im Listing anzeigen: Artikel mit Muster tragen das Badge Muster möglich. Standardmäßig eingeschaltet.
• Musterpreise im Listing anzeigen: Unter dem Preis steht der Musterpreis, bei kostenlosen Mustern Muster Gratis!. Standardmäßig eingeschaltet.
• Musterbutton im Listing anzeigen: Der Button Muster in den Warenkorb erscheint direkt im Listing. So bestellen Kunden Muster ohne Umweg über die Produktseite. Standardmäßig ausgeschaltet.

Diese drei Schalter betreffen nur das Listing. Auf der Produktseite erscheinen Musterpreis und Button immer, sobald der Artikel als Muster freigeschaltet ist.

So bietest du einen Artikel als Muster an

Was dir das bringt: Du entscheidest je Artikel, ob es ihn als Muster gibt, was das Muster kostet, wie es im Warenkorb heißt und wie schnell es geliefert wird.

Artikel als Muster freischalten

1. Öffne Kataloge → Produkte und klicke auf den Artikel.
2. Wechsle in den Reiter Spezifikationen.
3. Scrolle zum Abschnitt Zusatzfelder und öffne dort den Reiter Muster.
4. Schalte hat Muster ein.
5. Trage bei Bedarf die weiteren Angaben ein. Die nächsten Abschnitte beschreiben jedes Feld.
6. Klicke oben rechts auf Speichern.

Reiter Muster im Abschnitt Zusatzfelder eines Artikels

Ab jetzt sehen deine Kunden auf der Produktseite den Musterpreis und den Button Muster in den Warenkorb.

Tipp: Du willst viele Artikel auf einmal freischalten? Trage die Angaben einmal an der Kategorie ein und übertrage sie. Wie das geht, steht unter So überträgst du Muster-Angaben auf eine ganze Kategorie.

Musterpreis festlegen

Im Feld Musterpreis trägst du einen festen Preis für das Muster dieses Artikels ein, zum Beispiel 2,50. Dieser Preis gilt immer, auch wenn der Kunde noch kostenlose Muster frei hat.

Lässt du das Feld leer oder trägst 0 ein, ist das Muster kostenlos. Es zählt dann zu den kostenlosen Mustern aus den Einstellungen. Mehr dazu unter Kostenlose Muster und den Preis danach festlegen.

Eigenen Namen für das Muster vergeben

Mit Name überschreiben gibst du dem Muster im Warenkorb einen eigenen Namen, zum Beispiel „Farbmuster Eiche hell“ statt des Artikelnamens. Dieser Name ersetzt den Artikelnamen vollständig. Artikelnamen Präfix und Artikelnamen Suffix aus den Einstellungen werden dann nicht ergänzt.

Solange du hier nichts einträgst, setzt das Plugin den Namen aus Artikelnamen Präfix, dem Artikelnamen und Artikelnamen Suffix zusammen.

Abweichende Lieferzeit für das Muster

Ein Muster ist oft schneller verschickt als der Artikel selbst. So hinterlegst du eine eigene Lieferzeit:

1. Schalte Lieferzeit überschreiben Status ein.
2. Trage unter Lieferzeit überschreiben minimale Tage und Lieferzeit überschreiben maximale Tage die Lieferzeit in Tagen ein, zum Beispiel 1 und 3.
3. Klicke oben rechts auf Speichern.

Im Warenkorb zeigt das Muster dann einen Lieferzeitraum, der zu diesen Tagen passt. An den Versandkosten ändert die eigene Lieferzeit nichts, dafür gilt weiter Versandkosten für Muster.

Wichtig: Die eigene Lieferzeit gilt nur, wenn Lieferzeit überschreiben Status eingeschaltet ist und in beiden Tage-Feldern eine Zahl größer als 0 steht. Andernfalls gilt für das Muster die Lieferzeit des Artikels.

Einen eigenen Artikel als Muster verwenden

Führst du dein Muster als eigenen Artikel, zum Beispiel eine Farbkarte mit eigener Artikelnummer und eigenem Lagerbestand? Dann hinterlegst du diesen Artikel als Musterartikel. Der Button Muster in den Warenkorb legt ab dann genau diesen Artikel in den Warenkorb. Sein Bestand wird wie bei jedem anderen Artikel abgebucht, und du siehst jederzeit, wie viele Muster du noch vorrätig hast. Lässt du das Feld leer, entsteht das Muster wie bisher als eigene Musterposition.

So hinterlegst du einen Musterartikel:

1. Lege das Muster zuerst als eigenen Artikel an, mit Namen, Artikelnummer, Preis und Bestand. Der Artikel muss aktiv und dem Verkaufskanal zugeordnet sein. In Kategorien und in der Suche muss er nicht zu sehen sein.
2. Öffne unter Kataloge → Produkte den Artikel, für den es das Muster geben soll, und wechsle in den Reiter Spezifikationen.
3. Prüfe im Abschnitt Zusatzfelder im Reiter Muster, ob hat Muster eingeschaltet ist. Ohne diesen Schalter gibt es auch mit Musterartikel kein Muster.
4. Öffne im Abschnitt Zusatzfelder den Reiter Muster: Musterartikel.
5. Wähle im Feld Musterartikel den Artikel aus, den deine Kunden als Muster erhalten.
6. Klicke oben rechts auf Speichern.

Reiter Muster: Musterartikel mit ausgewähltem Musterartikel

Den Musterartikel legst du immer direkt am Artikel fest. An der Kategorie gibt es dieses Feld nicht, und Einstellungen auf Artikel übernehmen lässt einen hinterlegten Musterartikel unverändert.

Was sich für das Muster ändert:

• Das Muster steht mit Namen, Artikelnummer und Bild des Musterartikels im Warenkorb, immer mit der Menge 1.
• Es kostet den Preis des Musterartikels. Dafür gelten dieselben Preisregeln wie für jeden anderen Artikel deines Shops. Genau diesen Preis zeigt die Produktseite als Musterpreis an. Kostet der Musterartikel nichts, steht dort Muster Gratis!.
• Von den Angaben im Reiter Muster gilt nur hat Muster. Musterpreis, Name überschreiben und die Lieferzeit-Felder bleiben unberücksichtigt, die Lieferzeit kommt vom Musterartikel.
• Artikelnummer Präfix, Artikelnummer Suffix, Artikelnamen Präfix und Artikelnamen Suffix werden nicht ergänzt.
• Das Muster zählt nicht zu den kostenlosen Mustern, und Musterpreis nach kostenfrei gilt dafür nicht.
• Im Rule Builder erfasst die Bedingung Position vom Typ mit dem Wert Musterartikel dieses Muster nicht. Siehe So nutzt du Muster in Regeln.

Was weiter gilt:

• Das Muster zählt bei Maximale Anzahl von Mustern mit.
• Für die Musterpauschale zählt es als Muster. Mit nur Muster im Warenkorb fällt die Pauschale also auch an, wenn der Warenkorb nur solche Muster enthält.
• Ist Muster immer versandkostenfrei eingeschaltet, ist auch dieses Muster versandkostenfrei. Andernfalls gilt die Versandeinstellung des Musterartikels.
• Schaltest du Plugin für diesen Verkaufskanal aktivieren aus, entfernt der Shop auch diese Muster aus dem Warenkorb.
• Bei Promotions und Gutscheinen für den ganzen Warenkorb zählt das Muster immer mit. Siehe Muster bei Warenkorb-Rabatten berücksichtigen.

Warenkorb mit einem Muster aus einem Musterartikel

Tipp: Mehrere Artikel dürfen denselben Musterartikel verwenden, zum Beispiel eine gemeinsame Farbkarte. Im Warenkorb liegt er trotzdem nur einmal. Klickt dein Kunde bei einem zweiten Artikel auf Muster in den Warenkorb, erscheint der Hinweis Es kann nur ein Muster pro Artikel bestellt werden.

Wichtig: Nicht jeder Artikel eignet sich als Musterartikel. Ein Hauptartikel mit Varianten und ein Artikel mit einer Mindestabnahme über 1 werden nicht verwendet. Dasselbe gilt, wenn der Musterartikel im Verkaufskanal nicht verfügbar ist, zum Beispiel weil er inaktiv oder dem Verkaufskanal nicht zugeordnet ist. In diesen Fällen legt der Button automatisch ein normales Muster an, mit Musterpreis, Name und Nummer nach deinen Einstellungen. Siehe Fehlerbehebung.

So überträgst du Muster-Angaben auf eine ganze Kategorie

Was dir das bringt: Statt jeden Artikel einzeln zu bearbeiten, trägst du die Muster-Angaben einmal an der Kategorie ein. Danach überträgst du sie auf alle Artikel dieser Kategorie und ihrer Unterkategorien.

Wichtig: Die Angaben an der Kategorie wirken im Shop erst, wenn du sie überträgst. Beim Übertragen ersetzen die Werte der Kategorie die entsprechenden Werte, die bisher an den Artikeln stehen.

Schritt für Schritt

1. Öffne Kataloge → Kategorien und wähle links unter Kategorien die gewünschte Kategorie aus.
2. Bleib im Reiter Allgemein und scrolle zum Abschnitt Zusatzfelder. Öffne dort den Reiter Muster.
3. Trage die gewünschten Angaben ein. Die Felder sind dieselben wie am Artikel, siehe So bietest du einen Artikel als Muster an.
4. Klicke oben rechts auf Speichern. Solange ungespeicherte Änderungen offen sind, lässt sich der Button für das Übertragen nicht anklicken.
5. Klicke unter den Feldern auf Einstellungen auf Artikel übernehmen.

Reiter Muster an einer Kategorie mit dem Button Einstellungen auf Artikel übernehmen

6. Bestätige die Rückfrage Bist du dir sicher? mit Speichern. Mit Abbrechen schließt du das Fenster, ohne etwas zu ändern.

Rückfrage vor dem Übertragen auf die Artikel

Nach dem Übertragen schließt sich das Fenster. Die Angaben gelten jetzt für alle Artikel, die der Kategorie oder einer ihrer Unterkategorien zugeordnet sind. Auch die Unterkategorien selbst erhalten die Angaben. Das Übertragen berücksichtigt alle Sprachen deines Shops.

Tipp: Ordnest du der Kategorie später neue Artikel zu, übertrage die Angaben erneut. Neue Artikel erhalten die Angaben nicht automatisch.

Tipp: Braucht ein einzelner Artikel einen eigenen Musterpreis, trage ihn nach dem Übertragen direkt am Artikel ein.

So nutzt du Muster in Regeln

Was dir das bringt: Mit dem Rule Builder von Shopware erkennst du Warenkörbe, in denen Muster oder die Musterpauschale liegen. So bietest du zum Beispiel eine eigene Versandart nur für Warenkörbe mit Mustern an.

Schritt für Schritt

1. Öffne Automation → Rule Builder und klicke auf Regel erstellen.
2. Trage unter Name einen Namen und unter Priorität eine Zahl ein.
3. Wähle im Abschnitt Bedingungen die Bedingung Position vom Typ. Wähle dahinter Mind. eine und Ist gleich.
4. Wähle als Wert Musterartikel, wenn die Regel auf Muster reagieren soll. Wähle Musterpauschale, wenn sie auf die Pauschale reagieren soll.
5. Klicke oben rechts auf Speichern.

Bedingung Position vom Typ mit den Werten Musterartikel und Musterpauschale

Die Regel setzt du anschließend überall ein, wo Shopware Regeln anbietet, zum Beispiel als Verfügbarkeitsregel einer Versandart oder Zahlungsart.

Wichtig: Trotz seines Namens erfasst der Wert Musterartikel nur Muster, für die am Artikel kein eigener Musterartikel hinterlegt ist. Ein Muster aus einem Musterartikel liegt als normaler Artikel im Warenkorb und wird davon nicht erfasst. Mehr dazu unter Einen eigenen Artikel als Muster verwenden.

So sehen deine Kunden die Muster

Muster im Listing

Artikel mit Muster tragen das Badge Muster möglich. Unter dem Preis steht der Musterpreis, bei kostenlosen Mustern Muster Gratis!. Hast du den Musterbutton für das Listing eingeschaltet, legen deine Kunden das Muster direkt dort mit Muster in den Warenkorb in den Warenkorb. Was davon erscheint, steuerst du unter Muster im Listing zeigen.

Listing mit Badge Muster möglich, Musterpreis und Musterbutton

Muster auf der Produktseite bestellen

Auf der Produktseite steht der Musterpreis unter den Preisangaben des Artikels, direkt vor dem Hinweis zu Mehrwertsteuer und Versandkosten. So bezieht sich eine Grundpreisangabe immer auf den Artikel und nie auf das Muster. Ist das Muster kostenlos, steht dort Muster Gratis!.

Unter In den Warenkorb liegt der Button Muster in den Warenkorb. Ein Klick legt genau ein Muster des Artikels in den Warenkorb, danach öffnet sich der Warenkorb am rechten Rand.

Produktseite mit Musterpreis und Button Muster in den Warenkorb

Der angezeigte Musterpreis berücksichtigt, was schon im Warenkorb liegt: Sind die kostenlosen Muster verbraucht, zeigt die Produktseite den Preis aus Musterpreis nach kostenfrei an. Hast du am Artikel einen Musterartikel hinterlegt, zeigt die Produktseite dessen Preis als Musterpreis an.

Muster im Warenkorb

Jedes Muster steht als eigene Position mit der Menge 1 im Warenkorb. Es trägt Namen und Artikelnummer nach deinen Einstellungen und zeigt seinen Lieferzeitraum. Kostenlose Muster zeigen in der Summe Gratis!. Ein Klick auf den Namen führt zur Produktseite des Artikels. Mit dem Kreuz rechts neben der Position entfernt dein Kunde ein Muster wieder.

Hast du am Artikel einen Musterartikel hinterlegt, steht stattdessen dieser Artikel mit eigenem Namen, eigener Artikelnummer und eigenem Preis im Warenkorb. Mehr dazu unter Einen eigenen Artikel als Muster verwenden.

Die Musterpauschale steht als eigene Position darunter und lässt sich nicht entfernen.

Warenkorb mit drei Mustern und der Position Musterpauschale

Hinweise für deine Kunden

In bestimmten Fällen zeigt der Shop deinen Kunden einen Hinweis:

• Maximale Anzahl Muster im Warenkorb erreicht. Der Kunde hat so viele Muster im Warenkorb, wie du unter Maximale Anzahl von Mustern erlaubst. Das nächste Muster legt der Shop nicht mehr in den Warenkorb.
• Es kann nur ein Muster pro Artikel bestellt werden. Das Muster dieses Artikels liegt schon im Warenkorb.
• Die maximale Anzahl Muster ist erreicht. Überzählige Muster wurden aus dem Warenkorb entfernt. Du hast die maximale Anzahl herabgesetzt, und ein Warenkorb enthielt danach mehr Muster als erlaubt.
• Dieser Artikel ist derzeit nicht als Muster bestellbar. Der Artikel wird in diesem Verkaufskanal nicht oder nicht mehr als Muster angeboten.

Hinweis im Warenkorb, wenn die maximale Anzahl Muster erreicht ist

Ansicht auf dem Smartphone

Auch auf dem Smartphone sehen deine Kunden den Musterpreis bei den Preisangaben. Der Button Muster in den Warenkorb liegt direkt unter In den Warenkorb.

Produktseite auf dem Smartphone mit Musterpreis und Musterbutton

Fehlerbehebung

Der Button „Muster in den Warenkorb“ fehlt auf der Produktseite

Woran es liegen kann und so behebst du es:

1. Das Plugin ist im Verkaufskanal ausgeschaltet. Öffne die Einstellungen, wähle oben unter Verkaufskanal genau diesen Verkaufskanal aus und prüfe Plugin für diesen Verkaufskanal aktivieren.
2. Der Artikel ist nicht als Muster freigeschaltet. Schalte am Artikel hat Muster ein und speichere. Hast du die Angaben nur an der Kategorie eingetragen, übertrage sie mit Einstellungen auf Artikel übernehmen.
3. Der Artikel ist im Abverkauf und nicht mehr ausreichend auf Lager. Ist am Artikel Abverkauf eingeschaltet und reicht der Bestand nicht mehr, blendet das Plugin den Musterbutton aus.
4. Du nutzt zusätzlich unser Plugin „Preis auf Anfrage“ mit der freigeschalteten Funktion „Muster anfragen“. Steht der Artikel dort auf Nur Muster anfragen, blendet Musterbestellung den eigenen Button aus. Siehe FAQ.
5. Der Shop zeigt noch einen alten Stand. Leere den Cache unter Einstellungen → System → Caches & Indizes mit Cache löschen.

Musterbutton, Badge oder Musterpreis fehlen im Listing

Woran es liegt: Jede dieser Anzeigen hat einen eigenen Schalter. Den Musterbutton im Listing musst du erst einschalten.

So behebst du es: Schalte unter weitere Einstellungen die Schalter Musterbutton im Listing anzeigen, Badge im Listing anzeigen und Musterpreise im Listing anzeigen nach Bedarf ein und speichere. Prüfe dabei, ob oben der richtige Verkaufskanal ausgewählt ist.

Im Warenkorb steht „Musterpauschale“ mit „Gratis!“

Woran es liegt: Unter Musterpauschale ist eine Pauschale ausgewählt, der Betrag steht aber auf 0.

So behebst du es: Willst du keine Pauschale, stelle Musterpauschale auf Nein. Andernfalls trage unter Preis für Musterpauschale den gewünschten Betrag ein.

Die Musterpauschale erscheint nicht

Woran es liegt: Mit nur Muster im Warenkorb fällt die Pauschale nur an, wenn der Warenkorb ausschließlich Muster enthält. Liegt zusätzlich ein normaler Artikel im Warenkorb, entfällt sie.

So behebst du es: Soll die Pauschale bei jedem Warenkorb mit Muster anfallen, wähle wenn Muster im Warenkorb.

Der angezeigte Betrag weicht von meiner Eingabe ab

Woran es liegt: Der Shop zeigt Musterbeträge je nach Steuerdarstellung der Kundengruppe als Brutto- oder Nettobetrag an.

So behebst du es: Lies So zeigt der Shop Bruttobeträge und Nettobeträge an und trage die Beträge so ein, wie deine Kunden sie sehen sollen.

Ein Muster zeigt nicht die eingetragene Lieferzeit

Woran es liegt: Die eigene Lieferzeit gilt nur, wenn Lieferzeit überschreiben Status eingeschaltet ist und beide Tage-Felder eine Zahl größer als 0 enthalten.

So behebst du es: Prüfe am Artikel im Reiter Muster alle drei Felder und speichere.

Hast du am Artikel einen Musterartikel hinterlegt, gelten diese Felder nicht. Das Muster zeigt dann die Lieferzeit des Musterartikels.

Statt des Musterartikels erscheint die normale Musterposition

Woran es liegen kann:

1. Der Musterartikel ist im Verkaufskanal nicht verfügbar, zum Beispiel weil er inaktiv oder dem Verkaufskanal nicht zugeordnet ist.
2. Der Musterartikel ist ein Hauptartikel mit Varianten.
3. Der Musterartikel hat eine Mindestabnahme über 1.

In allen drei Fällen legt der Shop automatisch ein normales Muster an, damit dein Kunde sein Muster trotzdem bekommt. Den Grund notiert das Plugin als Warnung in seinem Protokoll, siehe Für Administratoren / Technische Details.

So behebst du es: Mach den Musterartikel im Verkaufskanal verfügbar oder wähle unter Musterartikel einen geeigneten Artikel aus, zum Beispiel einen Artikel ohne Varianten. Speichere den Artikel. Ein Muster, das schon im Warenkorb liegt, bleibt eine normale Musterposition: Entferne es und lege es neu in den Warenkorb.

Ein Gutschein für den ganzen Warenkorb vergünstigt die Muster nicht

Woran es liegt: Muster in Warenkorb-Rabatte einbeziehen ist ausgeschaltet. Das ist die Standardeinstellung.

So behebst du es: Schalte unter weitere Einstellungen Muster in Warenkorb-Rabatte einbeziehen ein und speichere. Prüfe dabei, ob oben der richtige Verkaufskanal ausgewählt ist. Mehr dazu unter Muster bei Warenkorb-Rabatten berücksichtigen.

Der Button „Einstellungen auf Artikel übernehmen“ lässt sich nicht anklicken

Woran es liegen kann:

1. An der Kategorie sind noch ungespeicherte Änderungen offen.
2. Dein Benutzerkonto darf keine Kategorien bearbeiten.

So behebst du es: Klicke zuerst oben rechts auf Speichern. Fehlt dir die Berechtigung, bitte einen Administrator, sie dir unter Einstellungen → System → Benutzer & Rechte zu geben.

Nach „Speichern“ in der Rückfrage bleibt das Fenster offen

Woran es liegt: Das Übertragen hat nicht geklappt. Dafür braucht dein Benutzerkonto das Recht, Kategorien und Produkte zu bearbeiten.

So behebst du es: Schließe das Fenster mit Abbrechen. Lass dir unter Einstellungen → System → Benutzer & Rechte beide Rechte geben und versuche es erneut.

FAQ

F: Kann ein Kunde mehrere Muster desselben Artikels bestellen?

A: Nein. Von jedem Artikel liegt höchstens ein Muster im Warenkorb, immer mit der Menge 1.

F: Zählen Muster mit eigenem Musterpreis zu den kostenlosen Mustern?

A: Nein. Ein Muster mit eigenem Musterpreis kostet immer diesen Preis. Zu den kostenlosen Mustern zählen nur Muster ohne eigenen Preis.

F: Was passiert, wenn ich unter „Musterpreis nach kostenfrei“ nichts eintrage?

A: Dann bleiben auch die Muster kostenlos, die über die eingestellte Anzahl kostenloser Muster hinausgehen.

F: Kann ich Muster nur in einem Verkaufskanal anbieten?

A: Ja. Wähle in den Einstellungen oben den Verkaufskanal aus, in dem es keine Muster geben soll, und schalte dort Plugin für diesen Verkaufskanal aktivieren aus.

F: Werden Musterpreise in andere Währungen umgerechnet?

A: Ja. Musterpreis, Musterpreis nach kostenfrei und Musterpauschale rechnet der Shop mit dem Umrechnungsfaktor der Währung um, die dein Kunde gewählt hat.

F: Kann ich als Muster einen eigenen Artikel mit Lagerbestand verwenden?

A: Ja. Hinterlege ihn am Artikel als Musterartikel. Dann legt der Musterbutton genau diesen Artikel in den Warenkorb, und sein Bestand wird abgebucht. Siehe Einen eigenen Artikel als Muster verwenden.

F: Gelten Gutscheine auch für Muster?

A: Standardmäßig nicht. Promotions und Gutscheine für den ganzen Warenkorb vergünstigen Muster nur, wenn Muster in Warenkorb-Rabatte einbeziehen eingeschaltet ist. Muster aus einem Musterartikel zählen immer mit. Siehe Muster bei Warenkorb-Rabatten berücksichtigen.

F: Ändern sich Muster und Musterpauschale, wenn ich eine Bestellung in der Administration bearbeite?

A: Nein. Beim Bearbeiten einer Bestellung bleiben Musterpositionen und die Musterpauschale in der Bestellung und behalten ihren bestellten Preis. Das gilt auch, wenn du inzwischen die Einstellungen geändert, am Artikel hat Muster ausgeschaltet oder das Plugin im Verkaufskanal ausgeschaltet hast.

F: Erhalten neue Artikel einer Kategorie die Muster-Angaben automatisch?

A: Nein. Übertrage die Angaben nach dem Zuordnen neuer Artikel erneut mit Einstellungen auf Artikel übernehmen.

F: Ich nutze auch das Plugin „Preis auf Anfrage“. Was passiert?

A: Beide Plugins arbeiten zusammen, ohne dass du etwas einstellen musst. Bietet „Preis auf Anfrage“ für einen Artikel an, ein Muster anzufragen, blendet Musterbestellung für diesen Artikel den Button Muster in den Warenkorb aus, im Listing und auf der Produktseite. So sehen deine Kunden nicht zwei Muster-Buttons nebeneinander.

F: Was brauche ich für „Muster anfragen“?

A: Drei Dinge, und alle drei müssen zusammenkommen:

1. Beide Plugins: Musterbestellung und Preis auf Anfrage, beide installiert und aktiv. Musterbestellung legt über den Schalter hat Muster fest, welche Artikel überhaupt musterfähig sind; „Preis auf Anfrage“ bringt das Anfrageformular mit. Fehlt eines der beiden Plugins, gibt es kein „Muster anfragen“.
2. Den In-App-Kauf „Muster anfragen“: Er gehört zu „Preis auf Anfrage“ und wird dort in den Plugin-Einstellungen freigeschaltet (Erweiterungen → Meine Erweiterungen → Preis auf Anfrage → Konfigurieren). Ohne diesen Kauf erscheint im Shop nichts davon.
3. Die Einstellung am Artikel: In „Preis auf Anfrage“ legst du je Artikel das Musterverhalten fest — Nur Muster bestellen (Standard), Nur Muster anfragen oder Muster bestellen und anfragen.

Erst wenn der In-App-Kauf freigeschaltet ist und der Artikel auf Nur Muster anfragen steht, blendet Musterbestellung seinen Button Muster in den Warenkorb aus. Ohne den Kauf bleibt unser Button stehen, bei Muster bestellen und anfragen stehen beide Buttons untereinander.

F: Kann ich Versandarten oder Zahlungsarten nur für Muster anbieten?

A: Ja, über eine Regel mit der Bedingung Position vom Typ. Siehe So nutzt du Muster in Regeln.

Für Administratoren / Technische Details

Dieser Abschnitt richtet sich an technische Administratoren. Für die normale Nutzung brauchst du ihn nicht.

Systemanforderungen

• Shopware: 6.7
• PHP: 8.2 oder neuer

Installation über die Kommandozeile

Der technische Name des Plugins lautet SwpSampleOrderSix.

bin/console plugin:refresh
bin/console plugin:install --activate SwpSampleOrderSix
bin/console cache:clear

Hinweise für eigene Themes und Anbindungen

Seit Version 6.7.6 tragen die Routen des Plugins ein Herstellerpräfix. Eigene Themes oder Anbindungen, die noch die alten Pfade aufrufen, musst du anpassen:

• Muster in den Warenkorb legen (Storefront): POST /swp-sample-order/line-item/add, Routenname frontend.swp.sample-order.line-item.add. Bisher /checkout/line-item/add-sample.
• Muster-Angaben einer Kategorie übertragen (Admin-API): POST /api/_action/swp-sample-order/processing. Bisher /api/_action/sampleordertoproducts/processing.

Seit Version 6.7.7 ist die Kennung einer Musterposition im Warenkorb eine gültige UUID, bisher <Produkt-ID>sample. Erweiterungen, die Positionskennungen umwandeln, etwa die Shopware B2B Suite, brachen den Warenkorb daran bisher mit einem Fehler ab. Warenkörbe von vor dem Update funktionieren weiter.

Im Warenkorb und in Regeln haben Muster den Positionstyp swpsampleorder, die Musterpauschale den Positionstyp sampleSurcharge. Menge und Höchstzahl der Muster setzt die Warenkorbberechnung selbst durch: Eine Musterposition hat immer die Menge 1.

Ein Muster aus einem Musterartikel ist dagegen eine normale Produktposition (product). Du erkennst es an den Zusatzdaten der Position: swpSample ist true, swpSampleOf enthält die ID des Artikels, zu dem das Muster gehört. Beides wird mit der Bestellung in der Bestellposition gespeichert; eine Warenwirtschaft liest es über die Admin-API aus. Die Regel-Bedingung Position vom Typ mit dem Wert swpsampleorder erfasst solche Muster nicht.

Für Datenimporte: Die Muster-Felder gehören zum Zusatzfeld-Set sample_order_six. Die Freischaltung als Muster steckt im Zusatzfeld sample_order_six_flag, der Musterpreis in sample_order_six_price.

Der Musterartikel steckt im Zusatzfeld sample_order_six_article des eigenen Zusatzfeld-Sets sample_order_six_target („Muster: Musterartikel“). Es enthält die ID des Musterartikels. Das Set hängt nur an Artikeln, nicht an Kategorien; das Übertragen von Kategorie-Angaben verändert den Musterartikel deshalb nicht.

Protokoll

Kann das Plugin einen hinterlegten Musterartikel nicht verwenden, legt es die normale Musterposition an und schreibt eine Warnung in seinen eigenen Protokoll-Kanal swp_sample_order_six. Die Dateien liegen unter var/log/ und heißen swp_sample_order_six_<Umgebung>-<Datum>.log, zum Beispiel swp_sample_order_six_prod-2026-09-21.log. Das Plugin bewahrt die letzten 14 Tagesdateien auf. Jeder Eintrag nennt die IDs von Artikel, Musterartikel und Verkaufskanal (sourceProductId, sampleProductId, salesChannelId). Je nach Grund lautet die Meldung:

• Zugewiesener Musterartikel ist im Verkaufskanal nicht verfuegbar - Rueckfall auf die virtuelle Musterposition.
• Zugewiesener Musterartikel ist nicht als Einzelstueck bestellbar (Variantenhauptartikel oder Mindestabnahme ueber 1) - Rueckfall auf die virtuelle Musterposition.

Dieselbe Meldung schreibt das Plugin je Anfrage an den Shop höchstens einmal.

Berechtigungen

Das Übertragen der Kategorie-Angaben verlangt die Rechte category:update und product:update. Der Button in der Kategorie ist nur für Benutzer mit Bearbeitungsrecht für Kategorien anklickbar.

Alte Regel „Sample Price“

Bis Version 6.7.5 legte das Plugin eine Regel „Sample Price“ an. Der Bedingungstyp dieser Regel funktioniert seit Langem nicht mehr, die Regel hat nie gegriffen. Ab Version 6.7.6 legt das Plugin sie nicht mehr an. Muster sprichst du stattdessen mit der Bedingung Position vom Typ an.

Beim Update entfernt das Plugin die alte Regel nur, wenn sie unverändert und unbenutzt ist. Hat sie weitere Bedingungen oder wird sie von Preisen, Versandarten, Zahlungsarten, Steueranbietern, Aktionen oder Flows verwendet, bleibt sie bestehen. Prüfe sie dann im Rule Builder und lösche sie, sobald du sie nicht mehr brauchst.

Deinstallation

Deinstallierst du das Plugin und behältst dabei die Plugin-Daten nicht, entfernt es die Zusatzfeld-Sets „Muster“ und „Muster: Musterartikel“ mit ihren Feldern. Außerdem entfernt es eine noch vorhandene Regel „Sample Price“. Wird sie noch von Preisen, Versandarten, Zahlungsarten, Steueranbietern oder Flows verwendet, bleibt sie bestehen. Behältst du die Daten, bleibt alles erhalten.

---

Diese Anleitung wurde für Musterbestellung Version 6.7.7 erstellt.