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.
Den Link aufbauen
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=SOMMER25Ersetze SOMMER25 durch den Code der Promotion, die du in Shopware angelegt hast. Der Parameter heißt immer voucher und ist fest vorgegeben.
Mehrere Gutscheine in einem Link
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[]=VERSANDFREIDabei 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=DEINCODEfunktionieren 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.
Wirf 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.