codeenterpriseService

Gutschein per URL einlösen

Das Herzstück des Plugins ist der voucher-Parameter. Du hängst ihn an eine beliebige Storefront-URL an — beim Aufruf des Links werden die angegebenen Codes automatisch in den Warenkorb gelegt.

Ergänze deine URL um ?voucher=DEINCODE (oder &voucher=DEINCODE, falls die Adresse bereits Parameter enthält):

https://dein-shop.de/?voucher=SOMMER25
https://dein-shop.de/aktion/sommer?voucher=SOMMER25

Ersetze SOMMER25 durch den Code der Promotion, die du in Shopware angelegt hast. Der Parameter heißt immer voucher und ist fest vorgegeben.

Möchtest du mehrere Codes gleichzeitig einlösen, schreibst du den Parameter mit eckigen Klammern und wiederholst ihn für jeden Code:

https://dein-shop.de/?voucher[]=SOMMER25&voucher[]=VERSANDFREI

Dabei gilt:

  • Jeder Code wird einzeln eingelöst, in der Reihenfolge, in der er im Link steht. Dein Kunde sieht für jeden Code die passende Meldung — Erfolg oder Hinweis.
  • Pro Link werden höchstens 25 Codes berücksichtigt. Weitere Codes werden ignoriert.
  • Leere Werte und doppelt angegebene Codes werden übersprungen.
  • Links mit nur einem Code im Format ?voucher=DEINCODE funktionieren weiterhin unverändert.

Was beim Aufruf passiert

  • Warenkorb enthält Produkte: Die Codes werden sofort angewendet. Dein Kunde sieht die Erfolgsmeldung von Shopware und der Rabatt erscheint im Warenkorb.
  • Warenkorb ist leer: Alle Codes werden gemerkt und automatisch eingelöst, sobald das erste Produkt hinzukommt. Optional zeigt dein Shop dazu einen Hinweis an (siehe Konfiguration):

> Promotion wird automatisch dem Warenkorb hinzugefügt, wenn mindestens ein Produkt im Warenkorb liegt.

  • Code bereits im Warenkorb: Ein identischer Code wird nicht doppelt hinzugefügt.

Feste und individuelle Codes

Beide Gutschein-Arten von Shopware funktionieren:

  • Feste Codes — ein Code für alle Kunden (z. B. SOMMER25).
  • Individuelle Codes — pro Kunde generierte Einmal-Codes. Setze den jeweils erzeugten Code als voucher-Wert ein.

Entscheidend ist nur, dass die zugehörige Promotion in Shopware aktiv ist und ihre Bedingungen (etwa ein Mindestbestellwert) erfüllt sind.

Werden Bedingungen noch nicht erfüllt

Erreicht der Warenkorb zum Beispiel einen geforderten Mindestbestellwert noch nicht, kann der Code noch nicht greifen. Dein Kunde erhält beim Öffnen des Links einen entsprechenden Hinweis. Der Gutschein bleibt aber im Warenkorb hinterlegt und wird automatisch eingelöst, sobald die Bedingungen erfüllt sind — der Link muss nicht erneut aufgerufen werden.

Du brauchst mehr als ein Plugin?

Deine eigene Shopware-Abteilung zum Festpreis.

codeenterprise – Shopware Premium Extension PartnerWirf deine Aufgabe rein — im Schnitt ist sie in 72 Stunden erledigt. Ohne Angebotsschleife, ohne Stundenzettel, ohne Meeting-Zwang. Und wenn's nicht mehr passt: jederzeit kündbar.

Jetzt freien Slot sichern